PostgreSQL作为常用的关系型数据库，在高并发业务场景中，每次请求都新建数据库连接会消耗大量CPU和内存资源，还可能导致连接数耗尽的问题。Pgbouncer是一款轻量级的PostgreSQL连接池中间件，它可以在客户端和数据库之间维护一组可复用的连接，减少连接创建销毁的开销，提升数据库服务的整体性能。
Pgbouncer的核心作用
Pgbouncer主要解决的是PostgreSQL连接管理的问题，它的核心功能包括以下几点：
- 复用数据库连接，避免频繁创建销毁连接带来的性能损耗
- 限制同时连接到数据库的客户端数量，防止连接数过载
- 支持多种连接池模式，适配不同的业务场景需求
- 资源占用极低，本身对服务器性能的影响非常小
Pgbouncer的安装步骤
不同系统的安装方式略有差异，以下是常见系统的安装方法：
Ubuntu/Debian系统安装
可以直接通过系统包管理器安装：
# 更新软件源 sudo apt update # 安装pgbouncer sudo apt install pgbouncer -y
CentOS/RHEL系统安装
需要先添加对应的软件源再安装：
# 添加PostgreSQL官方源 sudo yum install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-7-x86_64/pgdg-redhat-repo-latest.noarch.rpm # 安装pgbouncer sudo yum install -y pgbouncer
源码编译安装
如果需要指定版本，可以选择源码编译安装：
# 下载源码包，这里以1.21.0版本为例 wget https://www.pgbouncer.org/downloads/files/1.21.0/pgbouncer-1.21.0.tar.gz # 解压 tar -zxvf pgbouncer-1.21.0.tar.gz cd pgbouncer-1.21.0 # 编译安装 ./configure --prefix=/usr/local/pgbouncer make sudo make install
Pgbouncer的连接池模式
Pgbouncer支持三种不同的连接池模式，需要根据业务场景选择合适的模式：
| 模式名称 | 说明 | 适用场景 |
|---|---|---|
| session | 客户端连接Pgbouncer的整个会话期间，分配一个固定的数据库连接，会话结束才释放连接 | 需要保持会话状态的操作，比如开启了事务、临时表、会话级变量的场景 |
| transaction | 仅在事务执行期间分配数据库连接，事务提交或回滚后就释放连接 | 大部分无会话状态依赖的业务场景，是默认推荐的模式 |
| statement | 每次执行完一条SQL语句就释放连接，不支持跨语句的事务 | 无事务需求的简单查询场景，使用较少 |
Pgbouncer的配置说明
Pgbouncer的配置文件默认路径为/etc/pgbouncer/pgbouncer.ini，核心配置项如下：
[databases] # 配置数据库映射，格式为：别名 = host=数据库地址 port=端口 dbname=数据库名 mydb = host=127.0.0.1 port=5432 dbname=test_db [pgbouncer] # 监听地址，0.0.0.0表示监听所有网卡 listen_addr = 0.0.0.0 # 监听端口，默认6432 listen_port = 6432 # 连接池模式，可选session、transaction、statement pool_mode = transaction # 最大客户端连接数 max_client_conn = 1000 # 每个数据库的最大服务端连接数 default_pool_size = 20 # 认证方式，md5表示使用md5密码认证 auth_type = md5 # 认证文件路径，存放数据库用户密码信息 auth_file = /etc/pgbouncer/userlist.txt # 日志文件路径 logfile = /var/log/pgbouncer/pgbouncer.log # pid文件路径 pidfile = /var/run/pgbouncer/pgbouncer.pid # 管理员用户名 admin_users = postgres
其中userlist.txt文件需要存放数据库用户的认证信息，格式如下：
"postgres" "md5加密后的密码"
可以通过PostgreSQL的pg_md5工具生成加密密码：
# 生成用户postgres密码123456的md5加密串 pg_md5 -u postgres 123456
Pgbouncer的启动与管理
配置完成后可以通过以下命令管理Pgbouncer服务：
系统服务方式管理
# 启动服务 sudo systemctl start pgbouncer # 设置开机自启 sudo systemctl enable pgbouncer # 查看服务状态 sudo systemctl status pgbouncer # 停止服务 sudo systemctl stop pgbouncer
手动启动方式
如果是源码编译安装，没有系统服务的话可以手动启动：
# 启动pgbouncer，指定配置文件路径 /usr/local/pgbouncer/bin/pgbouncer -d /etc/pgbouncer/pgbouncer.ini
客户端连接验证
配置完成后，客户端不需要直接连接PostgreSQL的5432端口，而是连接Pgbouncer的6432端口，连接方式和直连数据库一致：
# 使用psql连接pgbouncer代理的数据库 psql -h 127.0.0.1 -p 6432 -U postgres -d mydb
连接成功后可以执行正常SQL操作，Pgbouncer会自动管理后端的数据库连接。
常用管理命令
Pgbouncer内置了管理控制台，可以通过连接到Pgbouncer的虚拟数据库pgbouncer执行管理命令：
# 连接管理控制台 psql -h 127.0.0.1 -p 6432 -U postgres -d pgbouncer
常用管理命令如下：
SHOW STATS;查看连接池的统计信息SHOW POOLS;查看当前连接池的状态SHOW CLIENTS;查看当前连接的客户端信息RELOAD;重新加载配置文件，不需要重启服务PAUSE mydb;暂停指定数据库的连接池，等待现有连接处理完成RESUME mydb;恢复指定数据库的连接池
注意事项
- 如果业务需要用到PostgreSQL的会话级特性，比如临时表、会话级变量，需要将连接池模式设置为session，否则会出现功能异常
- default_pool_size的大小需要根据数据库的承载能力设置，过大会导致数据库压力过大，过小则无法发挥连接池的作用
- 修改配置文件后可以通过RELOAD命令热加载，不需要重启Pgbouncer服务，避免影响现有业务
- 生产环境建议给Pgbouncer配置监控，关注连接数、请求延迟等指标，及时发现异常
PostgreSQLPgbouncer连接池pgbouncer配置修改时间：2026-07-22 18:21:33