ongres/pgbouncer

PgBouncer OCI镜像（基于UIB8 minimal）

镜像概述

本镜像为PgBouncer的OCI（开放容器倡议）标准容器镜像，基于UIB8 minimal最小化基础镜像构建。PgBouncer是一款轻量级的PostgreSQL连接池工具，主要用于管理数据库连接，减少频繁创建/销毁连接带来的性能开销，优化数据库资源利用率。

核心功能和特性

• 轻量级设计：基于UIB8 minimal最小化基础镜像，镜像体积小，资源占用低，适合资源受限环境部署
• 连接池化管理：实现PostgreSQL连接复用，降低数据库连接建立开销，提升并发处理能力
• 资源优化：有效控制数据库并发连接数，防止连接过载导致的性能下降或服务不可用
• OCI标准兼容：符合OCI镜像规范，可在Docker、containerd等主流容器运行时环境中无缝使用
• 简化部署：容器化封装减少环境依赖，支持快速启动与集成到现有容器化架构

使用场景和适用范围

• 高并发PostgreSQL环境：适用于需要处理大量客户端连接的Web应用、数据分析平台等场景
• 连接密集型应用：针对频繁建立数据库连接的应用（如微服务架构），优化连接管理效率
• 资源受限环境：边缘计算节点、轻量级服务器等资源有限场景，利用其低资源占用特性
• 容器化部署架构：作为PostgreSQL前置组件，集成到Kubernetes、Docker Compose等容器编排系统中

使用方法和配置说明

基本运行命令

通过挂载PgBouncer配置文件（pgbouncer.ini）启动容器，基础命令示例：

bash
docker run -d \
  --name pgbouncer \
  -p 6432:6432 \
  -v /host/path/to/pgbouncer.ini:/etc/pgbouncer/pgbouncer.ini \
  [镜像名称]:[标签]

注：默认暴露6432端口（PgBouncer标准端口），需根据实际配置文件调整端口映射

配置文件说明

PgBouncer的核心配置通过pgbouncer.ini文件实现，典型配置结构如下：

ini
[databases]
# 定义后端PostgreSQL数据库连接信息
mydb = host=postgres-host port=5432 dbname=mydb user=dbuser password=dbpass

[pgbouncer]
# 全局配置项
listen_addr = 0.0.0.0      # 监听地址（容器内需设置为0.0.0.0以对外提供服务）
listen_port = 6432         # 监听端口
max_connections = 100      # 最大连接数限制
auth_type = md5            # 认证方式（支持md5、trust等）
auth_file = /etc/pgbouncer/userlist.txt  # 认证用户列表文件路径
pool_mode = session        # 连接池模式（session/transaction/statement）

可根据需求调整pool_mode（会话/事务/语句级连接池）、max_connections等参数优化连接策略。

持久化配置

建议通过Docker卷（Volume）持久化PgBouncer配置，避免容器重建导致配置丢失：

bash
# 创建专用配置卷
docker volume create pgbouncer-config

# 启动容器并挂载配置卷
docker run -d \
  --name pgbouncer \
  -p 6432:6432 \
  -v pgbouncer-config:/etc/pgbouncer \
  [镜像名称]:[标签]

# 查看卷路径并管理配置文件
docker volume inspect pgbouncer-config  # 获取卷在宿主机的实际路径，编辑配置后重启容器生效

注意事项

• 需确保PgBouncer配置文件中的数据库连接信息（如host）与容器网络环境匹配（如使用Docker网络别名或服务发现）
• 生产环境建议通过环境变量或配置中心动态注入敏感信息（如数据库密码），避免硬编码
• 根据应用负载调整max_connections等参数，建议结合PostgreSQL的max_connections配置协同优化