Установите MariaDB на VPS через готовый шаблон Unihost MariaDB with phpMyAdmin в Portainer. Выберите приложение, задайте надёжные пароли и разверните стек. Для сохранения базы подключите постоянный Docker volume, проверьте соединение и создавайте резервные копии через mariadb-dump. Порт 3306 открывайте извне только при необходимости и с ограничением доступа.

Совместимость: Linux с Docker Engine и Portainer, официальный Docker-образ MariaDB и phpMyAdmin. Доступные параметры зависят от версии шаблона.

Требования

Потребуются VPS с Docker и Portainer, административный доступ и свободное место для базы и резервных копий. В оригинальной инструкции Unihost для публикации phpMyAdmin используется Nginx Proxy Manager.

Что такое Portainer · VPS Unihost

Шаги

Шаг 1. Разверните шаблон Unihost

В Portainer откройте Templates → Application, выберите MariaDB with phpMyAdmin, заполните обязательные поля и разверните приложение. Стек появится в разделе Stacks. Проверьте контейнеры:

docker ps

Выбор шаблона MariaDB with phpMyAdmin в Portainer

Стек MariaDB в списке Stacks интерфейса Portainer

Шаг 2. Настройте пароли и хранение данных

Официальный образ MariaDB поддерживает переменные первоначальной настройки:

Переменная Назначение
MARIADB_ROOT_PASSWORD Пароль root-пользователя MariaDB
MARIADB_DATABASE База, создаваемая при инициализации
MARIADB_USER Пользователь приложения
MARIADB_PASSWORD Пароль пользователя приложения
MARIADB_ROOT_PASSWORD=YOUR_STRONG_ROOT_PASSWORD
MARIADB_DATABASE=appdb
MARIADB_USER=appuser
MARIADB_PASSWORD=YOUR_STRONG_USER_PASSWORD

Используйте уникальные сложные пароли. Переменные инициализации не изменяют уже существующую базу в подключённом томе. В стеке должен быть постоянный volume для /var/lib/mysql:

volumes:
  - mariadb_data:/var/lib/mysql

Шаг 3. Настройте доступ к MariaDB и phpMyAdmin

Дополнительный снимок настройки MariaDB и Portainer из оригинальной инструкции Unihost

Контейнеры в одной Docker-сети подключаются к MariaDB по порту 3306 без его публикации. Внешний доступ включайте только при необходимости и ограничивайте firewall или VPN. В шаблоне Unihost публикация порта включается в редакторе стека:

ports:
  - "3306:3306"

Для безопасного доступа к phpMyAdmin настройте домен через Nginx Proxy Manager (NPM):

  1. Создайте DNS-запись A для db.example.com, направленную на публичный IP VPS.
  2. Откройте NPM → Hosts → Proxy Hosts → Add Proxy Host.
  3. Укажите Domain Names: db.example.com и Scheme: http.
  4. В Forward Hostname / IP укажите имя контейнера phpMyAdmin, доступное из NPM, а в Forward Port установите 80.
  5. На вкладке SSL запросите сертификат Let’s Encrypt, включите Force SSL, сохраните настройки и откройте https://db.example.com.

NPM должен иметь доступ к phpMyAdmin по Docker-сети. Ограничьте доступ к phpMyAdmin. NPM проксирует веб-интерфейс phpMyAdmin, а не протокол MariaDB на TCP-порту 3306.

Инструкция по установке и настройке Nginx Proxy Manager

Не открывайте порт базы данных 3306 в интернет без необходимости; ограничивайте доступ правилами firewall.

Proxy Host для phpMyAdmin в Nginx Proxy Manager

Внутренний адрес phpmyadmin и порт 80 в Nginx Proxy Manager

Шаг 4. Проверьте подключение

Откройте консоль MariaDB (вместо CONTAINER укажите имя из docker ps):

docker exec -it CONTAINER mariadb -u root -p

После ввода пароля выполните SQL-команду ниже. В списке должна быть ваша база. Также можно войти в phpMyAdmin через HTTPS.

SHOW DATABASES;

На скриншотах показан исходный интерфейс phpMyAdmin. Для рабочего сервера используйте HTTPS через Nginx Proxy Manager и ограничивайте доступ доверенными пользователями.

Экран входа в phpMyAdmin после установки MariaDB

Панель phpMyAdmin с подключением к серверу MariaDB

Шаг 5. Создайте резервную копию

Создайте SQL-копию на Docker-хосте с помощью mariadb-dump:

docker exec CONTAINER sh -c 'exec mariadb-dump -u root -p"$MARIADB_ROOT_PASSWORD" appdb' > backup.sql

Пример использует переменную MARIADB_ROOT_PASSWORD внутри контейнера. Если шаблон хранит пароль в Docker secrets, используйте соответствующий способ авторизации. Проверьте файл и сохраните копию вне VPS.

Шаг 6. Обновите MariaDB

Сначала создайте резервную копию. В Portainer выберите совместимую версию образа MariaDB и повторно разверните стек с сохранением тома. В официальном образе доступен параметр:

MARIADB_AUTO_UPGRADE=1

MARIADB_AUTO_UPGRADE обновляет системные таблицы при необходимости, но не заменяет полноценный бекап и не гарантирует возможность отката. Перед сменой основной версии проверьте путь обновления.

Проверка

Проверьте, что контейнер запущен, phpMyAdmin подключается, база существует, а файл SQL-копии не пуст. При необходимости посмотрите журналы:

docker ps
docker logs --tail 50 CONTAINER
ls -lh backup.sql

Устранение проблем

MariaDB не запускается

Проверьте логи контейнера, конфигурацию, место на диске и права доступа к volume.

Нет удалённого подключения

Проверьте пользователя, Docker-сеть, проброс порта и firewall. Не открывайте 3306 для всех адресов.

Изменение пароля не работает

Переменные инициализации не сбрасывают пароль в существующей базе. Измените его SQL-командами MariaDB.

Частые вопросы

Как подключиться к MariaDB с другого сервера?

Опубликуйте порт 3306 только при необходимости, ограничьте доверенные IP и настройте пользователя MariaDB. Предпочтительнее приватная сеть или VPN.

Где хранятся данные?

MariaDB хранит данные в /var/lib/mysql внутри контейнера. Постоянный Docker volume сохраняет их при пересоздании контейнера.

Как создать резервную копию базы?

Используйте mariadb-dump для экспорта SQL и храните копию вне сервера. Регулярно проверяйте восстановление.

Как обновить MariaDB?

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

Связанные статьи

MariaDB на серверах Unihost

Разворачивайте MariaDB через готовые шаблоны Portainer или выбирайте выделенные серверы для баз данных.

Документация официального Docker-образа MariaDB