wmarinho/postgresql

docker-postgresql 镜像文档

镜像概述

docker-postgresql是一个封装了PostgreSQL数据库的Docker镜像，旨在简化PostgreSQL的部署和管理流程。通过容器化方式，用户可快速搭建独立的PostgreSQL数据库环境，无需手动配置系统依赖，支持跨平台运行，适用于各类开发、测试及小型生产场景。

核心功能与特性

• 版本支持：提供多种PostgreSQL版本（如12、13、14等），满足不同应用兼容性需求。
• 数据持久化：支持通过Docker数据卷（Volume）挂载，确保数据库数据在容器重启后不丢失。
• 环境变量配置：通过环境变量快速设置数据库用户、密码、默认数据库名等核心参数。
• 初始化脚本：支持在容器启动时执行自定义SQL脚本，实现数据库初始化（如创建表、插入初始数据等）。
• 网络隔离：可通过Docker网络配置实现数据库服务的访问控制和隔离。

使用场景

• 开发环境：为本地开发提供独立、干净的PostgreSQL环境，避免与系统全局数据库冲突。
• 测试环境：快速部署临时数据库实例，用于自动化测试或功能验证。
• 小型生产环境：适用于数据量较小、访问压力适中的应用，配合数据卷和备份策略保障数据安全。

使用方法

基本部署（docker run）

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

bash
docker run -d \
  --name postgres-db \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_DB=mydb \
  -p 5432:5432 \
  -v postgres-data:/var/lib/postgresql/data \
  docker.xuanyuan.run/postgres:latest

参数说明：

• -d：后台运行容器。
• --name postgres-db：指定容器名称为postgres-db。
• -e POSTGRES_PASSWORD：设置数据库超级用户密码（必填）。
• -e POSTGRES_USER：指定数据库用户名（默认：postgres）。
• -e POSTGRES_DB：指定默认创建的数据库名（默认与POSTGRES_USER同名）。
• -p 5432:5432：映射容器内5432端口到主机5432端口，允许外部访问。
• -v postgres-data:/var/lib/postgresql/data：挂载数据卷postgres-data到容器内数据目录，实现数据持久化。

Docker Compose配置

创建docker-compose.yml文件，定义服务配置：

yaml
version: '3'
services:
  postgres:
    image: docker.xuanyuan.run/postgres:latest
    container_name: postgres-db
    environment:
      POSTGRES_PASSWORD: mysecretpassword
      POSTGRES_USER: myuser
      POSTGRES_DB: mydb
    ports:
      - "5432:5432"
    volumes:
      - postgres-data:/var/lib/postgresql/data
      - ./init-scripts:/docker-entrypoint-initdb.d  # 挂载初始化脚本目录
    restart: unless-stopped

volumes:
  postgres-data:  # 声明数据卷，自动创建

启动服务：

bash
docker-compose up -d

环境变量说明

初始化脚本

容器启动时，会自动执行/docker-entrypoint-initdb.d目录下的.sql、.sql.gz或.sh文件。可通过挂载本地脚本目录实现数据库初始化：

bash
docker run -d \
  --name postgres-db \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -v postgres-data:/var/lib/postgresql/data \
  -v ./init-scripts:/docker-entrypoint-initdb.d \  # 本地脚本目录挂载
  postgres:latest

连接数据库

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

bash
docker exec -it postgres-db psql -U myuser -d mydb

或通过主机端口远程连接（需开放端口）：

bash
psql -h localhost -p 5432 -U myuser -d mydb

注意事项

• 数据备份：定期备份数据卷（postgres-data），避免数据丢失。
• 安全配置：生产环境中避免直接暴露数据库端口到公网，可通过Docker网络或反向代理限制访问。
• 版本选择：根据应用需求指定具体PostgreSQL版本（如postgres:14），避免因版本更新导致兼容性问题。