上周帮朋友在本地搭一套开发环境,他问我MySQL用什么方式装最省心。我没怎么犹豫就回了句:直接上Docker。他半信半疑——在他的印象里,Docker是部署阶段才用的东西,装个数据库何必绕这一圈。结果我在他电脑上敲完两条命令,十分钟后他已经能用Navicat连上容器里的MySQL了。这篇文章就是当时那两条命令的完整拆解,以及后续我踩过的那些坑。
如果你是第一次接触Docker下的MySQL,想搞清楚镜像怎么拉、容器怎么启、配置文件怎么挂、SQL怎么在容器里执行,那么这篇应该能帮你省不少时间。我尽量按一个完整的链路来讲:先交代思路,再给可复制的命令,最后把高频报错和排查逻辑单独拎出来说。所有内容都基于实际验证过的方式,版本以MySQL 8.0为主,部分地方会补充与5.7的差异。
1. 为什么我坚持用Docker跑MySQL:从裸机到容器化的思路转变
1.1 什么场景适合容器化,什么场景不适合
先说结论:Docker跑MySQL最舒服的场景,是本地开发、测试环境、多版本共存和CI/CD流水线。我自己日常至少有三个MySQL环境是同时跑的——一个MySQL 8.0给当前项目用,一个5.7用来复现老项目的兼容问题,还有一个临时实例用来验证数据库初始化脚本。如果是裸机安装,你得在多个版本之间反复卸载、修改配置、处理端口冲突,光想想就头疼。容器化之后,每个实例都是独立的名字、独立的端口映射、独立的存储卷,想开就开,想删就删,完全不干扰系统里其他软件。
但如果你是要跑一个对性能极致敏感的大型线上实例,或者数据安全合规要求极高,那我不建议直接用Docker裸上。不是说容器本身性能差多少,而是生产环境牵扯到网络方案、调度策略、文件系统选型,这些不是本文这种新手向内容能覆盖的。我的原则很简单:开发、测试、个人项目随便用容器,生产环境请交给专业的DBA和运维去评估。
1.2 Docker环境准备:先把虚拟化这关过了
经常有人卡在第一步:Docker Desktop装好了,点启动,报错。热词里那个很长的错误其实很典型,说的是“virtualization support not detected”,翻译过来就是系统没检测到虚拟化支持,Docker Desktop直接起不来。
这种报错九成出现在Windows机器上。排查顺序我建议是这样:
- 打开任务管理器,切到“性能”标签,看CPU部分是否显示“虚拟化:已启用”。如果显示“已禁用”,得进BIOS/UEFI把Intel VT-x或AMD-V打开。这一步在不同主板上的菜单位置不一样,但关键词基本都是Virtualization、SVM Mode之类的。
- 确认Windows的“适用于Linux的Windows子系统”功能(也就是WSL2)已经开启。可以管理员身份运行PowerShell,执行
wsl --status看状态。没装的话先用wsl --install装一个。 - 如果你用的是Windows 10旧版本,建议先把系统更新到较新版本,旧版Docker Desktop和WSL2的兼容性没那么好。
我这几年在Mac、Linux服务器上都跑过Docker,Mac的Docker Desktop体验最省心,Linux服务器上直接用curl -fsSL https://get.docker.com | bash一键装也行。Windows最大的问题就是虚拟化这一关,过了之后就顺利了。总之,装Docker之前先确认底层虚拟化是通的,可以省掉一晚上的折腾。
1.3 Docker跑MySQL的核心逻辑:镜像、容器、数据卷
在操作之前,先把Docker的三个概念和MySQL结合起来理解。
镜像可以理解为MySQL的“安装包”,它里面已经打包好了可执行文件、默认配置和运行环境。容器是你用这个“安装包”创建出的一个运行实例,就像一台独立的、只跑了MySQL的小机器。数据卷则是这台小机器里的外部硬盘,你把它挂载到容器内的数据目录,容器删了、重建了,数据都还在。
这三个概念对应到MySQL上,就是三条命令的事:docker pull拉镜像,docker run创建并启动容器,-v参数挂载数据卷。后面的操作全部围绕这三件事展开。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 镜像选择与首次启动:一条命令背后的完整逻辑
2.1 版本标签怎么选:别一上来就latest
我见过太多人上来就docker pull mysql:latest,这不是不能用,但不太推荐。原因很简单:latest标签随着官方发版会漂移,你今天拉下来的镜像和你同事下周拉下来的,未必是同一个版本。这就失去了容器化“环境一致”的意义。
我的建议是锁定一个大版本,最好连小版本也固定。比如当前项目基本兼容8.0,那就直接指定:
bash复制docker pull mysql:8.0
如果你想连小版本都锁死,可以在Docker Hub上查一下当前的8.0.x具体版本号,然后docker pull mysql:8.0.40这样精确指定。5.7的历史项目同理,指定mysql:5.7即可。官方镜像的tag列表是开源的,查起来很方便,养成锁版本的习惯,后面排查问题会好受很多。
2.2 从docker run说起:环境变量、端口、数据卷逐个拆解
拉完镜像,核心操作就是创建容器。我第一次用Docker跑MySQL时,命令是抄来的,完全没搞懂每个参数干什么,结果后面遇到问题只能干瞪眼。这里我把一条典型的启动命令拆开来讲。
假设我要创建一个名为mysql8的容器,使用8.0镜像,宿主机3306端口映射到容器3306端口,root密码设成MyRoot@123456,时区设为东八区,数据存到名为mysql-data的数据卷里:
bash复制docker run -d \
--name mysql8 \
-p 3306:3306 \
-e MYSQL_ROOT_PASSWORD='MyRoot@123456' \
-e TZ=Asia/Shanghai \
-v mysql-data:/var/lib/mysql \
--restart=always \
mysql:8.0
逐个说:
-d:后台运行,不占着当前终端。--name mysql8:给容器取名。后续docker exec -it mysql8 bash直接按名字操作,比记一长串ID方便得多。-p 3306:3306:端口映射。左侧是宿主机端口,右侧是容器端口。如果宿主机3306已经被占用,改成-p 3307:3306,那么外部客户端就连3307端口。-e MYSQL_ROOT_PASSWORD:初始化root密码。官方镜像要求必须设置`MYSQL_ROOT_PASSWO
