abakpress/postgres-db

PostgreSQL Docker镜像文档

镜像概述

本镜像为PostgreSQL数据库提供容器化部署方案，基于官方PostgreSQL构建，旨在简化PostgreSQL数据库的安装、配置和运行流程。通过Docker容器化技术，可快速搭建独立的PostgreSQL数据库环境，适用于开发、测试及小型生产场景。

核心功能与特性

• 多版本支持：提供多种PostgreSQL版本（如12、13、14等），满足不同应用兼容性需求。
• 数据持久化：支持通过Docker数据卷（Volume）或绑定挂载（Bind Mount）实现数据持久化，避免容器重启导致数据丢失。
• 环境变量配置：通过环境变量快速配置数据库参数，如管理员密码、默认数据库名、用户名等。
• 网络隔离：容器化部署确保数据库环境与主机系统隔离，提高安全性。
• 轻量级部署：镜像体积优化，启动快速，资源占用低。

使用场景与适用范围

• 开发环境：为开发人员提供独立、一致的数据库环境，避免本地环境差异。
• 测试环境：快速创建临时数据库实例，支持自动化测试和集成测试。
• 小型生产环境：适用于数据量较小、访问压力适中的应用场景，如个人项目、小型企业应用等。
• CI/CD流程：作为持续集成/持续部署流程中的数据库服务组件，支持自动化构建和测试。

使用方法与配置说明

基本使用（docker run）

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

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

参数说明：

• --name postgres-db：指定容器名称为postgres-db。
• -e POSTGRES_PASSWORD=mysecretpassword：设置数据库管理员密码（必填）。
• -p 5432:5432：将容器内5432端口映射到主机5432端口，允许外部访问。
• -d：后台运行容器。
• postgres：镜像名称（默认使用最新版本，如需指定版本可使用postgres:14等）。

数据持久化配置

为避免容器删除导致数据丢失，需配置数据持久化：

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

其中-v postgres-data:/var/lib/postgresql/data表示创建名为postgres-data的Docker数据卷，并挂载到容器内PostgreSQL数据目录（/var/lib/postgresql/data）。

docker-compose配置示例

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

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

volumes:
  postgres-data:

通过docker-compose up -d启动服务，docker-compose down停止服务（数据卷不会被删除）。

环境变量说明

连接数据库

容器启动后，可通过以下方式连接数据库：

• 本地连接（容器内）：

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

• 外部工具连接：使用数据库客户端（如pgAdmin、DBeaver）连接localhost:5432，用户名/密码为配置的POSTGRES_USER（默认postgres）和POSTGRES_PASSWORD。