pgbouncer简化容器

镜像概述

该镜像旨在提供一个简单易用的pgbouncer容器解决方案，解决现有pgbouncer镜像普遍存在的配置复杂问题。通过极简设计，用户无需处理繁琐的初始化步骤，仅需挂载自定义的pgbouncer.ini配置文件即可快速启动服务，专注于核心功能而无需额外复杂设置。

核心功能与特性

• 极致简化：摒弃冗余配置流程，核心功能聚焦于pgbouncer服务本身
• 即插即用：仅需挂载配置文件即可运行，无需预先设置环境变量或执行初始化脚本
• 兼容性强：支持标准pgbouncer.ini配置文件格式，兼容所有pgbouncer原生配置项

使用场景与适用范围

• 快速部署pgbouncer连接池服务的开发/测试环境
• 需要简化配置流程的生产环境部署
• 对pgbouncer配置熟悉，希望避免复杂容器化配置的用户
• 轻量级连接池需求场景，无需额外扩展功能

使用方法与配置说明

前置准备

1. 准备符合pgbouncer规范的pgbouncer.ini配置文件（需包含必要的数据库连接、认证等配置）
2. 确保宿主机路径下的pgbouncer.ini具有正确的权限（容器内进程需可读该文件）

基本运行命令

通过Docker命令直接运行，使用-v参数挂载配置文件：

bash
docker run -d \
  --name simple-pgbouncer \
  -v /path/to/your/local/pgbouncer.ini:/etc/pgbouncer/pgbouncer.ini \
  [镜像名称]

参数说明

• /path/to/your/local/pgbouncer.ini：宿主机上pgbouncer.ini配置文件的绝对路径
• /etc/pgbouncer/pgbouncer.ini：容器内固定的配置文件路径，不可修改
• [镜像名称]：实际使用的Docker镜像标签

配置文件要求

容器完全依赖挂载的pgbouncer.ini进行配置，所有pgbouncer功能（如连接池设置、用户认证、日志配置等）均通过该文件定义，容器不提供默认配置或环境变量覆盖机制。配置文件需符合pgbouncer***规范，确保包含[databases]、[pgbouncer]等必要配置段。

验证运行状态

容器启动后，可通过以下命令检查服务状态：

bash
docker logs simple-pgbouncer

若配置正确，日志将显示pgbouncer启动信息及监听端口状态。