Martin 瓦片服务器极简实用教程

一、简介

Martin 是由 Rust 开发的轻量、高性能地图瓦片服务器，支持 MBTiles、PMTiles、PostGIS 等数据源，开箱即用，非常适合本地离线地图开发、内网瓦片服务发布。

二、安装

1. 从官方 Releases 下载对应系统版本
2. 解压后得到单个可执行文件，无需安装
3. Windows：martin.exe
4. Linux/macOS：martin

三、最基础启动（自动扫描）

将瓦片文件（.mbtiles / .pmtiles）放在 martin.exe 同一目录下，直接运行：

martin.exe

Martin 会自动扫描并加载所有瓦片数据源。

四、常见报错与解决

错误：No tile sources found

原因：当前目录没有检测到任何瓦片文件。

解决方法（任选其一）：

1. 手动指定瓦片文件

martin.exe 你的瓦片文件.mbtiles

2. 开启 Web UI 并指定数据源

martin.exe --webui enable-for-all 你的瓦片文件.mbtiles

3. 将瓦片文件复制到 martin 所在目录，再直接运行 martin.exe

五、常用启动命令

1. 开启 Web 管理界面

martin.exe --webui enable-for-all

打开浏览器访问：http://localhost:3000

2. 修改端口

martin.exe --webui enable-for-all -l 0.0.0.0:8080

3. 保存配置文件

martin.exe --save-config config.yaml

4. 使用配置文件启动

martin.exe -c config.yaml

六、瓦片访问地址

启动成功后，瓦片接口格式：

http://localhost:3000/数据源名称/{z}/{x}/{y}

例如瓦片文件名为 base.mbtiles：

http://localhost:3000/base/{z}/{x}/{y}

七、其他实用功能

• 默认已开启 CORS，前端调用无跨域问题
• 支持多数据源同时加载
• 支持字体、图标 sprite、地图样式托管
• 支持设置缓存大小、路由前缀、反向代理适配

八、典型完整启动命令（推荐）

martin.exe --webui enable-for-all -l 0.0.0.0:3000 瓦片文件.mbtiles