Помощник подключения pgAdmin к PostgreSQL

Заполните параметры подключения PostgreSQL — инструмент автоматически подготовит настройки для pgAdmin, команду psql и строку подключения для локального сервера, Docker-контейнера или удаленной базы данных.

Как подключить pgAdmin к PostgreSQL

pgAdmin — это графический интерфейс для управления PostgreSQL. Через него можно подключаться к локальным и удаленным базам данных, запускать SQL-запросы, создавать таблицы, управлять пользователями и администрировать сервер PostgreSQL.

Главная проблема новичков — непонятно, какие параметры вводить в Register Server и чем отличаются Host, Database и Maintenance database. Из-за этого появляются ошибки вроде connection refused, password authentication failed или no pg_hba.conf entry.

Этот помощник подключения pgAdmin к PostgreSQL автоматически подготавливает:

настройки для Register Server в pgAdmin 4;
команду psql для проверки подключения;
строку подключения PostgreSQL;
подсказки для Docker, VPS и удаленных серверов;
рекомендации по SSL и типовым ошибкам подключения.

Инструмент работает локально в браузере и не подключается к вашей базе данных.

Сценарий

Server name только имя в pgAdmin Host без http:// Port Maintenance database Database Username Password не сохраняется SSL mode

В pgAdmin включить Save password. На чужом компьютере лучше не включать.

Вставить пароль в строку подключения и команду. Использовать только для локального теста.

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

Можно копировать

pgAdmin / General

Это имя подключения внутри pgAdmin. Оно не создает новый сервер PostgreSQL.

pgAdmin / Connection

Проверка через psql

Строка подключения

Что проверить, если не подключается

Какие данные нужны для подключения PostgreSQL

Для подключения pgAdmin к PostgreSQL обычно нужны следующие параметры:

Поле	Что вводить
Host	IP-адрес, `localhost`, домен сервера PostgreSQL или имя Docker-сервиса
Port	Порт PostgreSQL, обычно `5432`
Database	Название базы данных, с которой вы будете работать
Username	Пользователь PostgreSQL
Password	Пароль пользователя PostgreSQL
Maintenance database	Обычно `postgres`
SSL mode	`disable`, `prefer`, `require` или режим, который требует хостинг

Если PostgreSQL запущен локально, Host обычно равен localhost. Если база находится на VPS, облачном сервере или хостинге, используется IP-адрес или домен сервера.

Что вводить в Host в pgAdmin

В поле Host name/address нужно указывать только сетевой адрес PostgreSQL:

localhost;
IP-адрес;
домен сервера;
имя Docker-сервиса.

Не нужно вставлять http://, https://, postgresql:// или полный URL подключения.

Правильно

db.example.com
127.0.0.1
postgres

Неправильно

https://db.example.com
postgresql://user:password@host/db

Что такое Maintenance database в pgAdmin

Maintenance database — это служебная база данных, через которую pgAdmin устанавливает первоначальное подключение к PostgreSQL.

В большинстве случаев здесь используется postgres. Даже если вы работаете с другой базой данных, Maintenance database обычно оставляют postgres.

Если сервер PostgreSQL настроен нестандартно, хостинг или администратор могут указать другую maintenance database.

Проверка подключения через psql

Иногда pgAdmin показывает слишком общую ошибку подключения. В этом случае проще проверить соединение через консольную команду psql.

psql -h localhost -p 5432 -U postgres -d app_db

Если psql подключается успешно, проблема обычно связана с настройками pgAdmin, SSL или интерфейсом подключения. Если psql тоже не подключается, нужно проверять порт, службу PostgreSQL, firewall, pg_hba.conf, логин и пароль.

Подключение pgAdmin к PostgreSQL в Docker

При работе с Docker многие пытаются подключаться через localhost и получают ошибку подключения.

Если pgAdmin и PostgreSQL находятся в одной docker-compose сети, в Host обычно указывается имя сервиса:

services:
  postgres:

Тогда Host в pgAdmin будет:

postgres

Если PostgreSQL запущен в контейнере, а pgAdmin работает на компьютере, обычно используется localhost или host.docker.internal, в зависимости от конфигурации Docker.

Подключение к удаленному PostgreSQL серверу

pgAdmin можно использовать для подключения к VPS, облачным PostgreSQL, AWS RDS, Supabase, Neon, Railway, DigitalOcean, Hetzner и корпоративным серверам.

Для удаленного подключения обычно нужны публичный IP или домен, открытый порт 5432, разрешение в pg_hba.conf и SSL mode Require для облачных сервисов.

Многие managed PostgreSQL сервисы требуют SSL-подключение. Если подключение не работает, попробуйте SSL mode → Require.

Почему pgAdmin не подключается к PostgreSQL

connection refused

PostgreSQL не запущен или закрыт порт 5432. Проверьте службу PostgreSQL, Docker-контейнер и проброс порта.

sudo systemctl status postgresql

password authentication failed

Сервер найден, но пользователь или пароль неверны. Проверьте Username, Password, пользователя в PostgreSQL и регистр символов.

no pg_hba.conf entry

PostgreSQL не разрешает подключение с вашего IP-адреса. Нужно изменить pg_hba.conf и добавить разрешение для клиента.

timeout expired

Сервер недоступен по сети. Проверьте firewall, VPS, cloud security groups, порт 5432 и VPN.

SSL required

Сервер требует SSL-подключение. Попробуйте выбрать SSL mode → Require.

Безопасность подключения PostgreSQL

Не сохраняйте пароль в pgAdmin на чужих компьютерах. Если база данных доступна через интернет, ограничьте IP-доступ, используйте SSL, отключите публичный доступ при необходимости и не используйте пользователя postgres в production.

Для production-серверов рекомендуется firewall, VPN, fail2ban, SSL/TLS и отдельные роли PostgreSQL под приложения и администрирование.

FAQ

pgAdmin создает PostgreSQL сервер?

Нет. pgAdmin — это клиент для подключения к PostgreSQL. Сам сервер PostgreSQL должен быть установлен отдельно.

Почему Host указывается без http?

PostgreSQL использует TCP-подключение, а не HTTP. Поэтому нужен только hostname или IP-адрес.

Какой порт использует PostgreSQL?

По умолчанию PostgreSQL использует порт 5432.

Можно ли подключить Supabase или Neon?

Да. Нужно использовать параметры подключения, выданные сервисом, и часто выбрать SSL mode Require.

Почему localhost не работает в Docker?

В Docker localhost внутри контейнера указывает на сам контейнер, а не на ваш компьютер и не на соседний сервис.

Что делать, если pgAdmin зависает при подключении?

Проверьте firewall, SSL, DNS, доступность сервера, правильность Host и Port.

Можно ли использовать pgAdmin для удаленного сервера?

Да. pgAdmin поддерживает локальные и удаленные PostgreSQL-серверы.

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

Связанные материалы из базы:

pgAdmin 4 — подключение к серверу и создание базы данных.

PostgreSQL в Docker — настройка контейнеров и Docker Compose.

psql команды — проверка подключения через консоль.

Пароль PostgreSQL — смена и сброс пароля пользователя.

Хостинг PostgreSQL — Supabase, Neon, Railway и облачные базы.

Пользователи и права PostgreSQL — роли, GRANT и доступы.