waybarrios/geoserver

geoserver-docker

http://geoserver.org 是一个用于共享地理空间数据的开源服务器。本Docker镜像简化了GeoServer的部署流程，专门为https://github.com/GeoNode/geoserver-geonode-ext设计，并包含一个独立的数据目录。该镜像基于官方Tomcat 9镜像构建。

安装

该镜像可通过Docker Hub的https://registry.hub.docker.com/r/geonode/geoserver/获取，这是推荐的安装方式。直接从Docker Hub拉取镜像：

bash
$ docker pull docker.xuanyuan.run/geonode/geoserver

或者，你也可以在本地构建镜像：

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

快速启动

可通过命令行快速启动镜像：

bash
$ docker run --name "geoserver" -d -p 8080:8080 geonode/geonode

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

• 用户名：admin
• 密码：geoserver

如何使用不同版本

该镜像主要有两个版本，适用于运行GeoNode时使用不同的认证系统。这些版本以特定标签发布，对应两种认证机制：

• 基于Cookie的认证：https://hub.docker.com/r/geonode/geoserver/builds/
• 基于Oauth2的认证：https://hub.docker.com/r/geonode/geoserver/builds/

使用时需声明版本，并确保对应的数据目录标签与该版本一致。

配置

数据卷

此GeoServer容器的配置数据存储在 /geoserver_data/data，该路径在Dockerfile中已暴露为卷。通过卷可以停止并启动新容器时保留数据和自定义配置。

建议将此卷映射到主机目录，便于未来升级。可通过在docker run命令中添加-v标志挂载卷：

bash
-v /your/host/data/path:/geoserver_data/data

数据卷容器

如果使用Compose自动启动GeoServer，会挂载一个数据卷容器，其中包含预加载的默认GEOSERVER_DATA_DIR到容器的配置数据目录。确保https://github.com/GeoNode/data-docker仓库的镜像可从https://hub.docker.com/u/geonode/获取，或已在本地构建：

bash
docker build -t geonode/geoserver_data .

持久化行为

若运行：

bash
docker-compose stop

数据会保留在GEOSERVER_DATA_DIR中，再次运行以下命令时可挂载到新的GeoServer实例：

bash
docker-compose up

若运行：

bash
docker-compose down

数据会被完全清除，但可从为GeoNode构建的基础GeoServer数据目录重新开始。

数据目录版本

数据目录版本必须与Docker Compose文件中使用的GeoServer镜像标签一一对应。可用镜像如下：

• 2.9.x：https://hub.docker.com/r/geonode/geoserver_data/builds/
• 2.9.x-oauth2：https://hub.docker.com/r/geonode/geoserver_data/builds/

数据库

GeoServer推荐使用空间数据库。

PostGIS容器（PostgreSQL + GIS扩展）

若要使用PostGIS容器，可将其链接到此镜像。可使用任何PostGIS容器，以下是使用https://registry.hub.docker.com/u/kartoza/postgis/镜像的示例：

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

更多信息请参见https://registry.hub.docker.com/u/kartoza/postgis/。

启动GeoServer实例时，通过添加--link选项链接PostGIS容器：

bash
--link postgis:postgis