常见问题
星火地图发布服务常见问题：专网离线部署、免费版限制、数据合规与接入
要点速览
星火地图发布服务可以完全部署在专网 / 内网中，接入端在同一网络访问，全程不需要外网，授权可离线激活。社区免费版登录即用，仅本机（127.0.0.1）发布、1 个服务、50 并发、非商用；对外发布需要授权版。工具不预置任何地图数据，发布的数据须为自有或已获授权的数据。
这篇汇总了星火地图发布服务（桌面程序「星火地图发布」）在选型、部署和接入中最常见的问题，适合项目负责人、GIS 工程师和运维人员。每个问题的第一句话就是结论。操作步骤请参考 快速入门 与 发布与接入操作指南。
部署与环境 #
没有外网的专网环境能用星火地图发布服务吗？ #
可以，这正是它的设计目标场景。发布服务部署在内网 / 专网服务器上，接入端在同一网络环境中访问，全程不需要连接外网。
授权可以通过离线激活完成，不要求专网服务器能访问官网。地图数据需要事先拷贝到服务器上。
专网服务器怎么离线激活？ #
在专网服务器上的程序中生成挑战码，到能上网的电脑上登录官网，在用户中心的离线激活页面（/user/offline-activate）签发授权文件，再把授权文件拷回服务器导入即可。
签发出的授权文件绑定生成挑战码的那台服务器。建议在导入授权文件之前，不要在服务器上重新生成挑战码，以免挑战码与授权文件对不上。
星火地图发布服务支持哪些操作系统？ #
正式提供 Windows 10 / 11（x64）安装包。Linux 等其他平台有项目需求时，可以通过 联系我们 咨询。
发布服务对服务器有什么要求？ #
按数据量和访问量评估即可，关键是存储空间和磁盘读取速度：存储要能放下全部瓦片数据，并发访问量大时，数据放在固态硬盘上响应更快。
服务器需要长期开机、网络稳定，并在防火墙中放行发布端口。
授权与版本 #
社区免费版有什么限制？ #
社区免费版登录即用、免费：仅本机（127.0.0.1）发布、1 个服务、50 并发连接、个人 / 非商用，适合本地验证。
需要对外发布、更多服务与并发、商用授权时，可以升级标准版（5 个服务、500 并发）、企业版（服务数不限、5000 并发）或买断永久版，也可以先申请 14 天试用。
为什么局域网里的其他电脑访问不到我发布的服务？ #
最常见的原因是使用社区免费版：免费版只允许绑定本机地址 127.0.0.1，其他电脑无法访问。
使用授权版时，请检查监听地址是否为服务器的局域网 IP，并确认服务器防火墙已放行发布端口。
星火地图发布服务怎么登录激活？换服务器怎么办？ #
使用官网会员账号登录，一键激活本单位授权；领取或购买前，账号需要先在「用户中心 → 我的单位」创建或加入一个单位。
更换服务器时，先在旧服务器上解绑，或到官网 用户中心 → 我的授权 中解绑旧设备，再在新服务器上激活。在线授权会定期联网心跳续期，长时间离线后需要联网；专网服务器建议直接使用离线激活。
数据与协议 #
能发布哪些格式的瓦片数据？ #
支持 SQLite / MBTiles 单文件和传统文件瓦片目录（PNG / JPG）两种存储形式。
星火地图下载器 的下载成果可以直接发布；测绘单位交付的自有航空 / 卫星影像，切成上述格式的瓦片后同样可以发布。
发布成哪些协议？主流地图组件能直接接入吗？ #
发布为 WMTS、TMS、XYZ 三种标准协议，Leaflet、OpenLayers、Cesium 以及主流 GIS 桌面软件都可以直接接入。
Web 地图组件通常使用 XYZ 地址，GIS 桌面软件和政务平台对接通常使用 WMTS 地址。接入示例见 操作指南。
多套系统能共用一个地图服务吗？ #
可以。发布出来的是标准服务，多套 GIS 系统、多个 Web 地图组件可以同时接入同一个发布地址，不需要各自维护一份数据。
需要注意并发连接上限按套餐计算，接入系统较多时请选择并发更高的套餐。
发布第三方地图瓦片合规吗？ #
星火地图发布服务不预置任何地图数据，发布哪些数据、是否具备相应授权，需要使用单位自行确认，并遵守对应数据源的服务条款。
从第三方地图服务下载的瓦片，再通过发布服务提供给其他系统，属于对数据的再分发，多数商业地图服务的条款对此有限制，商业使用需要取得数据源授权。产品的核心定位是让自有或已获授权的瓦片在内网环境中发布得起来、用得顺手。在中国境内公开提供地图服务，还需遵守测绘与地图管理相关法规。
接入问题 #
客户端加载后地图一片空白怎么办？ #
先确认地图的中心位置和缩放级别落在数据的覆盖范围和层级内；数据只下载到 16 级时，放大到 18 级就会显示空白。
然后在浏览器中直接打开一张瓦片的地址，确认服务能返回图片；返回失败时，检查服务是否在运行、地址和端口是否正确、防火墙是否放行。
地图瓦片上下错乱或位置不对是什么原因？ #
最常见的原因是把 TMS 地址当作 XYZ 使用（或反过来），两者的行号方向相反。
在 Leaflet 中使用 TMS 地址时需要设置 tms: true，或者直接改用 XYZ 地址。另外，GCJ-02 坐标的瓦片（如高德）与 WGS84 业务数据叠加会有数十到数百米偏移，属于坐标系差异，需要在项目中统一坐标系。