容器与云原生 / 系统课时
排查挂载与权限问题
排查挂载与权限问题
本课解决“挂载后文件消失、容器无法读写、配置未生效或启动时报权限错误”的问题。你将从宿主机路径、容器目标路径、只读属性、UID/GID 和安全策略逐层确认挂载行为。
学习目标
- 区分路径错误、目录覆盖和读写权限问题
- 使用
docker inspect核对实际挂载源、目标和模式 - 根据容器运行用户修复宿主机文件所有权与安全策略
先确认 Docker 实际挂载了什么
不要只检查启动命令,应读取容器最终生效的挂载信息。相对路径、环境变量展开和 Compose 工作目录都可能让实际源路径与预期不同。下面创建一个只读挂载并观察写入失败:
rm -rf /tmp/anystack-mount-demo
mkdir -p /tmp/anystack-mount-demo/data
printf 'hello-mount\n' > /tmp/anystack-mount-demo/data/message.txt
docker rm -f mount-demo 2>/dev/null || true
docker run -d \
--name mount-demo \
-v /tmp/anystack-mount-demo/data:/data:ro \
alpine:3.20 \
sh -c 'sleep 300'
docker inspect mount-demo --format '{{range .Mounts}}type={{.Type}} source={{.Source}} destination={{.Destination}} rw={{.RW}}{{end}}'
docker exec mount-demo cat /data/message.txt
docker exec mount-demo sh -c 'printf "new\n" > /data/new.txt'预期输出
type=bind source=/tmp/anystack-mount-demo/data destination=/data rw=false
hello-mount
sh: can't create /data/new.txt: Read-only file system最后一条命令返回非零状态,证明文件可读但挂载被设置为只读。rw=false 比应用日志中的“写入失败”更直接地说明根因。
区分路径错误与目录覆盖
绑定挂载要求宿主机源路径真实存在且类型正确。使用 --mount 时,源路径不存在会直接报错;使用部分 -v 写法时,Docker 可能创建一个空目录,导致你误以为文件“被清空”。
挂载还会遮住镜像原有内容。例如镜像在 /app/config 内置默认配置,但把宿主机空目录挂到同一路径后,容器只能看到空目录。原文件仍在镜像层中,只是被挂载覆盖。建议在启动前检查源路径:
HOST_PATH=/tmp/anystack-mount-demo/data
test -d "$HOST_PATH"
find "$HOST_PATH" -maxdepth 1 -printf '%M %u:%g %p\n'预期输出
drwxr-xr-x <USER>:<GROUP> /tmp/anystack-mount-demo/data
-rw-r--r-- <USER>:<GROUP> /tmp/anystack-mount-demo/data/message.txt<USER> 和 <GROUP> 取决于宿主机账户。若 test -d 没有输出且返回码为 0,表示目录存在;返回非 0 则应先修正路径。
用 UID 和 GID 判断写权限
容器内用户名与宿主机用户名并不重要,真正参与权限判断的是数字 UID 和 GID。应用以 UID 10001 运行时,宿主机目录若只允许 root 写入,容器就会收到 Permission denied。
先查看容器进程身份和目录数字权限:
docker exec mount-demo id
docker exec mount-demo ls -ldn /data
stat -c 'uid=%u gid=%g mode=%a path=%n' /tmp/anystack-mount-demo/data预期输出
uid=0(root) gid=0(root) groups=0(root)
drwxr-xr-x 2 <UID> <GID> <SIZE> <TIME> /data
uid=<UID> gid=<GID> mode=755 path=/tmp/anystack-mount-demo/data<UID>、<GID>、<SIZE> 和 <TIME> 为动态值。真实应用若不是 root,应把其 UID/GID 与宿主机目录所有权逐项对照。
修复时优先让目录属于应用用户,而不是直接设置 chmod 777:
sudo chown -R 10001:10001 /tmp/anystack-mount-demo/data
sudo chmod -R u+rwX,go-rwx /tmp/anystack-mount-demo/data
stat -c 'uid=%u gid=%g mode=%a path=%n' /tmp/anystack-mount-demo/data预期输出
uid=10001 gid=10001 mode=700 path=/tmp/anystack-mount-demo/data如果多个容器需要共享目录,应使用共同 GID 并授予组权限,避免所有容器都以 root 运行。
检查 SELinux、AppArmor 与只读文件系统
传统 Unix 权限正确时,安全策略仍可能阻止访问。SELinux 系统可查看 getenforce 和审计日志;使用 bind mount 时,部分发行版需要 :z 或 :Z 标签。AppArmor 拒绝通常会出现在内核日志中。
此外还要区分挂载只读与容器根文件系统只读。--read-only 会禁止写入镜像可写层,应用仍需通过明确的可写卷或 tmpfs 保存日志、缓存和临时文件。
不要在不了解影响时关闭安全模块。更稳妥的做法是保留策略,修正挂载标签、允许路径或容器配置。
修复后验证读写与应用行为
权限修复后,应使用与应用相同的 UID 做最小写入测试:
docker rm -f mount-demo
docker run --rm \
-u 10001:10001 \
-v /tmp/anystack-mount-demo/data:/data \
alpine:3.20 \
sh -c 'printf "write-ok\n" > /data/probe.txt && cat /data/probe.txt'预期输出
write-ok测试成功后再启动真实应用,并确认配置读取、数据写入和重启后的持久化结果。最后删除 probe.txt,避免把诊断文件留在业务目录。