ubuntu/mysql
MySQL是一款广泛应用于各类Web应用、企业级系统及数据存储场景的开源SQL数据库，它以快速的数据处理能力、稳定的运行性能和高效的多线程架构为核心优势，其长期版本的维护工作由Canonical负责，为用户提供持续的技术支持、安全更新及功能优化服务，是全球众多开发者和企业信赖的数据库解决方案。
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
MySQL Docker镜像（基于Ubuntu）
关于本镜像
本镜像为Canonical提供的MySQL Docker镜像，基于Ubuntu系统构建。镜像会持续接收安全更新，并自动滚动升级至更新的MySQL版本或Ubuntu发行版。该仓库可免费使用，且不受用户速率限制。
MySQL简介
MySQL是一款快速、稳定的多用户、多线程SQL数据库服务器。SQL（结构化查询语言）是全球最流行的数据库查询语言，而MySQL的核心目标是实现速度、健壮性与易用性的平衡。更多详情可参考[MySQL官方文档] 。
标签与架构
维护支持说明
- LTS：LTS渠道提供长达5年的免费安全维护。
- ESM：通过Canonical的受限仓库可提供长达10年的客户安全维护（[联系Canonical获取] ）。
渠道标签与架构详情
| 渠道标签 | 关联标签 | 支持截止时间 | 当前版本 | 支持架构 |
|---|---|---|---|---|
8.0-24.04_beta | edge, latest | - | MySQL 8.0 基于 Ubuntu 24.04 LTS | arm64, amd64 |
8.0-22.04_beta | 8.0-22.04_edge | - | MySQL 8.0 基于 Ubuntu 22.04 LTS | amd64, s390x, ppc64le, arm64 |
8.0-21.10_beta | 8.0-21.10_edge | - | MySQL 8.0 基于 Ubuntu 21.10 | s390x, amd64, arm64, ppc64le |
8.0-21.04_beta | 8.0-21.04_edge | - | MySQL 8.0 基于 Ubuntu 21.04 | s390x, arm64, amd64, ppc64le |
8.0-20.04_beta | 8.0-20.04_edge | - | MySQL 8.0 基于 Ubuntu 20.04 LTS | s390x, arm64, amd64, ppc64le |
8.0-24.04_edge | 8.0-24.04_edge | - | MySQL 8.0 基于 Ubuntu 24.04 LTS | amd64, s390x, arm64 |
track_risk |
渠道稳定性说明
渠道标签按稳定性从高到低排序为：stable、candidate、beta、edge。高风险渠道默认可用，例如若列出beta，则edge也可拉取；若列出candidate，则beta和edge可拉取；若列出stable，则四个渠道均可用。镜像版本会按edge→beta→candidate→stable的顺序逐步发布。
使用方法
本地启动
通过以下命令启动镜像：
bashdocker run -d --name mysql-container -e TZ=UTC -e MYSQL_ROOT_PASSWORD=My:S3cr3t -p 30306:3306 docker.xuanyuan.run/ubuntu/mysql:8.0-24.04_beta
启动后，可通过localhost:30306访问MySQL服务。
参数说明
| 参数 | 描述 |
|---|---|
-e TZ=UTC | 时区设置（示例为UTC）。 |
-e MYSQL_ROOT_PASSWORD=xxx | 设置root用户密码（必填，不可为空）。 |
-e MYSQL_PASSWORD=xxx | 为MYSQL_USER用户设置密码。 |
-e MYSQL_USER=xxx | 创建新用户（带超级用户权限），需配合MYSQL_PASSWORD使用。 |
-e MYSQL_DATABASE=xxx | 设置默认数据库名称。 |
-e MYSQL_ALLOW_EMPTY_PASSWORD=yes | 允许root用户空密码（不建议生产环境使用，需确认风险）。 |
-e MYSQL_RANDOM_ROOT_PASSWORD=yes | 生成随机root密码（密码会打印在日志中，搜索“GENERATED ROOT PASSWORD”）。 |
-e MYSQL_ONETIME_PASSWORD=yes | 强制root用户首次登录修改密码。 |
-e MYSQL_INITSB_SKIP_TZINFO=yes | 禁用入口脚本自动加载时区数据（设为任意非空值即可）。 |
-p 30306:3306 | 端口映射（本地30306端口映射容器3306端口）。 |
-v /path/to/data:/var/lib/mysql | 数据持久化（避免每次启动容器重新初始化数据库）。 |
-v /path/to/config:/etc/mysql/mysql.conf.d/ | 挂载本地配置文件（参考[MySQL配置文档] ）。 |
测试与调试
-
查看容器日志：
bashdocker logs -f mysql-container -
进入容器交互式shell：
bashdocker exec -it mysql-container /bin/bash
问题反馈与功能请求
若发现镜像bug或需请求功能，可在[launchpad提交issue] ，标题格式为mysql: <问题摘要>。提交时需附上镜像摘要，可通过以下命令获取：
bashdocker images --no-trunc --quiet ubuntu/mysql:<tag>
已弃用渠道与标签
以下渠道（标签）已停止更新，请升级至新版本；若无法升级，可[联系Canonical] 。
| 渠道（Track） | 版本（Version） | 停止维护时间（EOL） | 升级路径（Upgrade Path） |
|---|---|---|---|
track |
商业使用与ESM渠道：若需商业分发或使用ESM渠道/未列出的版本，请[联系Canonical团队] （或发送邮件至[***已删除]）。
更多相关 Docker 镜像与资源
以下是 ubuntu/mysql 相关的常用 Docker 镜像，适用于 关系型数据库、事务处理、数据存储 等不同场景：
- library/mysql Docker 镜像说明
- bitnami/mysql Docker 镜像说明（企业级配置，适合生产环境）
- alpine/mysql Docker 镜像说明（基于 Alpine Linux，体积更小）
- bitnamicharts/mysql Docker 镜像说明（Bitnami MySQL 图表版本）
- iwfwebsolutions/mysql Docker 镜像说明（MySQL 数据库服务）
ubuntu/mysql 国内 Docker 镜像拉取说明
在国内网络环境下，直接使用 docker pull 访问 Docker Hub 官方仓库时，较常遇到连接超时、TLS 握手失败或 registry 响应缓慢等情况。这类问题多与跨境链路质量、运营商策略及客户端 DNS 解析有关，并非单个镜像本身异常。
轩辕镜像提供两种常用加速方式：一是使用公共加速域名 docker.xuanyuan.run 拉取（可参考 登录认证方式）；二是在控制台配置 专属域名拉取，将拉取命令中的 registry 前缀替换为分配的专属域名，通常能提升成功率与稳定性。
以 ubuntu/mysql 为例，加速拉取命令格式为 docker pull docker.xuanyuan.run/ubuntu/mysql:<标签>，请将 <标签> 替换为具体版本。下方「镜像拉取方式」区块提供与本文一致的命令示例，可直接复制使用。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull ubuntu/mysql:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"