星火地图发布服务操作指南：发布参数、对外发布、缓存并发与客户端接入

这篇面向需要在内网或专网中长期提供底图服务的 GIS 工程师和运维人员。读完后，你能正确配置发布参数、把服务开放给局域网中的其他系统，并在主流地图组件和 GIS 软件中完成接入。前置条件：已按 快速入门 在本机发布并验证过一个服务。

数据源 #

数据可以来自 星火地图下载器 的下载成果，也可以是测绘单位交付的自有航空 / 卫星影像切片。一台发布服务可以同时运行多个服务，每个服务对应一份数据，可发布的服务数量按套餐限制。

发布参数 #

本机发布与对外发布 #

对外发布的操作要点：

1. 把监听地址设为服务器的局域网 IP（或程序允许的全部地址）。
2. 在服务器 Windows 防火墙中放行该端口的入站连接；中间有硬件防火墙或安全网关时，请网络管理员放通。
3. 在另一台电脑上用浏览器或 GIS 软件访问接入地址验证。

对公网开放前，请确认所发布数据的授权允许公开提供服务，并做好访问控制。

并发连接与分级缓存 #

• 并发连接上限：限制同时连接的数量，防止单个客户端或突发访问拖垮服务。地图客户端浏览时一次会请求多张瓦片，并发需求会比在线用户数高。
• 分级缓存：常用层级的瓦片会自动缓存，减少重复读取存储的开销。运行状态中可以查看并发连接数和缓存命中情况。

多个系统频繁访问时出现加载变慢，先查看并发连接是否接近上限，再考虑升级套餐或把数据放在更快的磁盘上。

三种发布协议怎么选 #

TMS 与 XYZ 的行号方向相反。把 TMS 地址当作 XYZ 使用（或反过来）时，瓦片会上下错位，表现为地图内容错乱或范围不对。

客户端接入示例 #

以下示例中，<XYZ 接入地址> 和 <TMS 接入地址> 请替换为程序生成的完整地址。

Leaflet #

// XYZ 地址
L.tileLayer('<XYZ 接入地址>', { maxZoom: 18 }).addTo(map)

// TMS 地址：需要声明 tms: true，翻转行号方向
L.tileLayer('<TMS 接入地址>', { tms: true, maxZoom: 18 }).addTo(map)

OpenLayers #

const layer = new ol.layer.Tile({
  source: new ol.source.XYZ({ url: '<XYZ 接入地址>' })
})
map.addLayer(layer)

Cesium #

viewer.imageryLayers.addImageryProvider(
  new Cesium.UrlTemplateImageryProvider({ url: '<XYZ 接入地址>' })
)

QGIS 等 GIS 桌面软件 #

• 使用 WMTS：在数据源管理中新建 WMTS 连接，填入程序生成的 WMTS 地址，连接后选择图层添加。
• 使用 XYZ：新建 XYZ Tiles 连接，填入 XYZ 地址模板。

多系统共用一套底图 #

发布出来的是标准服务，多套 GIS 系统、多个 Web 地图组件可以同时接入同一个发布地址，不需要各自保存一份数据。更新底图时，只需替换发布服务端的数据文件并重启对应服务，所有接入系统同步生效。

授权与设备 #

授权页显示套餐、到期日、可发布服务数、并发上限与对外发布权限。到期后先进入宽限期再转为只读，不会突然停机。专网服务器支持离线激活。需要升级时可在程序内选择标准版、企业版或永久版，扫码支付后自动激活；设备解绑在官网 用户中心 → 我的授权 中完成。

相关文档 #

• 星火地图发布服务常见问题
• 星火地图下载器操作指南