如何在Docker中安装并运行MySQL 8.0？-mysql教程-PHP中文网

必须先拉取镜像、创建挂载目录、设置密码；不能用mysql:latest因未来可能切至9.x导致兼容问题，生产环境应锁定小版本如8.0.36；必须挂载/var/lib/mysql、/etc/mysql/my.cnf、/var/log/mysql三个目录以保障数据持久化、配置生效和日志排查。

如何在docker中安装并运行mysql 8.0？

Docker Cli

使用 Docker CLI 构建、运行、停止、检查和管理容器与镜像的助手。用于执行容器相关任务。

下载

docker run 启动 MySQL 8.0 容器前，必须先拉取镜像、创建挂载目录、设置密码——否则容器会启动失败或数据无法持久化。

拉取镜像时为什么不能只写 `mysql:latest`？

mysql:latest 当前指向 MySQL 8.x，但未来可能切到 9.x，导致应用兼容性问题。生产环境必须锁定小版本：

推荐使用 mysql:8.0.36（2026 年主流稳定版）
国内用户可加镜像源加速：docker pull registry.cn-hangzhou.aliyuncs.com/library/mysql:8.0.36
docker images | grep mysql 确认镜像 ID 和 CREATED 时间，避免缓存旧镜像

`docker run` 必须挂载的三个目录是哪些？

MySQL 容器默认把数据写在内存里，容器一删，库就丢。关键挂载点只有三个：

/var/lib/mysql → 宿主机 /mydata/mysql/data（必须，否则重启后数据清空）
/etc/mysql/my.cnf → 宿主机 /mydata/mysql/conf/my.cnf（可选但强烈建议，用于配置 lower_case_table_names=1 或字符集）
/var/log/mysql → 宿主机 /mydata/mysql/logs（排查连接失败、初始化错误时必看）

注意：mkdir -p /mydata/mysql/{conf,data,logs} 要提前执行，且宿主机目录权限需为 755，否则容器内 MySQL 进程无法写入。

启动命令里 `MYSQL_ROOT_PASSWORD` 和 `--restart=always` 能省吗？

不能省。缺一不可：

-e MYSQL_ROOT_PASSWORD=root123 是唯一初始化 root 密码的方式；不设则容器卡在启动阶段，日志里反复报 mysqld: Can't start server : Bind on unix socket...
--restart=always 防止 Docker daemon 重启后 MySQL 宕机；若用 systemd 管理 Docker，还需加 --init 避免信号传递异常
端口映射必须写全：-p 3306:3306，不能只写 -p 3306，否则宿主机无法访问

典型命令：

docker run --name mysql8 \
  -v /mydata/mysql/conf/my.cnf:/etc/mysql/my.cnf \
  -v /mydata/mysql/data:/var/lib/mysql \
  -v /mydata/mysql/logs:/var/log/mysql \
  -e MYSQL_ROOT_PASSWORD=root123 \
  -p 3306:3306 \
  --restart=always \
  -d mysql:8.0.36

容器启动后连不上 3306 怎么快速定位？

别急着重装，先查三件事：

运行 docker logs mysql8，重点看是否有 ready for connections —— 没这句说明初始化失败，大概率是挂载目录权限不对或 my.cnf 语法错误
执行 docker exec -it mysql8 mysql -uroot -proot123 -e "SELECT VERSION();"，能返回版本号说明容器内通，问题出在宿主机网络或防火墙
检查宿主机是否监听 netstat -tuln | grep :3306，如果没输出，说明端口没映射成功，常见原因是 docker run 没加 -p 或已存在其他 MySQL 占用 3306

远程连接失败时，还要确认 MySQL 8.0 默认关闭远程访问：进入容器后执行 mysql -uroot -proot123 -e "ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'root123'; FLUSH PRIVILEGES;"。挂载目录路径、密码环境变量、端口映射这三项漏掉任意一个，容器都起不来或者起得来但用不了——不是配置多复杂，而是 Docker 启动 MySQL 的硬性前提就这三条。