Документация PgBouncer 1.25.2 on PIG.CENTER

Возможности

Mon, 01 Jan 0001 00:00:00 +0000

Несколько уровней строгости при перераспределении соединений:

Сеансовый режим пула

Наиболее щадящий метод. При подключении клиента ему назначается серверное соединение на всё время клиентского соединения. После отключения клиента серверное соединение возвращается в пул. Этот режим поддерживает все возможности PostgreSQL.

Транзакционный режим пула

Серверное соединение назначается клиенту только на время транзакции. Когда PgBouncer определяет завершение транзакции, серверное соединение возвращается в пул. Этот режим нарушает работу некоторых сеансовых возможностей PostgreSQL. Его можно использовать, только если приложение не применяет несовместимые возможности. Они перечислены в таблице ниже.

Режим пула на уровне операторов

Наиболее строгий метод. Это транзакционный режим пула с дополнительным ограничением: транзакции из нескольких операторов запрещены. Такой режим принудительно обеспечивает клиентский режим «autocommit» и в основном предназначен для PL/Proxy.
Низкое потребление памяти (по умолчанию 2 kB на соединение), поскольку PgBouncer не требуется получать пакеты целиком.

Конфигурация: pgbouncer.ini

Mon, 01 Jan 0001 00:00:00 +0000

Описание

Файл конфигурации имеет формат «ini». Имена секций заключаются между [ и ]. Строки, начинающиеся с ; или #, считаются комментариями и игнорируются. Символы ; и # не имеют специального значения в других позициях строки.

Общие параметры

logfile

Задаёт файл журнала. Для демонизации (-d) обязательно задать этот параметр или syslog.

Файл журнала остаётся открытым, поэтому после ротации следует выполнить kill -HUP или RELOAD; в консоли. В Windows службу необходимо остановить и запустить.

Использование команды pgbouncer

Mon, 01 Jan 0001 00:00:00 +0000

Синтаксис

pgbouncer [-d][-R][-v][-u user] <pgbouncer.ini>
pgbouncer -V|-h

Параметры для Windows:

pgbouncer.exe [-v][-u user] <pgbouncer.ini>
pgbouncer.exe -V|-h

Дополнительные параметры для настройки службы Windows:

pgbouncer.exe --regservice <pgbouncer.ini>
pgbouncer.exe --unregservice <pgbouncer.ini>

Описание

PgBouncer — менеджер пула соединений PostgreSQL. Любое клиентское приложение может подключаться к PgBouncer как к серверу PostgreSQL, а PgBouncer создаст соединение с настоящим сервером либо повторно использует одно из существующих соединений.

Компиляция и установка PgBouncer

Mon, 01 Jan 0001 00:00:00 +0000

Сборка

Для компиляции PgBouncer требуется несколько компонентов:

GNU Make 3.81+
Libevent 2.0+
pkg-config
OpenSSL 1.0.1+ для поддержки TLS
(необязательно) c-ares как альтернатива evdns из Libevent
(необязательно) библиотеки LDAP
(необязательно) библиотеки PAM

После установки зависимостей выполните:

$ ./configure --prefix=/usr/local
$ make
$ make install

Для сборки из Git или под Windows используйте отдельные инструкции ниже.

Поддержка поиска DNS

PgBouncer разрешает имена узлов при установке соединения, а не только один раз при загрузке конфигурации. Для этого нужна асинхронная реализация DNS. В таблице перечислены поддерживаемые бэкенды в порядке их проверки:

Загрузка исходных выпусков

Mon, 01 Jan 0001 00:00:00 +0000

PgBouncer 1.25

Файл	Дата	Размер	SHA256
pgbouncer-1.25.2.tar.gz	2026-05-08	865371 bytes	sha256
pgbouncer-1.25.1.tar.gz	2025-12-03	864801 bytes	sha256
pgbouncer-1.25.0.tar.gz	2025-11-09	863322 bytes	sha256

PgBouncer 1.24

Файл	Дата	Размер	SHA256
pgbouncer-1.24.1.tar.gz	2025-04-16	717796 bytes	sha256
pgbouncer-1.24.0.tar.gz	2025-01-10	706573 bytes	sha256

PgBouncer 1.23

Файл	Дата	Размер	SHA256
pgbouncer-1.23.1.tar.gz	2024-08-02	700025 bytes	sha256
pgbouncer-1.23.0.tar.gz	2024-07-03	694845 bytes	sha256

PgBouncer 1.22

Файл	Дата	Размер	SHA256
pgbouncer-1.22.1.tar.gz	2024-03-04	677351 bytes	sha256
pgbouncer-1.22.0.tar.gz	2024-01-31	670589 bytes	sha256

