本站面向开发者与科研用户，提供开源镜像的搜索和下载加速服务。
所有镜像均来源于原始开源仓库，本站不存储、不修改、不传播任何镜像内容。
轩辕镜像 - 国内开发者首选的专业 Docker 镜像下载加速服务平台 - 官方QQ群:13763429 👈点击免费获得技术支持。
本站面向开发者与科研用户，提供开源镜像的搜索和下载加速服务。所有镜像均来源于原始开源仓库，本站不存储、不修改、不传播任何镜像内容。
本站面向开发者与科研用户，提供开源镜像的搜索和下载加速服务。所有镜像均来源于原始开源仓库，本站不存储、不修改、不传播任何镜像内容。
本站支持搜索的镜像仓库：Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com
mariadb Docker 镜像下载 - 轩辕镜像
mariadb 镜像详细信息和使用指南
mariadb 镜像标签列表和版本信息
mariadb 镜像拉取命令和加速下载
mariadb 镜像使用说明和配置指南
Docker 镜像加速服务 - 轩辕镜像平台
国内开发者首选的 Docker 镜像加速平台
极速拉取 Docker 镜像服务
相关 Docker 镜像推荐
热门 Docker 镜像下载
linuxserver/mariadb
mariadb 镜像详细信息
mariadb 镜像标签列表
mariadb 镜像使用说明
mariadb 镜像拉取命令
Docker 镜像加速服务
轩辕镜像平台优势
镜像下载指南
相关 Docker 镜像推荐
LinuxServer.io提供的Mariadb容器，用于部署和运行Mariadb关系型数据库服务。
409 收藏0 次下载activelinuxserver镜像
mariadb 镜像详细说明
mariadb 使用指南
mariadb 配置说明
mariadb 官方文档
linuxserver/mariadb
镜像概述和主要用途
MariaDB 是最流行的数据库服务器之一，由MySQL的原始开发人员创建。LinuxServer.io团队提供的此容器镜像旨在提供一个简单、安全且易于配置的MariaDB数据库服务部署方案。
核心功能和特性
LinuxServer.io团队提供的容器具有以下特点：
- 定期和及时的应用更新
- 简单的用户映射（PGID、PUID）
- 带有s6覆盖层的自定义基础镜像
- 每周基础操作系统更新，在整个LinuxServer.io生态系统中共享通用层，以最小化空间使用、停机时间和带宽
- 定期安全更新
支持的架构
该镜像利用Docker清单实现多平台支持。只需拉取 lscr.io/linuxserver/mariadb:latest 即可获取适合您架构的正确镜像，也可以通过标签拉取特定架构的镜像。
支持的架构：
| 架构 | 可用 | 标签 |
|---|---|---|
| x86-64 | ✅ | amd64-<version tag> |
| arm64 | ✅ | arm64v8-<version tag> |
使用场景和适用范围
适用于需要在Docker环境中快速部署可靠的MariaDB数据库服务的场景，包括：
- 开发和测试环境数据库
- 小型生产环境数据库服务
- 需要隔离部署的数据库实例
- 与其他LinuxServer.io容器集成的应用栈
应用设置
根据上游行为，通过localhost（docker exec）访问的root用户不再需要密码。如果在初始启动时未设置远程访问的root密码，请按照容器日志中的说明操作。
注意：容器设置初始数据库后，更改任何MYSQL_变量都不会生效，请使用mysqladmin工具或命令行进行更改。
注意：如果要使用（MYSQL_DATABASE、MYSQL_USER、MYSQL_PASSWORD），这三个变量都需要设置，不能只选择其中几个。
Unraid用户建议在设置后编辑模板/webui，并删除对此变量的引用。
配置更改可在 /config/custom.cnf 中进行（需重启容器生效），数据库文件位于 /config/databases，日志位于 /config/log/mysql。
从文件加载密码和用户
MYSQL_ROOT_PASSWORD、MYSQL_DATABASE、MYSQL_USER、MYSQL_PASSWORD、REMOTE_SQL 环境变量的值可以通过以下文件设置：
/config/env
格式如下：
MYSQL_ROOT_PASSWORD="ROOT_ACCESS_PASSWORD" MYSQL_DATABASE="USER_DB_NAME" MYSQL_USER="MYSQL_USER" MYSQL_PASSWORD="DATABASE_PASSWORD" REMOTE_SQL="[***]"
这些设置可以与Docker环境变量混合使用，但文件中的设置始终优先。
引导新实例
支持在初始化时一次性运行自定义SQL文件。为此，将 *.sql 文件放在：
/config/initdb.d/
这与设置 REMOTE_SQL 环境变量具有相同效果。SQL文件仅在容器首次启动和设置时运行。
检查和修复
如果用户数据库处于不健康状态（有时由升级失败引起），可以通过运行以下命令修复：
mariadb-check -c -A # 检查所有数据库错误 mariadb-check -r -A # 修复所有数据库 mariadb-check -a -A # 分析所有数据库 mariadb-check -o -A # 优化所有数据库
运行上述命令后，可能需要再次运行升级命令。
升级
当容器初始化时，如果设置了 MYSQL_ROOT_PASSWORD，将运行升级检查。如果需要升级，日志将指示需要停止所有访问此容器中数据库的服务，然后运行命令：
mariadb-upgrade
只读操作
此镜像可以在只读容器文件系统中运行。有关详细信息，请阅读文档。
注意事项
/tmp必须挂载到tmpfs- 首次运行时不支持
非root用户操作
此镜像可以使用非root用户运行。有关详细信息，请阅读文档。
详细的使用方法和配置说明
以下是使用Docker Compose或Docker CLI创建容器的方法。
Docker Compose（推荐）
--- services: mariadb: image: lscr.io/linuxserver/mariadb:latest container_name: mariadb environment: - PUID=1000 - PGID=1000 - TZ=Etc/UTC - MYSQL_ROOT_PASSWORD=ROOT_ACCESS_PASSWORD - MYSQL_DATABASE=USER_DB_NAME #可选 - MYSQL_USER=MYSQL_USER #可选 - MYSQL_PASSWORD=DATABASE_PASSWORD #可选 - REMOTE_SQL=[***] #可选 volumes: - /path/to/mariadb/config:/config ports: - 3306:3306 restart: unless-stopped
Docker CLI
docker run -d \ --name=mariadb \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Etc/UTC \ -e MYSQL_ROOT_PASSWORD=ROOT_ACCESS_PASSWORD \ -e MYSQL_DATABASE=USER_DB_NAME `#可选` \ -e MYSQL_USER=MYSQL_USER `#可选` \ -e MYSQL_PASSWORD=DATABASE_PASSWORD `#可选` \ -e REMOTE_SQL=[***] `#可选` \ -p 3306:3306 \ -v /path/to/mariadb/config:/config \ --restart unless-stopped \ lscr.io/linuxserver/mariadb:latest
参数说明
容器通过运行时传递的参数进行配置。这些参数用冒号分隔，表示 <外部>:<内部>。例如，-p 8080:80 会将容器内的80端口暴露到主机的8080端口。
端口参数
| 参数 | 功能 |
|---|---|
-p 3306:3306 | MariaDB监听端口 |
环境变量
| 参数 | 功能 |
|---|---|
-e PUID=1000 | 用户ID - 详见下文说明 |
-e PGID=1000 | 组ID - 详见下文说明 |
-e TZ=Etc/UTC | 指定时区，详见时区列表 |
-e MYSQL_ROOT_PASSWORD=ROOT_ACCESS_PASSWORD | 设置安装时的root密码（至少4个字符，非字母数字密码必须正确转义）。（仅首次运行有效） |
-e MYSQL_DATABASE=USER_DB_NAME | 指定要创建的数据库名称。（仅首次运行有效） |
-e MYSQL_USER=MYSQL_USER | 此用户将对MYSQL_DATABASE指定的数据库拥有超级用户访问权限（此处不要使用root）。（仅首次运行有效） |
-e MYSQL_PASSWORD=DATABASE_PASSWORD | 为MYSQL_USER设置密码（至少4个字符，非字母数字密码必须正确转义）。（仅首次运行有效） |
-e REMOTE_SQL=[***] | 设置从http/https端点获取sql文件（逗号分隔的数组） |
卷参数
| 参数 | 功能 |
|---|---|
-v /config | 持久化配置文件 |
其他参数
| 参数 | 功能 |
|---|---|
--read-only=true | 以只读文件系统运行容器。请阅读文档 |
--user=1000:1000 | 以非root用户运行容器。请阅读文档 |
来自文件的环境变量（Docker secrets）
您可以使用特殊前缀 FILE__ 从文件中设置任何环境变量。
例如：
-e FILE__MYVAR=/run/secrets/mysecretvariable
将根据 /run/secrets/mysecretvariable 文件的内容设置环境变量 MYVAR。
运行应用的Umask
对于所有镜像，我们提供了使用可选的 -e UMASK=022 设置来覆盖容器内启动的服务的默认umask设置的能力。请记住，umask不是chmod，它基于其值减去权限而不是添加权限。在请求支持之前，请先了解umask。
用户/组标识符
使用卷（-v 标志）时，主机操作系统和服容器之间可能会出现权限问题。我们通过允许您指定用户 PUID 和组 PGID 来避免此问题。
确保主机上的任何卷目录都由您指定相同的用户拥有，这样任何权限问题都会神奇地消失！
在这个例子中 PUID=1000 和 PGID=1000，要找到您的PUID和PGID，请使用 id your_user 命令：
id your_user
示例输出：
uid=1000(your_user) gid=xxx(your_user) groups=1000(your_user)
Docker Mods
我们发布各种Docker Mod以启用容器内的附加功能。可用于此镜像的Mod列表以及可应用于我们任何镜像的通用Mod可通过上方的动态徽章访问。
支持信息
-
容器运行时的Shell访问：
docker exec -it mariadb /bin/bash -
实时监控容器日志：
docker logs -f mariadb -
容器版本号：
docker inspect -f '{{ index .Config.Labels "build_version" }}' mariadb -
镜像版本号：
docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/mariadb:latest
更新信息
我们的大多数镜像是静态的、版本化的，需要更新镜像并重新创建容器来更新内部的应用程序。除了一些例外情况（在相关的readme.md中注明）外，我们不建议或支持在容器内更新应用程序，请咨询上面的应用设置部分，了解是否推荐对镜像进行更新。
以下是更新容器的说明：
通过Docker Compose
-
更新镜像：
-
所有镜像：
docker-compose pull -
指定镜像：
docker-compose pull mariadb
-
-
更新容器：
-
所有容器：
docker-compose up -d -
指定容器：
docker-compose up -d mariadb
-
-
您还可以删除旧的悬空镜像：
docker image prune
通过Docker Run
-
更新镜像：
docker pull lscr.io/linuxserver/mariadb:latest -
停止运行中的容器：
docker stop mariadb -
删除容器：
docker rm mariadb -
使用上述相同的docker run参数重新创建新容器（如果正确映射到主机文件夹，您的
/config文件夹和设置将被保留） -
您还可以删除旧的悬空镜像：
docker image prune
镜像更新通知 - Diun（Docker镜像更新通知器）
我们推荐使用Diun进行更新通知提醒。我们不推荐或支持其他自动无人值守更新容器的工具。
本地构建
如果您想对这些镜像进行本地修改以用于开发目的或自定义逻辑：
git clone [***] cd docker-mariadb docker build \ --no-cache \ --pull \ -t lscr.io/linuxserver/mariadb:latest .
可以使用lscr.io/linuxserver/qemu-static在x86_64硬件上构建ARM变体，反之亦然：
docker run --rm --privileged lscr.io/linuxserver/qemu-static --reset
注册后，您可以使用-f Dockerfile.aarch64定义要使用Dockerfile。
版本历史
- 09.07.25: - 基于Alpine 3.22重建
- 11.01.25: - 添加日志轮换，请按照容器日志中的说明操作
- 06.01.25: - 基于Alpine 3.2重建
- 31.05.24: - 基于Alpine 3.20重建
- 23.12.23: - 基于Alpine 3.19重建
- 09.06.23: - 更新已提供的custom.cnf中的lc_messages路径以匹配上游
- 25.05.23: - 基于Alpine 3.18重建，弃用armhf
- 04.02.******- custom.cnf中默认值的小更新
- 31.01.23: - 基于3.17重建
- 09.12.22: - 添加升级检查警告
- 11.10.22: - 将主分支基于Alpine 3.16重建，迁移到s6v3，删除导致一小部分用户出现问题的密码转义逻辑
- 06.07.21: - 将主分支基于Alpine重建
- 03.07.21: - 基于3.14重建
- **08.02.21: - 修复新安装
- 08.02.21: - 基于Alpine重建，添加mariadb-backup
- 08.02.21: - 发布Alpine标签，Alpine版本将在不久的将来取代latest标签
- 27.10.19: - 升级到10.4版本，能够在初始初始化时使用自定义SQL，通过文件定义root密码
- 23.03.19: - 切换到新的基础镜像，迁移到arm32v7标签
- 07.03.19: - 添加在首次启动时设置数据库和默认用户的功能
- 26.01.19: - 添加流水线逻辑和多架构支持
- 10.09.18: - 基于Ubuntu Bionic重建，并使用MariaDB 10.3仓库
- 09.12.17: - 修复连续行
- 12.09.17: - 优雅关闭MariaDB
- 27.10.16: - 实施数据库初始化脚本的 linting 建议
- 11.10.16: - 基于Ubuntu Xenial重建，添加版本标签
- 09.03.16: - 更新到MariaDB 10.1版本，改为在/config中使用custom.cnf而非my.cnf，重构初始化文件以在启动时更改配置选项，而不是在dockerfile中
- **26.01.16: - 将mysqld_safe脚本的用户更改为abc，更好地处理重启时不干净的关闭
- 23.12.15: - 移除自动更新功能，某些版本更新之间容器可能会中断
- 12.08.15: - 初始发布
mariadb
by library
官方
MariaDB Server 是一款从 MySQL 分叉而来的高性能开源关系型数据库，它继承了 MySQL 的核心架构与兼容性，同时凭借持续的技术革新和社区驱动的优化，在查询效率、并发处理及数据安全等方面实现了显著提升，广泛应用于企业级系统、Web服务平台及各类数据存储场景，成为全球开发者和组织青睐的开源数据库解决方案之一。
60451B+ pulls
上次更新：9 天前
mariadb/maxscale
by MariaDB Corporation
认证
MariaDB MaxScale 是世界上最先进的数据库代理，它能够实现数据库负载均衡、读写分离、高可用性支持与故障自动切换，同时提供数据分片管理、安全访问控制及性能监控等功能，有效提升数据库系统的运行效率、稳定性与可扩展性，简化复杂数据库环境的管理与维护。
385M+ pulls
上次更新：1 个月前
mariadb/mariadb-operator-enterprise
by MariaDB Corporation
认证
用于配合MariaDB Operator使用的Docker镜像
10K+ pulls
上次更新：11 个月前
mariadb/mariadb-prometheus-exporter-ubi
by MariaDB Corporation
认证
用于与MariaDB Operator配合使用的Docker镜像
110K+ pulls
上次更新：2 个月前
bitnami/mariadb
by VMware
认证
Bitnami Secure Image for MariaDB是一款针对MariaDB数据库开发的预配置安全镜像，它集成自动化安全补丁、合规性检查工具及加固配置，可快速在容器、虚拟机或云平台等环境中部署，提供持续更新与维护支持，有效降低部署风险，确保数据库运行的稳定性与安全性，满足企业级应用对数据保护的严格需求。
206500M+ pulls
上次更新：2 天前
常见问题
轩辕镜像免费版与专业版有什么区别？
免费版仅支持 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 错误时，表示流量已耗尽，需要充值流量包以恢复服务。
410 错误问题
通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。
manifest unknown 错误
先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。
镜像拉取成功后，如何去掉轩辕镜像域名前缀？
使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。
轩辕镜像下载加速使用手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
登录方式进行 Docker 镜像下载加速教程
通过 Docker 登录方式配置轩辕镜像加速服务，包含7个详细步骤
Linux Docker 镜像下载加速教程
在 Linux 系统上配置轩辕镜像源，支持主流发行版
Windows/Mac Docker 镜像下载加速教程
在 Docker Desktop 中配置轩辕镜像加速，适用于桌面系统
Docker Compose 镜像下载加速教程
在 Docker Compose 中使用轩辕镜像加速，支持容器编排
K8s containerd 镜像下载加速教程
在 k8s 中配置 containerd 使用轩辕镜像加速
宝塔面板 Docker 镜像下载加速教程
在宝塔面板中配置轩辕镜像加速，提升服务器管理效率
群晖 NAS Docker 镜像下载加速教程
在 Synology 群晖NAS系统中配置轩辕镜像加速
飞牛fnOS Docker 镜像下载加速教程
在飞牛fnOS系统中配置轩辕镜像加速
极空间 NAS Docker 镜像下载加速教程
在极空间NAS中配置轩辕镜像加速
爱快路由 ikuai Docker 镜像下载加速教程
在爱快ikuai系统中配置轩辕镜像加速
绿联 NAS Docker 镜像下载加速教程
在绿联NAS系统中配置轩辕镜像加速
威联通 NAS Docker 镜像下载加速教程
在威联通NAS系统中配置轩辕镜像加速
Podman Docker 镜像下载加速教程
在 Podman 中配置轩辕镜像加速，支持多系统
ghcr、Quay、nvcr、k8s、gcr 等仓库下载镜像加速教程
配置轩辕镜像加速9大主流镜像仓库，包含详细配置步骤
专属域名方式进行 Docker 镜像下载加速教程
无需登录即可使用轩辕镜像加速服务，更加便捷高效
需要其他帮助？请查看我们的 常见问题 或 官方QQ群: 13763429