先从结论说起:struct user_namespace 在整个 Linux 内核的 namespace 体系里是一个非常特殊的存在。网络命名空间隔离的是 IP 地址和端口,挂载命名空间隔离的是文件系统视图,PID 命名空间隔离的是进程号——它们都只管某一类"资源"。而用户命名空间隔离的是权限身份本身,也就是"你是谁、你能干什么"。这个"身份"一旦被隔离,其他所有命名空间里关于权限的判定都要重新基于它来计算。这也是为什么容器场景里 rootless 方案绕不开 user namespace,也是为什么非特权用户能凭空捏出一个"自己是 root"的隔离环境却又伤害不到宿主机。
这篇文章不打算从头科普 namespace 是什么,我会直接以 struct user_namespace 这个结构体为线索,把用户命名空间的内核设计、Uid/Gid 映射机制、能力模型、生命周期管理,以及实际工程里容易踩的坑一条条拆开讲。适合已经写过容器、调过 unshare、或者正在被 rootless 容器权限问题折磨的开发者,也适合想真正理解内核 namespace 底层逻辑的运维和内核爱好者。
1. 先从 namespace 的"身份"问题说起
我们平时看到的 lsns 输出里,有 mnt、pid、net、ipc、uts、cgroup、time 这些 namespace,排在最后或者单独一个类别的是 user。从使用频率上看,user namespace 是大多数开发者接触最少的,但它在内核里承担的职责却是最基础的。
1.1 为什么"身份"也需要隔离
普通进程在系统里的一切行为,几乎都绕不开 uid/gid 和 capabilities 的检查。你打开一个文件,内核要查 inode 的属主和你的 fsuid 是否匹配;你 mount 一个文件系统,内核要检查你是否有 CAP_SYS_ADMIN;你发一个信号给别的进程,内核要比较双方的真实 uid。这些检查依赖的"你是谁"这个事实,在传统 Linux 里是全局唯一的——uid 0 就是 root,uid 1000 就是普通用户。
问题来了:如果我想在自己的目录里建立一套完整可用的 Linux 环境,里面有 systemd、有 sshd、甚至想跑 docker,但我又不是 root,怎么办?传统的做法是给这个用户 sudo 权限,这等于把整个系统交给他。另一种思路是:能不能让这个用户在某个隔离的视图里"看起来是 root",但出了这个视图,他仍然只是一个普通用户?这就是 user namespace 的出发点。
struct user_namespace 就是用来记录"这个隔离视图里 UID/GID 如何映射到外层"以及"这个视图的边界在哪里"的核心数据结构。每一个进程在创建时,它的 struct cred 里都会有一个 user_ns 指针,指向它当前所在的用户命名空间。权限检查时,内核拿到一个 uid,先通过这个指针找到对应的 user namespace,再经过映射翻译成外层的真实 uid,才能决定"他到底有没有权限做这件事"。
1.2 和普通结构体完全不同的设计出发点
如果把 struct net 或者 struct nsproxy 拿出来看,会发现那些结构体里装的是"资源清单":有哪些网卡、有哪些挂载点、进程树长什么样。但 struct user_namespace 的设计出发点不是资源清单,而是映射关系和边界关系。
它要回答三个问题:
- 这个命名空间里的 uid 0,映射到父命名空间里的哪个 uid?
- 这个命名空间的拥有者是谁?谁能在这里拥有完整权限?
- 这个命名空间的父级是谁?权限判定要追溯到哪一层?
这三个问题的答案,直接决定了 user namespace 的所有行为。理解了这一点,再看结构体里的字段就不会觉得奇怪了。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 解剖 struct user_namespace:内核是怎么设计这个结构体的
下面这段代码取自内核的 include/linux/user_namespace.h(以最近几个 6.x 稳定版为准),我先完整贴出来,再逐字段分析:
c复制struct user_namespace {
struct uid_gid_map uid_map;
struct uid_gid_map gid_map;
struct uid_gid_map projid_map;
atomic_t count;
struct user_namespace *parent;
struct uid_gid_map parent_uid_map;
struct uid_gid_map parent_gid_map;
struct uid_gid_map parent_projid_map;
kuid_t owner;
kgid_t group;
struct ns_common ns;
unsigned long flags;
struct ucounts *ucounts;
int ucount_max[UCOUNT_COUNTS];
} __randomize_layout;
注意最后这个 __randomize_layout 宏。内核开启了 RANDSTRUCT 加固时,编译期会随机打乱结构体字段顺序,所以绝对不要依赖字段的内存布局写外部代码,也不要在调试时按固定偏移去访问字段。这一点后面讲调试工具时还会再提。
2.1 三个映射表:uid_map、gid_map、projid_map
这是结构体里最核心的部分。分别对应 UID 映射、GID 映射、文件项目 ID(project ID)映射。每个字段的类型都是 struct uid_gid_map,这个结构体本身也不大:
c复制struct uid_gid_map {
unsigned int nr_extents;
union {
struct uid_gid_extent extent[UID_GID_MAP_MAX_EXTENTS];
struct {
struct uid_gid_extent *forward;
struct uid_gid_extent *reverse;
};
};
};
struct uid_gid_extent {
u32 first;
u32 lower_first;
u32 count;
};
extent 表示一段连续的映射区间:把"本命名空间里从 first 开始的 count 个 ID"映射到"父命名空间里从 lower_first 开始的 count 个 ID"。因为要求连续,所以一条映射记录只需要三个整数就能完整表达。UID_GID_MAP_MAX_EXTENTS 等于 5,意思是最多只能写五段不连续的映射区间。之后写映射文件时,内核会检查 nr_extents 是否超过 5。
还有一个值得注意的细节:nr_extents 小于等于 5 时,映射数据直接存在结构体里,不需要额外分配内存;超过 5 时,union 切换到 forward 和 reverse 两个指针,指向动态分配的数组。老版本内核直接规定了最多 5 段,为什么后来要支持动态扩展?因为某些场景需要大量不连续的映射段,比如把容器里 65536 个 uid 交错映射到宿主机一组子 uid 上。不过目前默认的 new_idmap_permitted 校验仍然把一次性写入限制在 5 段以内。
2.2 parent 指针与三个 parent 映射表
parent 指向创建当前命名空间的那个父用户命名空间。parent_uid_map、parent_gid_map、`