PgBouncer 1.21

Файл	Дата	Размер	SHA256
pgbouncer-1.21.0.tar.gz	2023-10-16	668211 bytes	sha256

PgBouncer 1.20

Файл	Дата	Размер	SHA256
pgbouncer-1.20.1.tar.gz	2023-08-09	638844 bytes	sha256
pgbouncer-1.20.0.tar.gz	2023-07-20	638020 bytes	sha256

PgBouncer 1.19

Файл	Дата	Размер	SHA256
pgbouncer-1.19.1.tar.gz	2023-05-31	623569 bytes	sha256
pgbouncer-1.19.0.tar.gz	2023-05-04	616947 bytes	sha256

PgBouncer 1.18

Файл	Дата	Размер	SHA256
pgbouncer-1.18.0.tar.gz	2022-12-12	600825 bytes	sha256

PgBouncer 1.17

Файл	Дата	Размер	SHA256
pgbouncer-1.17.0.tar.gz	2022-03-23	598294 bytes	sha256

PgBouncer 1.16

Файл	Дата	Размер	SHA256
pgbouncer-1.16.1.tar.gz	2021-11-11	591450 bytes	sha256
pgbouncer-1.16.0.tar.gz	2021-08-09	592136 bytes	sha256

PgBouncer 1.15

Файл	Дата	Размер	SHA256
pgbouncer-1.15.0.tar.gz	2020-11-19	588042 bytes	sha256

PgBouncer 1.14

Файл	Дата	Размер	SHA256
pgbouncer-1.14.0.tar.gz	2020-06-11	578955 bytes	sha256

PgBouncer 1.13

Файл	Дата	Размер	SHA256
pgbouncer-1.13.0.tar.gz	2020-04-27	574955 bytes	sha256

PgBouncer 1.12

Файл	Дата	Размер	SHA256
pgbouncer-1.12.0.tar.gz	2019-10-17	567465 bytes	sha256

PgBouncer 1.11

Файл	Дата	Размер	SHA256
pgbouncer-1.11.0.tar.gz	2019-08-27	571414 bytes	sha256

PgBouncer 1.10

Файл	Дата	Размер	SHA256
pgbouncer-1.10.0.tar.gz	2019-07-01	480571 bytes	sha256

PgBouncer 1.9

Файл	Дата	Размер	SHA256
pgbouncer-1.9.0.tar.gz	2018-08-13	469300 bytes	sha256

PgBouncer 1.8

Файл	Дата	Размер	SHA256
pgbouncer-1.8.1.tar.gz	2017-12-20	465930 bytes	sha256
pgbouncer-1.8.tar.gz	2017-12-19	465612 bytes	sha256

PgBouncer 1.7

Файл	Дата	Размер	SHA256
pgbouncer-1.7.2.tar.gz	2016-02-26	462374 bytes	sha256
pgbouncer-1.7.1.tar.gz	2016-02-18	461903 bytes	sha256
pgbouncer-1.7.tar.gz	2015-12-18	459080 bytes	sha256

PgBouncer 1.6

Файл	Дата	Размер	SHA256
pgbouncer-1.6.1.tar.gz	2015-09-03	431076 bytes	sha256
pgbouncer-1.6.tar.gz	2015-08-01	412700 bytes	sha256

PgBouncer 1.5

Файл	Дата	Размер	SHA256
pgbouncer-1.5.5.tar.gz	2015-04-09	336145 bytes	sha256
pgbouncer-1.5.4.tar.gz	2012-11-28	339610 bytes	sha256
pgbouncer-1.5.3.tar.gz	2012-09-12	339013 bytes	sha256
pgbouncer-1.5.2.tar.gz	2012-05-29	335338 bytes	sha256
pgbouncer-1.5.1.tar.gz	2012-04-17	334413 bytes	sha256
pgbouncer-1.5.tar.gz	2012-01-05	411488 bytes	sha256

PgBouncer 1.4

Файл	Дата	Размер	SHA256
pgbouncer-1.4.2.tgz	2011-06-16	283204 bytes	sha256
pgbouncer-1.4.1.tgz	2011-04-01	282728 bytes	sha256
pgbouncer-1.4.tgz	2011-01-11	231691 bytes	sha256

PgBouncer 1.3

