Docker 容器数据卷配置错误

容器虽然轻量好用，但很多人第一次用 Docker 时都会栽在数据卷上——容器删了，数据也没了。
今天我就以资深运维的视角，带你彻底搞懂数据卷的配置规范，不再丢数据。

先搞清楚：数据卷是什么？为什么容易丢？

数据卷（Volume）是 Docker 用来持久化数据的机制。
简而言之，你把容器里的一个文件夹映射到宿主机硬盘上，容器删了，映射的文件夹还在。
但一旦配置写错或没映射，容器一删，里面的数据就真没了。

动手前确认三件事

• 已经安装 Docker（版本 20.10+ 最佳）
• 有一个测试用的镜像（比如 nginx 或 ubuntu）
• 明白 docker run -v 的基本语法：宿主机路径:容器路径

最常见的三个配置错误（附根源分析）

错误一：挂载路径写错

docker run -d -v /data:/app/data nginx   # 宿主机路径 /data 不存在？注意权限

如果宿主机目录不存在，Docker 不会报错，而是自动创建一个空目录。
文件写入容器后你以为进了 /data，实际容器里只看到空文件夹。

错误二：权限不足导致写不进去

docker run -d -v /root/mydata:/app/data nginx   # 宿主机目录属于 root，容器内用户无写权限

很多新手使用 root 用户的目录，但容器内默认不是 root（或 SELinux/AppArmor 限制），结果程序运行时写入失败，还不会立刻报错。

错误三：忘记挂载，数据全在容器层

docker run -d --name web nginx   # 没有 -v，写进去的配置文件随容器删除而消失

这是最致命的——容器内部的所有修改都保存在容器层，容器一删，数据就彻底丢了。

正确配置数据卷的完整步骤（只要这三步）

1. 创建专用目录并设置权限

sudo mkdir -p /opt/mydata
sudo chown 1000:1000 /opt/mydata   # 1000 是容器内常见用户 UID，可换成你自己的

2. 挂载时明确指定路径和权限参数

docker run -d --name myapp -v /opt/mydata:/app/data:Z nginx

:Z 是 SELinux 标签（如果系统开启了 SELinux），大多数场景可以省略。

3. 用 docker inspect 确认挂载生效

docker inspect myapp | grep -A10 Mounts

输出里会显示 Source（宿主机路径）和 Destination（容器路径），只要 Source 不为空就说明配置成功。

验证数据是否真正持久化（必须做）

1. 进入容器写入文件：

   docker exec -it myapp bash
   echo "持久化测试" > /app/data/test.txt
   exit

1. 删掉容器再重建（注意保留宿主机文件）：

   docker rm -f myapp
   docker run -d --name myapp2 -v /opt/mydata:/app/data nginx
   docker exec myapp2 cat /app/data/test.txt   # 应该输出“持久化测试”

1. 如果报错 cat: /app/data/test.txt: No such file or directory，说明挂载配置有问题，立刻检查宿主机路径和容器路径是否匹配。

避坑指南与紧急恢复

• 不要在容器启动后临时修改 -v 路径：需要停止容器，重新 run。
• 使用 docker volume create 命名卷更安全：自动管理路径，无需手动创建目录。

  docker volume create mydata
  docker run -d -v mydata:/app/data nginx

• 万一数据丢失怎么办：如果容器已删除且未挂载，可以尝试用 docker export 的备份恢复，但成功率很低。所以唯一可靠的方法是从一开始就正确配置数据卷。
• 养成习惯：每次部署前用 docker run --rm 加 -v 测试写入，检查宿主机文件是否变化。

最后总结

Docker 数据卷配置错误导致数据丢失，说白了就是三个坑：路径错、权限错、没挂载。
按我上面的步骤走一遍，先建目录设权限，再用 -v 挂载并 inspect 确认，最后删容器验证持久性。
只要养成这个习惯，你的数据就稳了。