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

Настройки PostgreSQL: какой файл править и как применить

В Ubuntu настройки PostgreSQL лежат в папке /etc/postgresql/16/main/: основные — в postgresql.conf, правила входа — в pg_hba.conf. Одни настройки начинают действовать после команды «перечитать настройки», другие — только после перезапуска базы.

≈ 9 мин чтения
Содержание 11

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

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Узнайте версию базы: pg_lsclusters. В столбце Ver — номер версии, в столбце Cluster — имя кластера, после установки это main. Дальше в примерах — 16 и main: подставьте свои.
  3. Откройте файл настроек: sudo nano /etc/postgresql/16/main/postgresql.conf. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter.
  4. Найдите нужную строку: нажмите Ctrl+W, напечатайте имя настройки и нажмите Enter. Если строка начинается со знака #, уберите # и впишите своё значение.
  5. Сохраните файл: Ctrl+O, Enter, затем Ctrl+X.
  6. Примените настройку. Для shared_buffers, max_connections, listen_addresses и port нужен перезапуск: sudo systemctl restart postgresql. Для остальных хватит перечитать настройки: sudo pg_ctlcluster 16 main reload. Какой случай у вашей настройки — ниже.
  7. Проверьте, что значение действует: sudo -u postgres psql -c "SHOW max_connections;". Вместо max_connections — имя своей настройки.
  8. Проверьте, что база работает: pg_lsclusters. В строке кластера должно быть слово online.

Если в строке кластера down, база не запустилась: верните строку как было, снова выполните sudo systemctl restart postgresql и посмотрите причину в журнале: журнал PostgreSQL.

Где какие файлы

ЧтоГде лежит
основные настройки/etc/postgresql/16/main/postgresql.conf
кто и как может подключаться/etc/postgresql/16/main/pg_hba.conf — разбор файла
соответствие пользователей системы и базы/etc/postgresql/16/main/pg_ident.conf
дополнительные файлы настроекпапка /etc/postgresql/16/main/conf.d/
что записала команда ALTER SYSTEM/var/lib/postgresql/16/main/postgresql.auto.conf
данные базпапка /var/lib/postgresql/16/main/
журнал/var/log/postgresql/postgresql-16-main.log

16 в путях — версия PostgreSQL, main — имя кластера. В Ubuntu 24.04 ставится PostgreSQL 16, в Ubuntu 26.04 — PostgreSQL 18: там вместо 16 подставьте 18. Как поставить базу — Как установить PostgreSQL на Ubuntu.

Кластер — это один работающий сервер базы со своими настройками и папкой данных. После установки кластер один, и сайт работает с ним.

Где база берёт файл настроек прямо сейчас, покажет команда:

sudo -u postgres psql -c "SHOW config_file;"
               config_file
-----------------------------------------
 /etc/postgresql/16/main/postgresql.conf
(1 row)

Как устроен файл

# строка со знаком решётки не действует
max_connections = 100
shared_buffers = 128MB
#work_mem = 4MB
listen_addresses = 'localhost'
  • Одна строка — одна настройка: имя, знак = и значение.
  • Всё, что стоит после знака #, база не читает. Строка #work_mem = 4MB — подсказка из пакета: пока перед ней стоит #, действует значение по умолчанию.
  • Текст и адреса пишут в одинарных кавычках: 'localhost'. Числа и слова on и off — без кавычек.
  • Размер памяти пишут с буквами: kB — килобайты, MB — мегабайты, GB — гигабайты. Буквы пишут как здесь: mb или Gb база не поймёт.
  • Время пишут так же: ms — миллисекунды, s — секунды, min — минуты.
  • Если одна настройка записана несколько раз, действует последняя строка.

Ubuntu добавляет в этот файл строку include_dir = 'conf.d': база читает и все файлы с окончанием .conf из папки conf.d, по порядку имён. Если настройка в postgresql.conf не меняется, проверьте, не записана ли она в этой папке — как найти.

Какое значение действует

Что база использует прямо сейчас, показывает команда SHOW. Её вводят в консоли базы: войдите командой sudo -u postgres psql, строка ввода сменится на postgres=#. Каждая команда заканчивается точкой с запятой, выйти — \q.

SHOW shared_buffers;
 shared_buffers
----------------
 128MB
(1 row)

Не помните имя точно — найдите его по части слова:

SELECT name, setting, unit FROM pg_settings WHERE name LIKE '%conn%';

Если значение не то, что вы вписали, спросите базу, из какого файла и какой строки оно взято:

SELECT name, setting, sourcefile, sourceline, pending_restart
FROM pg_settings WHERE name = 'max_connections';
  • В столбце sourcefile — файл, из которого взято значение, в sourceline — номер строки. Если там postgresql.auto.conf, значение задано командой ALTER SYSTEM, и оно перебивает postgresql.conf — как убрать.
  • pending_restart со значением t значит: в файле уже новое значение, но заработает оно только после перезапуска.

Перечитать или перезапустить

Когда начинает действовать новое значение, показывает столбец context:

SELECT name, context FROM pg_settings WHERE name = 'shared_buffers';
contextЧто сделать после правки файлаПримеры
postmasterперезапустить базу: sudo systemctl restart postgresqlshared_buffers, max_connections, listen_addresses, port
sighupперечитать настройки: sudo pg_ctlcluster 16 main reloadlog_line_prefix; так же перечитывается pg_hba.conf
superuser, userперечитать настройки; можно менять и на ходу командой SETlog_min_duration_statement, work_mem
internalпоменять нельзя: значение задано при сборке или создании кластераblock_size

Перечитать настройки можно и из консоли базы: SELECT pg_reload_conf();. Ответ t значит, что команда принята. Подключённые программы получат новые значения, когда закончат текущий запрос.

Перезапуск обрывает все подключения к базе: сайт на несколько секунд не сможет к ней обратиться. Если настройка с context postmaster, выберите для перезапуска время, когда посетителей меньше.

Если в файле ошибка, при перечитывании база не применит из него ничего, а при перезапуске не запустится. После правки проверьте, что pg_lsclusters показывает online, и загляните в журнал.

ALTER SYSTEM

Команда ALTER SYSTEM меняет настройку без редактора: база сама записывает её в файл postgresql.auto.conf в папке данных. Значения из этого файла перебивают postgresql.conf.

ALTER SYSTEM SET work_mem = '16MB';
SELECT pg_reload_conf();
  • Значение с буквами пишут в одинарных кавычках: '16MB'.
  • Для настроек с context postmaster вместо pg_reload_conf нужен перезапуск.
  • Убрать строку из postgresql.auto.conf и вернуться к значению из postgresql.conf: ALTER SYSTEM RESET work_mem;, затем снова SELECT pg_reload_conf();.
  • Править postgresql.auto.conf руками не нужно: файл ведёт сама база.

Команда SET без слова SYSTEM меняет значение только для текущего подключения: SET work_mem = '64MB';. После выхода из psql значение вернётся.

Главные настройки

НастройкаЧто задаётЗначение после установкиПодробнее
shared_buffersсколько памяти база держит под данные128MBshared_buffers
max_connectionsсколько подключений принимает база100max_connections
listen_addressesна каких адресах база ждёт подключенияlocalhost — только сам серверпорт 5432
portномер порта5432порт 5432
log_min_duration_statementзаписывать в журнал запросы дольше заданного времени-1 — выключеномедленные запросы
work_memпамять на одну сортировку внутри запроса4MBshared_buffers

Пользователи, права и базы

Эти вещи задают не в postgresql.conf, а командами в консоли базы и в pg_hba.conf:

Ошибки и как их исправить

Что видитеПричинаЧто делать
ERROR: unrecognized configuration parameter "max_conection"опечатка в имени настройкинайдите имя через pg_settings и LIKE
ERROR: parameter "max_connections" cannot be changed without restarting the serverэту настройку нельзя менять на ходувпишите её в файл и перезапустите базу
ERROR: invalid value for parameter "work_mem": "16mb"буквы размера написаны не такпишите kB, MB, GB
ERROR: ALTER SYSTEM cannot run inside a transaction blockкоманда введена после BEGINвыполните ROLLBACK; и повторите ALTER SYSTEM отдельно
после правки pg_lsclusters показывает downошибка в файлеверните строку и посмотрите журнал
значение не меняетсяего перебивает postgresql.auto.conf или файл в conf.dпосмотрите sourcefile в pg_settings

Все разборы ошибок — в разделе Ошибки PostgreSQL. Всё сверено с PostgreSQL 16 — эта версия ставится в Ubuntu 24.04.

Источники

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

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

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