Файл	Дата	Размер	SHA256
pgbouncer-1.3.4.tgz	2010-09-09	167957 bytes	sha256
pgbouncer-1.3.3.tgz	2010-05-10	167476 bytes	sha256
pgbouncer-1.3.2.tgz	2010-03-15	166756 bytes	sha256
pgbouncer-1.3.1.tgz	2009-07-06	161518 bytes	sha256
pgbouncer-1.3.tgz	2009-02-18	160154 bytes	sha256

PgBouncer 1.2

Файл	Дата	Размер	SHA256
pgbouncer-1.2.3.tgz	2008-08-08	145372 bytes	sha256
pgbouncer-1.2.2.tgz	2008-08-06	145017 bytes	sha256
pgbouncer-1.2.1.tgz	2008-08-04	144903 bytes	sha256
pgbouncer-1.2.tgz	2008-07-29	143915 bytes	sha256

PgBouncer 1.1

Файл	Дата	Размер	SHA256
pgbouncer-1.1.2.tgz	2007-12-10	122054 bytes	sha256
pgbouncer-1.1.1.tgz	2007-10-26	121042 bytes	sha256
pgbouncer-1.1.tgz	2007-10-09	120462 bytes	sha256

PgBouncer 1.0

Файл	Дата	Размер	SHA256
pgbouncer-1.0.8.tgz	2007-06-18	93636 bytes	sha256
pgbouncer-1.0.7.tgz	2007-04-19	93086 bytes	sha256
pgbouncer-1.0.6.tgz	2007-04-12	92244 bytes	sha256
pgbouncer-1.0.5.tgz	2007-04-11	91934 bytes	sha256
pgbouncer-1.0.4.tgz	2007-04-11	91889 bytes	sha256
pgbouncer-1.0.3.tgz	2007-04-11	91489 bytes	sha256
pgbouncer-1.0.2.tgz	2007-03-28	90555 bytes	sha256
pgbouncer-1.0.1.tgz	2007-03-15	89609 bytes	sha256
pgbouncer-1.0.tgz	2007-03-13	88587 bytes	sha256

Двоичные пакеты

В различных дистрибутивах операционных систем имеются собственные пакеты или порты PgBouncer. Поэтому сначала следует проверить, доступен ли PgBouncer в вашей системе.

Журнал изменений

Mon, 01 Jan 0001 00:00:00 +0000

PgBouncer 1.25.x

2026-05-08 - PgBouncer 1.25.2 - «Человеческое прикосновение и новый поворот в полной неопределённости борьбе за титул»

Безопасность
- Исправлена CVE-2026-6664: целочисленное переполнение в коде разбора сетевых пакетов в PgBouncer до 1.25.2 позволяло обойти проверку границ и могло привести к аварийному завершению. Неаутентифицированный удалённый злоумышленник мог вывести PgBouncer из строя некорректным пакетом аутентификации SCRAM.
- Исправлена CVE-2026-6665: код SCRAM в PgBouncer до 1.25.2 неверно проверял возвращаемое значение strlcat() при построении содержимого SCRAM client-final-message. Злонамеренный бэкенд, отправивший SCRAM server-final-message с длинным nonce, мог вызвать переполнение стека.
- Исправлена CVE-2026-6666: возможное обращение по нулевому указателю в PgBouncer до 1.25.2 могло привести к аварийному завершению, если сервер отправлял ответ об ошибке без поля SQLSTATE.
- Исправлена CVE-2026-6667: PgBouncer до 1.25.2 не выполнял надлежащую проверку авторизации для административной команды KILL_CLIENT. Её могли выполнять все пользователи с доступом к административной консоли, хотя сама консоль требует авторизации. Команда должна быть разрешена только пользователям, перечисленным в параметре admin_users.
Исправления

Сообщество

Mon, 01 Jan 0001 00:00:00 +0000

Учебные материалы

Настройка PgBouncer для Postgres Plus Standard Server

Хороший обзор основных понятий PgBouncer.
Зачем нужен PgBouncer?

Рассматривает различия между режимами пула.

Поддержка

Часто задаваемые вопросы

Mon, 01 Jan 0001 00:00:00 +0000

Как подключиться к PgBouncer?

PgBouncer работает как сервер Postgres, поэтому достаточно направить клиент на порт PgBouncer.

Как распределять запросы между несколькими серверами?

PgBouncer не имеет встроенной конфигурации для нескольких узлов. Распределение можно реализовать внешними средствами:

Циклический перебор DNS. Укажите несколько IP-адресов для одного имени DNS. PgBouncer не выполняет поиск DNS при каждом новом соединении: он кэширует все IP-адреса и перебирает их циклически. Обратите внимание: если с одним именем связано более 8 IP-адресов, бэкенд DNS должен поддерживать протокол EDNS0. Подробности приведены в README.