Linux用户命名空间如何映射主机UID?容器内外权限为何不同
容器内看到的 uid=0,不一定等于主机上的 UID 0。启用了用户命名空间后,Linux 会把容器内的 UID 映射到父用户命名空间中的另一组 UID;因此,容器内的“root”可能只是主机上的普通用户。反过来,主机上的文件也可能在容器内显示为 root、普通用户,甚至 nobody,具体取决于映射表和文件所在的文件系统。
权限差异的核心不在于容器把文件“复制”成了另一份,而在于进程凭据、文件属主和用户命名空间之间发生了转换。要判断一个进程能否访问文件,不能只看容器内的 id 输出,还要同时检查 UID/GID 映射、文件所在挂载点、权限位、ACL、能力和安全策略。
概念边界:用户命名空间隔离的是什么
UID不是跨命名空间固定不变的身份
Linux 文件的属主和进程身份最终都以数字 UID、GID 表示,但这个数字需要放在某个用户命名空间中理解。
在没有用户命名空间隔离时,容器内的 UID 0通常直接对应主机 UID 0:
容器 UID 0 → 主机 UID 0
这类容器中的 root 进程通常拥有主机级别的 root 身份,虽然仍可能受到容器能力集、挂载选项、SELinux、AppArmor、seccomp 等机制限制。
启用用户命名空间后,映射关系可能变成:

容器 UID 0 → 主机 UID 100000
容器 UID 1 → 主机 UID 100001
容器 UID 1000 → 主机 UID 101000
此时容器内的 UID 0仍然是该用户命名空间中的 root,但它并不是主机初始用户命名空间中的 root。
需要注意,映射表中的“主机 UID”更准确地说是父用户命名空间中的 UID。只有当父命名空间就是主机初始用户命名空间时,才能直接把它称为主机 UID。嵌套容器可能经过多层映射,不能简单把任意一层的数字都当作主机 UID。
用户命名空间不等于文件系统副本
用户命名空间主要隔离和转换以下内容:
- 进程的 UID、GID;
- 进程拥有的 capability;
- 与 UID/GID 相关的权限判断;
- 某些需要用户身份的内核操作。
它不会自动为每个命名空间创建一套完全独立的文件属主数据库。主机文件仍然是同一个 inode,文件内容也没有因为映射而自动复制。
例如,容器内 root 在可写层创建文件:
容器内看到:uid=0
主机上看到:uid=100000
这通常表示该文件实际由主机 UID 100000拥有,而不是主机 UID 0拥有。
工作机制:UID映射表如何生效
映射表的三列含义
在用户命名空间内查看 /proc/self/uid_map,通常会看到类似内容:
0 100000 65536
三列分别表示:
- 用户命名空间内的起始 UID;
- 父用户命名空间中的起始 UID;
- 连续映射的数量。
这行配置表示:
容器 UID 0 → 父命名空间 UID 100000
容器 UID 1 → 父命名空间 UID 100001
容器 UID 65535 → 父命名空间 UID 165535
换算关系可以写成:
父命名空间 UID = 父起始 UID +(容器 UID - 容器起始 UID)
如果映射表是:
0 1000 1
1 100000 65535
则含义是:
容器 UID 0 → 主机 UID 1000
容器 UID 1 → 主机 UID 100000
容器 UID 1000 → 主机 UID 100999
UID 和 GID 是两套独立映射,分别通过 uid_map 和 gid_map 表示。只检查 UID 而忽略 GID,可能会误判目录写入、组权限和设备访问结果。
常见的三种映射形态
| 使用方式 | 容器内 UID 0可能映射到 | 典型含义 |
|---|---|---|
| 未启用用户命名空间 | 主机 UID 0 | 容器 root通常也是主机 root |
| rootful 用户命名空间 | 主机的 subordinate UID,例如 100000 | 容器 root被降权为主机上的映射用户 |
| rootless 容器 | 启动者 UID,例如 1000 | 容器 root对应当前普通用户,其他 UID使用分配的 subordinate UID |
这里的 100000、1000 只是演示值,不代表所有系统都使用相同范围。实际范围可能由 /etc/subuid、/etc/subgid、容器运行时配置或显式映射参数决定。
rootless 容器常见的一行映射可能是:
0 1000 1
这意味着容器内 root 映射到启动容器的主机用户。为了让容器内其他 UID 也能工作,运行时通常还会配置更大的 subordinate UID/GID 范围。
创建用户命名空间时发生了什么
用户命名空间可以通过 clone()、unshare() 等机制创建。创建新的命名空间后,内核需要知道其中的 UID/GID 如何对应到父命名名空间。
典型流程可以概括为:
- 创建新的用户命名空间;
- 为新命名空间写入
uid_map; - 写入
gid_map; - 根据映射后的身份执行文件访问和系统调用;
- 通过
/proc/<pid>/uid_map、/proc/<pid>/gid_map提供当前映射信息。
普通用户创建用户命名空间并不等于获得主机 root。它只是获得了一个隔离的身份范围。即使进程在新命名空间中显示为 UID 0,它拥有的 capability 也主要作用于该命名空间及其允许管理的对象,不能自动转化为初始用户命名空间中的主机级权限。
为什么容器内外的文件属主会不同
容器可写层中的文件
如果文件是在启用 UID 映射的容器可写层中创建的,存储驱动或文件系统会按照映射关系记录属主。
例如:
容器内:
-rw-r--r-- 1 root root 12 data.txt
主机上:
-rw-r--r-- 1 100000 100000 12 data.txt
容器内的 root 和主机上的 100000 指向同一个实际身份,只是观察者所在的用户命名空间不同。
因此,直接在主机上使用 chown root:root 修改容器文件,未必会让容器内看到的文件变成预期的属主。主机 UID 0是否映射到容器中的某个 UID,需要先查看映射表。
bind mount中的主机文件
bind mount是权限问题最容易出现差异的地方。容器挂载主机目录时,目录中的 inode通常已经存在,容器并不会自动重写每个文件的 UID。

