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

Статья 61 из 141

Гайды

phpMyAdmin на VPS: установка в Docker рядом с MySQL/MariaDB и безопасный доступ

phpMyAdmin — веб-интерфейс для MySQL и MariaDB. В нём удобно создать базу и пользователя, посмотреть таблицы, выполнить SQL-запрос, загрузить или выгрузить дамп. Это мощный инструмент с доступом ко всем данным, поэтому открывать его в интернет без защиты нельзя.

Ниже phpMyAdmin запускается в Docker в одной сети с контейнером MariaDB. Проверено на Ubuntu 24.04 с phpMyAdmin 5.2.3 и MariaDB 11.4 (ноябрь 2026).

Ресурс Минимум
RAM 1 ГБ (MariaDB + phpMyAdmin занимают 200–300 МБ)
vCPU 1
Диск 2 ГБ плюс размер ваших баз
ПО Docker и Compose

Если база у вас уже стоит на хосте без Docker, прочитайте сначала статью про MySQL. Вариант с apt описан в конце.

Окно терминала
mkdir -p /opt/phpmyadmin && cd /opt/phpmyadmin
echo "MARIADB_ROOT_PASSWORD=$(openssl rand -hex 16)" > .env
chmod 600 .env
nano docker-compose.yml
services:
db:
image: mariadb:11.4
restart: unless-stopped
environment:
MARIADB_ROOT_PASSWORD: ${MARIADB_ROOT_PASSWORD}
volumes:
- db-data:/var/lib/mysql
phpmyadmin:
image: phpmyadmin:5.2
restart: unless-stopped
depends_on:
- db
ports:
- "127.0.0.1:8082:80"
environment:
PMA_HOST: db
UPLOAD_LIMIT: 256M
volumes:
db-data:
Окно терминала
docker compose up -d
docker compose ps

Что здесь важно:

  • PMA_HOST: db указывает phpMyAdmin на сервис db внутри сети Compose. Порт базы 3306 наружу не публикуется вовсе.
  • Порт phpMyAdmin привязан к 127.0.0.1. Из интернета он недоступен, пока вы сами не откроете его через прокси.
  • UPLOAD_LIMIT поднимает лимиты PHP upload_max_filesize и post_max_size. Без него импорт файла больше 2 МБ не пройдёт.

Пароль root лежит в .env: cat /opt/phpmyadmin/.env.

Самый безопасный способ. На сервере ничего открывать не нужно. На своём компьютере выполните:

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

Пока сессия открыта, phpMyAdmin доступен в браузере по адресу http://127.0.0.1:8082. В Windows команда та же, в PowerShell. Подробнее про подключение: SSH.

Вариант 2: HTTPS через Nginx и дополнительный пароль

Заголовок раздела «Вариант 2: HTTPS через Nginx и дополнительный пароль»

Нужен, если phpMyAdmin открывают с разных устройств. Понадобится поддомен, например pma.example.com, с A-записью на сервер (DNS).

Добавьте в environment сервиса phpmyadmin адрес, по которому его открывают:

PMA_ABSOLUTE_URI: https://pma.example.com/

Создайте файл паролей для базовой авторизации. Это второй замок перед формой входа phpMyAdmin:

Окно терминала
apt install -y apache2-utils
htpasswd -cB /etc/nginx/.htpasswd-pma admin

Конфиг /etc/nginx/sites-available/phpmyadmin:

server {
listen 80;
server_name pma.example.com;
client_max_body_size 256M;
location / {
auth_basic "Restricted";
auth_basic_user_file /etc/nginx/.htpasswd-pma;
proxy_pass http://127.0.0.1:8082;
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;
}
}
Окно терминала
ln -s /etc/nginx/sites-available/phpmyadmin /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
certbot --nginx -d pma.example.com
docker compose up -d

Проверено: без логина и пароля Nginx отвечает 401, с ними открывается phpMyAdmin. client_max_body_size должен быть не меньше UPLOAD_LIMIT, иначе большой импорт оборвётся с ошибкой 413. Ещё надёжнее разрешить вход только со своего IP через allow/deny в location или файрвол. Подробнее: Nginx, Let’s Encrypt.

Откройте phpMyAdmin. Язык интерфейса выбирается на странице входа, русский определяется по браузеру. Войдите как root с паролем из .env.

