支持多语言及时区的MariaDB Docker镜像（基于Alpine Linux）

![Docker Automated build]([] ![Docker Pulls]([] ![Docker Stars]([***]

![Alpine Version]([] ![MariaDB Version]([]

此Docker镜像(maurosoft1973/alpine-mariadb)基于轻量级Alpine Linux，内置MariaDB v11.4.4-r1（兼容MySQL）数据库服务器。

Alpine版本：3.21.0（发布于2024-12-05）

MariaDB版本：11.4.4-r1（发布于2024-11-22）

什么是Alpine Linux？

Alpine Linux是一个基于musl libc和BusyBox构建的Linux发行版。该镜像仅5MB大小，且可访问比其他基于BusyBox的镜像更完整的软件包仓库。这使得Alpine Linux成为实用工具甚至生产应用的理想镜像基础。

什么是MariaDB？

MariaDB Server是全球最受欢迎的数据库服务器之一，由MySQL原开发团队打造，保证开源。知名用户包括***、WordPress.com和谷歌。

MariaDB能将数据转换为各类应用中的结构化信息，应用范围从银行系统到网站。它是MySQL的增强型替代品，因其快速、可扩展和健壮的特性，以及丰富的存储引擎、插件和工具生态系统，适用于多种使用场景。

MariaDB作为开源软件开发，作为关系型数据库提供SQL接口访问数据。最新版本还包含GIS和JSON功能。

特性

• 最小体积和层数
• 简单安装下内存占用极低
• 多语言支持
• 时区支持
• MariaDB作为MySQL替代品

架构

• :aarch64 - 64位ARM
• :armhf - 32位ARM v6
• :armv7 - 32位ARM v7
• :ppc64le - 64位PowerPC
• :x86 - 32位Intel/AMD
• :x86_64 - 64位Intel/AMD（x86_64/amd64）

标签

• :latest 基于最新分支（自动架构选择）
• :aarch64 最新64位ARM
• :armhf 最新32位ARM v6
• :armv7 最新32位ARM v7
• :ppc64le 最新64位PowerPC
• :x86 最新32位Intel/AMD
• :x86_64 最新64位Intel/AMD
• :test 基于测试分支（自动架构选择）
• :test-aarch64 测试版64位ARM
• :test-armhf 测试版32位ARM v6
• :test-armv7 测试版32位ARM v7
• :test-ppc64le 测试版64位PowerPC
• :test-x86 测试版32位Intel/AMD
• :test-x86_64 测试版64位Intel/AMD
• :3.21.0-11.4.4-r1 基于3.21.0-11.4.4-r1分支（自动架构选择）
• :3.21.0-11.4.4-r1-aarch64 3.21.0版本64位ARM
• :3.21.0-11.4.4-r1-armhf 3.21.0版本32位ARM v6
• :3.21.0-11.4.4-r1-armv7 3.21.0版本32位ARM v7
• :3.21.0-11.4.4-r1-ppc64le 3.21.0版本64位PowerPC
• :3.21.0-11.4.4-r1-x86 3.21.0版本32位Intel/AMD
• :3.21.0-11.4.4-r1-x86_64 3.21.0版本64位Intel/AMD

层与大小

卷结构

• /etc/my.cnf.d: MariaDB配置文件目录
• /var/lib/mysql: 数据库文件目录
• /var/lib/mysql/mysql-bin: MariaDB日志目录

环境变量

主要MariaDB参数：

• LC_ALL: 默认区域设置（en_GB.UTF-8）
• TIMEZONE: 默认时区（Europe/Brussels）
• MYSQL_DATA_USER: 指定MySQL数据目录所有者（默认：mysql）
• MYSQL_DATA_USER_UID: 指定MySQL数据目录所有者UID（默认：100）
• MYSQL_DATA_GROUP: 指定MySQL数据目录组（默认：mysql）
• MYSQL_DATA_GROUP_UID: 指定MySQL数据目录组GID（默认：101）
• MYSQL_DATABASE: 指定数据库名称（默认：demo）
• MYSQL_CHARSET: 指定数据库字符集（默认：utf8）
• MYSQL_COLLATION: 指定数据库排序规则（默认：utf8_general_ci）
• MYSQL_USER: 指定数据库用户（默认：demo）
• MYSQL_PASSWORD: 指定数据库用户密码（为空则自动生成）
• MYSQL_PASSWORD_LENGTH: 指定用户密码长度（当MYSQL_PASSWORD为空时使用）
• MYSQL_ROOT_PASSWORD: 指定root用户密码（为空则自动生成）
• MYSQL_ROOT_PASSWORD_LENGTH: 指定root密码长度（当MYSQL_ROOT_PASSWORD为空时使用）
• MYSQL_REPLICATION: 启用复制（1=启用，默认0）
• MYSQL_REPLICATION_USER: 指定复制用户（默认：replic）
• MYSQL_REPLICATION_PASSWORD: 指定复制用户密码（默认：replic）
• MYSQL_REPLICATION_SERVER_ID: 复制服务器唯一ID（默认：1）
• MYSQL_REPLICATION_LOG_BIN: 启用复制所需的binlog（默认：/var/log/mysql/mysql-bin.log）
• MYSQL_REPLICATION_BINLOG_FORMAT: 二进制日志格式（STATEMENT/ROW/MIXED，默认ROW）
• MYSQL_REPLICATION_BINLOG_EXPIRE_LOG_SECONDS: 二进制日志过期时间（秒，默认864000）
• MYSQL_REPLICATION_MAX_BINLOG_SIZE: 二进制日志轮转大小（默认500M）

区域设置列表

设置区域时需指定，否则使用默认值（en_GB.UTF-8）。

+-----------------+
| 区域设置         |
+-----------------+
| fr_CH.UTF-8     |
| fr_FR.UTF-8     |
| de_CH.UTF-8     |
| de_DE.UTF-8     |
| en_GB.UTF-8     |
| en_US.UTF-8     |
| es_ES.UTF-8     |
| it_CH.UTF-8     |
| it_IT.UTF-8     |
| nb_NO.UTF-8     |
| nl_NL.UTF-8     |
| pt_PT.UTF-8     |
| pt_BR.UTF-8     |
| ru_RU.UTF-8     |
| sv_SE.UTF-8     |
+-----------------+

字符集及信息列表

设置字符集时需指定排序规则，否则使用默认值。

+----------+-----------------------------+---------------------+--------+
| 字符集   | 描述                        | 默认排序规则        | 最大长度 |
+----------+-----------------------------+---------------------+--------+
| big5     | Big5繁体中文                | big5_chinese_ci     |      2 |
| dec8     | DEC西欧语言                  | dec8_swedish_ci     |      1 |
| cp850    | DOS西欧语言                  | cp850_general_ci    |      1 |
| hp8      | HP西欧语言                   | hp8_english_ci      |      1 |
| koi8r    | KOI8-R俄罗斯语               | koi8r_general_ci    |      1 |
| latin1   | cp1252西欧语言               | latin1_swedish_ci   |      1 |
| latin2   | ISO 8859-2中欧语言           | latin2_general_ci   |      1 |
| swe7     | 7位瑞典语                    | swe7_swedish_ci     |      1 |
| ascii    | US ASCII                     | ascii_general_ci    |      1 |
| ujis     | EUC-JP日语                   | ujis_japanese_ci    |      3 |
| sjis     | Shift-JIS日语                | sjis_japanese_ci    |      2 |
| hebrew   | ISO 8859-8希伯来语           | hebrew_general_ci   |      1 |
| tis620   | TIS620泰语                   | tis620_thai_ci      |      1 |
| euckr    | EUC-KR韩语                   | euckr_korean_ci     |      2 |
| koi8u    | KOI8-U乌克兰语               | koi8u_general_ci    |      1 |
| gb2312   | GB2312简体中文               | gb2312_chinese_ci   |      2 |
| greek    | ISO 8859-7希腊语             | greek_general_ci    |      1 |
| cp1250   | Windows中欧语言              | cp1250_general_ci   |      1 |
| gbk      | GBK简体中文                  | gbk_chinese_ci      |      2 |
| latin5   | ISO 8859-9土耳其语           | latin5_turkish_ci   |      1 |
| armscii8 | ARMSCII-8亚美尼亚语          | armscii8_general_ci |      1 |
| utf8     | UTF-8 Unicode                | utf8_general_ci     |      3 |
| ucs2     | UCS-2 Unicode                | ucs2_general_ci     |      2 |
| cp866    | DOS俄语                      | cp866_general_ci    |      1 |
| keybcs2  | DOS捷克-斯洛伐克语           | keybcs2_general_ci  |      1 |
| macce    | Mac中欧语言                  | macce_general_ci    |      1 |
| macroman | Mac西欧语言                  | macroman_general_ci |      1 |
| cp852    | DOS中欧语言                  | cp852_general_ci    |      1 |
| latin7   | ISO 8859-13波罗的海语        | latin7_general_ci   |      1 |
| utf8mb4  | UTF-8 Unicode                | utf8mb4_general_ci  |      4 |
| cp1251   | Windows西里尔语              | cp1251_general_ci   |      1 |
| utf16    | UTF-16 Unicode               | utf16_general_ci    |      4 |
| utf16le  | UTF-16LE Unicode             | utf16le_general_ci  |      4 |
| cp1256   | Windows阿拉伯语              | cp1256_general_ci   |      1 |
| cp1257   | Windows波罗的海语            | cp1257_general_ci   |      1 |
| utf32    | UTF-32 Unicode               | utf32_general_ci    |      4 |
| binary   | 二进制伪字符集                | binary              |      1 |
| geostd8  | GEOSTD8格鲁吉亚语            | geostd8_general_ci  |      1 |
| cp932    | Windows日语SJIS              | cp932_japanese_ci   |      2 |
| eucjpms  | Windows日语UJIS              | eucjpms_japanese_ci |      3 |
+----------+-----------------------------+---------------------+--------+

[***]

使用示例

1. 使用默认值创建容器

sh
docker run --rm --name mysql -p 3306:3306 -v /var/lib/mysql:/var/lib/mysql maurosoft1973/alpine-mariadb

2. 创建指定字符集和排序规则的容器

bash
docker run --rm --name mysql -p 3306:3306 -v /var/lib/mysql:/var/lib/mysql -e MYSQL_CHARSET=utf8mb4 -e MYSQL_COLLATION=utf8mb4_unicode_ci maurosoft1973/alpine-mariadb

3. 使用初始化脚本导入数据库

首次启动容器时，会创建指定名称的数据库并使用提供的配置变量初始化。此外，容器会执行/docker-entrypoint-initdb.d目录中扩展名为.sh、.sql和.sql.gz的文件，按字母顺序执行。通过挂载SQL转储文件到该目录，可轻松初始化数据库。SQL文件默认导入到MYSQL_DATABASE指定的数据库。

sh
docker run --rm --name mysql -p 3306:3306 -v /var/lib/mysql:/var/lib/mysql -v /myscript/initdb:/docker-entrypoint-initdb.d -v /myscript/pre-init:/scripts/pre-init.d -e MYSQL_DATABASE=dbtest -e MYSQL_USER=user -e MYSQL_PASSWORD=pwd -e MYSQL_ROOT_PASSWORD=root maurosoft1973/alpine-mariadb

4. Docker Compose示例

（请使用自定义凭据或让系统自动生成，生产环境请勿使用示例凭据！）

yaml
mysql:
  image: maurosoft1973/alpine-mariadb
  environment:
    MYSQL_ROOT_PASSWORD: test
    MYSQL_DATABASE: