thedutchselection/postgresql

PostgreSQL Docker镜像文档

镜像概述

本镜像为The Dutch Selection提供的PostgreSQL官方Docker镜像，基于开源关系型数据库PostgreSQL构建，旨在提供便捷、可移植的数据库服务部署方案。PostgreSQL以其强大的SQL兼容性、事务可靠性和扩展性著称，广泛应用于各类数据存储场景。

核心功能与特性

• SQL标准支持：全面兼容SQL:2016标准，支持复杂查询、子查询、窗口函数等高级SQL特性
• 事务处理：遵循ACID原则，确保数据一致性和可靠性
• 数据类型丰富：支持JSON、数组、地理信息（PostGIS扩展）、UUID等多种数据类型
• 扩展性：支持自定义函数、存储过程、触发器及扩展插件（如全文搜索、时序数据处理）
• 安全性：提供细粒度权限控制、SSL加密、行级安全等安全特性
• 高可用性：支持主从复制、流复制，可构建高可用集群

使用场景

• 开发环境：本地开发时快速搭建独立的PostgreSQL数据库实例
• 测试环境：自动化测试中提供隔离的数据库环境
• 生产环境：中小型应用的数据存储服务，或作为分布式系统的数据库节点
• 数据迁移：作为数据迁移过程中的临时数据库实例

使用方法

基本部署（docker run）

bash
docker run --name postgres-instance \
  -e POSTGRES_PASSWORD=your_secure_password \
  -e POSTGRES_USER=app_user \
  -e POSTGRES_DB=app_db \
  -p 5432:5432 \
  -v postgres-data:/var/lib/postgresql/data \
  -d postgres

docker-compose配置

yaml
version: '3.8'
services:
  postgres:
    image: postgres
    container_name: postgres-db
    environment:
      POSTGRES_PASSWORD: your_secure_password
      POSTGRES_USER: app_user
      POSTGRES_DB: app_db
      PGDATA: /var/lib/postgresql/data/pgdata
    ports:
      - "5432:5432"
    volumes:
      - postgres-data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres-data:

环境变量配置

数据持久化

通过挂载卷（volume）确保数据持久化：

bash
# 创建命名卷
docker volume create postgres-data

# 运行容器时挂载卷
docker run -v postgres-data:/var/lib/postgresql/data ... postgres

连接数据库

使用psql客户端连接：

bash
docker exec -it postgres-instance psql -U app_user -d app_db

注意事项

• 生产环境中需使用强密码并限制网络访问
• 定期备份数据卷以防止数据丢失
• 根据实际需求调整资源限制（如--memory、--cpus参数）
• 如需使用扩展插件，可通过Dockerfile基于此镜像构建自定义镜像