Скоро здесь появится новая инструкция

Установка pgAdmin 4
Настройка подключения к локальному серверу PostgreSQ
Настройка pgAdmin4 в качестве внешнего веб-сервиса
Решение возникающих проблем

Окружение

• Версия ОС: 7.3
• Конфигурация ОС: Сервер графический
• Редакция ОС: Стандартная
• Версия ПО: pgadmin4-8.14-2, pgadmin4-qt-8.14-2, httpd-2.4.66-6, pgadmin4-httpd-8.14-2, python3-mod_wsgi-4.6.6-14

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

Установка pgAdmin 4

Для установки pgAdmin4 через терминал выполните команду (потребуются права администратора):

sudo dnf install pgadmin4 pgadmin4-qt

После установки pgAdmin4 будет доступен в «Главном меню» — «Программирование» — «pgAdmin 4».

После запуска pgAdmin4 в интерфейсе появится окно, разделённое на две панели:

• область отображения со вкладками (1);
• древовидная панель управления объектами (2).

При первом запуске pgAdmin4 некоторые вкладки, такие как Query Tool, PSQL Tool и Dashboard, недоступны до подключения к базе данных. После подключения к серверу PostgreSQL эти вкладки становятся активными.

Настройка подключения к локальному серверу PostgreSQL

Установите и настройте сервер PostgreSQL согласно нашей инструкции «Установка PostgreSQL».

Настройте конфигурацию PostgreSQL и задайте пароль пользователя согласно нашей инструкции «Установка PostgreSQL. Решение возникающих проблем».

Для регистрации локального сервера PostgreSQL в pgAdmin в левой боковой панели нажмите ПКМ на пункт «Servers» в появившемся контекстном меню выберите пункт «Register» — «Server».

В открывшемся окне «Register-Server» во вкладке «General» введите имя сервера — 127.0.0.1. Затем перейдите во вкладку «Connection».

Во вкладке «Connection» заполните следующие строки:

• Host name/address: 127.0.0.1;
• Port: 5432;
• Maintenance database: postgres;
• Username: postgres;
• Password: пароль, который был указан для пользователя postgres при настройке конфигурации PostgreSQL.

Затем нажмите «Save».

После успешной регистрации на экране откроется содержимое локального сервера PostgreSQL.

Раскройте плашку сервера 127.0.0.1, и на панели управления появятся следующие разделы:

• «Databases» — отображает все имеющиеся базы данных. После регистрации сервера здесь отображается одна база данных — postgres;
• «Login/Group Roles» — позволяет управлять пользователями и их ролями;
• «Tablespaces» — позволяет управлять местом хранения файлов баз данных.

Для создания пользовательской базы данных нажмите ПКМ на раздел «Databases» и из контекстного меню выберите «Create» — «Database».

В появившемся окне «Create-Database» во вкладке «General» укажите имя создаваемой базы данных, например test_db. Затем нажмите «Save».

После успешного сохранения на панели инструментов в разделе «Databases» появится созданная база данных с именем test_db.

Дальнейшую настройку вновь созданной базы данных можно осуществить во вкладке «Properties» либо, вызвав окно настроек из контекстного меню с помощью щелчка ПКМ по плашке test_db на панели управления.

Настройка pgAdmin4 в качестве внешнего веб-сервиса

Для настройки pgAdmin4 в качестве внешнего веб-сервиса с возможностью подключения к веб-панели pgAdmin4 с других ПК необходимо выполнить ряд настроек и установить дополнительные RPM-пакеты из репозитория РЕД ОС.

Установите дополнительные пакеты (потребуются права администратора):

sudo dnf install httpd python3-mod_wsgi pgadmin4-httpd

Настройте SELinux, последовательно выполнив следующие команды:

sudo setsebool -P httpd_can_network_connect 1
sudo setsebool -P httpd_can_network_connect_db 1
sudo semanage fcontext -a -t httpd_sys_rw_content_t "/var/lib/pgadmin(/.*)?"
sudo semanage fcontext -a -t httpd_sys_rw_content_t "/var/log/pgadmin(/.*)?"
sudo restorecon -R /var/lib/pgadmin/
sudo restorecon -R /var/log/pgadmin/

Запустите сервис httpd:

sudo systemctl enable httpd --now

Откройте файл конфигурации /usr/lib/pgadmin4/config_local.py для редактирования:

sudo nano /usr/lib/pgadmin4/config_local.py

и приведите его к следующему виду:

import os
from config import *
HELP_PATH = '/usr/share/doc/pgadmin4/html/'
DATA_DIR = os.path.realpath(os.path.expanduser(u'/var/lib/pgadmin'))
LOG_FILE = os.path.join(DATA_DIR, 'pgadmin4.log')
SQLITE_PATH = os.path.join(DATA_DIR, 'pgadmin4.db')
SESSION_DB_PATH = os.path.join(DATA_DIR, 'sessions')
STORAGE_DIR = os.path.join(DATA_DIR, 'storage')
AZURE_CREDENTIAL_CACHE_DIR = os.path.join(DATA_DIR, 'azurecredentialcache')
KERBEROS_CCACHE_DIR = os.path.join(DATA_DIR, 'krbccache')
TEST_SQLITE_PATH = os.path.join(DATA_DIR, 'test_pgadmin4.db') 

Для настройки внутренней базы данных pgAdmin4 выполните команду (потребуется ввести адрес почты и пароль):

sudo python /usr/lib/pgadmin4/setup.py setup-db

Далее выполните команду смены владельца для каталогов:

sudo chown -R apache:apache /var/lib/pgadmin /var/log/pgadmin

После чего перезапустите веб-службу:

sudo systemctl restart httpd

После этих действий pgAdmin4 будет доступен в браузере через веб-интерфейс по адресу вида http://<IP-адрес_сервера>/pgadmin.

На странице авторизации введите учетные данные (адрес почты и пароль), сохраненные при настройке внутренней базы данных pgAdmin4, и нажмите «Login».

После идентификации пользователя веб-сервис pgAdmin4 станет доступен.

Решение возникающих проблем

При возникновении ошибки подключения создайте пользовательский пакет политик SELinux, разрешающий заблокированные действия веб-сервера Apache (httpd):

sudo ausearch -c 'httpd' --raw | audit2allow -M my-httpd

Установите созданный пакет политик, выполнив команду:

sudo semodule -i my-httpd.pp

Обновите запущенные службы, последовательно выполнив команды:

sudo systemctl daemon-reload
sudo systemctl restart postgresql-15.service
sudo systemctl restart httpd

После выполнения описанных действий pgAdmin4 будет доступен в браузере через веб-интерфейс по адресу вида http://<IP-адрес_сервера>/pgadmin.

Дата последнего изменения: 28.05.2026

Если вы нашли ошибку, пожалуйста, выделите текст и нажмите Ctrl+Enter.