一、先看本质:目录与单文件

XYZ 瓦片不是一种文件格式,而是一种目录约定。切片工具按层级和行列把每张 256×256 的图片存成 {z}/{x}/{y}.png,前端按当前视口计算出需要的 z、x、y,拼成 URL 去请求。 整个体系里没有数据库、没有服务端解析,Nginx 把目录当静态资源发出去就行。

MBTiles 是一个 SQLite 数据库文件。所有瓦片以二进制形式存在 tiles 表的 tile_data 字段里,用 zoom_level、tile_column、 tile_row 三列定位;另有一张 metadata 表记录名称、范围、 最低和最高级别、图像格式等信息。因为是单个文件,拷贝、归档和传给第三方都很省事。

最容易踩的坑:MBTiles 内部使用 TMS 的行号,y 轴方向与 XYZ 相反, 关系是 y_tms = 2^z - 1 - y_xyz。导出或转换时没有翻转,地图会上下颠倒, 而且只有放大到高等级时才容易被发现。

二、六个维度对比

两种格式承载的像素完全相同,差别在存储与读取方式。下面这张表可以直接拿去做选型沟通。

维度XYZ 目录MBTiles 单文件
存储形态多级目录,数十万个小文件一个 SQLite 文件
寻址方式按 URL 路径直接定位文件按三列主键查询,再读出二进制
读取链路Web 服务器直接返回,可走 sendfile 与内核缓存需要服务进程打开数据库、执行查询、返回结果
部署Nginx root 指向目录即可,零配置需要 tileserver-gl 之类的读取服务或插件
增量更新直接覆盖对应瓦片文件,改动粒度最小事务写入替换单条记录,需要写入工具
备份迁移文件多,打包和同步都慢单文件拷贝,适合归档与跨网传递

补充两点实际影响。第一是文件数量:一个做到 z16 的园区工程可能有几万到十几万张瓦片, 目录方案在小文件密集时更依赖文件系统性能,拷贝和杀毒扫描都会明显变慢。 第二是对象存储与 CDN:XYZ 的地址天然可缓存,扔进对象存储就能加速;MBTiles 是单文件,不能直接这样用。

三、性能差在哪里

很多对比会说「MBTiles 更快」或「XYZ 更快」,这两个结论都对,取决于场景。 静态目录的优势在于并发:请求进来后由 Web 服务器直接零拷贝返回,不需要应用进程参与, 高并发时更容易把网卡和磁盘跑满。MBTiles 的优势在于文件管理:没有海量小文件, 备份、同步、迁移的成本低,也不会把目录的 inode 撑爆。

内网大屏这类「几十个客户端、固定几张底图」的场景,两种格式都能胜任, 差别更多体现在运维便利性上。真正需要关注的是随机读:MBTiles 每次请求都要经过一次索引查询, 并发很高时受数据库连接和锁的限制,调优空间不如静态文件大。 如果确实要压测,用自己的瓦片和真实并发跑一遍,比看任何结论都可靠。

四、两种格式互相转换

两者可以无损互转,常用工具是 mb-util,也可以借助 GDAL。 转换时最关键的是 y 轴方向,务必显式指定 XYZ 方案。

terminalmb-util 转换
# MBTiles 单文件 → XYZ 目录
mb-util --scheme=xyz input.mbtiles output_tiles

# XYZ 目录 → MBTiles 单文件
mb-util --scheme=xyz output_tiles output.mbtiles

不同版本的 mb-util 默认 scheme 不完全一致,转换完成后先随便打开一张瓦片, 确认上下方向、缩放级别和文件名都对。转换会继承原文件的级别范围, 如果源数据只切到 z15,转换后也不会凭空多出 z16。

用 GDAL 时可以把 MBTiles 当成栅格数据源读取,再按 XYZ 目录组织导出; 反过来也可以先把目录整理成 VRT 再写 MBTiles。命令行参数更多,适合需要批量处理的场景, 日常单次转换用 mb-util 更直接。

五、Nginx 直出 XYZ

XYZ 目录最大的优势是发布成本低。下面这段配置把 /data/basemap 作为根目录, 通过 /tiles/ 前缀暴露,并补上缓存与跨域头。

nginx.confXYZ 静态直出
server {
    listen 80;
    server_name map.intra.example.com;

    root /data/basemap;

    location /tiles/ {
        add_header Access-Control-Allow-Origin "*";
        add_header Cache-Control "public, max-age=604800";
        try_files $uri =404;
    }
}

前端地址就是 http://map.intra.example.com/tiles/frost/{z}/{x}/{y}.png。 如果瓦片是 WebP,把后缀改成 .webp 即可,服务端配置不用动。 MBTiles 则必须再加一层读取服务,把一个 HTTP 端点映射为 XYZ 地址, 这也是它更适合归档而不是直接对外供图的原因。

六、怎么选:按场景决策

你的场景建议原因
内网大屏、瓦片长期不变XYZ 目录Nginx 直接发布,运维成本最低,出问题好排查
要发给甲方或跨网拷贝MBTiles(可同时留一份 XYZ)单文件传输不易丢,接收方导入方便
要放对象存储或 CDNXYZ 目录URL 可缓存,能直接享受分发网络
移动端离线包MBTiles单文件便于打包进应用,按范围查询
需要按小块范围更新XYZ 目录覆盖单张瓦片即可,不必重写整个文件
归档与长期备份MBTiles一个文件搞定版本和校验,节省备份窗口

如果不想做选择,就两个都出。切图时用同一份数据、同一套样式,导出一份目录用于供图, 再导出一份单文件用于归档。代价只是多占一份磁盘,换来的是部署灵活和交付方便。

七、三个常见误区

  • 以为 MBTiles 更省空间。瓦片本身已经是 PNG 或 WebP,压缩在上一步就完成了。 MBTiles 省的是小文件占用的文件系统开销,不是图像体积,差距通常远小于预期。
  • 直接把 MBTiles 放进静态目录。浏览器拿到的是一个二进制数据库文件, 前端无法按 XYZ 地址请求,必须由服务进程读出瓦片再返回。
  • 转换后不检查方向。TMS 与 XYZ 的 y 轴相反,转换参数写错时地图会上下颠倒, 在低级别下不明显,放大后才发现,返工成本很高。

八、常见问题

Q1 MBTiles 能直接用 Nginx 提供 XYZ 服务吗?

不能。Nginx 不能解析 SQLite,必须由服务端进程(例如 tileserver-gl)读取 MBTiles 再以 XYZ 地址输出,或者先用转换工具导出成瓦片目录。想要零配置直出,就用 XYZ 目录。

Q2 同一个范围,两种格式体积差多少?

瓦片图像本身完全相同,MBTiles 只是把文件装进一个 SQLite 容器。体积差异主要来自文件系统块开销和小文件元数据,瓦片数量越多差异越明显,但通常不是数量级差别。

Q3 能不能同时导出两种格式?

可以,而且推荐这样做。用同一份数据和同一套样式切一次,再分别导出目录与单文件,保证范围、级别和配色完全一致。目录用于对内供图,单文件用于归档和对外拷贝。

还在确定整体方案的话,先看离线地图怎么做理清数据、样式、 瓦片和服务四层的关系;要把底图放进隔离网长期运行,看 内网底图解决方案。想直接看 XYZ 目录跑起来的样子, 在线预览就是按这个结构切出来的深圳 z8–z16 瓦片。