К содержимому

MariaDB в Docker: запуск и настройка на Ubuntu 24.04

MariaDB в Docker поднимается одним файлом compose.yaml: образ mariadb, volume для данных, переменные для root и приложения.

Руководство MySQL 3 мин чтения

01Проверьте Docker и Docker Compose

На сервере уже должны работать Docker и плагин Compose. Одна команда показывает обе версии. Если вывод содержит command not found, установите Docker по официальной инструкции и вернитесь к этому шагу.

bash
docker --version
docker compose version

02Создайте каталог проекта и файл compose.yaml

Заведите отдельный каталог, чтобы рядом с compose.yaml лежали данные и дампы. В файле описан один сервис db на образе mariadb с публикацией порта 3306 и volume db_data. Пароли подставьте свои, в примере они условные.

bash
mkdir -p /opt/mariadb && cd /opt/mariadb
nano compose.yaml

03Опишите сервис MariaDB в compose.yaml

Переменная MARIADB_ROOT_PASSWORD обязательна: без неё контейнер не стартует и пишет в лог, что пароль root не задан. MARIADB_DATABASE создаёт базу при первом запуске, MARIADB_USER и MARIADB_PASSWORD заводят пользователя с правами на эту базу. Volume db_data хранит /var/lib/mysql, поэтому данные не теряются при пересоздании контейнера.

yaml
services:
  db:
    image: mariadb:11
    container_name: mariadb
    restart: unless-stopped
    environment:
      MARIADB_ROOT_PASSWORD: "ChangeMeRoot123"
      MARIADB_DATABASE: "shop"
      MARIADB_USER: "shop"
      MARIADB_PASSWORD: "ChangeMeShop123"
    ports:
      - "3306:3306"
    volumes:
      - db_data:/var/lib/mysql

volumes:
  db_data:

04Запустите контейнер

Команда скачивает образ и поднимает сервис в фоне. В выводе будет строка вида Container mariadb Started, она значит, что контейнер запущен. Первый запуск занимает больше времени: MariaDB инициализирует каталог данных.

bash
docker compose up -d

05Проверьте, что контейнер работает и база отвечает

docker compose ps показывает состояние running, а docker compose logs db не должен содержать ошибок инициализации. Клиент внутри контейнера подтверждает, что сервер принимает подключения. Список баз должен включать shop.

bash
docker compose ps
docker compose logs --tail=50 db
docker compose exec db mariadb -u root -pChangeMeRoot123 -e "SHOW DATABASES;"

06Создайте пользователя и базу вручную

Переменные образа создают пользователя только при первом запуске на пустом volume. Дальше пользователей и базы заводят SQL-командами. В MariaDB, как и в MySQL, пользователь определяется парой имени и хоста: 'app'@'%' подходит для подключения по сети, 'app'@'localhost' для локального сокета и подключений с 127.0.0.1. FLUSH PRIVILEGES после CREATE USER и GRANT не нужен.

bash
docker compose exec db mariadb -u root -pChangeMeRoot123 -e "CREATE DATABASE app;"
docker compose exec db mariadb -u root -pChangeMeRoot123 -e "CREATE USER 'app'@'%' IDENTIFIED BY 'AppPass123';"
docker compose exec db mariadb -u root -pChangeMeRoot123 -e "GRANT ALL PRIVILEGES ON app.* TO 'app'@'%';"

07Посмотрите базы и удалите ненужную

Список баз выводит SHOW DATABASES;. Удаление выполняют командой DROP DATABASE, она стирает все таблицы без подтверждения. Перед удалением снимите дамп, если данные могут понадобиться.

bash
docker compose exec db mariadb -u root -pChangeMeRoot123 -e "SHOW DATABASES;"
docker compose exec db mariadb -u root -pChangeMeRoot123 -e "DROP DATABASE app;"

08Снимите дамп и проверьте сохранность данных

Дамп снимают клиентом mariadb-dump внутри контейнера. Флаг -T у docker compose exec отключает TTY, иначе перенаправление вывода в файл может не сработать. После docker compose down и нового up -d база shop должна остаться на месте: это подтверждает, что volume подключён верно.

bash
docker compose exec -T db mariadb-dump -u root -pChangeMeRoot123 shop > dump.sql
docker compose down
docker compose up -d
docker compose exec db mariadb -u root -pChangeMeRoot123 -e "SHOW DATABASES;"

Частые ошибки

  • Контейнер не стартует, в docker compose logs db сообщение о том, что не задан пароль root.

    Задайте MARIADB_ROOT_PASSWORD в секции environment. Если пустой root нужен намеренно, добавьте MARIADB_ALLOW_EMPTY_ROOT_PASSWORD: "yes" или MARIADB_RANDOM_ROOT_PASSWORD: "yes".

  • docker compose up -d завершается ошибкой Bind for 0.0.0.0:3306 failed: port is already allocated.

    Порт 3306 занят службой на хосте. Остановите её: sudo systemctl stop mysql для MySQL или sudo systemctl stop mariadb для MariaDB. Другой вариант: публикуйте "3307:3306" и подключайтесь к порту 3307.

  • Пользователь 'app'@'%' не подключается из другого контейнера, хотя пароль верный.

    Проверьте хост в CREATE USER: для подключения по сети нужен 'app'@'%'. Убедитесь, что контейнеры в одной сети Docker Compose и вы обращаетесь к хосту db, а не к localhost.

  • docker compose exec db mariadb-dump -u root -p shop > dump.sql создаёт пустой файл или зависает.

    Передайте пароль без интерактивного запроса и отключите TTY: docker compose exec -T db mariadb-dump -u root -pChangeMeRoot123 shop > dump.sql.

Deploykin

Как это делается в Deploykin

В Deploykin базы MySQL и пользователи создаются из панели, phpMyAdmin открывается в один клик. Бэкапы баз уходят по расписанию на ваше SFTP-хранилище, сжатыми и проверенными, а восстановление запускается из панели.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Чем MariaDB в Docker отличается от установки пакетом на хост?

В контейнере версия MariaDB задаётся тегом образа, а данные лежат в volume. Пакет на хосте ставит одну версию из репозитория Ubuntu и пишет данные в /var/lib/mysql.

Где хранятся данные контейнера MariaDB?

В volume db_data, он подключён к /var/lib/mysql внутри контейнера. Пока volume существует, docker compose down и up -d не удаляют базы.

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

По имени сервиса в compose.yaml, например хосту db и порту 3306, с пользователем вида 'app'@'%'. Порт 3306 наружу для этого не нужен.

Что будет, если удалить volume db_data?

Все базы и пользователи пропадут: docker compose down -v удаляет volume вместе с данными. Сначала снимите дамп через mariadb-dump.

Ещё по теме

MySQL на своём сервере: установка, настройка и типичные ошибки: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.