讲师中心 微信公众号
AI工具推荐 视频效率加速

mysql如何在Docker环境下实现数据持久化_挂载宿主机目录与环境变量设置

星强小哥_2702

星强小哥_2702

发布时间:2026-04-10 09:47:04

|

593人浏览过

|

来源于php中文网

原创

MySQL容器数据丢失是因为未挂载宿主机目录,正确做法是用-v将/var/lib/mysql映射到宿主机绝对路径(如/mydata/mysql),且该目录需为空、属主为999;环境变量仅首次初始化生效;自定义配置应挂载到/etc/mysql/conf.d/并设只读。

mysql如何在docker环境下实现数据持久化_挂载宿主机目录与环境变量设置

MySQL容器启动时数据丢失,是因为没挂载宿主机目录

默认用 docker run mysql:8.0 启动的容器,所有数据都存在容器内部的临时文件系统里。容器一删,/var/lib/mysql 里的数据库全没了。持久化的前提是把这目录映射到宿主机一个固定路径,让 MySQL 写数据时实际落在宿主机磁盘上。

正确做法是用 -v 挂载,例如:

docker run -d \
  --name mysql-dev \
  -v /mydata/mysql:/var/lib/mysql \
  -e MYSQL_ROOT_PASSWORD=123456 \
  -p 3306:3306 \
  -d mysql:8.0

注意三点:

  • /mydata/mysql 必须是宿主机已存在的空目录(首次启动前手动 mkdir -p /mydata/mysql),且 MySQL 容器内用户(uid 999)要有写权限,常见坑是 SELinux 或 root 创建的目录导致容器启动失败
  • 不要挂载到 /mydata 这种父级目录,否则容器初始化时可能因已有文件干扰而卡在 “Starting MySQL” 状态
  • 挂载点必须是绝对路径,相对路径如 ./mysql 在 Docker 中会被忽略或报错

MYSQL_ROOT_PASSWORD 不生效?检查环境变量拼写和启动时机

MySQL 官方镜像只认几个特定环境变量,且仅在容器**首次初始化数据库时**起作用。如果挂载的 /var/lib/mysql 目录非空(比如之前跑过、或误拷贝了旧数据),容器会跳过初始化流程,此时 MYSQL_ROOT_PASSWORD、MYSQL_DATABASE 全部被忽略。

关键环境变量只有这些:

  • MYSQL_ROOT_PASSWORD:必填,否则容器启动失败(8.0+ 镜像强制要求)
  • MYSQL_DATABASE:自动创建指定库名,仅首次初始化有效
  • MYSQL_USER 和 MYSQL_PASSWORD:配对使用,自动建用户并授权,同样只在初始化阶段执行
  • MYSQL_ALLOW_EMPTY_PASSWORD:设为 yes 可跳过密码强制校验(不推荐生产)

常见错误:改了 MYSQL_ROOT_PASSWORD 但重启容器后密码还是旧的——因为数据目录有残留,MySQL 直接复用了原有 mysql 系统库。

想自定义配置(如修改 max_connections),不能直接改容器内 my.cnf

官方镜像不建议覆盖容器内的 /etc/mysql/my.cnf,因为升级镜像时容易丢失。正确方式是挂载自定义配置文件到 /etc/mysql/conf.d/(该目录下所有 .cnf 文件会被 MySQL 自动加载)。

MySQL
MySQL

编写正确的MySQL查询,避免字符集、索引和锁方面的常见陷阱。

下载

例如:

echo "[mysqld]\nmax_connections = 500" > /mydata/mysql/conf/my-custom.cnf

docker run -d \
  -v /mydata/mysql:/var/lib/mysql \
  -v /mydata/mysql/conf/my-custom.cnf:/etc/mysql/conf.d/my-custom.cnf:ro \
  -e MYSQL_ROOT_PASSWORD=123456 \
  -p 3306:3306 \
  mysql:8.0

