wodby/postgres

PostgreSQL Docker镜像（基于Alpine）

概述

该镜像是一个基于Alpine Linux构建的轻量级PostgreSQL容器化解决方案，集成编排功能，旨在简化PostgreSQL数据库的部署、配置与运维流程。Alpine Linux基础确保镜像体积小巧、资源占用低，同时完整保留PostgreSQL核心功能，适用于开发、测试及轻量级生产环境。

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积显著小于传统Linux发行版基础的PostgreSQL镜像，降低存储和网络传输成本，运行时内存与CPU占用更低。
• 完整数据库功能：集成官方PostgreSQL数据库引擎，支持标准SQL、事务处理、索引、存储过程等核心特性，兼容各版本PostgreSQL功能规范。
• 编排支持：内置初始化脚本执行、配置文件管理、服务健康检查等编排功能，支持自动化部署与实例生命周期管理。
• 灵活配置：通过环境变量、挂载配置文件等方式自定义数据库参数，满足不同场景下的性能与功能需求。
• 安全增强：继承Alpine Linux的安全特性，默认配置遵循最小权限原则，减少潜在***面。

使用场景与适用范围

• 开发与测试环境：快速搭建独立的PostgreSQL实例，支持本地开发与团队协作测试。
• 轻量级生产环境：适用于资源受限或中小型应用，提供高效的数据库服务。
• CI/CD流程集成：作为自动化测试的依赖服务，支持快速启动与销毁，提升持续集成效率。
• 边缘计算场景：在边缘设备或嵌入式系统中部署轻量级数据库服务。

使用方法与配置说明

基本部署（docker run）

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

bash
docker run -d \
  --name postgres-alpine \
  -p 5432:5432 \
  -v postgres-data:/var/lib/postgresql/data \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_PASSWORD=mypassword \
  -e POSTGRES_DB=mydb \
  wodby/postgres:latest

• -v postgres-data:/var/lib/postgresql/data：挂载数据卷以持久化数据库数据，避免容器删除导致数据丢失。
• -e 参数：设置数据库初始化与运行参数（详见配置参数说明）。

Docker Compose配置示例

创建 docker-compose.yml 文件实现多服务协同部署：

yaml
version: '3.8'
services:
  postgres:
    image: wodby/postgres:latest
    container_name: postgres-alpine
    ports:
      - "5432:5432"
    volumes:
      - postgres-data:/var/lib/postgresql/data
      # 可选：挂载初始化脚本目录（支持.sql/.sh文件自动执行）
      # - ./init-scripts:/docker-entrypoint-initdb.d
    environment:
      POSTGRES_USER: myuser
      POSTGRES_PASSWORD: mypassword
      POSTGRES_DB: mydb
      POSTGRES_PORT: 5432
      POSTGRES_PARAMS: "-c max_connections=100 -c shared_buffers=256MB"  # 自定义数据库参数
    restart: unless-stopped

volumes:
  postgres-data:  # 命名卷持久化数据

配置参数（环境变量）

数据持久化

为避免容器重启或删除导致数据丢失，需通过 -v 参数将容器内 /var/lib/postgresql/data 目录挂载到宿主机目录或命名卷（推荐使用命名卷，如示例中的 postgres-data）。

注意事项

• 版本选择：镜像标签通常对应PostgreSQL版本（如 15-alpine、14-alpine），请根据应用兼容性需求选择具体版本。
• 权限管理：挂载宿主机目录时，需确保宿主机目录权限允许容器内 postgres 用户（UID 70）访问，避免权限错误。
• 生产环境安全：生产环境中应避免使用默认密码，建议通过密钥管理工具或环境变量文件安全传递敏感信息。
• 高级编排：如需主从复制、定时备份等高级功能，可参考官方GitHub仓库获取详细配置指南。