goabout/postgis

PostGIS固定版本镜像文档

镜像概述

本镜像为PostGIS的固定版本副本，旨在提供一个不会自动更新的地理空间数据库环境。它基于PostGIS构建，确保用户在使用过程中不会因上游镜像更新而导致版本变化，从而保障系统的稳定性和兼容性。

核心功能和特性

• 版本固定：镜像内容不会随PostGIS官方更新而变化，确保环境一致性
• 完整PostGIS功能：包含PostGIS的全部地理空间扩展功能，支持空间数据存储、查询和分析
• 稳定性保障：避免因版本更新导致的配置冲突或功能变更
• 兼容性：与基于标准PostGIS镜像开发的应用程序完全兼容

使用场景和适用范围

• 需要长期稳定运行的地理空间数据库服务
• 对版本一致性有严格要求的生产环境
• 需避免因依赖更新导致应用异常的场景
• 地理信息系统（GIS）应用的后端数据库支持

使用方法和配置说明

基本使用（docker run）

bash
docker run -d \
  --name postgis-fixed \
  -e POSTGRES_PASSWORD=your_password \
  -e POSTGRES_USER=your_user \
  -e POSTGRES_DB=your_db \
  -p 5432:5432 \
  -v postgis_data:/var/lib/postgresql/data \
  [镜像名称]

Docker Compose配置

yaml
version: '3'
services:
  postgis:
    image: docker.xuanyuan.run/[镜像名称]
    container_name: postgis-fixed
    environment:
      POSTGRES_PASSWORD: your_password
      POSTGRES_USER: your_user
      POSTGRES_DB: your_db
    ports:
      - "5432:5432"
    volumes:
      - postgis_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgis_data:

环境变量说明

• POSTGRES_PASSWORD：数据库超级用户密码（必填）
• POSTGRES_USER：数据库超级用户名（默认：postgres）
• POSTGRES_DB：初始数据库名称（默认与POSTGRES_USER相同）
• POSTGRES_INITDB_ARGS：初始化数据库时的额外参数

数据持久化

建议使用Docker卷（volume）或绑定挂载（bind mount）来持久化数据库数据，避免容器重启导致数据丢失。

注意事项

• 本镜像不会自动更新，如需升级PostGIS版本，需手动替换镜像
• 与标准PostGIS镜像使用方法完全一致，可直接替换使用
• 首次启动时会自动初始化PostGIS扩展

连接示例

使用psql连接数据库：

bash
psql -h localhost -p 5432 -U your_user -d your_db

验证PostGIS是否安装成功：

sql
SELECT postgis_version();