geographica/postgis

PostgreSQL 12.2 PostGIS 3.0.1 镜像文档

镜像概述和主要用途

本镜像由Geographica构建，基于PostgreSQL 12.2开发版本，集成PostGIS 3.0.1空间扩展及GEOS 3.8.0、PROJ 6.3.1依赖库，提供完整的空间数据库功能。主要用于地理信息系统（GIS）开发、空间数据存储与管理，支持数据持久化、配置自定义及安全密码管理，适合快速部署包含空间数据处理能力的数据库环境。

核心功能和特性

• 组件集成：包含PostgreSQL 12.2、PostGIS 3.0.1、GEOS 3.8.0和PROJ 6.3.1
• 数据持久化：支持通过数据卷或主机目录挂载保存数据库数据
• 灵活配置：通过环境变量自定义数据库密码、编码、区域设置及配置文件
• 安全密码：支持明文或PostgreSQL加密格式密码，增强安全性
• 便捷工具：提供psql-docker脚本简化数据库交互操作
• 命令执行：支持运行任意命令，如数据库备份、交互式psql会话等
• 配置自定义：支持修改pg_hba.conf和postgresql.conf配置文件
• 优雅关闭：支持信号处理，确保数据库安全 shutdown

使用场景和适用范围

• 地理信息系统（GIS）应用开发与测试环境搭建
• 空间数据存储、查询与空间分析需求场景
• 需要PostGIS扩展的应用部署（如地图服务、空间数据可视化）
• 开发环境中快速构建PostgreSQL+PostGIS数据库
• 数据库备份、迁移等管理操作

详细使用方法和配置说明

如何使用

使用Docker Compose

创建docker-compose.yml文件：

yml
version: "3"
services:
  postgis:
    image: docker.xuanyuan.run/geographica/postgis:unbiased_uakari
    ports:
      - "5432:5432"
    volumes:
      - db-data:/data
    environment:
      - POSTGRES_PASSWD=postgres
volumes:
  db-data:

启动服务：

bash
docker-compose up

不使用Compose

直接运行容器：

bash
docker run --name postgis -p 5432:5432 docker.xuanyuan.run/geographica/postgis:unbiased_uakari

环境变量

容器可通过以下环境变量配置：

• POSTGRES_PASSWD：设置postgres用户密码，支持明文或PostgreSQL加密格式，默认值为postgres
• ENCODING：数据库及默认数据库的编码，默认值为UTF-8
• LOCALE：数据库及默认数据库的区域设置，默认值为en_US
• PG_HBA：配置pg_hba.conf访问控制文件，详见配置数据存储
• PG_CONF：配置postgresql.conf，详见配置数据存储

版本信息

本镜像编译包含以下软件版本：

• PostgreSQL 12.2
• GEOS 3.8.0
• PROJ 6.3.1
• PostGIS 3.0.1

脚本工具

镜像提供psql-docker脚本，用于在独立容器中打开psql控制台连接其他数据库。查看帮助：

bash
psql-docker -h

执行任意命令

可运行任意命令，适用于数据库备份、交互式操作等场景：

交互式pg_dump（需输入密码）

bash
docker run --rm -ti -v /whatever/:/d --link the_container_running_the_database:pg \
docker.xuanyuan.run/geographica/postgis: \
pg_dump -b -E UTF8 -f /d/dump -F c -v -Z 9 -h pg -p 5432 -U postgres project

自动pg_dump（密码通过环境变量传递）

bash
docker run --rm -v /home/malkab/Desktop/:/d --link test_07:pg \
docker.xuanyuan.run/geographica/postgis: \
PGPASSWORD="new_password_here" pg_dump -b -E UTF8 -f /d/dump33 -F c \
-v -Z 9 -h pg -p 5432 -U postgres postgres

交互式psql

bash
docker run --rm -ti -v /home/malkab/Desktop/:/d --link test_07:pg \ 
docker.xuanyuan.run/geographica/postgis: \
PGPASSWORD="new_password_here" psql -h pg -p 5432 -U postgres postgres

数据持久化

数据库数据可通过数据卷或主机挂载目录持久化，供其他容器使用。容器会检查/data/目录是否为空：若为空则创建新数据存储，否则使用现有数据。

密码配置

POSTGRES_PASSWD支持明文或PostgreSQL加密格式：

• 明文密码：直接设置，docker inspect可查看，安全性较低
• 加密密码：采用PostgreSQL加密格式（md5前缀+md5(password+username)哈希值）

生成加密密码示例：

bash
export USER="projectuser" && \
export USERPASSWD="md5"$(printf '%s' "userpass" ${USER} | md5sum | cut -d ' ' -f 1) && \
export PGPASSWD="md5"$(printf '%s' "password_here" "postgres" | md5sum | cut -d ' ' -f 1) && \
docker run -d -P --name ageworkshoptestpg -e "POSTGRES_PASSWD=${PGPASSWD}" \
-e "CREATE_USER=${USER}" -e "CREATE_USER_PASSWD=${USERPASSWD}" \
docker.xuanyuan.run/geographica/postgis:

配置数据存储

支持通过脚本和环境变量配置pg_hba.conf和postgresql.conf。

pg_hba.conf配置

通过pg_hba_conf脚本操作，支持三种模式：

1. pg_hba_conf l：查看当前配置内容
2. pg_hba_conf a "line 1#line 2#...#line n"：添加配置行
3. pg_hba_conf d "line 1#line 2#...#line n"：删除配置行

示例（通过exec执行）：

bash
docker exec -ti whatevercontainer pg_hba_conf a \
"host all all 23.123.22.1/32 trust#host all all 93.32.12.3/32 md5"

环境变量PG_HBA默认值：

txt
local all all trust#host all all 127.0.0.1/32 trust#host all all 0.0.0.0/0 md5#host all all ::1/128 trust

postgresql.conf配置

通过postgresql_conf脚本操作，语法与pg_hba_conf相同。环境变量PG_CONF默认值：

txt
max_connections=100#listen_addresses='*'#shared_buffers=128MB#dynamic_shared_memory_type=posix#log_timezone='UTC'#datestyle='iso, mdy'#timezone='UTC'#lc_messages='en_US.UTF-8'#lc_monetary='en_US.UTF-8'#lc_numeric='en_US.UTF-8'#lc_time='en_US.UTF-8'#log_statement='all'#log_directory='pg_log'#log_filename='postgresql-%Y-%m-%d_%H%M%S.log'#logging_collector=on#client_min_messages=notice#log_min_messages=notice#log_line_prefix='%a %u %d %r %h %m %i %e'#log_destination='stderr,csvlog'#log_rotation_size=500MB

日志存储路径：$POSTGRES_DATA_FOLDER/pg_log

停止容器

容器支持通过信号优雅关闭数据库：

• SIGTERM：智能关闭（等待所有连接和事务完成，不接受新连接）

  bash
  docker kill -s SIGTERM containername
  

• SIGINT：快速关闭（中止当前事务，断开用户连接）

  bash
  docker kill -s SIGINT containername
  

• SIGQUIT：立即关闭（可能导致数据库不一致，下次启动需恢复）

  bash
  docker kill -s SIGQUIT containername