本站支持搜索的镜像仓库:Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com
!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 卷中有关配置变量,请参见备份相关。
强烈建议在更新到较新版本之前运行备份。
| 卷 | 用途 |
|---|---|
/backup | 备份文件(也用于导出/导入脚本 - 参见辅助函数)。 |
/data | 数据文件。 |
/ssl | SSL 证书和文件。 |
| 变量 | 值 | 描述 | 默认值 |
|---|---|---|---|
BF_DB_BACKUP_COMPRESS_FILES | 0 或 1 | 是否压缩备份文件(使用 gzip)。 | 0 |
BF_DB_BACKUP_KEEP_FOR | Nu 时长 | 自动删除备份前的保留时间。 | 28day |
| 变量 | 值 | 描述 | 默认值 |
|---|---|---|---|
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 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
参数说明:
-d:后台运行容器--name mariadb:容器名称为 mariadb-p 3306:3306:映射容器 3306 端口到主机 3306 端口-v /path/on/host/data:/data:挂载主机目录到容器 /data 卷(数据文件)-v /path/on/host/backup:/backup:挂载主机目录到容器 /backup 卷(备份文件)-e BF_DB_ROOT_PASSWORD:设置 root 用户密码(必填)-e BF_DB_APPLICATION:应用名称,用于自动设置数据库名、用户名和密码-e BF_DB_BACKUP_COMPRESS_FILES=1:启用备份文件压缩MIT
Copyright (c) 2020-2025 bfren(除非另有说明)

免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录方式配置轩辕镜像加速服务,包含7个详细步骤
在 Linux 系统上配置轩辕镜像源,支持主流发行版
在 Docker Desktop 中配置轩辕镜像加速,适用于桌面系统
在 Docker Compose 中使用轩辕镜像加速,支持容器编排
在 k8s 中配置 containerd 使用轩辕镜像加速
在宝塔面板中配置轩辕镜像加速,提升服务器管理效率
在 Synology 群晖NAS系统中配置轩辕镜像加速
在飞牛fnOS系统中配置轩辕镜像加速
在极空间NAS中配置轩辕镜像加速
在爱快ikuai系统中配置轩辕镜像加速
在绿联NAS系统中配置轩辕镜像加速
在威联通NAS系统中配置轩辕镜像加速
在 Podman 中配置轩辕镜像加速,支持多系统
配置轩辕镜像加速9大主流镜像仓库,包含详细配置步骤
无需登录即可使用轩辕镜像加速服务,更加便捷高效
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429