例如主机上的文件属于 UID 1000:
主机:
-rw------- 1 1000 1000 secret.txt
如果容器映射关系是:
容器 UID 0 → 主机 UID 200000
那么容器内的 root并不等于这个文件的属主。即使容器内执行:
id -u
输出为:
0
也不代表它能读取该文件。原因是它对应的主机身份是 UID 200000,而不是文件属主 UID 1000;同时,用户命名空间中的 capability也不能直接变成主机初始用户命名空间中的 CAP_DAC_OVERRIDE。
如果主机文件的 UID不在容器映射范围内,容器内查看时可能显示为 65534,通常对应 nobody 或匿名用户。这个数字并不一定表示文件真的被主机用户 65534拥有,而是表示当前命名空间无法把原属主转换为一个可表示的 UID。
文件权限检查不是只看UID
权限判断至少要同时考虑以下内容:
- 文件或目录的 UID;
- 文件或目录的 GID;
- 进程的有效 UID、有效 GID和附加组;
rwx权限位;- POSIX ACL;
- 文件系统挂载选项;
- 进程在目标用户命名空间中的 capability;
- SELinux、AppArmor等安全策略;
- 容器运行时配置的只读挂载或设备限制。
因此,“容器内是 root但无法写入”并不矛盾。这个 root可能没有主机级 capability,也可能面对一个主机上属于其他 UID的 bind mount目录,还可能被 ACL或安全策略拒绝。
影响结果的关键因素
是否启用了用户命名空间
首先要确认容器到底使用了哪种模式。默认容器并不一定自动启用 UID 重映射。没有用户命名空间时,容器内 UID 0通常仍然对应主机 UID 0;启用 rootless或 userns-remap后,映射关系才会改变。
不要根据容器内的 id 输出推断主机身份,应该读取实际的映射表。
文件位于哪一层
同一个容器中,不同路径可能对应不同存储来源:
- 容器自身的可写层;
- 镜像只读层;
- 主机 bind mount;
- 容器卷;
- 网络文件系统;
- 通过 idmapped mount调整过的挂载点。
可写层中的新文件通常遵循容器运行时的 UID 映射。bind mount中的既有文件则保留主机原有属主,权限问题更容易暴露。
现代 Linux还支持 idmapped mount。它可以为某个挂载点提供独立的 UID/GID 视图,而不必修改磁盘上 inode的实际属主。这与用户命名空间的进程身份映射不是同一个机制,排查时需要查看挂载属性,不能只看 uid_map。
GID和附加组是否正确
有些目录允许组写入,但容器内进程虽然显示了预期 UID,却没有正确的 GID或附加组。例如主机目录权限为:
drwxrwx--- 1 1000 2000 4096 project
容器进程如果没有映射到主机 GID 2000,即使 UID看起来正确,也可能无法写入。
用户命名空间中还可能限制 setgroups()。这是为了避免普通用户通过添加组身份扩大权限。rootless场景下遇到“UID映射成功但组权限不生效”,应同时查看 gid_map、进程的 Groups 字段以及 /proc/self/setgroups。
存储系统和安全模块
本地 ext4、XFS等文件系统对 UID映射的表现通常比较直观,但网络文件系统、特殊文件系统和某些旧版存储驱动可能有额外限制。
此外,权限位允许访问并不代表最终一定成功:
- SELinux可能根据安全上下文拒绝访问;
- AppArmor可能根据路径规则拒绝操作;
- 只读挂载会阻止写入;
- NFS服务端可能启用 root squash;
- overlayfs、网络文件系统或用户命名空间组合可能有版本相关限制。
因此,排查时应把“身份不匹配”和“其他安全策略拒绝”分开验证。
验证方法:不要只看容器内的 id
查看当前进程的映射
在容器或用户命名空间内执行:
id
printf '%s\n' '--- uid_map ---'
cat /proc/self/uid_map
printf '%s\n' '--- gid_map ---'
cat /proc/self/gid_map
printf '%s\n' '--- capabilities ---'
grep '^Cap' /proc/self/status
示例输出:
uid=0(root) gid=0(root) groups=0(root)
--- uid_map ---
0 100000 65536
--- gid_map ---
0 100000 65536
--- capabilities ---
CapInh: 0000000000000000
CapPrm: 0000000000000000
CapEff: 0000000000000000
这个结果表明:
- 容器内进程显示为 UID 0;
- 容器 UID 0映射到父命名空间 UID 100000;
- 容器内的 root不能据此被视为主机 root;
- capability还需要进一步解码和结合目标资源判断。
如果查看的是嵌套用户命名空间,第二列首先表示父命名空间 UID,不一定直接是主机 UID。
使用最小实验验证创建文件的属主
以下示例使用临时目录,验证“命名空间内 root创建的文件在主机上属于谁”。unshare通常由 util-linux提供,--map-root-user会把当前主机用户映射为新命名空间中的 UID 0。
tmp=$(mktemp -d)
printf '%s\n' "temporary directory: $tmp"
unshare --user --map-root-user sh -c '
echo "inside uid: $(id -u)"
echo "inside uid_map:"
cat /proc/self/uid_map
touch "$1/from-userns"
stat -c "inside: uid=%u gid=%g mode=%a path=%n" "$1/from-userns"
' sh "$tmp"
stat -c "host: uid=%u gid=%g mode=%a path=%n" "$tmp/from-userns"
假设当前主机用户 UID为 1000,典型结果可能是:
inside uid: 0
inside uid_map:
0 1000 1
inside: uid=0 gid=0 mode=644 path=/tmp/tmp.xxxx/from-userns
host: uid=1000 gid=1000 mode=644 path=/tmp/tmp.xxxx/from-userns
这个实验说明:
新命名空间 UID 0 → 主机 UID 1000
文件在命名空间内显示为 root,在主机上却属于 UID 1000。实验只创建临时目录和一个临时文件;确认路径确实是该实验目录后,可以使用以下命令清理。不要把变量替换成重要目录:
rm -rf -- "$tmp"
如果 unshare 返回“不允许操作”,可能是内核或系统策略禁止当前用户创建用户命名空间,也可能是运行环境本身处于更严格的沙箱中。此时应先检查:
cat /proc/sys/user/max_user_namespaces
if [ -r /proc/sys/kernel/unprivileged_userns_clone ]; then
cat /proc/sys/kernel/unprivileged_userns_clone
fi
对文件同时检查数字属主和路径属性
排查容器挂载目录时,不要只执行 ls -l,因为名称解析可能掩盖实际数字 UID。可以使用:
path=/path/to/check
stat -c 'uid=%u gid=%g mode=%a type=%F path=%n' "$path"
namei -l "$path"
findmnt -T "$path" -o TARGET,SOURCE,FSTYPE,OPTIONS
如果系统安装了 ACL工具,还可以检查:
getfacl -p "$path"
建议在主机和容器内分别执行同一组命令,并对照以下项目:
| 检查项 | 主机侧关注点 | 容器侧关注点 |
|---|---|---|
| 进程身份 | 启动进程的 UID/GID | id、附加组 |
| 映射关系 | 容器运行时配置 | /proc/self/uid_map、gid_map |
| 文件属主 | stat显示的数字 UID/GID | 是否显示为 root、普通用户或 65534 |
| 文件来源 | bind mount、卷或容器层 | 当前路径是否来自相同挂载 |
| 权限控制 | mode、ACL、SELinux上下文 | capability、只读挂载和安全策略 |
用现象反推原因
可以先按现象建立判断:

