tbeadle/postgres Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

PostgreSQL 镜像文档

镜像概述

本镜像为官方PostgreSQL镜像的分支版本，在保留核心功能基础上进行了多项优化和调整，旨在提升容器化部署中的易用性、安全性和性能。镜像源码托管于GitHub。

核心功能与特性

环境变量调整

• 使用 PGUSER、PGPASSWORD 和 PGDATABASE 替代官方镜像的 POSTGRES_USER、POSTGRES_PASSWORD 和 POSTGRES_DB。此调整允许在 docker-compose.yml 中为数据库容器定义这些变量后，其他需连接数据库的服务可直接继承这些变量，仅需设置 PGHOST 为数据库容器名称即可使用 psql 命令无需额外连接参数。

访问控制优化

• 修改 pg_hba.conf 配置，将外部访问限制为 samenet（同一网络）而非 all，确保仅部署中的其他容器可连接数据库，外部地址无法访问，提升安全性。

工具增强

• 预装 pgcli 作为 psql 命令的替代工具，提供自动补全和语法高亮功能，提升数据库操作体验。

配置优化

• 集成 Christophe Pettus 在 技术讲座 中提出的 postgresql.conf 优化建议，提升数据库性能。

备份支持

• 标签以 -barman 结尾的镜像专为 Barman 备份工具设计，适用于数据库备份场景。详细使用方法参见 GitHub 文档，尤其适合配合 tbeadle/barman 镜像 搭建 Barman 备份服务器。

使用场景

• 容器化部署中需多服务共享数据库连接配置的场景
• 需限制数据库外部访问、提升安全性的部署环境
• 需要 pgcli 增强工具进行数据库操作的开发/运维场景
• 需优化 PostgreSQL 性能参数的生产环境
• 使用 Barman 进行数据库备份的场景（对应 -barman 标签镜像）

使用方法

基本部署（docker run）

bash
docker run -d \
  --name postgres-db \
  -e PGUSER=myuser \
  -e PGPASSWORD=mypassword \
  -e PGDATABASE=mydb \
  -p 5432:5432 \
  tbeadle/postgres:latest

Docker Compose 示例

yaml
version: '3'
services:
  db:
    image: tbeadle/postgres:latest
    environment:
      - PGUSER=myuser
      - PGPASSWORD=mypassword
      - PGDATABASE=mydb
    volumes:
      - postgres-data:/var/lib/postgresql/data
    networks:
      - app-network

  app:
    image: myapp:latest
    environment:
      - PGHOST=db  # 直接使用数据库容器名称作为主机
      # 无需重复定义 PGUSER、PGPASSWORD、PGDATABASE，将从 db 服务继承
    networks:
      - app-network

networks:
  app-network:

volumes:
  postgres-data:

环境变量说明

Barman 备份镜像使用

标签以 -barman 结尾的镜像（如 tbeadle/postgres:14-barman）需配合 Barman 服务使用，具体配置和使用方法请参考 GitHub 文档。