manz/postgres Docker 镜像 - 轩辕镜像

PostgreSQL with PostGIS and pgRouting 镜像文档

镜像概述

本镜像基于官方PostgreSQL数据库镜像构建，预安装并配置了PostGIS（空间数据库扩展）和pgRouting（路径规划扩展）。PostGIS提供空间数据存储、索引及分析能力，pgRouting则扩展了路径计算功能，适用于需要空间数据处理和路径分析的应用场景，无需手动安装配置扩展组件。

核心功能与特性

PostgreSQL基础功能

• 完整支持PostgreSQL数据库核心功能，包括ACID事务、复杂查询、JSON/XML支持及并发控制
• 兼容SQL标准及PostgreSQL扩展语法

PostGIS扩展功能

• 支持空间数据类型（Point、LineString、Polygon等几何/地理类型）
• 提供空间索引（GiST、SP-GiST）优化空间查询性能
• 包含200+空间分析函数（距离计算、面积测量、缓冲区分析等）
• 兼容OGC标准（WKT/WKB格式、空间参考系统EPSG）
• 支持栅格数据处理（通过PostGIS Raster扩展）

pgRouting扩展功能

• 集成多种路径算法：
  • Dijkstra算法（单源最短路径）
  • A*算法（带启发式的高效路径搜索）
  • Floyd-Warshall算法（全源最短路径）
  • Traveling Salesman Problem (TSP)求解
  • 等时线分析（Isochrones）与可达性计算
• 支持自定义权重参数（距离、时间、成本等）
• 与PostGIS空间数据无缝集成，直接基于地理网络数据计算

其他特性

• 预配置扩展，开箱即可使用空间函数和路径算法
• 兼容官方PostgreSQL镜像的所有环境变量和配置方式
• 支持数据持久化存储和容器生命周期管理

使用场景与适用范围

典型应用场景

• 地理信息系统（GIS）后端：存储和查询地理空间数据
• 位置服务应用：实现附近POI搜索、区域筛选等基于位置的功能
• 物流路径规划：计算最优配送路线、车辆调度路径
• 交通系统分析：公交/地铁网络路径查询、拥堵分析
• 城市规划：区域覆盖分析、资源分配优化
• 空间数据分析：结合统计工具进行地理数据挖掘

适用用户群体

• GIS开发工程师和空间数据分析师
• 需要路径计算功能的应用开发者
• 处理地理空间数据的科研人员和城市规划师

使用方法与配置说明

基本使用（Docker Run）

启动容器

bash
docker run -d \
  --name postgis-pgrouting \
  -e POSTGRES_PASSWORD=your_secure_password \
  -e POSTGRES_USER=dbuser \
  -e POSTGRES_DB=gisdb \
  -p 5432:5432 \
  -v postgres_data:/var/lib/postgresql/data \
  [镜像名称]

参数说明：

• -e POSTGRES_PASSWORD：数据库超级用户密码（必填）
• -e POSTGRES_USER：自定义数据库用户名（默认postgres）
• -e POSTGRES_DB：初始数据库名称（默认与用户名相同）
• -p 5432:5432：端口映射，主机端口:容器端口
• -v postgres_data:/var/lib/postgresql/data：数据卷挂载，持久化存储数据库文件
• [镜像名称]：实际使用的镜像标识（如postgis/postgis:latest-pgrouting）

验证扩展安装

1. 进入容器终端：

   bash
   docker exec -it postgis-pgrouting bash
   

2. 连接数据库：

   bash
   psql -U dbuser -d gisdb
   

3. 检查扩展版本：

   sql
   -- 验证PostGIS安装
   SELECT postgis_version();
   
   -- 验证pgRouting安装
   SELECT pgr_version();
   

Docker Compose配置示例

yaml
version: '3.8'

services:
  postgis-db:
    image: [镜像名称]
    container_name: postgis-pgrouting
    environment:
      POSTGRES_PASSWORD: your_secure_password
      POSTGRES_USER: dbuser
      POSTGRES_DB: gisdb
      POSTGRES_INITDB_ARGS: "--encoding=UTF8 --locale=C"
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data
      - ./init-scripts:/docker-entrypoint-initdb.d  # 挂载初始化脚本
    restart: unless-stopped

volumes:
  postgres_data:

启动服务：

bash
docker-compose up -d

配置参数说明

核心环境变量

空间数据操作示例

创建空间表并添加索引

sql
-- 创建道路网络表
CREATE TABLE road_network (
  id SERIAL PRIMARY KEY,
  name VARCHAR(100),
  geometry LineString,  -- 空间几何列
  length FLOAT,         -- 路段长度（公里）
  speed_limit INT       -- 限速（公里/小时）
);

-- 添加空间索引（优化查询性能）
CREATE INDEX road_network_geom_idx ON road_network USING GIST (geometry);

导入空间数据

sql
-- 插入示例道路数据（WKT格式，EPSG:4326坐标系统）
INSERT INTO road_network (name, geometry, length, speed_limit) VALUES
('主干道A', ST_GeomFromText('LINESTRING(116.397 39.908, 116.407 39.908, 116.417 39.908)', 4326), 2.2, 60),
('次干道B', ST_GeomFromText('LINESTRING(116.407 39.908, 116.407 39.918, 116.407 39.928)', 4326), 2.1, 40);

使用pgRouting计算路径

sql
-- 1. 创建网络拓扑（需先执行一次）
SELECT pgr_createTopology(
  'road_network',  -- 表名
  0.0001,          -- 容差（度，用于节点匹配）
  'geometry',      -- 几何列名
  'id'             -- 主键列名
);

-- 2. 计算最短路径（基于长度）
SELECT 
  seq, 
  node, 
  edge, 
  cost, 
  agg_cost,
  ST_AsText(geometry) AS path_geometry
FROM pgr_dijkstra(
  'SELECT id, source, target, length AS cost FROM road_network',  -- 边表查询
  1,  -- 起点节点ID
  5,  -- 终点节点ID
  false  -- 是否返回路径几何
) AS route
JOIN road_network ON route.edge = road_network.id;

注意事项

• 数据持久化：必须使用数据卷（-v参数）挂载数据目录，避免容器删除导致数据丢失
• 性能优化：对大型空间数据集，建议调整PostgreSQL配置参数（如shared_buffers、work_mem）并合理创建空间索引
• 版本兼容性：通过镜像标签指定特定版本（如postgis/postgis:15-3.4-pgrouting-3.5）以确保扩展版本兼容性
• 安全配置：生产环境中应避免使用弱密码，并限制数据库端口访问范围