Встановіть 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