meteofi/geoserver

GeoServer Docker镜像文档

镜像概述和主要用途

GeoServer是一个用于共享地理空间数据的开源服务器，实现了多项OGC（开放地理空间信息联盟）标准，包括Web要素服务（WFS）、Web地图服务（WMS）和Web覆盖服务（WCS）。此外，还支持Web地图瓦片服务（WMTS）及目录服务（CSW）、Web处理服务（WPS）等扩展功能，主要用于地理空间数据的发布、共享与管理。

核心功能和特性

• 基础构建：基于官方Tomcat 9 Docker镜像构建，确保稳定运行环境
• 丰富插件：内置CSS Styling、GRIB、MongoDB、NetCDF、Vector Tiling、WPS及YSLD Styling等插件
• 扩展字体：包含Noto、Open Sans、Roboto、Ubuntu和Lato等字体，优化地图标注显示效果
• 生产就绪：遵循GeoServer官方生产环境配置建议（http://docs.geoserver.org/stable/en/user/production/%EF%BC%89
• 健康检查：内置Docker健康检查机制，监控服务运行状态
• CORS支持：默认启用跨域资源共享（CORS），便于前端应用集成
• 灵活部署：支持以任意用户身份运行，适用于OpenShift等容器平台
• SSL集成：支持Let's Encrypt证书配置，实现HTTPS安全访问

使用场景和适用范围

• 地理空间数据发布：将 shp、GeoTIFF、PostGIS 等格式的地理数据发布为标准化Web服务
• Web地图服务提供：为Web应用、移动端应用提供WMS/WMTS瓦片服务
• 企业级GIS集成：作为中间件集成到企业地理信息系统（GIS），实现数据共享与协作
• 科研与教育：用于地理数据教学演示、科研项目中的数据可视化与共享

支持的标签

使用方法和配置说明

安装镜像

拉取官方镜像

bash
docker pull docker.xuanyuan.run/meteofi/geoserver

手动构建镜像

bash
git clone https://github.com/meteofi/docker-geoserver.git
cd docker-geoserver
docker build --rm -t meteofi/geoserver 2.19  # 2.19为目标版本目录，可替换为其他版本

快速启动

bash
docker run -d --name geoserver -p 8080:8080 docker.xuanyuan.run/meteofi/geoserver

• 访问管理界面：http://localhost:8080/geoserver/web/
• 管理员凭据：首次运行时，默认凭据可通过容器日志获取（执行docker logs geoserver查看），或通过GEOSERVER_ADMIN_PASSWORD环境变量自定义设置。

自定义数据目录

为实现数据持久化，建议将GeoServer数据目录挂载到宿主机或卷：

bash
# 创建数据卷
docker volume create geoserver-storage

# 挂载数据卷启动容器
docker run -d --name geoserver -p 8080:8080 \
  -v geoserver-storage:/data/geoserver \
  docker.xuanyuan.run/meteofi/geoserver

环境变量配置

Docker Compose配置示例

创建docker-compose.yml文件，配置持久化存储和自定义端口：

yaml
version: '3.8'

services:
  geoserver:
    image: docker.xuanyuan.run/meteofi/geoserver:latest
    container_name: geoserver
    restart: always
    ports:
      - "8081:8080"  # 宿主机端口:容器端口
    environment:
      - GEOSERVER_ADMIN_PASSWORD=your_secure_password  # 自定义管理员密码
    volumes:
      - geoserver-data:/data/geoserver  # 数据卷挂载
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/geoserver/web/"]
      interval: 30s
      timeout: 10s
      retries: 3

volumes:
  geoserver-data:  # 定义持久化数据卷

启动服务：

bash
docker-compose up -d

注意事项

• 数据备份：定期备份挂载的/data/geoserver目录，防止数据丢失
• 安全加固：生产环境中务必通过GEOSERVER_ADMIN_PASSWORD设置强密码，并启用HTTPS
• 资源配置：根据数据量和访问量调整容器CPU/内存资源（通过--cpus、-m参数）
• 版本升级：升级镜像前，建议先备份数据目录，并查阅对应版本的变更日志