注意:

  • 挂载配置文件必须加 :ro(只读),否则 MySQL 启动时报错“Can’t open the mysql.plugin table”
  • 配置项必须放在 [mysqld] 段落下,放错位置(比如顶格或写成 [client])不会生效
  • 某些参数如 datadir、socket 已被镜像固化,强行修改会导致启动失败

挂载目录权限问题最常导致容器反复重启

MySQL 容器以 UID 999(mysql 用户)运行,若宿主机挂载目录属主不是 999 或无写权限,容器日志会卡在 Initializing database 并不断重启。

快速验证方法:

ls -ld /mydata/mysql

修复方式(二选一):

  • 改宿主机目录属主:sudo chown -R 999:999 /mydata/mysql
  • 或启动时用 --user 指定 UID:docker run --user 999:999 ...(前提是宿主机目录对 999 可写)

Mac 或 Windows 上用 Docker Desktop 时,挂载目录默认权限较松,但 Linux 主机上几乎必踩这个坑。别信“我 chmod 777 就行”,MySQL 8.0 默认拒绝 world-writable datadir,反而会报错退出。

热门AI工具

更多
UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

相关专题

更多
mysql修改数据表名
mysql修改数据表名

MySQL修改数据表:1、首先查看数据库中所有的表,代码为:‘SHOW TABLES;’;2、修改表名,代码为:‘ALTER TABLE 旧表名 RENAME [TO] 新表名;’。php中文网还提供MySQL的相关下载、相关课程等内容,供大家免费下载使用。

2213

2023.06.20

MySQL创建存储过程
MySQL创建存储过程

存储程序可以分为存储过程和函数,MySQL中创建存储过程和函数使用的语句分别为CREATE PROCEDURE和CREATE FUNCTION。使用CALL语句调用存储过程智能用输出变量返回值。函数可以从语句外调用(通过引用函数名),也能返回标量值。存储过程也可以调用其他存储过程。php中文网还提供MySQL创建存储过程的相关下载、相关课程等内容,供大家免费下载使用。

1339

2023.06.21

mongodb和mysql的区别
mongodb和mysql的区别

mongodb和mysql的区别:1、数据模型;2、查询语言;3、扩展性和性能;4、可靠性。本专题为大家提供mongodb和mysql的区别的相关的文章、下载、课程内容,供大家免费下载体验。

795

2023.07.18

mysql密码忘了怎么查看
mysql密码忘了怎么查看

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql密码忘了怎么办呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3012

2023.07.19

mysql创建数据库
mysql创建数据库

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql怎么创建数据库呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

5088

2023.07.25

mysql默认事务隔离级别
mysql默认事务隔离级别

MySQL是一种广泛使用的关系型数据库管理系统,它支持事务处理。事务是一组数据库操作,它们作为一个逻辑单元被一起执行。为了保证事务的一致性和隔离性,MySQL提供了不同的事务隔离级别。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

1139

2023.08.08

sqlserver和mysql区别
sqlserver和mysql区别

SQL Server和MySQL是两种广泛使用的关系型数据库管理系统。它们具有相似的功能和用途,但在某些方面存在一些显著的区别。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

5351

2023.08.11

mysql忘记密码
mysql忘记密码

MySQL是一种关系型数据库管理系统,关系数据库将数据保存在不同的表中,而不是将所有数据放在一个大仓库内,这样就增加了速度并提高了灵活性。那么忘记mysql密码我们该怎么解决呢?php中文网给大家带来了相关的教程以及其他关于mysql的文章,欢迎大家前来学习阅读。

4702

2023.08.14

VibeKnow知识视频制作与导出详解
VibeKnow知识视频制作与导出详解

本专题整理VibeKnow从注册、素材上传、AI生成到预览导出的完整操作,帮助新手快速制作第一条知识讲解视频。

0

2026.10.14

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL vs MySQL
PostgreSQL vs MySQL

共1课时 | 184人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn