pg_hba.conf: кто и откуда может войти в PostgreSQL
pg_hba.conf решает, кто, к какой базе, откуда и каким способом может войти в PostgreSQL. В Ubuntu он лежит в /etc/postgresql/16/main/pg_hba.conf. База читает строки сверху вниз и берёт первую подходящую. После правки файл перечитывают командой sudo pg_ctlcluster 16 main reload — перезапуск не нужен.
Содержание 10
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Посмотрите строки файла без комментариев:
sudo grep -E -v '^(#|$)' /etc/postgresql/16/main/pg_hba.conf- Если нужно поменять файл, откройте его:
sudo nano /etc/postgresql/16/main/pg_hba.confСохраните правку (Ctrl+O, Enter, Ctrl+X).
- Проверьте, что в файле нет ошибок, — до того как база его перечитает:
sudo -u postgres psql -c 'SELECT line_number, error FROM pg_hba_file_rules WHERE error IS NOT NULL;' Ответ (0 rows) — ошибок нет. Иначе в столбце line_number номер строки, а в error — что с ней не так.
- Перечитайте настройки:
sudo pg_ctlcluster 16 main reloadПодключения, которые уже открыты, правка не трогает: pg_hba.conf проверяется только при входе.
Что стоит в файле после установки
Ubuntu создаёт файл сама, когда ставит PostgreSQL. Строки без комментариев:
local all postgres peer
local all all peer
host all all 127.0.0.1/32 scram-sha-256
host all all ::1/128 scram-sha-256
local replication all peer
host replication all 127.0.0.1/32 scram-sha-256
host replication all ::1/128 scram-sha-256| Строка | Что разрешает |
|---|---|
local all postgres peer | пользователь сервера postgres входит в базу как postgres без пароля — так работает sudo -u postgres psql |
local all all peer | пользователь сервера входит без пароля в пользователя базы с тем же именем: пользователь ubuntu — только как ubuntu |
host all all 127.0.0.1/32 scram-sha-256 | вход с самого сервера по адресу 127.0.0.1 — по паролю; так подключается сайт с хостом 127.0.0.1 или localhost |
host all all ::1/128 scram-sha-256 | то же для адреса ::1 — localhost может означать и его |
три строки replication | копирование базы на другой сервер (репликация); сайту не нужны |
Над первой строкой Ubuntu пишет комментарий DO NOT DISABLE!. Не меняйте её: через неё к базе подключаются задачи обслуживания, которые работают без пароля. Если поставить в ней другой способ входа, sudo -u postgres psql начнёт спрашивать пароль.
Строк для других адресов в файле нет: после установки база принимает подключения только с самого сервера. Как открыть её для другого сервера — ниже.
Из чего состоит строка
host shop ivan 203.0.113.5/32 scram-sha-256| Столбец | Что писать | В примере |
|---|---|---|
| тип подключения | local — на самом сервере без адреса, host — по адресу, в том числе 127.0.0.1, hostssl — по адресу и только с шифрованием SSL | host |
| база | имя базы; несколько — через запятую; all — любая; sameuser — база с тем же именем, что у пользователя | shop |
| пользователь | имя; несколько — через запятую; all — любой; +имя — все, кто входит в эту роль | ivan |
| адрес | откуда подключаются; у строк local этого столбца нет | 203.0.113.5/32 |
| способ входа | как проверять, таблица ниже | scram-sha-256 |
Столбцы разделяются пробелами или табуляцией, сколько их — неважно. Всё после # — комментарий.
Как записать адрес:
203.0.113.5/32— один адрес IPv4.203.0.113.0/24— 256 адресов, от 203.0.113.0 до 203.0.113.255.::1/128— один адрес IPv6.0.0.0.0/0— все адреса IPv4,::0/0— все адреса IPv6.all— любой адрес,samehost— любой адрес самого сервера.
Нули в конце адреса сети не опускайте: 203.0.113.0/24, а не 203.0.113/24.
Способы входа
| Способ | Что делает | Когда ставить |
|---|---|---|
peer | пускает без пароля, если имя пользователя сервера совпадает с именем пользователя базы | только в строках local |
scram-sha-256 | спрашивает пароль; сам пароль по сети не передаётся | для сайта и входа по адресу |
md5 | спрашивает пароль старым способом; если пароль записан способом scram-sha-256, база сама проверит его по scram-sha-256 | для старых программ, которые не умеют scram-sha-256 |
password | пароль идёт по сети открытым текстом | не ставьте без SSL |
trust | пускает без пароля под любым именем | не ставьте на сервере с сайтом |
reject | отказывает | чтобы закрыть один адрес выше строки, которая пускает целую сеть |
Есть и другие способы — ident, ldap, cert, pam и ещё несколько. Сайту на VPS они не нужны.
trust пускает любого, кто дотянулся до базы, под любым именем — в том числе как postgres, с правом удалить все базы. Строка host all all 0.0.0.0/0 trust открывает базу всему интернету без пароля. Если такая строка есть, замените trust на scram-sha-256 и перечитайте настройки.Пароль, записанный старым способом md5, не пройдёт по строке со способом scram-sha-256. Как узнать, каким способом записан пароль, и записать заново — на странице Как сменить пароль.
Как база выбирает строку
- База идёт по строкам сверху вниз.
- Берёт первую, где совпали тип подключения, адрес, база и пользователь.
- Проверяет вход способом из этой строки. Если вход не прошёл — например, неверный пароль, — строки ниже уже не проверяются.
- Если не подошла ни одна строка, база отказывает с ошибкой no pg_hba.conf entry.
Поэтому строки для одного пользователя, базы или адреса ставят выше строк с all. Пример: сайт подключается без адреса, через local, и входит под ivan с паролем. Если добавить строку для него в конец файла, база до неё не дойдёт: раньше сработает local all all peer, и придёт ошибка Peer authentication failed. Строку ставят выше:
local all postgres peer
local shop ivan scram-sha-256
local all all peerПроще дать сайту в настройках хост 127.0.0.1: тогда он попадёт на строку host … 127.0.0.1/32 scram-sha-256, которая уже есть, и файл менять не нужно.
Готовые строки для сайта
Сайт на том же сервере. Ничего добавлять не нужно. В настройках сайта укажите хост 127.0.0.1, порт 5432, пользователя, пароль и базу.
Сайт на другом сервере с адресом 203.0.113.5. Добавьте строку ниже строк host … 127.0.0.1/32:
hostssl shop ivan 203.0.113.5/32 scram-sha-256Одной строки мало: база должна ещё слушать внешний адрес (настройка listen_addresses), а файрвол — пропускать порт 5432 только с этого адреса. Пошагово — на странице Порт 5432 и в разборе no pg_hba.conf entry.
Два сервера сайта. По строке на каждый адрес или одна строка на сеть /24, если оба сервера в ней.
Закрыть один адрес из сети. Строка reject выше общей:
host shop ivan 203.0.113.7/32 reject
host shop ivan 203.0.113.0/24 scram-sha-256Пустить пользователя только в его базу. Это удобнее делать правами, а не строками pg_hba.conf: заберите у всех право CONNECT на базу и выдайте его только нужному пользователю — права в PostgreSQL.
Как проверить файл до перечитывания
Таблица pg_hba_file_rules показывает файл таким, какой он сейчас на диске, а не какие строки база взяла при последнем перечитывании. Поэтому её смотрят после сохранения, но до reload:
SELECT line_number, type, database, user_name, address, auth_method, error
FROM pg_hba_file_rules;- Каждая строка таблицы — строка файла, номер в line_number.
- В столбце error — ошибка, если строку не удалось разобрать. Остальные столбцы у такой строки могут быть пустыми.
- Таблицу видит только суперпользователь, поэтому команду выполняют под postgres.
Если в файле ошибка, а вы всё же выполнили reload, база продолжит работать по старым строкам и запишет в журнал /etc/postgresql/16/main/pg_hba.conf was not reloaded. Строками выше — какая строка файла с ошибкой: line 5 of configuration file "/etc/postgresql/16/main/pg_hba.conf".
Перечитать настройки можно и из консоли базы: SELECT pg_reload_conf();.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
FATAL: no pg_hba.conf entry for host "…", user "ivan", database "shop", … | ни одна строка не подошла | разбор ошибки |
FATAL: Peer authentication failed for user "ivan" | вход без адреса попал на строку local … peer | разбор ошибки |
FATAL: password authentication failed for user "ivan" | неверный пароль или пароль записан способом md5 | разбор ошибки |
invalid connection type "hots" | опечатка в первом столбце | пишите local, host или hostssl |
invalid authentication method "scram" | опечатка в способе входа | правильно — scram-sha-256 |
peer authentication is only supported on local sockets | peer в строке host | для host поставьте scram-sha-256 |
invalid IP mask "scram-sha-256": … | адрес записан без /32 | допишите /32 к адресу |
invalid CIDR mask in address "203.0.113.5/33" | число после / больше 32 | для IPv4 — от 0 до 32 |
hostssl record cannot match because SSL is disabled | в postgresql.conf выключен ssl | поставьте ssl = on или пишите host |
/etc/postgresql/16/main/pg_hba.conf was not reloaded | в файле ошибка, база работает по старым строкам | найдите строку через pg_hba_file_rules |
Всё сверено с PostgreSQL 16 — эта версия ставится в Ubuntu 24.04.
Источники
- PostgreSQL 16: The pg_hba.conf File — на английском: столбцы строки, all, sameuser, адреса /32 и /24, первая подходящая строка без перехода к следующей, перечитывание и совет ограничивать базы правом CONNECT.
- PostgreSQL 16: Password Authentication — на английском: scram-sha-256, md5 и password.
- PostgreSQL 16: Peer Authentication — на английском: peer только для local.
- PostgreSQL 16: Trust Authentication — на английском: вход без пароля под любым именем.
- PostgreSQL 16: pg_hba_file_rules — на английском: таблица показывает файл на диске, видна только суперпользователю.
- Образец pg_hba.conf в PostgreSQL 16 — строки local, host и replication, которые ставятся при создании базы.
- Исходный код pg_createcluster для Ubuntu 24.04 — строка для postgres с комментарием DO NOT DISABLE, способы peer и scram-sha-256 после установки.
- Исходный код PostgreSQL 16: hba.c — тексты ошибок разбора файла; при ошибке база оставляет старые строки.
- Исходный код PostgreSQL 16: postmaster.c — текст was not reloaded.
Сверено 5 ноября 2026 года.
Что почитать дальше
- no pg_hba.conf entryпошагово: строка для подключения с другого сервера.
- Peer authentication failedесли не пускает без пароля на самом сервере.
- Порт 5432на каком адресе база ждёт подключений.
- Настройки PostgreSQLгде лежат остальные файлы настроек.