东营昕睿信息科技GIS · 智慧园区 · 地下管网 · 嵌入式
预约演示

快速入门

星火地图发布服务快速入门：把 MBTiles 瓦片发布为 WMTS / XYZ 地图服务

初版内容

本文正在按正式版本补充截图与参数，界面名称与数值以实际软件为准。

要点速览

星火地图发布服务的基本流程是：登录官网账号激活授权 → 选择 SQLite / MBTiles 文件或文件瓦片目录 → 配置监听地址、端口、图块尺寸与输出格式 → 一键启动，得到 WMTS / TMS / XYZ 接入地址 → 在 Leaflet、OpenLayers、Cesium 或 GIS 桌面软件中填入地址验证。社区免费版只能在本机（127.0.0.1）发布 1 个服务，适合先做本地验证。

这篇适合第一次使用星火地图发布服务（桌面程序「星火地图发布」）的 GIS 工程师和运维人员。读完后，你能把一份已有的瓦片数据发布成标准地图服务，并在地图组件中加载验证。前置条件：一台 Windows 10 / 11（x64）电脑、一份 SQLite / MBTiles 瓦片文件或文件瓦片目录（例如用 星火地图下载器 下载的成果，或自有的航空 / 卫星影像切片），以及一个官网会员账号。

说明

不同版本的界面文字可能略有差异，菜单与按钮名称请以实际程序为准。

第 1 步：准备账号、单位与瓦片数据 #

目的：确认授权前提和待发布的数据都已就绪。

  1. 在官网注册会员账号，并在「用户中心 → 我的单位」中创建或加入一个单位。
  2. 准备待发布的瓦片数据，支持两种存储形式：
    • SQLite / MBTiles 单文件；
    • 传统文件瓦片目录（按层级、行列号存放的 PNG / JPG）。
  3. 确认你对这份数据拥有发布和使用的权利（自有数据或已获授权的数据）。

预期结果：账号已属于一个单位，瓦片数据已拷贝到将要运行发布服务的电脑上。

第 2 步：下载并安装星火地图发布服务 #

目的：在将要提供地图服务的电脑或服务器上安装程序。

  1. 登录官网后，打开 星火地图发布服务下载页 下载 Windows 安装包。
  2. 安装并启动程序。

建议：正式对外提供服务时，安装在内网中长期开机、网络稳定的服务器上；本地验证可以先装在自己的电脑上。

预期结果：程序启动后显示登录界面。

第 3 步：登录并激活授权 #

目的：授权决定了能否对外发布、可发布服务数和并发连接上限。

  1. 用官网会员账号登录，完成验证码。
  2. 登录后一键激活本单位授权；名下没有授权时，领取社区免费版或申请 14 天试用。
  3. 无法联网的专网服务器可以使用离线激活，见 常见问题。
套餐可发布服务数并发连接对外发布
社区免费版1 个50仅本机（127.0.0.1），个人非商用
标准版5 个500支持局域网 / 公网地址
企业版不限5000支持局域网 / 公网地址

预期结果：进入主界面，授权页显示当前套餐。

第 4 步：选择数据源并配置发布参数 #

目的：告诉程序发布哪份数据、在哪个地址和端口上提供服务。

  1. 新建一个发布服务，选择 SQLite / MBTiles 文件或文件瓦片目录。
  2. 配置发布参数：
参数含义首次验证建议
监听地址服务绑定的网络地址社区免费版只能使用本机地址 127.0.0.1
端口服务监听端口选择一个未被占用的端口
图块尺寸每张瓦片的像素尺寸与数据源实际尺寸保持一致，常见为 256 像素
输出格式瓦片图片格式与数据源格式保持一致（如 PNG 或 JPG）

预期结果：发布参数保存成功，没有地址或端口冲突提示。

第 5 步：一键启动服务并获取接入地址 #

目的：启动服务，拿到客户端需要填写的地址。

  1. 启动服务后，程序生成 WMTS、TMS、XYZ 三种接入地址。
  2. 在运行状态中查看服务是否正常、当前并发连接数和缓存命中情况。
  3. 复制需要的接入地址备用：Web 地图组件通常使用 XYZ 地址，GIS 桌面软件通常使用 WMTS 地址。

预期结果：服务处于运行状态，并获得接入地址。

第 6 步：在地图组件中接入验证 #

目的：确认底图能被客户端正常加载，各层级显示正确。

  1. 以 Leaflet 为例，新建一个网页，把 <XYZ 接入地址> 替换为程序生成的 XYZ 地址（地址中包含 {z}、{x}、{y} 占位符）：
javascript
const map = L.map('map').setView([30.66, 104.07], 12)
L.tileLayer('<XYZ 接入地址>', { maxZoom: 18 }).addTo(map)
  1. 用浏览器打开网页，拖动、缩放地图，检查各层级瓦片是否正常显示。
  2. 也可以在 QGIS 等支持 WMTS / XYZ 的 GIS 桌面软件中添加图层验证。

预期结果：地图正常显示发布的底图。出现空白时，先检查地图中心和缩放级别是否落在数据的覆盖范围与层级内。

下一步 #