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

pg_hba.conf: кто и откуда может войти в PostgreSQL

pg_hba.conf решает, кто, к какой базе, откуда и каким способом может войти в PostgreSQL. В Ubuntu он лежит в /etc/postgresql/16/main/pg_hba.conf. База читает строки сверху вниз и берёт первую подходящую. После правки файл перечитывают командой sudo pg_ctlcluster 16 main reload — перезапуск не нужен.

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

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

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Посмотрите строки файла без комментариев:
sudo grep -E -v '^(#|$)' /etc/postgresql/16/main/pg_hba.conf
  1. Если нужно поменять файл, откройте его:
sudo nano /etc/postgresql/16/main/pg_hba.conf

Сохраните правку (Ctrl+O, Enter, Ctrl+X).

  1. Проверьте, что в файле нет ошибок, — до того как база его перечитает:
sudo -u postgres psql -c 'SELECT line_number, error FROM pg_hba_file_rules WHERE error IS NOT NULL;'

Ответ (0 rows) — ошибок нет. Иначе в столбце line_number номер строки, а в error — что с ней не так.

  1. Перечитайте настройки:
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 — по адресу и только с шифрованием SSLhost
базаимя базы; несколько — через запятую; 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. Как узнать, каким способом записан пароль, и записать заново — на странице Как сменить пароль.

Как база выбирает строку

  1. База идёт по строкам сверху вниз.
  2. Берёт первую, где совпали тип подключения, адрес, база и пользователь.
  3. Проверяет вход способом из этой строки. Если вход не прошёл — например, неверный пароль, — строки ниже уже не проверяются.
  4. Если не подошла ни одна строка, база отказывает с ошибкой 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 socketspeer в строке 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.

Источники

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

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

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