Перейти к содержимому

Статья 94 из 141

Гайды

pgAdmin 4 в Docker: веб-панель для PostgreSQL на VPS

pgAdmin 4 — официальный веб-интерфейс для PostgreSQL. В нём можно смотреть таблицы, писать SQL с подсветкой, управлять ролями и делать резервные копии без командной строки. Внутри образа уже есть pg_dump и pg_restore для PostgreSQL 13–18.

Проверено на Ubuntu 24.04 с pgAdmin 4 версии 9.19 и PostgreSQL 17 (ноябрь 2026).

Ресурс Минимум
RAM 1 ГБ (pgAdmin около 200–300 МБ, плюс PostgreSQL)
vCPU 1
Диск 2 ГБ плюс размер баз и бэкапов
ПО Docker и Compose

Про установку и настройку самого PostgreSQL: PostgreSQL на VPS.

Окно терминала
mkdir -p /opt/pgadmin && cd /opt/pgadmin
cat > .env <<EOF
POSTGRES_PASSWORD=$(openssl rand -hex 16)
PGADMIN_PASSWORD=$(openssl rand -hex 12)
EOF
chmod 600 .env
nano docker-compose.yml
services:
db:
image: postgres:17
restart: unless-stopped
environment:
POSTGRES_USER: app
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
POSTGRES_DB: appdb
volumes:
- pg-data:/var/lib/postgresql/data
pgadmin:
image: dpage/pgadmin4:latest
restart: unless-stopped
depends_on:
- db
ports:
- "127.0.0.1:5050:80"
environment:
PGADMIN_DEFAULT_EMAIL: admin@example.com
PGADMIN_DEFAULT_PASSWORD: ${PGADMIN_PASSWORD}
volumes:
- pgadmin-data:/var/lib/pgadmin
volumes:
pg-data:
pgadmin-data:
Окно терминала
docker compose up -d
docker compose logs -f pgadmin

Первый запуск занимает 20–40 секунд: pgAdmin создаёт свою служебную базу. Дождитесь строки про запуск gunicorn и нажмите Ctrl+C.

Что важно:

  • PGADMIN_DEFAULT_EMAIL и PGADMIN_DEFAULT_PASSWORD обязательны. Это логин и пароль первого администратора pgAdmin, они не связаны с паролем PostgreSQL. Переменные читаются только при первом запуске. Позже пароль меняется в интерфейсе, а не в .env.
  • Порт PostgreSQL наружу не публикуется. pgAdmin ходит к базе по имени сервиса db внутри сети Compose.
  • Порт pgAdmin привязан к 127.0.0.1.
  • В томе /var/lib/pgadmin хранятся настройки, сохранённые серверы и файлы бэкапов. Если вместо тома вы используете папку на хосте, отдайте её пользователю контейнера: chown -R 5050:5050 ./pgadmin-data.

Пароли смотрите в .env: cat /opt/pgadmin/.env.

Самый простой и безопасный способ — SSH-туннель с вашего компьютера:

Окно терминала
ssh -L 5050:127.0.0.1:5050 root@IP_СЕРВЕРА

После этого pgAdmin открывается по адресу http://127.0.0.1:5050.

Для постоянного доступа по домену поставьте Nginx и получите сертификат: Nginx, Let’s Encrypt. Блок location для поддомена pgadmin.example.com:

