ciwater/postgis

PostGIS Docker 镜像文档

镜像概述

本Docker镜像提供一个已启用PostGIS扩展的PostgreSQL数据库实例，适用于需要地理空间数据存储和处理的应用场景。Dockerfile及相关上下文文件位于以下仓库：
https://github.com/CI-WATER/tethys_docker

注意：该仓库包含多个Dockerfile，PostGIS相关的Dockerfile位于postgis目录下。

核心功能与特性

• 基于PostgreSQL数据库，预安装并启用PostGIS扩展，支持地理空间数据类型和空间查询
• 自动初始化Tethys Platform所需的三个数据库用户：tethys_default、tethys_db_manager、tethys_super
• 支持通过环境变量自定义用户密码，满足生产环境安全需求
• 开箱即用，可快速部署地理空间数据库服务

安装方法

方法一：从Docker仓库拉取镜像

bash
$ sudo docker pull docker.xuanyuan.run/ciwater/postgis

方法二：从源码构建镜像

bash
$ git clone https://github.com/CI-WATER/tethys_docker.git
$ cd tethys_docker/postgis
$ sudo docker build -t ciwater/postgis .

运行容器

交互式运行（用于测试）

bash
$ sudo docker run --rm -it -p 5432:5432 ciwater/postgis

后台模式运行（生产环境推荐）

bash
$ sudo docker run -d -p 5432:5432 --name postgis ciwater/postgis

说明：容器启动后，数据库服务将在主机的5432端口可用。若主机5432端口已被占用，可修改端口映射（如-p 5433:5432将容器5432端口映射到主机5433端口）。

配置说明

默认用户与密码

镜像自动创建三个默认用户，初始密码均为pass：

• tethys_default：默认应用用户
• tethys_db_manager：数据库管理用户
• tethys_super：超级用户（具有数据库管理员权限）

自定义密码（生产环境必需）

通过环境变量修改默认密码，支持以下变量：

• TETHYS_DEFAULT_PASS：设置tethys_default用户密码
• TETHYS_DB_MANAGER_PASS：设置tethys_db_manager用户密码
• TETHYS_SUPER_PASS：设置tethys_super用户密码

示例：

bash
$ sudo docker run -d -p 5432:5432 \
  -e TETHYS_DEFAULT_PASS="your_default_pass" \
  -e TETHYS_DB_MANAGER_PASS="your_manager_pass" \
  -e TETHYS_SUPER_PASS="your_super_pass" \
  --name postgis ciwater/postgis

使用场景

• 作为Tethys Platform的地理空间数据库后端
• 开发和测试地理信息系统（GIS）应用
• 快速部署支持空间数据的PostgreSQL服务
• 教学或演示环境中的地理数据存储方案