当前位置:首页 > 文章列表 > 文章 > linux > Linux user namespaces 的 setgroups 文件怎样控制组权限切换

Linux user namespaces 的 setgroups 文件怎样控制组权限切换

来源:17golang原创 2026-11-19 19:43:22 0浏览 收藏

在 Linux user namespace 里,/proc/self/setgroups 不是一个普通的组列表文件,而是一个“是否允许调用 setgroups(2)”的控制开关。最容易出错的地方,是把它和 gid_map 当成同一件事:前者决定组集合能不能被调整,后者决定命名空间里的 GID 如何映射到父命名空间。

实际排查时可以记住一个顺序:先确保新命名空间能看到正确的 procfs,再在写 gid_map 前明确写入 allow 或 deny,最后才进行依赖映射的组权限切换。对没有父命名空间 CAP_SETGID 的普通创建者,通常要先写入 deny,否则写 gid_map 会失败。

官方参考:https://man7.org/linux/man-pages/man7/user_namespaces.7.html

先分清 setgroups 文件和 gid_map 的职责

/proc/self/setgroups 显示的是当前进程所属 user namespace 的策略:allow 表示允许命名空间内的进程使用 setgroups(2),deny 表示永久禁止。它不显示当前进程有哪些附加组,也不会替你写入任何 GID 映射。

/proc/self/gid_map 则描述组 ID 的映射关系。新 user namespace 刚创建时,映射为空;在映射完成前,改变组 ID 的系统调用不能正常使用。即使 setgroups 显示为 allow,gid_map 还没有写入时,调用 setgroups(2) 仍然会被拒绝。

对象回答的问题排查重点
setgroups能否调整附加组集合是否已写入 deny;是否在 gid_map 之前决定策略
uid_map用户 ID 怎样映射是否至少有一条有效映射,写入者是否满足权限条件
gid_map组 ID 怎样映射普通创建者是否先禁用了 setgroups,映射行是否有效
/proc这些内核接口能否被观察到当前命名空间是否挂载了可用的 procfs
user namespace 中 procfs、setgroups、uid_map、gid_map 和组权限切换的静态边界关系说明图
图1:结构说明图,展示 procfs 观察入口、setgroups 策略与 UID/GID 映射的职责边界;这是原创说明图,不是截图或运行证据。

准备可观察的 procfs 与 user namespace 环境

这里的“groups 挂载”应理解为:当前进程所在环境是否提供了包含 /proc/self/setgroups、uid_map 和 gid_map 的 procfs 观察入口。它不是一个独立的 groups 挂载参数,也不能通过重新挂载把已经做出的 deny 决策改回 allow。

先用下面的检查片段确认入口是否存在。它只读取状态,不创建命名空间,也不修改映射文件。

#!/bin/sh
# 只读取当前进程的命名空间接口,先排除 /proc 不可见的问题。
set -eu

for file in /proc/self/setgroups /proc/self/uid_map /proc/self/gid_map; do
    # 缺少文件时,通常先检查 procfs 挂载和内核接口,而不是先改权限。
    if [ -r "$file" ]; then
        printf '%s: ' "$file"
        cat "$file"
    else
        printf '%s: unavailable\n' "$file"
    fi
done

如果三个文件都能读到,下一步再看内容。初始命名空间中的 setgroups 默认通常为 allow;新命名空间继承父命名空间的设置。映射文件为空并不等于 procfs 有问题,而是说明该 user namespace 还没有完成身份映射。

按安全顺序建立 UID/GID 映射

创建者没有父命名空间中的 CAP_SETGID 时,最稳妥的顺序是:创建 user namespace,确认 /proc/self/setgroups 可写,在写入 gid_map 之前写入 deny,然后再写 uid_map 和 gid_map。deny 不是为了让当前命令“临时失去组权限”,而是为了阻断无特权进程通过丢弃附加组改变文件访问判断的路径。

# 这是启动器的顺序骨架,不是可直接复制的完整脚本。
# 映射数字必须替换为父命名空间中真实且允许的 UID/GID。
unshare --user --fork --mount-proc sh -c 'printf "%s\\n" ready'

# 父进程在子进程的 gid_map 写入前,先决定 setgroups 策略。
printf "%s\\n" deny > /proc//setgroups

# 下面两行需要由满足权限条件的协调者写入对应的 proc 文件。
printf "%s\\n" "0 1000 1" > /proc//uid_map
printf "%s\\n" "0 1000 1" > /proc//gid_map

# 映射完成后再让子进程读取 id,避免把映射前的空状态当成最终结果。
nsenter --user=/proc//ns/user id

这里把父进程和子进程的职责拆开,是为了突出真正的约束:setgroups 的写入必须发生在 gid_map 之前。unshare --map-root-user 等封装选项可能会替你自动完成映射和策略设置,因此不要把它和上面的骨架混拼。

