MySQL Docker 镜像
MySQL 官方 Docker 镜像,提供开箱即用的关系型数据库服务,支持通过环境变量完成库和账号初始化,并结合数据卷实现持久化存储,适合本地开发、集成测试及小到中型生产环境的数据库部署。
MySQL 官方 Docker 镜像中文说明
一、概述
MySQL 是使用最广泛的开源关系型数据库之一,适用于博客、企业官网、电商平台、SaaS 系统等各种场景。本镜像由官方团队维护,预装 MySQL Server,并对初始化流程做了容器化封装,可通过少量环境变量完成数据库创建与账号初始化,极大简化部署流程。
- 默认监听端口:
3306 - 默认数据目录:
/var/lib/mysql - 架构随 tag 而异;MySQL 5.7 等旧版 tag 可能仅 amd64,请以标签页「系统架构」列为准(https://xuanyuan.cloud/r/library/mysql/tags))
- 同时提供长期支持(LTS)与创新版本(Innovation)镜像标签
二、典型使用场景
- Web / API 服务数据库:为 PHP、Java、Node.js、Python 等应用提供主数据库服务。
- 本地开发与集成测试:在本地或 CI 中快速拉起一套“临时 MySQL 环境”,测试通过后直接销毁容器即可。
- 教学与实验环境:在课程或培训中一键启动 MySQL,聚焦于 SQL 与数据建模本身,而非环境安装。
三、快速开始
1. 启动一个最简 MySQL 实例
bashdocker run -d \ --name mysql \ -e MYSQL_ROOT_PASSWORD=your-root-password \ -p 3306:3306 \ docker.xuanyuan.run/mysql:latest
此命令会:
- 初始化一个 MySQL 数据目录(在容器内
/var/lib/mysql); - 创建
root用户并设置密码为your-root-password; - 监听容器内 3306 端口,并映射到宿主机 3306。
初始化期间 MySQL 还在创建系统表、用户等,短时间内可能无法立即连接,稍等片刻或在应用中增加重试逻辑即可。
2. 配置数据持久化
为了避免容器删除导致数据丢失,推荐将 /var/lib/mysql 挂载到宿主机目录或 Docker 卷:
bash# 使用命名卷(推荐) docker run -d \ --name mysql \ -e MYSQL_ROOT_PASSWORD=your-root-password \ -p 3306:3306 \ -v mysql-data:/var/lib/mysql \ docker.xuanyuan.run/mysql:latest # 或挂载宿主机目录 docker run -d \ --name mysql \ -e MYSQL_ROOT_PASSWORD=your-root-password \ -p 3306:3306 \ -v /opt/mysql/data:/var/lib/mysql \ docker.xuanyuan.run/mysql:latest
四、常用初始化环境变量
这些变量仅在数据目录为空、首次初始化时生效;目录中已存在数据库时会被忽略。
MYSQL_ROOT_PASSWORD(必选):root用户密码(除非使用空密码或随机密码模式)。MYSQL_DATABASE:初始化时自动创建的数据库名称。MYSQL_USER/MYSQL_PASSWORD:创建一个业务账号,并授予上面MYSQL_DATABASE的全部权限。MYSQL_ALLOW_EMPTY_PASSWORD:允许root使用空密码(设为yes,不推荐生产环境)。MYSQL_RANDOM_ROOT_PASSWORD:启动时为root生成随机密码(设为yes,密码会写入容器日志)。
示例:一次性创建库和业务账号:
bashdocker run -d \ --name mysql \ -e MYSQL_ROOT_PASSWORD=your-root-password \ -e MYSQL_DATABASE=app_db \ -e MYSQL_USER=app_user \ -e MYSQL_PASSWORD=app_password \ -v mysql-data:/var/lib/mysql \ docker.xuanyuan.run/mysql:latest
五、自定义配置与字符集
1. 使用命令行参数调整配置
很多常见配置可以直接通过 mysqld 参数设置,而无需准备独立的配置文件,例如统一设置 utf8mb4 字符集:
bashdocker run -d \ --name mysql \ -e MYSQL_ROOT_PASSWORD=your-root-password \ -v mysql-data:/var/lib/mysql \ docker.xuanyuan.run/mysql:latest \ --character-set-server=utf8mb4 \ --collation-server=utf8mb4_unicode_ci
2. 挂载自定义配置文件
如果已准备好 my.cnf 或额外配置片段,可以通过挂载目录的方式加载:
bash# 假设 /opt/mysql/conf.d 中放置了自定义 .cnf 文件 docker run -d \ --name mysql \ -e MYSQL_ROOT_PASSWORD=your-root-password \ -v mysql-data:/var/lib/mysql \ -v /opt/mysql/conf.d:/etc/mysql/conf.d \ docker.xuanyuan.run/mysql:latest
多个配置文件会按 MySQL 约定顺序加载,后加载的值会覆盖默认值。
六、备份与恢复示例
1. 全库备份
bash# 备份所有数据库到宿主机文件 Docker exec mysql sh -c 'exec mysqldump --all-databases -uroot -p"$MYSQL_ROOT_PASSWORD"' > /backup/all.sql
2. 从备份恢复
bash# 从备份文件恢复 docker exec -i mysql sh -c 'exec mysql -uroot -p"$MYSQL_ROOT_PASSWORD"' < /backup/all.sql
七、适用人群
- 希望快速搭建 LAMP / LNMP / Spring Boot / Node.js 等常见技术栈的开发者与运维;
- 需要在 CI/CD 流水线中自动拉起/销毁 MySQL 实例的团队;
- 需要在单机或小规模集群中部署稳定可靠关系型数据库的用户。
library/mysql 镜像文档
(5 篇)mysql 国内 Docker 镜像拉取说明
在国内网络环境下,直接使用 docker pull 访问 Docker Hub 官方仓库时,较常遇到连接超时、TLS 握手失败或 registry 响应缓慢等情况。这类问题多与跨境链路质量、运营商策略及客户端 DNS 解析有关,并非单个镜像本身异常。
轩辕镜像提供两种常用加速方式:一是使用公共加速域名 docker.xuanyuan.run 拉取(可参考 登录认证方式);二是在控制台配置 专属域名拉取,将拉取命令中的 registry 前缀替换为分配的专属域名,通常能提升成功率与稳定性。
以 mysql 为例,加速拉取命令格式为 docker pull docker.xuanyuan.run/mysql:<标签>,请将 <标签> 替换为具体版本。下方「镜像拉取方式」区块提供与本文一致的命令示例,可直接复制使用。
MySQL 镜像部署时通常需要映射 3306 端口并设置 root 密码与数据卷,首次拉取建议先确认所需主版本标签。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务




