romeoz/docker-postgresql

PostgreSQL容器镜像说明

镜像概述

本镜像基于Ubuntu 16.04/18.04 LTS，支持PostgreSQL 9.3、9.4、9.5、9.6、10及11版本，提供数据持久化、备份恢复、主从复制等核心功能，适用于开发、测试及生产环境的数据库部署。

核心功能

• 数据持久化存储
• 一键创建用户与数据库
• 支持指定 locale 的数据库创建
• 备份与恢复功能（含自动旋转）
• 主从复制（Master/Slave）
• 无 accent 搜索（Unaccent）
• 主机 UID/GID 映射
• 灵活的环境变量配置

使用场景

• 开发环境快速部署PostgreSQL数据库
• 测试环境模拟主从架构
• 生产环境数据备份与恢复
• 需要与其他容器联动的微服务架构

配置说明

安装

1. 安装Docker 1.9+
2. 拉取镜像：

bash
docker pull romeoz/docker-postgresql

或自行构建：

bash
git clone https://github.com/romeoz/docker-postgresql.git
cd docker-postgresql
docker build -t="$USER/postgresql" .

快速启动

bash
docker run --name postgresql -d -p 5432:5432 romeoz/docker-postgresql

登录数据库：

bash
docker exec -it postgresql sudo -u postgres psql

持久化

bash
mkdir -p /host/path/data
sudo chcon -Rt svirt_sandbox_file_t /host/path/data
docker run --name postgresql -d \
  -v /host/path/data:/var/lib/postgresql romeoz/docker-postgresql

创建用户与数据库

bash
docker run --name postgresql -d \
  -e 'DB_USER=dbuser' -e 'DB_PASS=dbpass' -e 'DB_NAME=dbname' \
  romeoz/docker-postgresql

主从复制

创建主节点：

bash
docker network create pg_net
docker run --name='psql-master' -d \
  --net pg_net \
  -e 'PG_MODE=master' -e 'PG_TRUST_LOCALNET=true' \
  -e 'REPLICATION_USER=replicator' -e 'REPLICATION_PASS=replicatorpass' \
  romeoz/docker-postgresql

创建从节点：

bash
docker run --name='psql-slave' -d \
  --net pg_net \
  -e 'PG_MODE=slave' -e 'PG_TRUST_LOCALNET=true' \
  -e 'REPLICATION_HOST=psql-master' -e 'REPLICATION_USER=replicator' -e 'REPLICATION_PASS=replicatorpass' \
  romeoz/docker-postgresql

环境变量

• PG_USER: 管理员用户名（默认postgres）
• PG_MODE: 运行模式（master/slave/backup）
• DB_NAME: 数据库名称（支持逗号分隔多个）
• DB_USER: 数据库用户
• DB_PASS: 用户密码
• PG_TRUST_LOCALNET: 信任同网络连接（默认false）

日志管理

查看日志：

bash
docker logs postgresql

日志分割：

bash
docker logs postgresql > stdout.log 2>stderr.log

许可证

本镜像基于MIT许可证开源。 ===END===