dailynuts/postgis

docker-postgis

这是一个运行PostGIS（PostgreSQL空间扩展）的Docker容器，区别于其他镜像的特点包括：开箱即用的SSL支持、默认仅允许Docker子网连接、预创建'gis'数据库便于QGIS等工具直接使用、支持数据复制、可创建多个数据库及启用多种扩展，目标是提供轻负载生产环境可用的PostGIS服务。

核心功能

• 开箱即用的SSL加密连接
• 支持PostgreSQL主从数据复制
• 可创建多个数据库（逗号分隔）
• 可启用多种扩展（如postgis、hstore、postgis_topology）
• 默认创建'gis'数据库，降低使用门槛
• 可限制连接IP范围，增强安全性

使用场景

• 地理信息系统（GIS）应用开发与测试
• 空间数据存储与管理
• 轻量级生产环境的空间数据库服务
• 需要PostGIS扩展的空间数据分析场景

配置说明

标签版本

镜像标签格式：kartoza/postgis:[postgres版本]-[postgis版本]，例如9.6-2.4（PostgreSQL 9.6 + PostGIS 2.4）。建议使用标签版本避免数据库存储目录不一致问题。

获取镜像

从Docker Hub拉取（推荐）

bash
docker pull kartoza/postgis

本地构建

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

运行容器

基本运行

bash
sudo docker run --name "postgis" -p 25432:5432 -d -t kartoza/postgis

环境变量配置

自定义用户、密码、数据库等：

• POSTGRES_USER: 超级用户名（默认'docker'）
• POSTGRES_PASS: 密码（默认'docker'）
• POSTGRES_DBNAME: 数据库名（可多个，逗号分隔）
• POSTGRES_MULTIPLE_EXTENSIONS: 启用扩展（如postgis,hstore）
• ALLOW_IP_RANGE: 允许连接的IP范围（默认Docker子网）
• SSL_CERT_FILE: 自定义SSL证书路径

示例：

bash
docker run --name postgis -e POSTGRES_USER=myuser -e POSTGRES_PASS=mypass -e POSTGRES_DBNAME=mygis -p 25432:5432 -d kartoza/postgis

Docker Compose示例

包含数据库备份服务的配置：

yaml
services:
  postgis:
    image: kartoza/postgis
    ports:
      - "25432:5432"
    environment:
      - POSTGRES_USER=docker
      - POSTGRES_PASS=docker
      - POSTGRES_DBNAME=gis
    volumes:
      - postgres_data:/var/lib/postgresql
  backup:
    image: kartoza/pg-backup
    links:
      - postgis:db
    environment:
      - DATABASE_HOST=db
      - DATABASE_USER=docker
      - DATABASE_PASS=docker
      - DATABASE_NAME=gis
      - BACKUP_INTERVAL=1440
volumes:
  postgres_data:

运行：docker-compose up -d

连接数据库

使用psql客户端连接：

bash
psql -h localhost -U docker -p 25432 -l

（Ubuntu安装客户端：sudo apt-get install postgresql-client-9.6）

数据持久化

挂载本地目录保存数据：

bash
mkdir -p ~/postgres_data
docker run -d -v $HOME/postgres_data:/var/lib/postgresql kartoza/postgis

数据复制设置

• 主节点：设置ALLOW_IP_RANGE允许从节点连接，配置POSTGRES_USER/POSTGRES_PASS作为复制凭据。
• 从节点：设置REPLICATE_FROM（主节点IP/域名）、REPLICATE_PORT（默认5432）。

示例参考sample/replication/docker-compose.yml，运行：make up

SSL配置

替换为自定义证书：

1. 创建Dockerfile：

dockerfile
FROM kartoza/postgis:11.0-2.5
ADD ssl_cert.pem /etc/ssl/certs/ssl_cert.pem
ADD localhost_ssl_key.pem /etc/ssl/private/ssl_key.pem
RUN chmod 400 /etc/ssl/private/ssl_key.pem

2. docker-compose.yml：

yaml
services:
  postgres:
    build:
      dockerfile: Dockerfile
      context: ssl_secured_docker
    environment:
      - SSL_CERT_FILE=/etc/ssl/certs/ssl_cert.pem
      - SSL_KEY_FILE=/etc/ssl/private/ssl_key.pem

启动时运行SQL脚本

挂载脚本到/docker-entrypoint-initdb.d/：

bash
docker run -d -v ./setup-db.sql:/docker-entrypoint-initdb.d/setup-db.sql kartoza/postgis

credits

Tim Sutton ()、Gavin Fleming ()、Risky Maulana ()、Admire Nyakudya () December 2018