cityseer/postgis

cityseer/postgis Docker镜像文档

镜像概述

该Docker镜像基于Postgres 11构建，集成了PostGIS 2.5.2、SFCGAL、pgrouting 2.6.2等地理空间扩展，并支持光栅数据处理和SSL连接。适用于需要地理空间数据存储和分析的应用场景。

核心功能与特性

• 基础数据库：Postgres 11
• 地理空间扩展：
  • PostGIS 2.5.2（含Geos 3.7.2）
  • SFCGAL 1.3.7（基于CGAL 4.13.1）
  • pgrouting 2.6.2
• 数据支持：光栅数据处理
• 安全特性：SSL连接支持
• 配置优化：基于pgtune推荐参数预配置，适应4GB内存、50连接数的混合工作负载

版本标签

Docker Hub镜像标签及对应版本信息：

• latest：Postgres 11 + PostGIS 2.5.2 + SFCGAL 1.3.7 + pgrouting 2.6.2
• 2.5：同上
• 2.5_10：Postgres 10 + PostGIS 2.5.2 + SFCGAL 1.3.7 + pgrouting 2.6.2
• 2.4：Postgres 10 + PostGIS 2.4.5 + SFCGAL 1.3.6 + pgrouting 2.6.1
• 2.3：Postgres 9.6 + PostGIS 2.3.7 + SFCGAL 1.3.6 + pgrouting 2.6.1

数据卷映射

容器默认映射数据卷路径：/postgresql/11/main（不同版本对应不同Postgres版本路径，如2.5_10使用/postgresql/10/main，2.3使用/postgresql/9.6/main）。

• 未映射本地目录：容器内创建新数据库，数据不持久化（删除容器后丢失）
• 映射空本地目录：在本地目录初始化新数据库
• 映射非空本地目录：尝试复用目录中已存在的数据库，若目录包含其他文件可能导致错误

环境变量

可通过以下环境变量配置新数据库：

新用户拥有数据库的一般权限，并被授予postgres超级用户成员资格，可通过SET ROLE postgres;临时获取超级用户权限，完成管理任务后用RESET ROLE;重置。

端口映射

容器暴露5432端口，需映射至本地端口才能通过localhost:5432连接，例如-p 5432:5432。

使用注意事项

1. 数据卷映射覆盖：若先在容器内上传数据再映射本地卷，原数据将被覆盖，需重新运行无卷映射容器访问
2. 现有数据库使用条件：
   • 确保镜像Postgres/PostGIS版本与现有数据库匹配
   • postgresql.conf中listen_addresses需设为'*'
   • pg_hba.conf需包含以下配置：

     local     all     all                 trust
     host      all     all     0.0.0.0/0   trust
     

使用示例

基本运行（后台模式）

bash
docker run -d -p 5432:5432  \
    -e "PG_USER=my_username" \
    -e "PG_PASSWORD=my_password" \
    -e "DB_NAME=my_db" \
    --restart=unless-stopped \
    --volume=/path/to/local/data:/postgresql/11/main \
    docker.xuanyuan.run/cityseer/postgis:latest

查看日志：

bash
docker logs -f <容器ID>

若使用已有配置数据库，可省略环境变量，新数据库初始化时未指定环境变量将使用默认值。

启用SSL

1. 准备server.crt（证书）和server.key（密钥）文件，放置于本地目录
2. 添加SSL卷映射：

bash
docker run -d -p 5432:5432  \
    -e "PG_USER=my_username" \
    -e "PG_PASSWORD=my_password" \
    -e "DB_NAME=my_db" \
    --restart=unless-stopped \
    --volume=/path/to/local/data:/postgresql/11/main \
    --volume=/path/to/local/ssl:/postgresql/11/ssl \
    docker.xuanyuan.run/cityseer/postgis:latest

SSL证书生成示例（使用Let's Encrypt）

bash
# 安装acme.sh
sudo apt-get install wget cron netcat
wget -O - https://get.acme.sh | sh

# 生成证书
sudo ~/.acme.sh/acme.sh --issue --standalone -d your_domain.com

# 安装证书到指定目录
mkdir /path/to/local/ssl
~/.acme.sh/acme.sh --installcert -d your_domain.com \
    --certpath /path/to/local/ssl/server.crt \
    --keypath /path/to/local/ssl/server.key
sudo chmod 0600 /path/to/local/ssl/server.key

配置参数

默认配置基于pgtune优化，适用于4GB内存、50连接数、HDD存储的混合工作负载，通过ALTER SYSTEM命令写入postgresql.auto.conf（覆盖postgresql.conf默认设置）：

• max_connections = 50
• shared_buffers = 1GB
• effective_cache_size = 3GB
• maintenance_work_mem = 256MB
• checkpoint_completion_target = 0.9
• wal_buffers = 16MB
• default_statistics_target = 100
• random_page_cost = 4
• effective_io_concurrency = 2
• work_mem = 10485kB
• min_wal_size = 1GB
• max_wal_size = 2GB

自定义配置

通过ALTER SYSTEM命令修改配置（需postgres超级用户权限）：

sql
SET ROLE postgres;
ALTER SYSTEM SET max_connections = '100';  -- 修改连接数
RESET ROLE;
SELECT pg_reload_conf();  -- 重载配置

验证配置：

sql
SELECT current_setting('max_connections');

建议根据实际环境（如SSD存储、更大内存）调整参数。

Docker Hub地址

https://hub.docker.com/r/cityseer/postgis/