bfren/mariadb Docker Image Overview

bfren/mariadb

bfren

基于 Alpine Linux 的 MariaDB 镜像，预安装多个 LTS 版本，内置自动备份功能，支持可选 SSL，提供辅助函数用于备份、导出、导入和恢复操作。

下载次数: 0状态：社区镜像维护者：bfren仓库类型：镜像最近更新：13 天前

轩辕镜像，不浪费每一次拉取。点击查看

中文简介版本下载

轩辕镜像，不浪费每一次拉取。点击查看

Docker MariaDB

!GitHub release (latest by date) !Docker Pulls !Docker Image Size !GitHub Workflow Status

Docker 仓库 - bfren 生态系统

预安装了 MariaDB（10.6 LTS、10.11 LTS、11.4 LTS、11.8 LTS 和 12.0.1 版本），并内置自动备份功能。

如果您要升级到 7.x 版本，请阅读此页面。

自动备份

除 mysql、information_schema、performance_schema 和 sys 之外的所有数据库的备份存储在：

/backup 卷中
按日期时间（yyMMddhhmm）分离子文件夹
每八小时一次

有关配置变量，请参见备份相关。

强烈建议在更新到较新版本之前运行备份。

端口

3306

卷

卷	用途
`/backup`	备份文件（也用于导出/导入脚本 - 参见辅助函数）。
`/data`	数据文件。
`/ssl`	SSL 证书和文件。

环境变量

备份相关

变量	值	描述	默认值
`BF_DB_BACKUP_COMPRESS_FILES`	0 或 1	是否压缩备份文件（使用 gzip）。	0
`BF_DB_BACKUP_KEEP_FOR`	Nu 时长	自动删除备份前的保留时间。	28day

SSL 相关

变量	值	描述	默认值
`BF_DB_SSL_ENABLE`	0 或 1	设置为 "1" 以启用 SSL 支持。	0
`BF_DB_SSL_EXPIRY`	Nu 时长	自生成 SSL 证书的过期时间。	36500day
`BF_DB_SSL_CA_KEY_BITS`	整数	CA SSL 私钥的位数。	4096
`BF_DB_SSL_SERVER_KEY_BITS`	整数	服务器 SSL 私钥的位数。	4096
`BF_DB_SSL_CLIENT_KEY_BITS`	整数	客户端 SSL 私钥的位数。	4096

数据库相关

变量	值	描述	默认值
`BF_DB_ROOT_PASSWORD`	字符串	root 用户密码。	无 - 必填
`BF_DB_APPLICATION`	字符串	应用名称 - 如果未设置 `BF_DB_DATABASE`、`BF_DB_PASSWORD` 和 `BF_DB_USERNAME`，将使用此名称。	无
`BF_DB_DATABASE`	字符串	数据库名称 - 多个数据库可用逗号分隔。	无
`BF_DB_USERNAME`	字符串	应用用户名 - 如果未使用 `BF_DB_APPLICATION`，则为必填项。	无
`BF_DB_PASSWORD`	字符串	应用密码 - 如果未使用 `BF_DB_APPLICATION`，则为必填项。	无
`BF_DB_SUPER_USER`	0 或 1	授予应用用户所有数据库权限及用户管理权限 - 不建议生产环境使用。	0
`BF_DB_CHARACTER_SET`	字符串	设置 character_set_server。	utf8
`BF_DB_COLLATION`	字符串	设置 collation_server。	utf8_general_ci
`BF_DB_LOG_WARNINGS`	字符串	设置 log_warnings。	2

辅助函数

函数	参数	用途	用法
`db-backup`	无	手动运行备份。	`docker exec <<容器名>> db-backup`
`db-export`	1: 数据库名称	将指定数据库导出为 SQL 文件至 `/backup` 卷的根目录。	`docker exec <<容器名>> db-export <<数据库名>>`
`db-import`	1: 数据库名称	执行 `/backup` 卷根目录中的所有文件。	`docker exec <<容器名>> db-import <<数据库名>>`
`db-restore`	1: 备份集	删除 `/data` 卷中的所有文件，然后从指定备份集恢复。	`docker exec <<容器名>> db-restore 202107180500`
`db-upgrade`	无	手动运行 `mariadb-upgrade` - 通常无需执行，但可执行各种检查。	`docker exec <<容器名>> db-upgrade`
`db-enable-super-user`	无	授予应用用户所有数据库访问权限及用户管理权限。	`docker exec <<容器名>> db-enable-super-user`
`db-disable-super-user`	无	仅授予应用用户访问应用数据库的权限。	`docker exec <<容器名>> db-disable-super-user`

Docker 部署示例

使用以下命令启动容器，包含基本配置：

bash
docker run -d \
  --name mariadb \
  -p 3306:3306 \
  -v /path/on/host/data:/data \
  -v /path/on/host/backup:/backup \
  -e BF_DB_ROOT_PASSWORD=your_root_password \
  -e BF_DB_APPLICATION=myapp \
  -e BF_DB_BACKUP_COMPRESS_FILES=1 \
  bfren/mariadb

参数说明：