MariaDB в Docker: запуск и настройка на Ubuntu 24.04
MariaDB в Docker поднимается одним файлом compose.yaml: образ mariadb, volume для данных, переменные для root и приложения.
01Проверьте Docker и Docker Compose
На сервере уже должны работать Docker и плагин Compose. Одна команда показывает обе версии. Если вывод содержит command not found, установите Docker по официальной инструкции и вернитесь к этому шагу.
docker --version
docker compose version
02Создайте каталог проекта и файл compose.yaml
Заведите отдельный каталог, чтобы рядом с compose.yaml лежали данные и дампы. В файле описан один сервис db на образе mariadb с публикацией порта 3306 и volume db_data. Пароли подставьте свои, в примере они условные.
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, поэтому данные не теряются при пересоздании контейнера.
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 инициализирует каталог данных.
docker compose up -d
05Проверьте, что контейнер работает и база отвечает
docker compose ps показывает состояние running, а docker compose logs db не должен содержать ошибок инициализации. Клиент внутри контейнера подтверждает, что сервер принимает подключения. Список баз должен включать shop.
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 не нужен.
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, она стирает все таблицы без подтверждения. Перед удалением снимите дамп, если данные могут понадобиться.
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 подключён верно.
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 База данных MySQL на сервере Ubuntu 24.04: пошаговая настройка Пошагово: проверка MySQL 8.0 на Ubuntu 24.04, создание базы и пользователя, подключение, проверка версии и прав. Команды и проверка результата.
- Руководство · MySQL Настройка phpMyAdmin по http на Ubuntu 24.04 Как открыть phpMyAdmin по http на Ubuntu 24.04: установка без Apache, настройка nginx и PHP-FPM, отдельный пользователь MySQL, проверка входа и типичные ошибки.
- Руководство · MySQL MySQL port: настройка внешнего доступа на Ubuntu 24.04 Пошаговая настройка порта MySQL 3306 на Ubuntu 24.04: bind-address, файрвол, пользователь для внешнего хоста, проверка подключения с другого сервера.
- Руководство · MySQL MySQL консоль на Ubuntu 24.04: вход, команды и проверка Как войти в консоль MySQL на Ubuntu 24.04: sudo mysql, создание пользователя, подключение к базе, проверка и типичные ошибки 1045 и 1698.
- Руководство · MySQL Как посмотреть пользователей MySQL и управлять ими Как посмотреть пользователей MySQL, добавить и удалить их, сменить пароль. Команды для Ubuntu 24.04, проверка списка через mysql.user и SHOW GRANTS.
- Руководство · MySQL phpMyAdmin что это: настройка PHP-FPM на Ubuntu 24.04 Пошаговая настройка PHP 8.3 и PHP-FPM на Ubuntu 24.04: установка пакетов, пул www, лимиты памяти, связка с nginx и проверка работы сайта.
MySQL на своём сервере: установка, настройка и типичные ошибки: все материалы темы