docker-geoserver 镜像文档

镜像概述与主要用途

基于 Docker *** Tomcat 镜像构建的 GeoServer 容器化部署方案，旨在提供便捷、可配置的 GeoServer 服务部署方式。主要用途是在容器环境中快速部署 GeoServer，支持自定义数据存储、扩展管理、权限控制等功能，适用于地理空间数据发布与管理场景。

受严重安全漏洞影响的旧版 GeoServer 已从本仓库移除，以避免潜在风险。请尽可能升级至最新版本，或至少使用以下安全版本：

若使用低于 2.23.x 的版本且无法升级，需自行 patch 并构建镜像（本仓库不提供支持或已 patch 的构建版本）。详情参考 CVE-2024-36401 ***公告。
2.23.x 系列：至少使用 2.23.6
2.24.x 系列：至少使用 2.24.5
2.25.x 系列：至少使用 2.25.2
2.26.0 及以上版本：不受此漏洞影响

若关注安全性并希望保持 GeoServer 良好运行状态，建议支持 3.0 版本的开发。

以下版本提供自动化构建，可从 Docker Hub 获取：

以下为实验性 Dockerfile（非自动化构建），更适合作为参考示例而非生产环境使用：

oracle：基于 wnameless/oracle-xe-11g，需手动提供 ojdbc7.jar 并配置数据库（参考 setup.sql），运行命令见 run.sh。
h2-vector：与 oscarfonts/h2:geodb 兼容，包含 docker-compose 和 systemd 示例脚本。
已弃用 ecw：为旧版 GeoServer 添加带 ECW 支持的 GDAL 插件，已停止分发，需升级至新版本。

bash
docker pull oscarfonts/geoserver

作为服务运行，暴露 8080 端口并挂载本地数据目录：

bash
docker run -d -p 8080:8080 -v ${PWD}/data_dir:/var/local/geoserver oscarfonts/geoserver

构建镜像时，通过 GEOSERVER_PATH 参数修改 GeoServer 基础访问路径，默认值为 /geoserver。

通过环境变量 CUSTOM_UID 和 CUSTOM_GID 自定义 tomcat 用户的 UID 和 GID，确保挂载的 data_dir 和 exts_dir 可被容器内外用户共同访问：

bash
docker run -d -p 8080:8080 -e CUSTOM_UID=$(id -u) -e CUSTOM_GID=$(id -g) oscarfonts/geoserver

如需添加扩展，提供包含未解压扩展包的目录（每个扩展一个子目录），挂载至 /var/local/geoserver-exts/：

bash
docker run -d -p 8080:8080 -v ${PWD}/exts_dir:/var/local/geoserver-exts/ oscarfonts/geoserver

可使用 build_exts_dir.sh 脚本配合 extensions 配置文件快速创建扩展目录。

警告：扩展目录中的 .jar 文件将被复制到 GeoServer 的 WEB-INF/lib 目录，仅添加来自可信来源的文件以避免安全风险。

通过挂载 Catalina 配置目录自定义上下文路径：

bash
docker run -d -p 8080:8080 -v ${PWD}/config_dir:/usr/local/tomcat/conf/Catalina/localhost oscarfonts/geoserver

默认已启用 CORS 并配置于 servlet 的 web.xml 过滤器中。若前端已处理跨域，可通过环境变量禁用：

bash
docker run -d -p 8080:8080 -e "GEOSERVER_CORS_ENABLED=false" oscarfonts/geoserver

可通过以下环境变量微调 CORS 策略（参考 Tomcat 文档）：

适用场景：需容器化部署 GeoServer 的开发、测试及生产环境；需要自定义数据存储、扩展插件或权限管理的场景；对跨域访问、JVM 性能有要求的地理空间服务部署。
版本选择：生产环境建议使用“可信构建版本”中的安全版本（2.23.6+、2.24.5+、2.25.2+、2.26.0+）；实验性版本（如 oracle、h2-vector）仅用于功能验证或学***参考，非生产就绪。