首页/云/Docker 容器速查/统一 UID/GID 数字避免权限错位
本包目录(366 条)
基础命令50 条
镜像与构建107 条
网络与存储52 条Compose 编排55 条资源与安全50 条容器排障52 条

统一 UID/GID 数字避免权限错位

跨镜像与跨机器共享挂载目录时,权限按数字 UID 匹配:预先规划固定数字(如 10001)并全链路使用。

Docker 容器速查云更新于 2026-10-12
原则文件权限按数字 UID/GID 匹配,与用户名无关
做法useradd -u 10001 + USER 10001:10001
复用node=1000、nginx=101 等基础镜像内置账号

示例

示例
RUN groupadd -g 10001 app && useradd -u 10001 -g 10001 -m app
USER 10001:10001
# 宿主目录对齐
sudo chown -R 10001:10001 /srv/app-data
多容器共享数据卷、宿主目录挂载时,把数字 UID 写进部署文档与 CI 模板,避免各处各写一个值。

易错点

  • 两个容器里用户名都叫 app 但 UID 不同,共享卷时其中一个必然写不进去
  • 宿主上先有 uid 1000 的普通用户时容器文件属主显示成那个名字,别误认为挂载错人

数据来源与参考

  • Docker 官方文档:USER 与挂载权限说明(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