baasgeo/geoserver

GeoServer Docker镜像文档

镜像概述和主要用途

GeoServer是一个开源的地理空间数据服务器，用于共享地理空间数据。本Docker镜像基于官方https://hub.docker.com/_/tomcat%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%97%A8%E5%9C%A8%E7%AE%80%E5%8C%96%E7%BB%84%E7%BB%87%E6%90%AD%E5%BB%BA%E5%92%8C%E9%83%A8%E7%BD%B2GeoServer%E6%9C%8D%E5%8A%A1%E7%9A%84%E8%BF%87%E7%A8%8B%E3%80%82

核心功能和特性

• 基于官方Tomcat 9镜像，确保稳定性和兼容性
• 支持数据卷持久化，保护配置和数据不丢失
• 可通过环境变量选择所需插件，灵活定制功能
• 支持资源约束配置，控制CPU和内存使用
• 可与空间数据库（如PostGIS）容器链接，满足数据存储需求

安装

从Docker Hub拉取镜像

bash
$ docker pull baasgeo/geoserver:tagname

本地构建镜像

bash
$ git clone https://github.com/baasgeo/docker-geoserver.git
$ cd geoserver-docker
$ docker build -t "baasgeo/geoserver:tagname" .

快速启动

创建主机数据文件夹

bash
$ sudo mkdir /var/geoserver/

运行容器

bash
$ docker run \
    --name=geoserver \
    --publish=8080:8082 \
    --volume /var/geoserver:/opt/geoserver \
    --memory 4G \
    baasgeo/geoserver:2.18

访问和登录

在浏览器中访问 http://localhost:8080/geoserver，使用GeoServer默认用户名和密码登录：

• 用户名：admin
• 密码：geoserver

版本使用方法

该镜像的主要版本标签对应GeoServer的每个次要版本：

• 2.16.x -> baasgeo/geoserver:2.16
• 2.17.x -> baasgeo/geoserver:2.17
• 2.18.x -> baasgeo/geoserver:2.18
• 2.19.x -> baasgeo/geoserver:2.19

更新镜像时，重新拉取对应标签并重启容器：

bash
$ docker pull baasgeo/geoserver:tagname
$ docker restart geoserver

配置说明

数据卷

容器的配置数据存储在 /opt/geoserver，已作为卷暴露。通过 -v 或 --volume 参数将其映射到主机目录，实现数据持久化和升级便利：

bash
--volume /var/geoserver:/opt/geoserver

GeoWebcache卷

GeoWebCache缓存瓦片存储在 /opt/geowebcache，同样作为卷暴露。映射到主机目录：

bash
--volume /var/geowebcache:/opt/geowebcache

插件

镜像包含多种插件，可通过环境变量 PLUGINS 选择，值为插件名称的逗号分隔列表。支持的插件包括：

• authkey：密钥认证安全
• css：CSS样式制图
• csw：Web目录服务（CSW）
• dxf：绘图交换格式（DXF）输出
• excel：Excel输出
• geopkg：GeoPackage输出格式
• importer：导入器核心
• metadata：图层元数据
• ogcapi：OGC API
• pyramid：图像金字塔覆盖格式
• sec-keycloak：Keycloak认证
• wps：Web处理服务（WPS）

示例：选择authkey、dxf和excel插件

bash
--env PLUGINS=authkey,dxf,excel

资源约束

默认情况下，容器无资源限制。可通过 docker run 的运行时参数控制CPU和内存使用，具体参考 Docker资源约束文档。

容器使用Java -XX:+UseContainerSupport 标志，最大堆内存大小按初始RAM百分比（InitialRAMPercentage = 50%）计算。

数据库

GeoServer推荐使用空间数据库，以下是PostGIS容器（PostgreSQL + GIS扩展）的使用示例。

启动PostGIS容器

使用官方https://hub.docker.com/r/postgis/postgis%E9%95%9C%E5%83%8F%EF%BC%9A

bash
$ docker run -d --name="postgis" postgis/postgis

更多信息参见 https://hub.docker.com/r/postgis/postgis%E3%80%82

链接GeoServer与PostGIS容器

启动GeoServer时添加 --link 选项：

bash
--link postgis:postgis