geonode/postgis

PostGIS for GeoNode 数据库镜像

镜像概述与主要用途

本镜像专为GeoNode地理信息平台设计，基于PostgreSQL数据库集成PostGIS空间扩展，提供地理空间数据存储、索引与查询能力。作为GeoNode的核心数据层组件，该镜像优化了与GeoNode的兼容性，支持地理空间数据类型（如点、线、面）及空间关系运算，满足GeoNode对地理信息数据的全生命周期管理需求。

核心功能与特性

空间数据支持

• 集成PostGIS扩展，支持OGC标准地理空间数据类型（POINT、LINESTRING、POLYGON等）及复合类型（MULTIPOINT、GEOMETRYCOLLECTION）
• 提供空间索引机制（GIST、SP-GIST），优化大规模地理数据查询性能
• 内置空间分析函数库，支持距离计算、面积量算、缓冲区分析等地理操作

与GeoNode深度兼容

• 预配置GeoNode所需的数据库 schema 与权限模型
• 支持GeoNode数据发布、图层管理、元数据关联等核心流程
• 兼容GeoNode对空间参考系统（SRS）的处理需求

可靠性与扩展性

• 基于官方PostgreSQL镜像构建，继承其数据持久化、事务支持等特性
• 支持数据卷挂载实现数据持久化，避免容器重启导致数据丢失
• 可通过环境变量配置多数据库实例，满足复杂应用场景

使用场景与适用范围

典型应用场景

• GeoNode开发/测试环境快速部署
• 生产环境中GeoNode平台的数据库服务
• 与GeoNode集成的WebGIS应用数据层
• 地理空间数据教学与演示环境

适用用户

• GeoNode开发者与管理员
• 地理信息系统（GIS）工程师
• 需要构建空间数据支持的Web应用团队

使用方法与配置说明

快速启动（Docker Run）

bash
docker run -d \
  --name geonode-postgis \
  -p 5432:5432 \
  -e POSTGRES_USER=geonode \
  -e POSTGRES_PASSWORD=secure_password \
  -e POSTGRES_DB=geonode \
  -v geonode_pgdata:/var/lib/postgresql/data \
  geonode/postgis:latest

参数说明

• -p 5432:5432: 映射容器PostgreSQL默认端口到主机
• -e POSTGRES_USER: 数据库管理员用户名（建议设为geonode）
• -e POSTGRES_PASSWORD: 用户密码（生产环境需使用强密码）
• -e POSTGRES_DB: 初始数据库名称（默认与用户名一致）
• -v geonode_pgdata:/var/lib/postgresql/data: 挂载数据卷实现持久化

Docker Compose 集成示例

适用于与GeoNode其他组件（如GeoServer、前端应用）协同部署：

yaml
version: '3'
services:
  db:
    image: geonode/postgis:latest
    container_name: geonode-postgis
    ports:
      - "5432:5432"
    environment:
      - POSTGRES_USER=geonode
      - POSTGRES_PASSWORD=secure_password
      - POSTGRES_DB=geonode
      - POSTGRES_MULTIPLE_DATABASES=geonode_data,geonode_uploads  # 可选：创建多数据库
    volumes:
      - geonode_pgdata:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  geonode_pgdata:  # 数据卷持久化

核心环境变量配置

与GeoNode集成配置

在GeoNode配置文件（如settings.py）中配置数据库连接：

python
DATABASES = {
    'default': {
        'ENGINE': 'django.contrib.gis.db.backends.postgis',
        'NAME': 'geonode',          # 与POSTGRES_DB一致
        'USER': 'geonode',          # 与POSTGRES_USER一致
        'PASSWORD': 'secure_password',  # 与POSTGRES_PASSWORD一致
        'HOST': 'db',               # Docker Compose服务名或容器IP
        'PORT': '5432',
    }
}

数据持久化与备份

数据持久化

通过挂载数据卷（如示例中的geonode_pgdata）确保容器销毁后数据留存，避免直接依赖容器内存储。

数据备份

使用pg_dump工具备份数据库：

bash
docker exec geonode-postgis pg_dump -U geonode geonode > geonode_backup.sql

恢复命令：

bash
cat geonode_backup.sql | docker exec -i geonode-postgis psql -U geonode -d geonode