neowaylabs/postgis

docker-postgis 镜像文档

镜像概述

docker-postgis是一个集成了PostGIS扩展的PostgreSQL数据库Docker镜像。PostGIS为PostgreSQL提供了空间数据支持功能，使数据库能够存储、查询和处理地理空间数据，适用于地理信息系统（GIS）应用、空间数据分析等场景。

核心功能与特性

• 基于PostgreSQL数据库，提供完整的关系型数据库功能
• 集成PostGIS扩展，支持地理空间数据类型（如点、线、面等）和空间索引
• 支持标准的空间查询操作，满足地理信息处理需求
• 简洁的环境变量配置，便于快速部署

环境变量配置

暴露端口

• 5432：PostgreSQL数据库默认端口，用于数据库连接

内部卷

• /var/lib/postgresql/9.3/main：PostgreSQL默认数据存储目录，用于持久化数据库数据

使用方法

基本运行命令

bash
docker run -d \
  -p 5432:5432 \
  -e POSTGRES_PASSWD=your_password \
  --name postgis-container \
  docker-postgis

参数说明

• -d：后台运行容器
• -p 5432:5432：将容器的5432端口映射到主机的5432端口
• -e POSTGRES_PASSWD=your_password：设置数据库密码（可选，默认值为postgis）
• --name postgis-container：指定容器名称（可选）

数据持久化

为确保数据持久化，可将内部卷挂载到主机目录：

bash
docker run -d \
  -p 5432:5432 \
  -e POSTGRES_PASSWD=your_password \
  -v /host/path/to/data:/var/lib/postgresql/9.3/main \
  --name postgis-container \
  docker-postgis

连接数据库

使用psql客户端连接容器内的PostgreSQL数据库：

bash
psql -h localhost -p 5432 -U postgres

连接时输入设置的密码（默认postgis）即可访问数据库。

适用场景

• 地理信息系统（GIS）应用后端数据库
• 空间数据分析与处理
• 需要存储和查询地理空间数据的Web应用
• 开发和测试环境中的空间数据库部署