mesasadc/geoserver

docker-geoserver

一个简单的Docker容器，用于运行Geoserver，受此Docker recipe影响：https://github.com/eliotjordan/docker-geoserver/blob/master/Dockerfile

注意：我们建议使用apt-cacher-ng加速包获取 - 您应在提供的71-apt-cacher-ng文件中配置主机。

镜像概述和主要用途

本镜像提供了一种便捷的方式来部署和运行Geoserver，Geoserver是一个开源的地理空间数据服务器，用于发布、共享和管理地理空间数据。该镜像支持与PostGIS数据库集成，可通过Docker卷实现数据持久化，适用于快速搭建地理信息服务环境。

核心功能和特性

• 运行Geoserver服务，支持地理空间数据发布
• 可与PostGIS容器集成，实现空间数据存储
• 支持通过环境变量配置PostgreSQL用户凭据
• 提供数据持久化方案，通过Docker卷挂载主机目录
• 支持本地构建和官方镜像拉取两种获取方式

使用场景和适用范围

• 地理信息系统（GIS）开发和测试环境
• 快速部署地理空间数据服务
• 需要临时或持久化地理数据服务的场景
• 与PostGIS配合构建完整的空间数据解决方案

获取镜像

有多种方式可将镜像获取到您的系统：

推荐方式（初始镜像带宽消耗较大）

获取我们的Docker可信构建：

bash
docker pull kartoza/geoserver

不使用apt-cacher-ng构建（每次构建需重新获取deb包，带宽消耗较大）

bash
docker build -t kartoza/geoserver git://github.com/kartoza/docker-geoserver

使用apt-cacher-ng构建（最小化下载需求）

需先本地克隆仓库并修改71-apt-cacher-ng内容以匹配您的缓存主机，然后使用本地URL构建：

bash
git clone git://github.com/kartoza/docker-geoserver

编辑71-apt-cacher-ng后执行：

bash
docker build -t kartoza/geoserver .

使用方法和配置说明

基本运行

通常需要同时运行PostGIS。创建运行容器：

bash
sudo docker run --name "postgis" -d -t kartoza/postgis
sudo docker run --name "geoserver" --link postgis:postgis -p 8080:8080 -d -t kartoza/geoserver

环境变量配置

可通过以下环境变量为PostGIS传递用户名和密码：

• -e USERNAME=<PGUSER>：PostgreSQL超级用户名
• -e PASS=<PGPASSWORD>：PostgreSQL超级用户密码

这些将用于创建具有您偏好凭据的新超级用户。若未指定，PostgreSQL用户默认为'docker'，密码为'docker'。

仓库中提供的run.sh脚本可便捷地设置PostGIS和Geoserver容器。

注意：默认Geoserver用户为'admin'，密码为'geoserver'。强烈建议首次登录后立即修改这些凭据。

主机数据持久化

可使用Docker卷持久化数据：

bash
mkdir -p ~/geoserver_data
docker run -d -v $HOME/geoserver_data:/opt/geoserver/data_dir kartoza/geoserver

需确保geoserver_data目录具有足够权限，允许Docker进程读写。

credits

Tim Sutton (***)
2014年5月