tobi312/rpi-mariadb

MariaDB Docker镜像文档（支持amd64、arm64、arm架构）

1. 镜像概述和主要用途

1.1 MariaDB简介

MariaDB是全球最流行的数据库服务器之一，由MySQL原开发团队创建，确保开源特性。其显著用户包括***、星展银行（DBS Bank）和ServiceNow等。MariaDB旨在保持与MySQL的高度兼容性，确保库二进制等效性以及与MySQL API和命令的精确匹配，同时持续开发新功能并优化性能。

1.2 本镜像用途

本镜像为MariaDB（MySQL分支）的Docker镜像，支持amd64、arm64及arm架构（如树莓派），基于官方Linux发行版镜像构建，适用于需要在多架构环境中部署MariaDB的场景，尤其针对arm架构设备提供适配支持。

2. 支持的标签

注意：对于amd64和arm64架构，建议优先使用基于Ubuntu的https://hub.docker.com/_/mariadb%E3%80%82

3. 核心功能与特性

• 架构兼容性：支持amd64、arm64及arm架构，适配树莓派等嵌入式设备。
• 官方移植：基于官方https://hub.docker.com/_/mariadb%E7%A7%BB%E6%A4%8D%EF%BC%88https://github.com/MariaDB/mariadb-docker%EF%BC%89%E3%80%82
• 可靠基础：构建于Alpine、Ubuntu、Debian等官方基础镜像之上。
• 原生包管理：使用各Linux发行版原生包管理器安装MariaDB（Alpine的apk、Ubuntu/Debian的apt）。
• 自动化构建：通过GitHub Actions实现自动化构建，确保镜像更新与安全性。

4. 使用场景和适用范围

• 嵌入式设备：适用于树莓派（Raspberry Pi）等arm架构设备部署数据库服务。
• 边缘计算：在边缘节点提供轻量级数据库支持，满足本地数据处理需求。
• 多架构开发/测试：为跨架构应用开发提供一致的数据库环境。
• 资源受限环境：Alpine版本镜像体积更小，适合资源有限的场景（如IoT设备）。

5. 使用方法和配置说明

5.1 前提条件

• 已安装Docker Engine（20.10+推荐）或Docker Desktop。
• 已安装Docker Compose（如需使用编排功能）。

5.2 Docker Run快速部署

通过以下命令快速启动MariaDB容器：

sh
docker run --name some-mariadb \
  -v $(pwd)/mariadb:/var/lib/mysql:rw \  # 挂载数据卷（持久化数据）
  -p 3306:3306 \  # 映射端口（主机:容器）
  -e MARIADB_ROOT_PASSWORD=my-secret-pw \  # 设置root密码
  -d tobi312/rpi-mariadb:10.6-alpine  # 指定镜像及标签

说明：更多高级用法可参考https://hub.docker.com/_/mariadb%E3%80%82

5.3 Docker Compose编排示例

创建docker-compose.yml文件，配置如下：

yaml
version: '2.4'
services:
  mariadb:
    image: docker.xuanyuan.run/tobi312/rpi-mariadb:10.6-alpine  # 镜像及标签
    container_name: mariadb  # 容器名称
    restart: unless-stopped  # 重启策略（除非手动停止）
    volumes:
      - ./mariadb-data:/var/lib/mysql:rw  # 数据卷（主机目录:容器目录）
    environment:
      TZ: Europe/Berlin  # 时区设置
      # MARIADB_RANDOM_ROOT_PASSWORD: "yes"  # 随机生成root密码（二选一）
      MARIADB_ROOT_PASSWORD: my-secret-pw  # root用户密码
      MARIADB_DATABASE: user-database  # 初始化数据库名称
      MARIADB_USER: example-user  # 初始化普通用户
      MARIADB_PASSWORD: my_cool_secret  # 普通用户密码
    ports:
      - 3306:3306  # 端口映射

启动服务：

sh
docker compose up -d

完整示例：参见https://github.com/Tob1as/docker-mariadb/blob/master/docker-compose.yaml%E3%80%82

5.4 核心配置说明

5.4.1 数据持久化

通过-v参数挂载数据卷至容器内/var/lib/mysql目录，确保容器重启或重建后数据不丢失。建议使用主机绝对路径或命名卷（如mariadb-data:/var/lib/mysql）。

5.4.2 环境变量配置

5.5 容器管理

• 查看日志：docker logs some-mariadb
• 进入容器：docker exec -it some-mariadb bash
• 连接数据库：docker exec -it some-mariadb mysql -uroot -p（输入root密码）
• 停止/删除容器：docker stop some-mariadb && docker rm some-mariadb

6. 注意事项

• 架构选择：对于amd64/arm64架构，官方MariaDB镜像（基于Ubuntu）提供更完善的支持，建议优先选用。
• 数据卷权限：主机挂载目录需确保Docker用户有读写权限（可通过chmod 777临时测试，生产环境建议细化权限）。
• 版本兼容性：不同标签对应MariaDB版本不同（如10.6 vs 10.11），升级前请参考https://mariadb.com/kb/en/upgrading/%E3%80%82
• 安全建议：生产环境中避免使用弱密码，可通过MARIADB_RANDOM_ROOT_PASSWORD随机生成密码，并限制端口映射范围（如仅绑定本地IP：-p 127.0.0.1:3306:3306）。

7. 镜像来源

• Docker Hub：https://hub.docker.com/r/tobi312/rpi-mariadb/
• GitHub源码：https://github.com/Tob1as/docker-mariadb