yobasystems/alpine-mariadb

基于Alpine Linux的MariaDB容器镜像

![Alpine版本]([] ![MariaDB版本]([]

此容器镜像 https://hub.docker.com/r/yobasystems/alpine-mariadb/ 基于轻量级 Alpine Linux 构建，集成 MariaDB v11.4.8（MySQL兼容）数据库服务器。

Alpine版本 3.22.1（发布于2025-07-15）

MariaDB版本 11.4.8

目录

• 什么是Alpine Linux？
• 什么是MariaDB？
• 特性
• 支持的架构
• 标签
• 镜像层与大小
• 如何使用此镜像
• 镜像内容与漏洞分析
• 源码仓库
• 容器仓库
• 链接

🏔️ 什么是Alpine Linux？

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

什么是MariaDB？

MariaDB Server是世界上最受欢迎的数据库服务器之一。它由MySQL的原始开发人员创建，并保证保持开源。知名用户包括***、WordPress.com和Google。

MariaDB在从银行到网站的各种应用中将数据转换为结构化信息。它是MySQL的增强型替代品，因其速度快、可扩展性强且稳定可靠而被广泛使用，丰富的存储引擎、插件和其他工具使其在各种用例中非常通用。

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

✨ 特性

• 镜像体积小，层数少
• 简单安装时内存占用低
• MariaDB作为MySQL的替代品

🏗️ 支持的架构

• :amd64, :x86_64 - 64位Intel/AMD（x86_64/amd64）
• :arm64v8, :aarch64 - 64位ARM（ARMv8/aarch64）
• :arm32v7, :armhf - 32位ARM（ARMv7/armhf）

📝 请查看下方标签了解支持的架构，以上为架构说明列表

🏷️ 标签

• :latest 基于最新分支（自动选择架构）
• :amd64, :x86_64 基于最新标签的amd64架构版本
• :aarch64, :arm64v8 基于最新标签的arm64架构版本
• :armhf, :arm32v7 基于最新标签的arm32架构版本
• :version 版本标签，例如 :10, :10.11, 11.4.8

📏 镜像层与大小

!版本 !Docker镜像大小（标签）

!版本 !Docker镜像大小（标签）

!版本 !Docker镜像大小（标签）

🚀 如何使用此镜像

卷结构

• /var/lib/mysql: 数据库文件存储路径
• /var/lib/mysql/mysql-bin: MariaDB日志存储路径

初始化脚本

• /docker-entrypoint-initdb.d：用于已运行系统的数据库备份文件（已存在数据库时使用）
• /scripts/pre-exec.d：主进程运行前执行的脚本
• /scripts/pre-init.d：数据库初始化前执行的脚本
• /scripts/first-run.d：数据库首次初始化时执行的脚本

初始化脚本执行顺序

1. /scripts/pre-init.d
2. /scripts/first-run.d
3. /docker-entrypoint-initdb.d
4. /scripts/pre-exec.d

环境变量：

主要MariaDB参数：

• MYSQL_DATABASE: 指定数据库名称
• MYSQL_USER: 指定数据库用户
• MYSQL_PASSWORD: 指定数据库用户密码
• MYSQL_ROOT_PASSWORD: 指定MariaDB的root用户密码
• MYSQL_CHARSET: MariaDB的默认字符集（默认utf8）
• MYSQL_COLLATION: MariaDB的默认排序规则（默认utf8_general_ci）

建议在Kubernetes或Swarm中将这些参数作为密钥注入。

字符集列表及说明

设置字符集时，请确保同时选择排序规则，否则将使用默认值。

+----------+-----------------------------+---------------------+--------+
| 字符集   | 描述                        | 默认排序规则        | 最大长度 |
+----------+-----------------------------+---------------------+--------+
| 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 Relcom俄语           | 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 Kamenicky捷克-斯洛伐克语 | 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 |
+----------+-----------------------------+---------------------+--------+

来源：[***]

创建实例

bash
docker run -it --name mysql -p 3306:3306 -v /var/lib/mysql:/var/lib/mysql -e MYSQL_DATABASE=wordpressdb -e MYSQL_USER=wordpressuser -e MYSQL_PASSWORD=hguyFt6S95dgfR4ryb -e MYSQL_ROOT_PASSWORD=hguyFtgfR4r9R4r76 yobasystems/alpine-mariadb

此命令将创建一个新数据库，并设置MySQL root密码（默认情况下由pwgen生成随机密码RaNd0MpA$$W0Rd），除非数据已存在。

不使用cnf文件的配置

许多配置选项可以作为参数传递给mariadbd。这使您可以灵活地自定义容器，而无需.cnf文件。例如，如果要将所有表的默认编码和排序规则更改为UTF-8（utf8mb4），只需运行以下命令：

bash
docker run --name some-mariadb -e MYSQL_ROOT_PASSWORD=my-secret-pw -d yobasystems/alpine-mariadb --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci

常用命令参数：

• --character-set-server=utf8（设置服务器字符集为utf8）
• --collation-server=utf8_bin（设置服务器排序规则为utf8_bin）
• --explicit-defaults-for-timestamp=1（为时间戳启用显式默认值）

配置文件位置

配置文件位于：

• /etc/my.cnf
• /etc/my.cnf.d/mariadb-server.cnf

初始化新实例

当容器首次启动时，将创建具有指定名称的新数据库，并使用提供的配置变量进行初始化。此外，它将执行在/docker-entrypoint-initdb.d中找到的扩展名为.sh、.sql和.sql.gz的文件。文件将按字母顺序执行。您可以通过将SQL转储文件挂载到该目录来轻松填充MariaDB服务，或提供包含贡献数据的自定义镜像。SQL文件默认将导入到MYSQL_DATABASE变量指定的数据库中。

Docker Compose示例：

（请传递您自己的凭据或让它们自动生成，不要在生产环境中使用这些凭据！！）

yaml
mysql:
  image: yobasystems/alpine-mariadb
  environment:
    MYSQL_ROOT_PASSWORD: hguyFtgfR4r9R4r76
    MYSQL_DATABASE: wordpressdb
    MYSQL_USER: wordpressuser
    MYSQL_PASSWORD: hguyFt6S95dgfR4ryb
  expose:
    - "3306"
  volumes:
    - /data/example/mysql:/var/lib/mysql
  restart: always

Docker Swarm示例：

以下是Docker Swarm示例，首先创建一些密钥，然后创建服务：

bash
printf "hguyFtgfR4r9R4r76" | docker secret create MYSQL_ROOT_PASSWORD -
printf "wordpressdb" | docker secret create MYSQL_DATABASE -
printf "wordpressuser" | docker secret create MYSQL_USER -
printf "hguyFt6S95dgfR4ryb" | docker secret create MYSQL_PASSWORD -
printf "utf8mb4" | docker secret create MYSQL_CHARSET -
printf "utf8mb4_general_ci" | docker secret create MYSQL_COLLATION -

docker service create \
     --name mariadb \
     --replicas 1 \
     --secret source=MYSQL_ROOT_PASSWORD,target=mysql_root_password \
     --secret source=MYSQL_PASSWORD,target=mysql_password \
     --secret source=MYSQL_USER,target=mysql_user \
     --secret source=MYSQL_DATABASE,target=mysql_database \
     -e MYSQL_ROOT_PASSWORD_FILE="/run/secrets/mysql_root_password" \
     -e MYSQL_PASSWORD_FILE="/run/secrets/mysql_password" \
     -e MYSQL_USER_FILE="/run/secrets/mysql_user" \
     -e MYSQL_DATABASE_FILE="/run/secrets/mysql_database" \
     yobasystems/alpine-mariadb:latest

🔍 镜像内容与漏洞分析

📚 源码仓库

• https://github.com/yobasystems/alpine-mariadb
• Gitlab - yobasystems/alpine-mariadb

🐳 容器仓库

• https://hub.docker.com/r/yobasystems/alpine-mariadb/
• Quay.io - yobasystems/alpine-mariadb
• GHCR - yobasystems/alpine-mariadb

🔗 链接

• Yoba Systems
• https://github.com/yobasystems/
• https://hub.docker.com/u/yobasystems/
• GHCR - Yoba Systems
• Quay.io - Yoba Systems
• https://github.com/dominictayloruk