Поиск
Справочник

max_connections: сколько подключений принимает PostgreSQL

max_connections — сколько подключений PostgreSQL принимает одновременно. После установки это 100, из них 3 места база держит для администратора. Предел меняется только перезапуском базы. Прежде чем поднимать его, посмотрите, кто занял подключения: лишние места расходуют память.

≈ 7 мин чтения
Содержание 10

Что сделать прямо сейчас

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Посмотрите предел и сколько подключений занято сейчас:
sudo -u postgres psql -c "SELECT count(*) AS zanyato, current_setting('max_connections') AS predel FROM pg_stat_activity WHERE backend_type = 'client backend';"
  1. В столбце zanyato — подключения программ и людей, включая эту команду. В столбце predel — max_connections.

Если сайт уже получает ошибку sorry, too many clients already, сначала освободите места — пошагово в разборе ошибки. Эта страница — о том, как настроить предел заранее.

Сколько мест достаётся сайту

НастройкаЧто значитПо умолчанию
max_connectionsсколько подключений база принимает одновременно100
superuser_reserved_connectionsсколько мест из них только для суперпользователя, например postgres3
reserved_connectionsсколько мест для ролей с правами pg_use_reserved_connections0

Пользователю сайта достаётся 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

  1. Создайте файл настроек:
sudo nano /etc/postgresql/16/main/conf.d/podklyucheniya.conf
  1. Впишите строку с новым пределом, например max_connections = 200. Сохраните (Ctrl+O, Enter, Ctrl+X). Ubuntu читает все файлы .conf из папки conf.d.
  2. Перезапустите базу — без перезапуска предел не меняется:
sudo pg_ctlcluster 16 main restart

При перезапуске все подключения обрываются: делайте это, когда на сайте мало посетителей.

  1. Проверьте: 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, очередипо одному на каждую задачу, которая работает одновременно
вы сами через psql1–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 LIMITALTER 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.

Источники

Сверено 5 ноября 2026 года.

Если не хочется держать базу на своём сервере. Есть облачные базы данных: MySQL, PostgreSQL или Redis без своего VPS, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Когда это выгоднее своего сервера, а когда нет, — в статье Сервер для базы данных.

Что почитать дальше