- 容器内 UID 0,主机文件属于 100000:通常是启用了 UID 重映射;
- 容器内看到 UID 65534:原属主不在当前映射范围内;
- 容器内是 root但主机目录拒绝写入:检查该 root对应的主机 UID、目录权限、ACL和挂载选项;
- 容器内文件属主正确但仍无法访问:检查 GID、附加组、SELinux/AppArmor和 capability;
- 容器层文件正常,bind mount文件异常:优先比较两者的实际 inode 属主和映射范围。
适用限制:UID映射不能替代完整隔离
用户命名空间适合解决两个问题:为容器提供独立的身份视图,以及降低容器 root对主机资源的直接权限。它并不保证所有文件系统、存储驱动和安全模块都以完全相同的方式支持身份转换。
以下边界需要特别注意:
- 没有用户命名空间时,不存在你期待的 UID降权效果。
容器内 UID 0可能仍是主机 UID 0。仅使用容器名称、镜像名称或 id 输出,无法确认是否启用了映射。
- 用户命名空间不是完整的安全边界。
主机内核、容器运行时、挂载权限、设备访问和安全模块仍会影响隔离效果。拥有用户命名空间中的 root,不等于可以随意管理主机进程、挂载点或内核资源。
- 未映射 UID不能被正常表示。
显示为 nobody 或 65534时,不应直接修改文件属主来“碰运气”。应先确认映射范围,再决定是调整容器用户、扩展 subordinate UID/GID,还是重新设计挂载目录的属主。
- 主机目录不应只按容器内用户名授权。
root、app、www-data等名称在不同命名空间中可能对应不同数字 UID。跨边界授权时应以数字 UID/GID、ACL和实际映射为准。
- 共享目录需要明确责任边界。
如果多个容器或主机进程共同访问同一目录,应先确定文件由哪一方创建、哪一方修改,以及使用 UID映射、固定 GID、ACL还是应用层权限协调。否则容易出现文件能创建但后续无法更新的情况。
判断容器内外权限时,可以遵循一个简单边界:先读 uid_map 和 gid_map,再用 stat确认文件数字属主,随后检查路径对应的挂载来源、权限位、ACL和安全策略。只有当这几项都对得上,才能解释为什么某个容器用户能够或不能够访问主机文件。
容器运行时与用户命名空间需要落在实际的计算、存储和网络资源之上。A5idc数据提供香港、美国、日本、韩国、中国台湾、新加坡及马来西亚等地区的物理服务器,涵盖不同CPU、内存、SSD或NVMe存储配置,可用于部署容器化业务、数据库和后台服务;多地区资源与不同线路方案,也为面向不同区域的业务部署提供基础。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/6422.html



