Docker PostGIS & pgRouting 镜像文档

1. 镜像概述和主要用途

本仓库提供以下 Docker 镜像标签：

• 基础镜像：corpusops/postgis-bare、corpusops/pgrouting-bare
• 衍生镜像：corpusops/postgis、corpusops/pgrouting（基于基础镜像构建，来自 corpusops/docker-images）

基础来源

这些镜像基于以下 Docker 镜像构建：

• postgres（*** PostgreSQL 镜像）
• mdillon/postgis（PostGIS 扩展镜像）
• starefossen/pgrouting（pgRouting 扩展镜像）

主要用途

提供明确标记版本的 PostGIS 和 pgRouting 镜像，避免生产环境中因镜像标签模糊导致的非预期升级，确保版本稳定性。

2. 核心功能和特性

• 版本明确化：通过显式版本标签（如 14-3.3）锁定 PostgreSQL、PostGIS 及 pgRouting 版本，杜绝生产环境非预期更新。
• 可靠基础：基于***及社区成熟镜像（postgres、mdillon/postgis、starefossen/pgrouting）构建，兼容性有保障。
• 衍生支持：提供 bare 基础镜像及 corpusops/postgis/pgrouting 衍生镜像，满足不同场景需求。
• 功能完整：集成 PostGIS（空间数据扩展）和 pgRouting（路径分析扩展）核心功能，开箱即用。

3. 使用场景和适用范围

• 生产环境部署：需稳定运行 PostgreSQL+PostGIS/pgRouting 的业务系统，对版本一致性要求高。
• 版本控制需求：需要精确控制 PostgreSQL、PostGIS 或 pgRouting 版本，避免依赖冲突的场景。
• GIS 应用开发：基于地理信息系统（GIS）的应用开发、测试及部署，如地图服务、路径规划系统等。

4. 使用方法和配置说明

4.1 镜像拉取

通过 Docker Hub 拉取镜像（以 postgis-bare 为例，版本标签需替换为实际需求版本，如 14-3.3）：

bash
docker pull corpusops/postgis-bare:14-3.3
docker pull corpusops/pgrouting-bare:14-3.3-3.4
docker pull corpusops/postgis:14-3.3  # 衍生镜像
docker pull corpusops/pgrouting:14-3.3-3.4  # 衍生镜像

4.2 基本运行（docker run）

PostGIS 基础镜像（postgis-bare）

bash
docker run -d \
  --name postgis-instance \
  -e POSTGRES_PASSWORD=mysecretpassword \  # PostgreSQL 超级用户密码
  -e POSTGRES_DB=mydb \                   # 初始化数据库名（可选）
  -p 5432:5432 \                          # 映射端口到主机
  corpusops/postgis-bare:14-3.3

pgRouting 基础镜像（pgrouting-bare）

bash
docker run -d \
  --name pgrouting-instance \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -e POSTGRES_USER=pguser \               # 自定义数据库用户（可选）
  -p 5432:5432 \
  corpusops/pgrouting-bare:14-3.3-3.4

4.3 Docker Compose 配置示例

创建 docker-compose.yml 文件，定义服务：

yaml
version: '3.8'
services:
  postgis:
    image: corpusops/postgis:14-3.3
    container_name: postgis-service
    environment:
      POSTGRES_PASSWORD: securepass        # 必选：数据库密码
      POSTGRES_USER: gisuser               # 可选：自定义用户
      POSTGRES_DB: gisdb                   # 可选：初始化数据库
    ports:
      - "5432:5432"
    volumes:
      - postgis-data:/var/lib/postgresql/data  # 持久化数据卷
    restart: unless-stopped                # 自动重启策略

  pgrouting:
    image: corpusops/pgrouting:14-3.3-3.4
    container_name: pgrouting-service
    environment:
      POSTGRES_PASSWORD: anotherpass
      POSTGRES_DB: routingdb
    ports:
      - "5433:5432"  # 避免端口冲突（若同时运行多个实例）
    volumes:
      - pgrouting-data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgis-data:
  pgrouting-data:

启动服务：

bash
docker-compose up -d

4.4 配置参数说明

镜像继承基础镜像的所有环境变量和配置方式，关键参数参考：

• PostgreSQL 核心配置：见 postgres ***镜像文档（如 POSTGRES_PASSWORD、POSTGRES_USER、POSTGRES_DB 等）。
• PostGIS 扩展配置：参考 appropriate/docker-postgis（如初始化空间数据库、扩展启用等）。
• pgRouting 扩展配置：参考 Starefossen/docker-pgrouting（如路径分析函数依赖等）。

5. 参考与致谢

• pgRouting 镜像：基于 Starefossen/docker-pgrouting 实现，感谢其设计灵感。
• PostGIS 镜像：基于 appropriate/docker-postgis 实现，感谢其设计灵感。
• 完整文档及源码：corpusops/docker-postgres