【Docker】PostgreSQL部署与配置指南

发布日期: 2025-02-28

更新日期: 2025-03-20

文章字数: 932

阅读时长: 3 分

阅读次数:

问题背景

PostgreSQL是一个功能强大的开源关系型数据库系统，以其可靠性、数据完整性和扩展性而闻名。在Docker环境中部署PostgreSQL不仅可以简化安装过程，还能提供更好的环境隔离和资源管理。本文将详细介绍如何使用Docker部署和配置PostgreSQL服务，包括单节点部署、性能优化以及常见问题的解决方案。

环境准备

在开始部署之前，请确保您的系统已经安装：

Docker Engine (版本 20.10.0 或更高)
Docker Compose (可选，用于多容器部署)

单节点部署

1. 拉取PostgreSQL镜像

# 拉取官方PostgreSQL镜像
docker pull postgres:15

2. 创建数据持久化目录

# 创建本地目录用于数据持久化
mkdir -p /data/postgresql/data
mkdir -p /data/postgresql/conf
mkdir -p /data/postgresql/logs

3. 配置PostgreSQL

创建自定义配置文件 /data/postgresql/conf/postgresql.conf：

# 基本配置
listen_addresses = '*'
max_connections = 100

# 内存配置
shared_buffers = 256MB
work_mem = 4MB
maintenance_work_mem = 64MB

# WAL配置
wal_level = replica
max_wal_size = 1GB
min_wal_size = 80MB

# 查询优化
effective_cache_size = 1GB
random_page_cost = 1.1

# 日志配置
log_destination = 'stderr'
logging_collector = on
log_directory = '/var/log/postgresql'
log_filename = 'postgresql-%Y-%m-%d_%H%M%S.log'
log_rotation_age = 1d
log_rotation_size = 10MB

4. 启动PostgreSQL容器

# 基本启动命令
docker run -d \
  --name postgresql \
  -p 5432:5432 \
  -e POSTGRES_PASSWORD=your_password \
  -e POSTGRES_USER=your_user \
  -e POSTGRES_DB=your_db \
  -v /data/postgresql/data:/var/lib/postgresql/data \
  -v /data/postgresql/conf/postgresql.conf:/etc/postgresql/postgresql.conf \
  -v /data/postgresql/logs:/var/log/postgresql \
  --restart=always \
  postgres:15 \
  -c 'config_file=/etc/postgresql/postgresql.conf'

5. 验证部署

# 检查容器状态
docker ps

# 连接到PostgreSQL
docker exec -it postgresql psql -U your_user -d your_db

性能优化

1. 内存配置优化

根据服务器可用内存调整以下参数：

# 调整共享缓冲区（建议为系统内存的25%）
shared_buffers = 2GB

# 调整工作内存（每个会话可用）
work_mem = 16MB

# 调整维护操作内存
maintenance_work_mem = 256MB

# 调整有效缓存大小（建议为系统内存的75%）
effective_cache_size = 6GB

2. 并发连接优化

# 根据服务器CPU核心数调整
max_connections = 200
max_worker_processes = 8
max_parallel_workers_per_gather = 4
max_parallel_workers = 8

3. WAL配置优化

# 调整WAL大小和检查点
max_wal_size = 2GB
checkpoint_timeout = 15min
checkpoint_completion_target = 0.9

数据备份与恢复

1. 创建数据备份

# 使用pg_dump创建数据库备份
docker exec postgresql pg_dump -U your_user -d your_db > backup.sql

# 使用pg_basebackup创建完整备份
docker exec postgresql pg_basebackup -D /backup -U your_user -P -Ft -z

2. 数据恢复

# 从SQL备份恢复
cat backup.sql | docker exec -i postgresql psql -U your_user -d your_db

# 从基础备份恢复
# 1. 停止容器
docker stop postgresql

# 2. 清空数据目录
rm -rf /data/postgresql/data/*

# 3. 解压备份文件到数据目录
tar xzf backup.tar.gz -C /data/postgresql/data

# 4. 重启容器
docker start postgresql