1. 为什么你需要一个内网离线地图服务如果你在政府单位、大型国企、涉密科研机构或者偏远地区的项目现场工作过大概率遇到过这样的场景项目会议开到一半需要调取一张高精度的卫星影像图来分析现场情况结果发现网络断了或者网速慢得像蜗牛加载一张图要等好几分钟。又或者你负责的某个系统需要频繁调用在线地图服务但每年高昂的API调用费用和流量费用让项目预算捉襟见肘。更让人头疼的是一些核心的地理信息数据出于安全和保密的考虑根本不允许上传到公网。这些问题我过去十年在多个智慧城市和大型基建项目中都遇到过。每次遇到项目进度就会卡壳团队效率大打折扣。后来我们找到了一个比较彻底的解决方案在内网搭建一套完全离线的地图服务。这就像是在你自己的办公室里建了一个私有的“谷歌地球”或“百度地图”数据完全掌握在自己手里访问速度飞快而且不受任何外网环境影响。《水经注地图服务》WeServer就是专门为这个场景而生的工具。它不是什么花哨的新概念而是一个经过大量实际项目验证的“实干派”。它的核心目标非常明确让你能轻松地把动辄几十TB、甚至上百TB的卫星影像、电子地图、高程模型等地理数据打包成一个标准的地图服务发布在你自己的服务器上。从此你的OA系统、指挥调度平台、三维可视化大屏都可以像调用在线服务一样高速、稳定地调用这些内网地图资源。我最初接触它时也怀疑过自己搭建地图服务是不是特别复杂需要专业的GIS团队才能搞定实际用下来发现它的设计思路非常“接地气”把很多复杂的GIS服务器配置流程都封装好了提供了Windows和Linux两个版本安装过程跟装一个普通软件差不多。对于大多数IT运维人员或者后端开发来说上手门槛比想象中低很多。接下来我就结合自己多次部署的经验带你从零开始快速搞定《水经注地图服务》的内网搭建。2. 部署前的准备工作选对版本和备好“粮草”打仗前要粮草先行部署服务前也得把准备工作做扎实。这一步没做好后面可能会踩不少坑。首先最关键的是选择适合你的版本。《水经注地图服务》主要提供Windows版和Linux版。怎么选我的经验是如果你追求快速验证、个人学习或者小团队内部使用Windows版是首选如果你的应用场景是正式的生产环境要求高稳定性、7x24小时不间断运行那么Linux版是不二之选。Windows版的优势在于图形化界面友好安装配置就像“下一步下一步”那么简单特别适合GIS背景不强、但对Windows服务器操作熟悉的同事。你甚至可以在自己的Windows笔记本上先装一个试试水。而Linux版则继承了Linux系统固有的稳定性、安全性和资源占用低的优点更适合部署在CentOS、Ubuntu等服务器操作系统上作为基础服务长期运行。确定好版本后就是下载了。官方渠道很清晰一是访问水经注的官方网站www.rivermap.cn在下载中心找到对应的版本二是关注他们的微信公众号“水经注GIS”后台回复“WeServer”也能获取下载链接。我通常两个渠道都会看一眼官网的版本可能更新一些。下载下来的Windows版通常是一个名为weserver.rar的压缩包Linux版则是一个.tar.gz的压缩包。除了软件本身你还需要准备好“数据粮草”。WeServer本身是一个地图发布引擎它需要你提供原始的地图数据。这些数据可以是你自己采购的商业卫星影像比如高分系列、WorldView等也可以是水经注软件下载的全球公开影像或者是通过其他渠道获取的GIS数据。在部署前你需要把这些TIFF、IMG等格式的栅格数据文件整理好放在服务器的某个目录下。我建议单独规划一块大容量的硬盘或存储分区来存放这些数据因为地图数据体积非常庞大。同时确保你的服务器硬件配置跟得上尤其是内存和CPU处理百GB级的数据时足够的资源是流畅体验的保障。3. Windows版部署详解十分钟搭建你的第一个地图服务咱们先从最简单的Windows版开始让你快速看到效果建立信心。整个安装过程非常直观我把它拆解成几个关键步骤你跟着做就行。首先把下载好的weserver.rar文件解压。你会看到一个安装程序双击它启动安装向导。第一个界面通常是欢迎和许可协议直接点“下一步”就行。接下来会进入一个关键的配置页面监听端口设置。这里有两个端口需要你配置一个是地图服务端口另一个是服务管理系统端口。地图服务端口默认是8080是将来你的其他应用程序比如WebGIS页面、业务系统用来请求地图瓦片的端口。管理系统端口默认是8090则是你通过浏览器访问用来管理、发布、监控地图服务的后台入口。这里有个实操建议如果8080或8090端口已经被你服务器上的其他程序比如Tomcat、Jenkins占用了你一定要在这里改成其他未被占用的端口比如8088和8099。我吃过亏安装时没注意直接用了默认端口结果启动失败排查了半天才发现是端口冲突。改完后一路点击“下一步”建议勾选“创建桌面快捷方式”这样以后管理起来方便。安装程序很快通常一两分钟就完成了。安装结束后安装向导会提示你是否立即启动WeServer服务并打开管理系统。我强烈建议你勾选上然后点击“完成”。这时你的系统托盘电脑右下角会出现一个WeServer的小图标说明地图服务引擎已经在后台运行了。同时浏览器会自动打开一个地址比如http://localhost:8090这就是WeServer的管理系统登录界面。第一次登录默认的用户名和密码通常是admin。成功登录后你就进入了WeServer的“驾驶舱”。界面左侧是功能菜单核心功能就是“地图发布”。点击“新建服务”给你的服务起个名字比如“北京市卫星图”。然后最关键的一步来了选择数据源。你需要点击“添加数据”找到你事先准备好的那个存放TIFF影像文件的文件夹。WeServer支持直接读取文件夹下的所有影像文件并自动进行拼接和金字塔构建。添加完数据点击“发布”。系统会开始处理你的数据这个过程叫做“创建瓦片金字塔”它会根据你设定的层级比如从第1级到第18级将原始的大影像切割成无数个小图片瓦片。处理时间取决于你原始数据的大小和电脑性能。处理完成后这个地图服务就处于“已发布”状态了。此时你可以在浏览器里访问一个类似http://localhost:8080/服务名/地图类型/z/x/y.png的URL就能看到一张张地图瓦片了。你也可以在管理系统的“预览”功能里直接看到一个交互式的地图窗口缩放平移跟你用百度地图一样流畅。至此一个最基本的内网离线地图服务就搭建成功了4. Linux版部署与优化打造企业级稳定服务Windows版适合入门和测试但真要用于7x24小时不间断的生产环境Linux版才是王道。它的部署过程稍微偏向命令行但稳定性极高。我以最常见的CentOS 7.x系统为例带你走一遍流程。首先通过SSH工具连接到你的Linux服务器。将下载好的Linux版安装包如weserver_linux_x64.tar.gz上传到服务器假设放到/opt目录下。然后打开终端执行解压命令cd /opt tar -zxvf weserver_linux_x64.tar.gz解压后会生成一个目录比如weserver。进入该目录你会看到几个关键文件一个可执行程序weserver和一个配置文件config.ini。在启动服务之前我们必须先编辑配置文件这是Linux部署的核心步骤。用vi或nano编辑器打开config.ini文件vi config.ini你会看到类似下面的配置段[server] port 8080 admin_port 8090 data_dir /data/weserver_dataport地图服务端口含义同Windows版。admin_port管理系统端口。data_dir这是极其重要的一个配置它指定了WeServer工作数据的存放目录包括发布的地图服务配置、缓存文件等。务必将它修改为一个空间充足、且你拥有读写权限的路径比如/home/gisdata/weserver。不要使用默认的或临时路径。配置保存后就可以启动服务了。在weserver目录下执行./weserver start如果看到“start successfully”之类的提示说明服务启动成功。此时你就可以在局域网内的其他电脑上通过浏览器访问http://你的服务器IP:8090来登录管理系统了。后续发布地图数据的操作和Windows版在网页后台的操作完全一样。为了让服务更稳定我们还需要做两件事设置开机自启动和进程守护。对于开机自启你可以将启动命令添加到/etc/rc.local文件中确保该文件有执行权限。更专业的方式是编写一个systemd服务单元文件这样可以用systemctl命令来优雅地管理服务的启动、停止和状态查看。关于进程守护我推荐使用supervisor这类工具。它可以监控WeServer进程如果进程意外崩溃supervisor会自动将其重启最大程度保障服务可用性。这些步骤稍微进阶一些但对于生产环境来说是必不可少的保障。5. 内网应用实战让你的业务系统用上离线地图服务搭好了数据也发布上去了这就像建好了一个仓库。接下来关键是怎么让我们的“货车”也就是各个业务系统来这个仓库里取货地图瓦片。这里我分享几个最常用的集成方式。第一种也是最通用的方式标准WMTS/WMS服务调用。WeServer发布的地图服务完全遵循OGC开放地理空间信息联盟标准。这意味着任何支持WMTS或WGS标准的GIS客户端或开发库都能直接调用。例如在OpenLayers、Leaflet、Cesium等前端地图库中你只需要添加一个WMTS图层源将URL指向你的WeServer服务地址如http://内网IP:8080/服务名/wmts并配置好图层名称、坐标系、瓦片矩阵集等参数就能无缝加载离线地图了。对于ArcGIS、QGIS等桌面软件也可以通过添加WMS/WMTS服务器的方式将你的离线地图作为底图使用。第二种API直接调用。如果你做的是自定义开发可以直接拼接瓦片URL来获取图片。URL格式通常是固定的http://服务器地址:端口/服务名/地图类型/缩放级别/瓦片列号/瓦片行号.图片格式。比如http://192.168.1.100:8080/beijing/img/15/12345/67890.png就是获取北京服务影像图第15级、第12345列、第67890行的一张PNG瓦片。这种方式最灵活你可以用任何编程语言Python、Java、C#等发起HTTP请求获取瓦片然后在自己的应用中渲染。第三种与现有平台集成。很多单位已经有成熟的GIS平台或可视化平台。你可以将WeServer发布的服务作为其中一个“数据源”或“图层”注册到这些平台中。例如在GeoServer中你可以通过“WMTS数据存储”的方式添加WeServer在一些商业的BI工具或大屏软件中也通常支持通过URL添加自定义地图图层。在实际项目中我通常采用“混合模式”核心的、保密要求高的卫星影像和矢量数据用内网WeServer提供一些辅助性的、公开的注记或POI信息可以酌情引用在线的开放地图服务作为补充。这样既保证了安全和速度又丰富了地图内容。集成过程中唯一需要注意的就是网络连通性确保你的应用服务器能够访问到WeServer所在服务器的指定端口8080和8090必要时需要在防火墙中放行这些端口。6. 性能调优与常见问题排查服务跑起来只是第一步让它跑得又快又稳才是终极目标。根据数据量和服务并发请求量的不同你可能需要进行一些调优。首先是数据预处理。WeServer在发布数据时会创建金字塔这个过程本身比较耗时。对于超大型数据集比如超过1TB我建议不要在管理网页上直接点击发布就干等。更好的做法是先在数据准备阶段利用水经注的另一个产品“水经注微图”或者GDAL等工具对原始TIFF文件进行预处理提前构建好内部金字塔Overview并做好压缩如LZW压缩这能极大缩短WeServer服务端的首次发布和处理时间。其次是硬件与配置优化。地图服务的性能瓶颈通常出现在磁盘I/O和网络I/O。因此将数据存放在SSD硬盘上能显著提升瓦片读取速度尤其是应对高并发请求时。config.ini文件中可能还有一些高级参数比如缓存大小cache_size、工作线程数等。如果你的服务器内存充足可以适当增大缓存让热点瓦片常驻内存。线程数可以根据CPU核心数进行调整。这些参数没有固定值需要你根据实际监控情况慢慢调整。然后是架构层面。当单台服务器压力过大时就要考虑分布式部署。一种简单的思路是读写分离一台主服务器专门用于发布和管理服务写操作多台从服务器通过同步机制承载地图瓦片的分发读操作。你可以在从服务器上也安装WeServer然后通过定期同步主服务器data_dir目录下特定服务文件夹的方式来实现数据的复制。更复杂的架构可以结合Nginx做负载均衡和反向代理将地图请求分发到多个WeServer实例上。最后说说我踩过的坑和常见问题。服务启动失败端口被占用这是最常见的问题。用netstat -tlnp | grep 端口号Linux或netstat -ano | findstr 端口号Windows命令检查端口占用情况修改config.ini或安装时的配置换一个空闲端口。发布数据时卡住或报内存不足处理超大影像时需要足够的内存。尝试分块发布不要一次性发布整个省份的数据可以按市、县分批发布。同时检查服务器虚拟内存设置是否足够。客户端访问地图一片空白首先在WeServer管理系统的“预览”里看是否正常。如果预览正常但客户端不行99%的问题是跨域或URL拼接错误。确保你的客户端请求的URL层级、参数完全正确。对于Web前端如果WeServer没有设置跨域头你需要在客户端代码中处理或者通过Nginx代理解决跨域问题。Linux版服务运行一段时间后自动停止检查系统日志/var/log/messages或journalctl -u 你的服务名看是否有错误信息。很可能是进程被系统OOM内存溢出杀掉了。这就需要回到上一步优化数据发布策略或增加服务器内存。部署和优化是一个持续的过程。我的经验是先让服务简单跑通然后随着数据量和用户量的增长逐步进行优化。每次改动配置前做好备份记录下改动点这样出了问题也能快速回滚。内网离线地图服务一旦稳定运行它带来的效率提升和成本节约是非常可观的前期投入的这点部署和调优时间绝对值得。