Страница входа phpMyAdmin на русском

На главной странице слева список баз, сверху вкладки: «Базы данных», «SQL», «Учётные записи пользователей», «Экспорт», «Импорт». Справа видны версии сервера базы данных и phpMyAdmin.

Главная страница phpMyAdmin

Приложению не нужен root. Создайте для него отдельного пользователя с правами только на свою базу.

  1. Откройте вкладку «Учётные записи пользователей» и нажмите «Добавить учётную запись пользователя».
  2. Укажите имя пользователя. В поле «Имя хоста» оставьте «Любой хост» (%): контейнеры приложений подключаются из сети Docker, а не с localhost.
  3. Задайте пароль или нажмите «Генерировать».
  4. Отметьте «Создать базу данных с таким же именем и предоставить на неё все привилегии».
  5. Глобальные привилегии не трогайте и нажмите кнопку подтверждения внизу страницы.

Форма добавления пользователя в phpMyAdmin

То же самое через вкладку «SQL»:

CREATE DATABASE shopdb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'shopuser'@'%' IDENTIFIED BY 'ДЛИННЫЙ_ПАРОЛЬ';
GRANT ALL PRIVILEGES ON shopdb.* TO 'shopuser'@'%';
FLUSH PRIVILEGES;

Экспорт. Выберите базу слева, вкладка «Экспорт», способ «Быстрый», формат SQL, кнопка «Экспорт». Для бэкапа по расписанию лучше mariadb-dump, см. ниже.

Импорт. Выберите базу, вкладка «Импорт», «Выберите файл». Над полем указан лимит: с UPLOAD_LIMIT: 256M там написано «Максимальный размер: 256МиБ». Принимаются .sql, а также сжатые .sql.gz, .sql.bz2 и .sql.zip.

Страница импорта в phpMyAdmin с лимитом 256 МиБ

Дампы на гигабайты через браузер грузить неудобно. Заливайте их в контейнер напрямую:

Окно терминала
cd /opt/phpmyadmin
source .env
# экспорт
docker compose exec -T db mariadb-dump -uroot -p"$MARIADB_ROOT_PASSWORD" \
--single-transaction shopdb | gzip > /root/shopdb-$(date +%F).sql.gz
# импорт в существующую базу
zcat /root/shopdb-2026-11-18.sql.gz | docker compose exec -T db mariadb -uroot -p"$MARIADB_ROOT_PASSWORD" shopdb

Проверено: дамп, снятый так, импортируется в новую базу без ошибок, данные с кириллицей сохраняются.

В Ubuntu 24.04 есть пакет phpmyadmin версии 5.2.1:

Окно терминала
apt install -y phpmyadmin

Установщик спросит, какой веб-сервер настроить, и предложит создать служебную базу через dbconfig-common. Пакет тянет за собой PHP и обычно Apache. Если на сервере уже работает Nginx на портах 80/443, этот путь даёт конфликты, а версия отстаёт от актуальной. Docker-вариант проще изолировать и обновлять.

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

phpMyAdmin не хранит данных, его контейнер можно пересоздавать в любой момент. База лежит в томе db-data. Перед обновлением MariaDB на новую мажорную версию сделайте дамп.

Сохраняйте дампы mariadb-dump каждый день и уносите их с сервера: бэкапы, restic, rsync.

Симптом Причина и решение
mysqli::real_connect(): (HY000/2002) при входе phpMyAdmin не видит базу. Проверьте PMA_HOST и что оба сервиса в одном docker-compose.yml.
Access denied for user 'root'@'172.x.x.x' Неверный пароль или пользователь создан только для localhost. Создавайте пользователей с хостом %.
Импорт отклоняет файл из-за размера Поднимите UPLOAD_LIMIT и пересоздайте контейнер: docker compose up -d.
413 Request Entity Too Large Лимит Nginx. Увеличьте client_max_body_size.
Импорт обрывается по времени Включите «Частичный импорт» или залейте дамп через docker compose exec -T db mariadb.
После входа редирект на http:// или на неправильный адрес Укажите PMA_ABSOLUTE_URI с вашим доменом и https://.
Сайт не открывается снаружи Так и задумано: порт привязан к 127.0.0.1. Используйте SSH-туннель или Nginx.