一、内网和公网的三处不同
公网项目里,底图是最不重要的一环:接一个在线地图服务,几百行代码就能显示。内网项目反过来, 底图往往是最先卡住的一环,因为它同时受三个约束。
第一是没有外网回源。任何依赖在线瓦片的方案在隔离网里直接失效,连降级到模糊底图都做不到。 第二是数据不出网,业务范围、管线走向、点位分布都属于敏感信息,不能为了生成底图把数据传到外部服务。 第三是没有专职 GIS 运维,系统上线后由业务方或集成商自己维护,出问题要能当天恢复,不能等厂商排期。
这三个约束决定了选型方向:底图必须能完整离线生成,运行时只依赖本地文件,故障恢复手段要简单到 「把目录拷回去重启服务」这种程度。
二、四种方案对比
内网底图常见的四种做法,前两种是把公网思路搬进内网,后两种是为离线环境设计的。
| 方案 | 供图方式 | 搭建成本 | 长期维护 | 主要问题 |
|---|---|---|---|---|
| 在线瓦片代理缓存 | 内网正向代理回源,磁盘做缓存 | 低 | 中 | 断网后没有新瓦片;授权与请求行为不可控 |
| GeoServer 等自建渲染 | PostGIS + WMS / WMTS 动态渲染 | 高 | 重 | JVM 内存与连接池要调,首屏慢,样式调试链路长 |
| 预切 XYZ + Nginx | 离线切好瓦片,静态文件直出 | 中 | 轻 | 范围与级别要提前规划,改范围需要补切 |
| MBTiles + 读取服务 | 单文件 SQLite,由轻量服务按请求读出 | 中 | 轻 | 随机读并发不如静态文件,需要额外进程 |
多数内网项目用第三种就够了:一次切图,之后只做静态文件服务,没有数据库、没有渲染进程, 重启和迁移的成本都很低。需要把底图拷给甲方或做长期归档时,再补一份 MBTiles 单文件。 只有在数据每天变化、业务要求实时出图的场景下,才值得为动态渲染付出运维代价。
代理缓存这条路线要特别小心。它看起来最省事,但缓存是否命中、抓了多少、什么时候被第三方限流, 都不在自己手里。一旦对方调整服务,内网大屏可能第二天就开不出来。
三、推荐的部署结构
把「生产」和「供图」分开,是内网底图最省心的结构。生产端可以联网,也可以是一台不接入业务网的切图机; 供图端只放静态文件,任何人不小心删了业务系统都不影响瓦片。
[切图机 / 准备机]
│ 选范围 · 配样式 · 切瓦片 · 导出
▼
/data/basemap/
└── tiles/
├── frost/{z}/{x}/{y}.png ← 浅色政务风
└── navy/{z}/{x}/{y}.png ← 深色大屏风
│
▼
[Nginx 静态服务 · 内网]
├── 指挥大屏
├── 业务系统(OpenLayers / Leaflet / MapLibre)
└── GIS 桌面端(按需)
两个主题共用同一份底图数据与切片范围,只切换目录前缀。目录约定建议在切图前就定好:tiles/{主题}/{z}/{x}/{y}.png。 主题放在最外层,前端切换主题时只改一个变量,不用动其他配置;级别和行列完全按标准 XYZ 排列, 任何支持 XYZ 的客户端都能直接读。
如果一台机器要供多个项目,按项目再套一层目录,例如 /data/basemap/project-a/tiles/..., Nginx 用不同的 location 或子域名暴露。不要把所有项目平铺在同一个 tiles 下, 否则同名主题会互相覆盖。
四、八条验收清单
上线前按下面八条逐项过一遍,能覆盖内网底图绝大多数事故场景。
- 物理断开外网后,清空浏览器缓存刷新首屏,地图正常出图。
- 最低级别、业务目标级别、最高级别三档都抽查过,没有整屏空白。
- 把视口拖到业务范围边缘,外扩一圈仍有瓦片,不会出现大量 404。
- 瓦片响应头包含
Cache-Control与Access-Control-Allow-Origin。 - 两台终端同时拖动缩放,大屏切换场景下没有明显卡顿。
- 换主题只切换目录前缀,底图数据不需要重新切。
- 整目录拷贝到另一台机器并指向新的 Nginx,服务能直接恢复。
- 数据来源、授权范围和署名方式有记录,不用于对外公开发布。
五、三个常见坑
把动态渲染直接放进内网
GeoServer 在演示环境里表现正常,一上大屏就开始卡。原因通常是内存给少了、连接池太小, 再加上首屏需要实时渲染,几十个请求排队后超时。内网服务器往往配置不高,这类问题会更明显。
瓦片目录和前端地址对不上
Nginx 的 root 和 location 组合多一层或少一层,是最常见的整屏空白原因。 排查时不要猜,直接在浏览器里打开一张完整瓦片地址,看返回 200 还是 404,再决定改哪一边。
只按中心点算范围
按业务中心点推算范围,看起来刚好覆盖,实际拖动到边缘就出界。正确做法是按业务图形的最小外接矩形, 再向外留一到两级瓦片的余量,成本增加很少,体验差别很大。
六、交付与授权边界
内网底图一般用于内部自用、内部演示和业务系统。对外公开发布的地图涉及测绘资质、审图号和国界省界画法, 需要由使用方自行取得资质并承担责任,工具本身不解决这个问题。
数据方面,客户应提供自有或已获授权的数据,工具只负责加工和部署。使用 OSM 数据时要保留 © OpenStreetMap contributors 署名(ODbL);行政边界数据仅作示意,不能作为法定界线依据。 软件授权与机器码绑定、离线校验,换机器用迁移码,整个过程不需要联网激活,符合隔离网要求。
七、常见问题
Q1 内网完全断网能部署吗?
可以。切图、调样式、打包都在有外网的准备机或内网自己的切图机上完成,产物是静态瓦片目录或 MBTiles 单文件。拷进隔离网后只需要 Nginx 或任意静态文件服务,运行阶段不访问任何外部地址。
Q2 需要几台服务器?
一般一台内网服务器就够。瓦片是静态文件,压力主要来自磁盘读和网卡带宽,不是 CPU;只有多套主题、多个项目并行时才需要按目录分盘或加一台缓存节点。
Q3 数据敏感,不能上传到第三方怎么办?
用本地运行的工具,数据处理、切片和打包都在自己的机器上完成,不上传任何范围或属性数据。交付物只包含瓦片和配置,换机器时用工程包整体迁移。
如果还没有切图经验,建议先看离线地图怎么做, 那里有完整流程和 Nginx 配置;确定要给甲方交付单文件还是目录,可以看 MBTiles 和 XYZ 的区别。想先确认效果, 在线预览里两套主题都是按这个结构真实切出来的。