gjrtimmer/postgresql

PostgreSQL

可配置的PostgreSQL服务器，支持备份、快照、备用节点、热备用、SSL/TLS等功能，通过环境变量实现简化配置。包含快速入门示例，源码托管于GitHub：https://github.com/gjrtimmer/docker-postgresql%E3%80%82

目录

• 快速开始
• PostgreSQL版本
• 核心功能
• 环境变量
• 时区配置
• 文件权限
• 持久化存储
• 自定义容器初始化
• 自定义服务
• 创建数据库
• 数据库初始化
• 启用扩展
• 创建备份
• 创建快照
• 创建备用服务器
• 自动故障转移/集群管理

快速开始

bash
docker run --detach -p 5432:5432 gjrtimmer/postgresql:latest

PostgreSQL版本

当前支持以下PostgreSQL版本：

• 9 (gjrtimmer/postgresql:9)
• 10 (gjrtimmer/postgresql:10)
• 11 (gjrtimmer/postgresql:11)
• 12 (gjrtimmer/postgresql:12)
• 13 (gjrtimmer/postgresql:13)
• 14 (gjrtimmer/postgresql:14)
• 15 (gjrtimmer/postgresql:15) (最新版)

容器基于LinuxServer的Alpine Linux构建。

核心功能

以下是主要功能，完整功能请参考完整文档：

环境变量

完整的功能/环境变量列表请参考：环境变量

时区配置

设置容器时区，默认值为UTC。通过TZ变量指定时区，需使用时区数据库格式。

示例：TZ=Europe/Amsterdam

文件权限

容器基于LinuxServer的Alpine Linux构建，支持PUID和PGID变量。

使用PUID和PGID可将容器内部用户映射到主机用户。所有容器均采用此用户映射方式，应正确配置。 更多信息：linuxserver: 理解PUID/PGID

持久化存储

默认所有数据存储在/config挂载点。需将/config映射到卷或主机目录以实现持久化存储。部分存储位置可通过环境变量配置，完整列表见环境变量。

自定义容器初始化

基于linuxserver.io的Alpine基础镜像，可通过/config/custom-cont-init.d目录提供自定义初始化脚本。

自定义服务

基于linuxserver.io的Alpine基础镜像，可通过/config/custom-services.d目录提供自定义服务。

创建数据库

启动容器时通过DB_NAME变量创建PostgreSQL数据库。

示例：DB_NAME=dbname

默认通过复制系统数据库template1创建数据库，可通过DB_TEMPLATE参数指定其他模板（参考模板数据库）。

支持创建多个数据库，使用逗号分隔数据库名：

示例：DB_NAME=dbname1,dbname2（创建dbname1和dbname2两个数据库）

数据库初始化

支持多数据库初始化，可通过PG_INIT_DB_DIR（/config/initdb.d）目录提供SQL文件，文件命名格式为<ID>-<DB_NAME>-<附加名称>.sql，其中ID用于指定加载顺序。

可用于全局配置或特定数据库初始化。例如：

bash
PG_USER=postgres
PG_PASS=********
DB_USER=maintenance
DB_PASS=********
DB_NAME=orders,customers

上述配置创建orders和customers数据库，用户maintenance拥有访问权限。可放置如下SQL文件：

bash
5-postgres-create-users.sql
10-orders-init.sql
10-orders-create-users.sql
10-customers-init.sql
10-customers-create-users.sql

也可为主数据库postgres提供初始化脚本，只需在文件名中包含postgres。

启用扩展

通过DB_EXTENSION环境变量启用扩展，多个扩展用逗号分隔。扩展将为DB_NAME创建的所有数据库启用。

容器预装postgres contrib模块，扩展列表见扩展概述。

创建备份

创建PostgreSQL服务器备份需主节点允许复制连接且有可用WAL发送器，支持非本镜像的PostgreSQL服务器备份。

备份通过pg_basebackup生成

要求：

• 主节点WAL级别为replica或logical
• 主节点有可用WAL发送器
• 主节点存在复制用户

备份容器需配置REPLICATION_*变量：

• REPLICATION_MODE=backup（必填）
• REPLICATION_*（必填）
• PG_BACKUP_*（可选）

使用示例：examples/backup

创建快照

快照功能可连接主节点克隆数据库并独立运行。与备用节点的区别：备用节点为只读且持续同步主节点数据（流复制），快照为可读写且克隆后不再同步主节点更新。适用于开发者快速克隆生产数据库进行本地开发/调试。

快照通过pg_basebackup生成

快照容器需配置REPLICATION_*变量：

• REPLICATION_MODE=snapshot（必填）
• REPLICATION_*（必填）
• PG_SNAPSHOT_*（可选）

使用示例：examples/snapshot

创建备用服务器

备用服务器配置中，主节点处理读写操作，数据复制到备用节点。支持热备用服务器（允许只读查询）。

备用容器需配置REPLICATION_*变量：

• REPLICATION_MODE=standby（必填）
• REPLICATION_*（必填）
• PG_STANDBY_*（可选）

配置PG_STANDBY_HOT变量启用热备用。

使用示例：examples/master-standby

自动故障转移/集群管理

镜像集成repmgr作为集群管理器，支持自动集群编排与故障转移。

重要

尽管repmgr可用于生产环境，但镜像中的实现尚未完全测试。部分依赖（如SSH访问）仍在开发中。 请自行评估风险使用。

通过REPMGR=enabled启用repmgr，配置选项见REPMGR配置。