本地部署环境非root运行AWS SSM Agent时Session Manager启动会话报错
报错核心根因
你遇到的fork/exec /usr/bin/sh: operation not permitted报错,和/usr/bin/sh的文件执行权限完全无关——这个错误是内核在PTY(伪终端)分配、子进程创建的权限校验环节直接拦截导致的,触发点远早于shell二进制被执行的阶段,所以核查sh的权限自然找不到问题。
结合贴出的SSM Agent源码逻辑,这类报错的常见触发场景包括:
- 强制访问策略拦截非root进程的PTY申请
系统默认对/dev/ptmx伪终端主设备的访问规则虽然对所有用户开放,但如果主机开启了SELinux、AppArmor强制访问控制,或是对服务进程的PTY申请做了自定义限制,非root身份运行的SSM Agent在调用pty.Start打开伪终端节点时,会被直接返回权限拒绝。 - 内核参数限制非特权命名空间创建
Go语言pty库的底层实现依赖用户命名空间完成终端权限隔离,如果主机内核关闭了非特权用户的命名空间创建能力(比如配置了kernel.unprivileged_userns_clone=0、user.max_user_namespaces=0),非root进程调用ioctl打开PTY设备时会直接触发operation not permitted错误。 - SSM Agent的原生设计约束
AWS SSM Agent的Session Manager交互式shell功能,从设计层面就强依赖root权限运行:Agent需要在PTY启动后完成终端权限配置、登录用户身份切换、会话日志的权限设置等操作,非root身份的Agent没有setuid系统调用权限,哪怕PTY分配成功,后续流程也会被内核拦截。你当前能正常注册、控制台显示节点online,是因为Agent注册、非交互式命令下发的流程不需要特殊权限,但交互式会话的启动链路天生不支持非root运行。 - 系统资源硬限制拦截
如果主机配置了cgroup进程数上限、PAM命名空间限制,把ec2-user身份运行的进程允许创建的子进程数设置为极低值,也会在fork启动sh子进程时触发权限错误。
另外补充:贴出的源码片段里存在明显笔误——非空命令分支本该以sh作为执行入口,实际代码写的是启动date程序,不过这个笔误不影响当前空交互式shell的报错场景,错误是在PTY初始化阶段就返回的,还没走到命令分支的执行逻辑。
排查与解决思路
- 先验证基础PTY创建能力
以ec2-user身份直接登录主机执行script -c sh /dev/null,如果同样报operation not permitted,说明问题是系统层面的非root PTY权限限制,和SSM Agent本身没有关系。 - 排查强制访问策略影响
临时关闭SELinux(执行setenforce 0)、暂停AppArmor对目标进程的规则拦截,再以ec2-user身份重启SSM Agent测试会话连接。如果连接恢复正常,就需要给SSM Agent进程添加对应的访问控制规则,允许其访问/dev/ptmx设备、创建pts子节点。 - 检查内核参数配置
执行sysctl kernel.unprivileged_userns_clone user.max_user_namespaces查看参数值,如果数值为0,临时修改为可运行状态测试:sysctl -w kernel.unprivileged_userns_clone=1 user.max_user_namespaces=15000
如果修改后会话可以正常建立,就将参数写入sysctl配置文件做持久化配置。 - 匹配功能权限要求
需要明确:AWS官方不支持非root身份运行SSM Agent的Session Manager交互式会话功能。非root模式下Agent仅可完成节点注册、无PTY依赖的非交互式命令下发,交互式终端功能必须使用root权限运行Agent才能正常工作。如果当前场景必须以非root用户运行Agent,建议放弃交互式会话,改用非交互式命令下发方式管理主机。 - 排查资源限制配置
查看/etc/security/limits.conf中ec2-user的进程数限制,以及cgroup挂载路径下对该用户的pids.max配置,确认没有将非root用户的可创建进程数设置为0或过低值,避免fork子进程时被拦截。
内容的提问来源于stack exchange,提问作者edison
相关产品推荐
相关产品推荐

