uwitech/postgresql

PostgreSQL Docker镜像

镜像概述和主要用途

PostgreSQL Docker镜像是PostgreSQL关系型数据库的容器化版本。PostgreSQL是一款功能强大的开源对象-关系型数据库系统，以可靠性、数据完整性和扩展性著称。该镜像主要为DHIS2（***健康信息系统）和OpenEMPI（患者主索引系统）提供后端数据库支持，同时适用于需要稳定关系型数据库的各类应用场景。

核心功能和特性

• 完整数据库功能：支持ACID事务、复杂查询、外键约束、触发器及存储过程等关系型数据库核心特性
• 数据可靠性：具备完善的崩溃恢复机制和数据一致性保障
• 可扩展性：支持自定义数据类型、操作符和函数，满足复杂业务需求
• 多语言支持：可通过PL/pgSQL、PL/Python等多种过程语言编写存储过程
• 容器化优势：部署简单、环境隔离、版本控制便捷，便于在开发、测试和生产环境中快速部署

使用场景和适用范围

• 作为DHIS2信息系统的后端数据库，存储和管理数据
• 作为OpenEMPI患者主索引系统的数据库，维护患者身份信息
• 开发和测试环境中的关系型数据库服务
• 需要快速部署且配置简单的中小型应用数据库
• 教学和学习PostgreSQL数据库的环境搭建

使用方法和配置说明

基本使用（docker run）

通过以下命令快速启动PostgreSQL容器：

bash
docker run --name postgres-db -e POSTGRES_PASSWORD=mysecretpassword -d postgres

核心环境变量说明

数据持久化

为避免容器删除导致数据丢失，建议挂载数据卷：

bash
docker run --name postgres-db -e POSTGRES_PASSWORD=mysecretpassword -v postgres-data:/var/lib/postgresql/data -d postgres

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  postgres:
    image: postgres
    container_name: postgres-db
    environment:
      POSTGRES_PASSWORD: mysecretpassword
      POSTGRES_USER: dhis2user
      POSTGRES_DB: dhis2db
    volumes:
      - postgres-data:/var/lib/postgresql/data
    ports:
      - "5432:5432"
    restart: unless-stopped

volumes:
  postgres-data:

启动服务：

bash
docker-compose up -d

连接数据库

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

bash
docker exec -it postgres-db psql -U postgres

通过外部客户端连接（需映射5432端口）：

bash
psql -h localhost -p 5432 -U postgres -d postgres