location / {
proxy_pass http://127.0.0.1:5050;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}

Добавьте ограничение по IP (allow ВАШ_IP; deny all;) или базовую авторизацию, как в статье про phpMyAdmin. Панель с доступом ко всем базам не должна быть открыта всем.

На странице входа выберите язык «Russian» в выпадающем списке, затем введите email и пароль из .env.

Страница входа pgAdmin 4

Тема оформления по умолчанию подстраивается под систему, поэтому интерфейс может открыться тёмным. Её меняют в «Файл → Настройки».

pgAdmin не видит базу сам. Её нужно добавить:

  1. На «Панели информации» в блоке «Быстрые ссылки» нажмите «Добавить новый сервер». Откроется окно «Register - Сервер».
  2. Вкладка «Общие»: в поле «Имя» укажите любое понятное название, например appdb-local.
  3. Вкладка «Соединение»:
    • «Имя/адрес сервера»: db (имя сервиса из Compose; для PostgreSQL на хосте укажите 172.17.0.1 и разрешите подключение в pg_hba.conf);
    • «Порт»: 5432;
    • «База данных обслуживания»: appdb;
    • «Имя пользователя»: app;
    • «Пароль»: значение POSTGRES_PASSWORD.
  4. Переключатель «Сохранить пароль?» оставьте выключенным, если не хотите хранить пароль в pgAdmin. Тогда он будет спрашивать пароль при каждом новом входе.
  5. Нажмите «Сохранить».

Диалог регистрации сервера в pgAdmin, вкладка «Соединение»

В дереве слева появится сервер, а на панели информации графики активности.

Раскройте сервер → «Базы данных» → выберите appdb. Затем меню «Инструменты» → «Инструмент запросов» (Alt+Shift+Q). Введите запрос и нажмите F5 или кнопку с треугольником.

SELECT customer, total, created_at
FROM orders
ORDER BY total DESC;

Инструмент запросов pgAdmin с результатом SELECT

Внизу три вкладки: «Результат», «Сообщения» (ошибки и число затронутых строк) и «Уведомления». Результат можно выгрузить в CSV кнопкой со стрелкой вниз над таблицей.

  1. Выберите базу appdb в дереве.
  2. «Инструменты» → «Резервная копия…».
  3. «Имя файла»: например appdb-2026-11-18.backup.
  4. «Формат»: «Специальный». Это сжатый формат pg_dump -Fc, из него можно восстановить всё или отдельные таблицы.
  5. Нажмите «Резервная копия».

Диалог резервного копирования базы в pgAdmin

pgAdmin запускает pg_dump в фоне и показывает уведомление «Процесс завершился». Файл сохраняется внутри контейнера в папке пользователя pgAdmin. Для admin@example.com это /var/lib/pgadmin/storage/admin_example.com/. Заберите копию на хост:

Окно терминала
cd /opt/pgadmin
docker compose cp pgadmin:/var/lib/pgadmin/storage/admin_example.com/appdb-2026-11-18.backup /root/

Через интерфейс. Создайте пустую базу через контекстное меню узла «Базы данных», выберите её и откройте «Инструменты» → «Восстановить…». Файл копии выбирается кнопкой с папкой в поле имени файла: откроется хранилище pgAdmin, туда же можно загрузить файл со своего компьютера.

Через командную строку надёжнее для больших баз:

Окно терминала
cd /opt/pgadmin
docker compose exec -T db createdb -U app appdb_restored
docker compose exec -T db pg_restore -U app -d appdb_restored --no-owner < /root/appdb-2026-11-18.backup
docker compose exec -T db psql -U app -d appdb_restored -c "select count(*) from orders"

Проверено: копия, сделанная из интерфейса pgAdmin, восстанавливается pg_restore в новую базу со всеми строками.

Ручные копии не заменяют регулярный бэкап. Делайте pg_dump по расписанию и уносите файлы с сервера: бэкапы, restic.

Окно терминала
cd /opt/pgadmin
docker compose pull pgadmin
docker compose up -d

Настройки и сохранённые серверы остаются в томе pgadmin-data. Мажорную версию PostgreSQL так обновлять нельзя: для перехода с 17 на 18 нужен дамп и восстановление.

Симптом Причина и решение
Контейнер pgAdmin сразу перезапускается Не задан PGADMIN_DEFAULT_EMAIL или PGADMIN_DEFAULT_PASSWORD, либо email некорректный. Смотрите docker compose logs pgadmin.
Permission denied: '/var/lib/pgadmin/sessions' Папка на хосте принадлежит root. Выполните chown -R 5050:5050 для неё.
Сменили пароль в .env, а войти со старым или новым не получается Переменные применяются только при первом запуске. Меняйте пароль в интерфейсе или удалите том pgadmin-data (сохранённые серверы пропадут).
connection refused при регистрации сервера Указан localhost. Внутри контейнера это сам pgAdmin. Используйте имя сервиса db.
password authentication failed for user Неверный пароль PostgreSQL. Он в POSTGRES_PASSWORD и задаётся только при первой инициализации тома.
Бэкап завершился с ошибкой версии pg_dump Сервер новее, чем утилиты в образе. Обновите образ pgAdmin: docker compose pull pgadmin. Пути к утилитам задаются в «Файл → Настройки».