Настройки PostgreSQL: какой файл править и как применить
В Ubuntu настройки PostgreSQL лежат в папке /etc/postgresql/16/main/: основные — в postgresql.conf, правила входа — в pg_hba.conf. Одни настройки начинают действовать после команды «перечитать настройки», другие — только после перезапуска базы.
Содержание 11
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Узнайте версию базы:
pg_lsclusters. В столбце Ver — номер версии, в столбце Cluster — имя кластера, после установки это main. Дальше в примерах — 16 и main: подставьте свои. - Откройте файл настроек:
sudo nano /etc/postgresql/16/main/postgresql.conf. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter. - Найдите нужную строку: нажмите Ctrl+W, напечатайте имя настройки и нажмите Enter. Если строка начинается со знака
#, уберите#и впишите своё значение. - Сохраните файл: Ctrl+O, Enter, затем Ctrl+X.
- Примените настройку. Для shared_buffers, max_connections, listen_addresses и port нужен перезапуск:
sudo systemctl restart postgresql. Для остальных хватит перечитать настройки:sudo pg_ctlcluster 16 main reload. Какой случай у вашей настройки — ниже. - Проверьте, что значение действует:
sudo -u postgres psql -c "SHOW max_connections;". Вместо max_connections — имя своей настройки. - Проверьте, что база работает:
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 postgresql | shared_buffers, max_connections, listen_addresses, port |
sighup | перечитать настройки: sudo pg_ctlcluster 16 main reload | log_line_prefix; так же перечитывается pg_hba.conf |
superuser, user | перечитать настройки; можно менять и на ходу командой SET | log_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 | сколько памяти база держит под данные | 128MB | shared_buffers |
max_connections | сколько подключений принимает база | 100 | max_connections |
listen_addresses | на каких адресах база ждёт подключения | localhost — только сам сервер | порт 5432 |
port | номер порта | 5432 | порт 5432 |
log_min_duration_statement | записывать в журнал запросы дольше заданного времени | -1 — выключено | медленные запросы |
work_mem | память на одну сортировку внутри запроса | 4MB | shared_buffers |
Пользователи, права и базы
Эти вещи задают не в postgresql.conf, а командами в консоли базы и в pg_hba.conf:
- Как создать пользователя — CREATE USER, список пользователей и DROP ROLE.
- Как выдать права — GRANT, REVOKE и права на схему public.
- Как сменить пароль — ALTER USER и команда \password.
- Как создать и удалить базу — CREATE DATABASE и DROP DATABASE.
- Файл pg_hba.conf — кого и каким способом база пускает.
- Список баз и таблиц — \l, \dt и размер базы.
- pg_dump и как загрузить дамп — копия базы в файл и обратно.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
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.
Источники
- PostgreSQL 16: Setting Parameters — на английском: устройство файла, буквы размера и времени, правило последней строки, include_dir, postgresql.auto.conf.
- PostgreSQL 16: ALTER SYSTEM — на английском: запись в postgresql.auto.conf, RESET, запрет внутри транзакции.
- PostgreSQL 16: SHOW — на английском: как посмотреть текущее значение.
- PostgreSQL 16: pg_settings — на английском: столбцы context, sourcefile, sourceline и pending_restart.
- PostgreSQL 16: pg_file_settings — на английском: если в файле ошибка, база не применяет из него ничего.
- PostgreSQL 16: Connections and Authentication — на английском: listen_addresses, port и max_connections меняются только перезапуском.
- PostgreSQL 16: Resource Consumption — на английском: shared_buffers и work_mem.
- PostgreSQL 16: System Administration Functions — на английском: функция pg_reload_conf.
- Справка pg_createcluster для Ubuntu 24.04 — файлы кластера в /etc/postgresql/версия/имя/, данные в /var/lib/postgresql/, журнал в /var/log/postgresql/.
- Справка pg_ctlcluster для Ubuntu 24.04 — reload: перечитать настройки без остановки базы.
- Файл createcluster.conf из пакета postgresql-common в Ubuntu 24.04 — строка include_dir = 'conf.d' в postgresql.conf.
- Исходный код PostgreSQL 16: guc.c — тексты ошибок unrecognized configuration parameter, cannot be changed without restarting the server и invalid value for parameter.
Сверено 5 ноября 2026 года.
Что почитать дальше
- Как установить PostgreSQL на Ubuntuустановка, вход и пользователь для сайта.
- Сервер для базы данныхгде держать базу и сколько памяти ей отдать.
- Ошибки PostgreSQLразборы ошибок по тексту.
- Настройки MySQL и MariaDBто же для MySQL.
- Настройки Redisгде redis.conf и как применить изменения.