corpusops/pgrouting-bare Docker镜像文档

1. 镜像概述

1.1 基本信息

镜像名称：corpusops/pgrouting-bare
主要用途：提供集成PostgreSQL、PostGIS和pgRouting的稳定地理空间路由功能环境，专注于生产环境的版本控制与兼容性保障。

1.2 基础依赖

该镜像基于以下开源Docker镜像构建，继承其核心功能与最佳实践：

• PostgreSQL官方镜像（数据库基础环境）
• mdillon/postgis（PostGIS地理空间扩展支持）
• starefossen/pgrouting（pgRouting路由算法扩展）

1.3 存在意义

解决基础镜像版本标签模糊导致的生产环境非预期升级问题，通过显式版本标记（如X.Y.Z-pgrouting-A.B.C）确保部署环境的可追溯性与稳定性，避免因自动升级引发的兼容性风险。

2. 核心功能与特性

3. 使用场景与适用范围

适用场景

• 生产环境地理空间路由服务：如交通流量分析、物流配送路径优化、城市规划路径模拟等需稳定算法支撑的业务系统。
• GIS应用开发与测试：开发包含路径规划功能的地理信息系统（GIS），确保开发/测试/生产环境版本一致性。
• 数据科学研究：地理网络分析、路由算法验证等场景，需固定版本环境以保证实验可复现性。
• 合规性部署：对依赖组件版本有严格审计要求的行业（如金融、政务），需明确版本追溯的场景。

4. 使用方法与配置说明

4.1 快速启动（docker run）

4.1.1 基础启动命令

docker run -d \
  --name pgrouting-instance \
  -e POSTGRES_PASSWORD=StrongPassword123 \  # 生产环境必填，建议使用强密码
  -p 5432:5432 \                            # 映射数据库端口
  corpusops/pgrouting-bare:latest           # 建议替换为具体版本标签（如14-3.4-13）

4.1.2 指定版本标签（推荐）

为避免版本漂移，生产环境需使用具体版本标签（格式通常为POSTGRESQL_VERSION-pgrouting-PGR_VERSION-postgis-PGIS_VERSION）：

docker run -d \
  --name pgrouting-instance \
  -e POSTGRES_PASSWORD=StrongPassword123 \
  -e POSTGRES_DB=gis_route_db \             # 自定义初始数据库名称
  -v /host/data/pgrouting:/var/lib/postgresql/data \  # 持久化数据到宿主机
  -p 5432:5432 \
  corpusops/pgrouting-bare:14-3.4-13        # 示例：PostgreSQL 14 + pgRouting 3.4 + PostGIS 13

4.2 Docker Compose配置示例

version: '3.8'

services:
  pgrouting:
    image: corpusops/pgrouting-bare:14-3.4-13  # 固定版本标签
    container_name: pgrouting-service
    restart: unless-stopped                   # 故障自动恢复
    environment:
      POSTGRES_USER: gis_admin                # 自定义管理员用户
      POSTGRES_PASSWORD: ${DB_PASSWORD}       # 建议通过环境变量注入密码
      POSTGRES_DB: city_routing_db            # 初始数据库名称
      PGDATA: /var/lib/postgresql/data/pgdata # 自定义数据存储路径（可选）
    volumes:
      - pgrouting_data:/var/lib/postgresql/data  # 命名卷持久化数据
      - ./init-scripts:/docker-entrypoint-initdb.d  # 挂载初始化脚本（如SQL文件）
    ports:
      - "5432:5432"  # 宿主机端口:容器端口

volumes:
  pgrouting_data:  # 自动创建的命名卷，独立于容器生命周期

4.3 核心配置参数

4.3.1 环境变量（继承自PostgreSQL官方镜像）

4.3.2 数据持久化

通过-v参数挂载宿主机目录或Docker命名卷，确保容器删除后数据不丢失：

# 宿主机目录挂载（需确保权限正确）
docker run -v /data/pgrouting:/var/lib/postgresql/data ...

# 命名卷挂载（推荐，由Docker管理权限）
docker run -v pgrouting_data:/var/lib/postgresql/data ...

4.4 扩展验证

容器启动后，可通过psql连接验证pgRouting扩展是否正常安装：

# 进入容器内数据库终端
docker exec -it pgrouting-instance psql -U postgres -d city_routing_db

# 验证pgRouting扩展
SELECT pgr_version();  # 返回pgRouting版本信息即表示安装成功

5. 相关链接与参考

• 官方代码仓库：corpusops/docker-postgres
• Docker Hub镜像页：corpusops/pgrouting-bare
• 基础镜像文档：
  • PostgreSQL官方Docker镜像文档
  • pgRouting Docker镜像（灵感来源）
  • PostGIS Docker镜像（灵感来源）