hyperized/pgbouncer

pgbouncer-docker

基于Alpine的轻量级PgBouncer Docker镜像，用于高效管理PostgreSQL数据库连接池，减少连接开销并优化数据库资源利用。

镜像概述

PgBouncer是PostgreSQL的轻量级连接池工具，本镜像基于Alpine Linux构建，具有体积小、资源占用低的特点，可快速部署并集成到PostgreSQL应用环境中，提供连接池管理、TLS加密等功能。

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，启动速度快
• 连接池管理：高效管理PostgreSQL数据库连接，减少频繁连接建立开销
• TLS支持：可配置TLS加密连接，保障数据传输安全
• 灵活配置：通过外部配置文件自定义连接池参数，适应不同场景需求

使用场景

• 需要优化PostgreSQL连接性能的应用系统
• PHP应用作为本地连接池，减少与数据库的TLS握手开销
• 高并发场景下的数据库连接资源管控
• 开发/测试环境快速部署PostgreSQL连接池服务

使用方法

拉取镜像

bash
docker pull hyperized/pgbouncer

构建镜像

从源码构建镜像：

bash
docker build -t hyperized/pgbouncer .

运行容器

基础运行方式

通过外部配置文件启动PgBouncer，需将配置文件（如example.ini）置于当前目录：

bash
docker run -v $(pwd):/m -p 6543:6543 hyperized/pgbouncer /m/example.ini

带TLS加密连接运行

用于与PostgreSQL服务器建立TLS加密连接，需确保当前目录存在TLS证书文件：ca.crt（CA证书）、key.pem（客户端私钥）、cert.pem（客户端证书），并使用TLS配置文件（如tls.ini）：

bash
docker run -v $(pwd):/m -p 6543:6543 hyperized/pgbouncer /m/tls.ini

预期输出示例：

shell
2025-04-16 19:19:36.846 UTC [1] LOG kernel file descriptor limit: 1048576 (hard: 1048576); max_client_conn: 100, max expected fd use: 152
2025-04-16 19:19:36.846 UTC [1] LOG listening on 0.0.0.0:6543
2025-04-16 19:19:36.847 UTC [1] LOG listening on unix:/tmp/.s.PGSQL.6543
2025-04-16 19:19:36.847 UTC [1] LOG process up: PgBouncer 1.24.1, libevent 2.1.12-stable (epoll), adns: c-ares 1.34.5, tls: OpenSSL 3.3.3 11 Feb 2025

连接与查看统计信息

使用psql客户端连接到PgBouncer管理接口，查看连接池统计信息：

bash
psql -h 127.0.0.1 -p 6543 pgbouncer

连接成功后执行统计命令：

sql
pgbouncer=# SHOW STATS;

参考链接

• Docker Hub: https://hub.docker.com/r/hyperized/pgbouncer
• GitHub源码: https://github.com/hyperized/pgbouncer-docker