示意里的 1000 只是占位符,不能直接当作任何机器都适用的配置。若实际运行返回 EPERM,先检查是否已经写过 gid_map、写入者是否是创建该命名空间的进程,以及映射行是否满足父命名空间权限条件。

如果上层启动器已经拥有父命名空间中的 CAP_SETGID,它可以按更宽的映射规则写入组映射;这并不改变 setgroups 的不可逆边界。选择 allow 应当是有明确组切换需求时的决定,而不是为了绕过一次映射错误。

用最小脚本定位权限切换失败

为了把“文件不存在”“映射为空”和“策略已拒绝”区分开,可以把三个状态和当前身份放在同一次诊断里。下面的脚本仍然只观察,不写入任何控制文件。

#!/bin/sh
# 把 setgroups、映射文件和当前身份并排输出,便于定位失败阶段。
set -eu

printf '%s\n' '== namespace group policy =='
if [ -r /proc/self/setgroups ]; then
    # allow/deny 是命名空间策略,不是当前附加组列表。
    sed -n '1p' /proc/self/setgroups
else
    printf '%s\n' 'setgroups file is not visible'
fi

printf '%s\n' '== uid map =='
# 空文件意味着 UID 映射尚未建立,不能据此判断 procfs 损坏。
cat /proc/self/uid_map

printf '%s\n' '== gid map =='
# GID 映射与 setgroups 策略是两个文件,必须分别记录。
cat /proc/self/gid_map

printf '%s\n' '== current identity =='
# id 的结果只表示当前视角,不能替代父命名空间中的映射检查。
id

诊断结果可以按三种情况处理:

  • setgroups 不存在:先检查当前 procfs 是否挂载在进程可见的 mount namespace 中,别急着写 gid_map。
  • setgroups=allow 且 gid_map 为空:策略看似允许,但映射未完成,组变更调用仍然不能使用。
  • setgroups=deny 且 gid_map 已有内容:这是已生效的永久策略,不能再通过写入 allow 恢复。
setgroups 策略、uid_map、gid_map 和 id 观察结果之间的静态关系说明图
图2:关系说明图,把策略文件、映射文件和身份观察放在同一个诊断边界内;这是原创说明图,不是终端截图或运行证据。

确认不可逆边界与部署取舍

deny 的关键特征是不可逆:在该 user namespace 中,之后再写 allow 会失败;子 user namespace 还会继承这项限制。另一方面,gid_map 写入后也不能再用 deny 把策略切换回去。因此,启动器必须在创建阶段就确定“这个命名空间是否需要运行时调整附加组”。

如果目标只是让命名空间内的进程获得一组固定的、已经映射的身份,先 deny 再写 gid_map 通常更容易解释,也能满足普通无特权创建流程。如果目标确实依赖 setgroups(2) 动态设置附加组,就需要让具备足够父命名空间权限的组件负责映射与策略安排,同时把这种能力限制在明确的启动边界内。

最后不要把 /proc/self/setgroups 的状态当成“文件权限已经切换”的证明。真正的文件访问检查还会结合 UID/GID 映射、文件自身的属主属组、能力以及所在的其他命名空间。这个文件只负责回答一个窄问题:当前 user namespace 是否允许调用 setgroups(2)。

相关问题

为什么 setgroups 显示 allow,调用仍然失败?

因为 gid_map 还没有写入时,内核会额外禁止 setgroups(2)。先读取映射文件,再判断策略值。

可以先写 gid_map,再写 setgroups deny 吗?

对需要通过 deny 放宽无特权 GID 映射条件的流程不可以。写入 gid_map 后,禁止 setgroups 的窗口已经关闭,之后写 deny 会得到 EPERM。

重新挂载 procfs 能把 deny 改回 allow 吗?

不能。挂载只影响这些接口是否可见,以及进程看到的 procfs 视图;它不会撤销已经写入命名空间的永久策略。

setgroups 文件和 /etc/group 有什么关系?

/etc/group 是用户态组数据库,setgroups 是内核 user namespace 的系统调用策略入口。前者不会替代后者,后者也不会自动更新前者。

小结

排查 Linux user namespaces 的组权限切换时,先确认 procfs 入口,再分别查看 setgroups、uid_map 和 gid_map。普通无特权创建流程应在写 gid_map 前写入 deny;需要动态组切换的流程则必须由具备足够父命名空间权限的启动组件明确承担。记住这个顺序,就不会把映射失败、procfs 不可见和永久策略拒绝混成一个问题。

版本声明
本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
Linux cgroup v2 memory.high 怎样限制而非立即终止进程Linux cgroup v2 memory.high 怎样限制而非立即终止进程
上一篇
Linux cgroup v2 memory.high 怎样限制而非立即终止进程
Linux tmpfiles.d 怎样自动创建并清理临时目录
下一篇
Linux tmpfiles.d 怎样自动创建并清理临时目录
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1127次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1112次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1287次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1227次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1077次使用