Docker是GIS地图服务发布的首选方式,因其将GeoServer运行环境打包成镜像,实现“一次构建,随处运行”,5分钟即可完成部署且不污染宿主机。

为什么Docker是GIS地图服务发布的首选方式
传统GIS服务器部署常卡在环境配置上:装JDK、配Tomcat、解压WAR包、调依赖版本……光是GeoServer启动前的准备就可能耗掉半天。而Docker把整个运行环境(含Java、Servlet容器、GeoServer核心及常用插件)打包成镜像,真正实现“一次构建,随处运行”。实测表明,用kartoza/geoserver或docker.osgeo.org/geoserver镜像,5分钟内即可获得可访问的Web管理界面,且不污染宿主机环境。
它特别适合三类场景:
- 教学演示——避免学生花时间在环境搭建上,专注空间数据发布逻辑
- 项目原型验证——快速加载TIF、Shapefile或PostGIS数据,测试服务可用性
- 多版本并行测试——比如同时运行2.23和2.28两个GeoServer容器,互不干扰
5分钟完成GeoServer容器部署
无需编译、不用手动下载,只需终端执行以下步骤:
- 创建项目目录并进入:
mkdir geoserver && cd geoserver - 新建
docker-compose.yml,内容如下(使用稳定版2.28.x):
services:
geoserver:
image: docker.osgeo.org/geoserver:2.28.x
container_name: gs-prod
ports:
- "8080:8080"
volumes:
- ./data:/opt/geoserver_data
- ./mydata:/mnt/data
environment:
- CORS_ENABLED=true
restart: unless-stopped
- 执行启动命令:
docker compose up -d - 等待约20秒,浏览器打开
http://localhost:8080/geoserver,默认账号密码为admin/geoserver
发布TIF或Shapefile地图服务的关键操作
容器跑起来只是第一步,发布真实数据才体现价值。GeoServer层级结构清晰:工作空间 → 数据存储 → 图层。以发布一个TIF影像为例:
- 先创建工作空间(如命名为
satellite),命名空间URI可填http://example.com/satellite - 在该工作空间下添加“GeoTIFF”类型的数据存储,路径指向
/mnt/data/landsat8.tif(即挂载进容器的宿主机文件) - 发布图层后,在“Publishing”选项卡中确认坐标参考系(CRS),常见如
EPSG:4326或EPSG:3857;若TIF无内嵌投影,需手动指定 - 启用WMS服务,在“WMS Settings”里勾选
Enabled,保存后即可通过URL访问:http://localhost:8080/geoserver/satellite/wms?service=WMS&version=1.1.0&request=GetMap&layers=satellite:landsat8&styles=&bbox=...&width=512&height=512&srs=EPSG:4326&format=image/png
对接PostGIS与中文支持避坑要点
生产环境中,矢量数据多存于PostGIS。Docker部署时需注意两点:
-
PostGIS容器联动:在
docker-compose.yml中增加PostGIS服务,并用networks打通容器网络;GeoServer添加数据存储时,数据库主机名填服务名(如postgis),而非localhost -
中文字体乱码:CAD图纸或中文标注图层常显示方块。解决方法是在宿主机准备
.ttf字体(如simhei.ttf),挂载到容器/usr/share/fonts/truetype/custom/,再执行:docker exec gs-prod fc-cache -fv
另外,首次登录务必修改默认密码,建议在environment中设置GEOSERVER_ADMIN_PASSWORD变量,避免使用admin/geoserver裸奔上线。


















