MariaDB Docker镜像文档

镜像概述

MariaDB是MySQL的社区开发分支，旨在遵循GNU GPL协议保持免费。本Docker镜像提供了MariaDB数据库服务的便捷部署方式，支持通过环境变量灵活配置数据库实例。

基础设置

• 端口: 3306 (MariaDB默认端口)
• 数据目录: /var/lib/mysql (数据库文件存储路径)
• 日志路径: /var/log/mysql (日志文件存储路径)

环境变量配置

启动镜像时，可通过传递环境变量调整实例配置。支持以下环境变量：

核心配置变量

• MYSQL_ROOT_PASSWORD (必填)
• MYSQL_DATABASE (可选)
• MYSQL_USER (可选)
• MYSQL_PASSWORD (可选)
• MYSQL_RESET (可选)
• MYSQL_DEBUG (可选)

复制配置变量（主从复制用）

• MYSQL_MASTER_HOST (可选)
• MYSQL_MASTER_PORT (可选)
• MYSQL_MASTER_USER (可选)
• MYSQL_MASTER_PASSWORD (可选)

变量详细说明

MYSQL_ROOT_PASSWORD

必填项，指定root超级用户账户的密码。

MYSQL_DATABASE

可选项，指定镜像启动时创建的数据库名称。若同时提供了用户/密码（见下文），该用户将被授予对该数据库的超级用户权限（对应GRANT ALL）。

MYSQL_USER

可选项，需与MYSQL_PASSWORD配合使用以创建新用户。该用户将被授予对MYSQL_DATABASE指定数据库的超级用户权限。创建用户时两个变量均为必填。

MYSQL_PASSWORD

可选项，与MYSQL_USER配合使用以设置新用户的密码。无需通过此方式创建root用户，root用户默认创建，密码由MYSQL_ROOT_PASSWORD指定。

MYSQL_RESET

可选项，设置为YES可重置相关变量。

MYSQL_DEBUG

可选项，设置为YES可显示初始化命令。

复制相关变量

• MYSQL_MASTER_HOST: 主库主机地址
• MYSQL_MASTER_PORT: 主库端口（默认3306）
• MYSQL_MASTER_USER: 主库复制用户
• MYSQL_MASTER_PASSWORD: 主库复制用户密码

使用方法

基本启动命令

bash
docker run -d \
  -p 3306:3306 \
  -e MYSQL_ROOT_PASSWORD=mysecretpassword \
  --name mariadb \
  agrozyme/mariadb

创建数据库和用户

bash
docker run -d \
  -p 3306:3306 \
  -e MYSQL_ROOT_PASSWORD=mysecretpassword \
  -e MYSQL_DATABASE=mydb \
  -e MYSQL_USER=myuser \
  -e MYSQL_PASSWORD=mypassword \
  --name mariadb \
  agrozyme/mariadb

此命令将创建数据库mydb，并创建用户myuser（密码mypassword），授予其对mydb的全部权限。

配置主从复制（从库）

bash
docker run -d \
  -p 3306:3306 \
  -e MYSQL_ROOT_PASSWORD=mysecretpassword \
  -e MYSQL_MASTER_HOST=master_ip \
  -e MYSQL_MASTER_PORT=3306 \
  -e MYSQL_MASTER_USER=repluser \
  -e MYSQL_MASTER_PASSWORD=replpass \
  --name mariadb-slave \
  agrozyme/mariadb

数据持久化

建议挂载数据目录以持久化存储数据库文件：

bash
docker run -d \
  -p 3306:3306 \
  -e MYSQL_ROOT_PASSWORD=mysecretpassword \
  -v /host/data:/var/lib/mysql \
  --name mariadb \
  agrozyme/mariadb

日志持久化

挂载日志目录以保存日志文件：

bash
docker run -d \
  -p 3306:3306 \
  -e MYSQL_ROOT_PASSWORD=mysecretpassword \
  -v /host/logs:/var/log/mysql \
  --name mariadb \
  agrozyme/mariadb