max_connections: сколько подключений принимает PostgreSQL
max_connections — сколько подключений PostgreSQL принимает одновременно. После установки это 100, из них 3 места база держит для администратора. Предел меняется только перезапуском базы. Прежде чем поднимать его, посмотрите, кто занял подключения: лишние места расходуют память.
Содержание 10
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Посмотрите предел и сколько подключений занято сейчас:
sudo -u postgres psql -c "SELECT count(*) AS zanyato, current_setting('max_connections') AS predel FROM pg_stat_activity WHERE backend_type = 'client backend';"- В столбце zanyato — подключения программ и людей, включая эту команду. В столбце predel — max_connections.
Если сайт уже получает ошибку sorry, too many clients already, сначала освободите места — пошагово в разборе ошибки. Эта страница — о том, как настроить предел заранее.
Сколько мест достаётся сайту
| Настройка | Что значит | По умолчанию |
|---|---|---|
max_connections | сколько подключений база принимает одновременно | 100 |
superuser_reserved_connections | сколько мест из них только для суперпользователя, например postgres | 3 |
reserved_connections | сколько мест для ролей с правами pg_use_reserved_connections | 0 |
Пользователю сайта достаётся max_connections минус оба запаса: после установки это 100 − 3 − 0 = 97. Когда свободных мест остаётся 3, войти может только суперпользователь — поэтому при нехватке подключений sudo -u postgres psql ещё работает.
Каждое подключение — отдельный процесс на сервере со своей памятью. Сложный запрос в нём может взять ещё несколько раз по work_mem — подробнее о памяти.
Кто занимает подключения
SELECT usename, datname, application_name, state, count(*)
FROM pg_stat_activity
WHERE backend_type = 'client backend'
GROUP BY usename, datname, application_name, state
ORDER BY count(*) DESC;usenameиdatname— пользователь и база.application_name— имя программы, если она его сообщает: у psql этоpsql.state—activeвыполняет запрос,idleждёт команды,idle in transactionначал транзакцию и замер.
Если сотни подключений в idle от одного пользователя, программа открывает подключения и не закрывает их. Поднимать предел в таком случае бесполезно: она займёт и новые места. Ищите, где в программе настраивается размер пула подключений.
Как поднять max_connections
- Создайте файл настроек:
sudo nano /etc/postgresql/16/main/conf.d/podklyucheniya.conf- Впишите строку с новым пределом, например
max_connections = 200. Сохраните (Ctrl+O, Enter, Ctrl+X). Ubuntu читает все файлы .conf из папки conf.d. - Перезапустите базу — без перезапуска предел не меняется:
sudo pg_ctlcluster 16 main restartПри перезапуске все подключения обрываются: делайте это, когда на сайте мало посетителей.
- Проверьте:
sudo -u postgres psql -c 'SHOW max_connections;'.
Если число не сменилось, значит, max_connections задана ещё где-то и база читает то значение позже — в postgresql.conf или через ALTER SYSTEM. Из какого файла взято значение, покажет столбец sourcefile: sudo -u postgres psql -c "SELECT setting, sourcefile, sourceline FROM pg_settings WHERE name = 'max_connections';". Подробнее — как проверить, что значение применилось.
Сколько поставить
Сложите, сколько подключений одновременно открывают все программы, которые ходят в базу:
| Что подключается | Сколько подключений |
|---|---|
| сайт на PHP-FPM, одно подключение на запрос | не больше числа процессов PHP-FPM — настройка pm.max_children |
| программа с пулом подключений: Django, Node.js, Java | размер пула в её настройках, умноженный на число запущенных копий |
| фоновые задачи, cron, очереди | по одному на каждую задачу, которая работает одновременно |
| вы сами через psql | 1–2 |
К сумме добавьте запас и 3 места администратора. Если вышло несколько сотен, лучше поставить перед базой пул подключений, например PgBouncer: он держит к базе немного подключений и раздаёт их программам по очереди.
Предел для одного пользователя или одной базы
Чтобы одна программа не заняла все места, ограничьте её пользователя:
ALTER ROLE ivan CONNECTION LIMIT 50;Или саму базу: ALTER DATABASE shop CONNECTION LIMIT 50;. Снять предел — CONNECTION LIMIT -1. Перезапуск не нужен: предел действует на новые подключения.
Посмотреть, у кого стоит предел:
SELECT rolname, rolconnlimit FROM pg_roles WHERE rolconnlimit <> -1;
SELECT datname, datconnlimit FROM pg_database WHERE datconnlimit <> -1;На суперпользователей предел CONNECTION LIMIT не действует.
Как закрывать подключения, которые висят
Подключение в состоянии idle in transaction держит место, а ещё не даёт автоочистке убрать старые строки таблиц и может держать блокировки. База закроет такие подключения сама, если задать время:
ALTER ROLE ivan SET idle_in_transaction_session_timeout = '10min';Для всех пользователей — строкой idle_in_transaction_session_timeout = 10min в conf.d/podklyucheniya.conf и командой sudo pg_ctlcluster 16 main reload. Перезапуск не нужен.
Для подключений, которые просто ждут команды вне транзакции, есть idle_session_timeout. Включайте её только для отдельных пользователей: пул подключений и программы, которые держат подключение открытым, могут не ждать, что база его закроет. По умолчанию обе настройки равны 0 — выключены.
Закрыть подключение вручную — SELECT pg_terminate_backend(pid);, где pid — номер процесса из pg_stat_activity. Пример — в разборе ошибки too many clients.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
FATAL: sorry, too many clients already | заняты все max_connections | разбор ошибки |
FATAL: remaining connection slots are reserved for roles with the SUPERUSER attribute | свободны только места администратора | войдите sudo -u postgres psql и найдите, кто занял места |
FATAL: remaining connection slots are reserved for roles with privileges of the "pg_use_reserved_connections" role | свободны только места из reserved_connections | то же: найдите, кто занял места |
FATAL: too many connections for role "ivan" | у пользователя свой предел CONNECTION LIMIT | ALTER ROLE ivan CONNECTION LIMIT -1; или найдите, кто держит его подключения |
FATAL: too many connections for database "shop" | у базы свой предел | ALTER DATABASE shop CONNECTION LIMIT -1; |
FATAL: terminating connection due to idle-in-transaction timeout | подключение закрыто по idle_in_transaction_session_timeout | программа не завершила транзакцию; ищите, где она не делает COMMIT |
база не запускается, в журнале superuser_reserved_connections (3) plus reserved_connections (…) must be less than max_connections (…) | запасы мест больше предела | поднимите max_connections или уменьшите запасы |
Всё сверено с PostgreSQL 16 — эта версия ставится в Ubuntu 24.04.
Источники
- PostgreSQL 16: Connections and Authentication — на английском: max_connections, superuser_reserved_connections, reserved_connections и значения по умолчанию.
- PostgreSQL 16: Client Connection Defaults — на английском: idle_in_transaction_session_timeout и idle_session_timeout, предупреждение о пулах подключений.
- PostgreSQL 16: ALTER ROLE — на английском: CONNECTION LIMIT и ALTER ROLE … SET.
- PostgreSQL 16: pg_database — на английском: datconnlimit, −1 — без предела.
- PostgreSQL 16: Cumulative Statistics System — на английском: pg_stat_activity, state и backend_type.
- Исходный код PostgreSQL 16: postinit.c — тексты remaining connection slots are reserved и too many connections for database.
- Исходный код PostgreSQL 16: miscinit.c — текст too many connections for role.
- Исходный код PostgreSQL 16: postgres.c — текст terminating connection due to idle-in-transaction timeout.
- Исходный код PostgreSQL 16: postmaster.c — текст sorry, too many clients already и проверка запасов мест при запуске.
Сверено 5 ноября 2026 года.
Что почитать дальше
- sorry, too many clients alreadyчто делать, если места кончились прямо сейчас.
- shared_buffers и памятьсколько памяти дать базе.
- pg_hba.confкто и откуда может подключаться.
- Настройки PostgreSQLгде лежат файлы настроек и как их перечитать.