AREXOpen in interactive Feed

AREX Feed Article

OpenAI 官方解析 Codex 沙箱:不用容器、在用户环境里设限,默认免批准改源码、禁写 .git、默认禁网

November 19, 2026

北京时间 11 月 18 日 16 时,OpenAI 上线技术博客《Inside the Codex sandbox》,拆解其编程代理 Codex 的沙箱机制;当天 19:01(UTC,北京时间 19 日凌晨 3 时),官方开发者账号 @OpenAIDevs 又以推文线程贴出要点,并附上这篇博客的链接。按官方口径,Codex 不把计算搬进独立容器,而是直接在用户既有的开发环境里运行命令,用操作系统级(OS-level)沙箱施加用户可控的文件系统与网络限制。帖文开篇写道:「模型能力越强,限制它能访问什么就越重要。一条正在编辑你仓库的命令,不应该自动获得网络访问权限。」

本次公布的核心事实是默认权限配置:以 Git 仓库为工作区时,内置 :workspace 配置允许 Codex 免逐条批准修改源码文件,但把根目录的 .git 与 .codex 目录设为只读,网络默认关闭;命令请求联网时,Codex 可能直接提示用户,也可能把请求转交 auto-review(自动审查)。构建需要定期从包注册表下载的场景,官方给出的出路是启用网络代理、按域名规则放行注册表域名。文中机制均为 OpenAI 对自家产品的官方说明。

不用容器,在用户自己的环境里划出边界

虚拟机和容器是两种常见的沙箱手段,OpenAI 选择第三条路:用各平台自带的沙箱设施,约束运行在用户既有环境中的命令。博客给出的理由是,许多开发者的笔记本本身就是随手改动的定制开发环境,在 Docker 容器里复刻一遍费时费力,而且有些工作流离不开宿主机上的工具。

博客举出的例子是 iOS 开发:在 Mac 上用 Codex 开发 iOS 应用时,若把 Codex 关进 Docker,它跑不了由原生 Mac 可执行文件组成的 iOS 构建工具链,也拉不起 iPhone 模拟器;换成「把构建和模拟器操作委托给 Mac 宿主」的方案,这些操作又落在容器沙箱之外,得另行设限。官方的结论是把力气花在操作系统专属的沙箱上,让 Codex 待在对当前任务最合适的环境里。

平台差异被收进一套跨 macOS、Windows、Linux 的统一 API:调用方传入命令、工作目录、环境变量、权限配置(permission profile)以及按需提供的网络代理,函数在沙箱中启动进程并返回用于等待结束的 Child 句柄。继承规则写在这一层:每个子进程继承父进程的沙箱约束,限制贯穿整棵命令进程树,甚至及于比原进程更长寿的后代进程(线程推文)。

默认值背后的取舍与剩余风险

以 Git 仓库为工作区根目录时,内置 :workspace 配置允许写入工作区,同时把 .git、.codex 等目录保持只读。官方解释这样设计的目的:Codex 改源码不必逐条申请批准,但也改不了 .codex/config.toml,或在 .git/hooks 下替换 Git 钩子;该配置还继承了对 .agents、.aws 等目录的只读保护。

同一配置允许受用户既有 OS 权限约束的广泛文件系统读取——编译器、运行时和构建工具依赖仓库之外的 SDK、库与配置,把读取锁死在仓库内会破坏许多常规工作流;代价也写得直白:机器上别处的敏感文件,比如含 API key 的配置文件,可能因此保持可读。网络访问默认禁用,官方称这挡住向外部服务的直接上传,包括把命令能读到的数据外传的尝试,也挡住下载依赖这类正当操作。

模型可以为单条命令申请更多权限——博客列出的选项包括在沙箱内扩展访问的 with_additional_permissions,和请求在沙箱外执行的 require_escalated——由 Codex 运行环境(harness)按用户偏好裁决,落点是弹窗提示或转交 auto-review。博客没有回避这些默认值的局限:代理可以往 node_modules/prettier 这类本地包里注入恶意代码,node_modules 常被 Git 忽略,改动不会出现在 git status 里;若编辑器在保存时运行这份被篡改的 Prettier,恶意代码就在 Codex 沙箱之外执行。官方把这放进纵深防御(defense in depth)的框架:沙箱限制命令能碰什么,训练与对齐让模型按用户意图使用这些权限。

Codex CLI 另有 codex sandbox 命令,可在代理会话之外按指定权限配置直接运行任意命令,官方建议用它验证配置是否真的挡住目标行为。博客的演示是向只读的 .vscode 目录写入一份 settings.json,让 VS Code 保存时调用恶意格式化器;在 macOS 上,这条写入以 Operation not permitted 失败。

网络代理按域名规则逐请求放行

默认禁网挡住了正当的依赖下载,博客给出的方案是域名规则代理:在启用网络代理的权限配置里放行特定域名,官方示例包括 *.openai.com 与 localhost、127.0.0.1、::1 这类本机地址;代理逐请求对照配置决定是否转发,匹配的请求不需要每次单独批准。域名规则支持精确匹配与通配符,显式 deny 优先于 allow;请求落在规则之外的域名时,代理可以挂起请求、交回 harness 审批(同样可能直接提示或转交 auto-review),拿到决定后放行,或以错误响应拒绝。

实现层面,网络代理位于 Codex 仓库的 codex-network-proxy crate(Rust 代码包),既作库使用,也能构建为独立 CLI;启用后默认同时启动一个 HTTP 代理和一个 SOCKS5 代理,经 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 等标准变量和 PIP_PROXY 这类应用专属变量注入给沙箱内的命令。博客提醒并非所有程序都认这些变量——直连外部主机的程序会被操作系统层的沙箱拦下。顺序上还有一个细节:主机名的 DNS 解析只在该域名被允许或获批后才进行,因为一次 DNS 查询就能把编码在主机名里的信息带出去;官方同时注明,宽泛的通配规则或放开 DNS 服务,仍可能留下基于 DNS 的外泄通道。

同一代理内核,三种系统三套执行路径

代理的请求处理与策略核心在三大操作系统间共享,代理搭建与沙箱集成则因系统而异。博客配了一张从配置到执行的四阶段总览图:配置与托管要求(managed requirements)汇入 harness 生成的会话权限配置,再交由当前平台的实现执行,最后在沙箱中运行命令,子进程继承限制,需要时经代理发出请求。

macOS 上,Codex 使用苹果内核强制的 Seatbelt,通过 /usr/bin/sandbox-exec 以 SBPL(Sandbox Profile Language,沙箱配置语言)下发策略,基础策略从 (deny default) 起步;启用网络代理时再注入放行规则,只允许连到本机代理监听的端口。博客坦承 sandbox-exec 在手册页里标注为 DEPRECATED,SBPL 也没有面向第三方的文档,但 macOS 仍在系统里随附 Seatbelt 配置,Chrome 与 Chromium 也依赖它,OpenAI 打算在可预见的将来继续使用。

Linux 上,Codex 用 bubblewrap(构造隔离环境的命令行工具)与 seccomp-bpf(Linux 内核的系统调用过滤机制)组合,由内部助手 codex-linux-sandbox 协调:bwrap 在独立挂载命名空间里按权限配置构造文件系统视图,禁网或必须走代理时加 --unshare-net;seccomp 过滤器由 seccompiler crate 动态编译,施加在一个启动器进程上,约束随进程树传递,启动器同时设置 no_new_privs 防止子进程经 setuid 程序提权。走代理时,命令连接的是自己隔离网络命名空间内的回环监听器,由沙箱外的一个进程把连接转发给配置的代理——监听器的文件描述符经 Unix 套接字控制通道移交给沙箱外进程,命令不必接触宿主的网络命名空间。

Windows 的方案正在切换:OpenAI 称微软在此后发布了 MXC(Microsoft eXecution Container)库,官方正用基于 MXC 的沙箱替换现有 Windows 方案,理由包括后者需要管理员权限才能搭建沙箱、ACL(访问控制列表)检查与设置开销大、在主机上留下 ACL、防火墙规则、沙箱用户等持久状态;新方案固定禁用剪贴板访问、输入注入等控件,并阻止 MXC 回退为修改主机文件系统权限。域名规则仍由共享代理执行:代理在沙箱外运行,其地址经标准 *_PROXY 环境变量传给命令,MXC 拦下直连外部主机的连接、放行主机回环连接。

企业托管要求与自建工具的沙箱化

权限配置写在 config.toml 的 [permissions] 段下,可以从内置配置继承、按项目覆写;多个 config.toml 按优先级递归合并,团队因此只需覆写自己关心的条目。企业管理员可用 requirements.toml 提供托管要求,例如用 allowed_permission_profiles 限定可选配置集,云端要求的优先级高于系统的 /etc/codex/requirements.toml,最终合并后为 false 或缺席的配置对用户不可用。

博客还演示了把这套沙箱用在自建工具里:harness 不会沙箱化启动 stdio MCP(Model Context Protocol,模型上下文协议)服务器的命令,因为无法可靠推断其所需文件与网络服务,裸跑的 npx 拥有与用户相同的写入和联网权限,官方称这「过于宽松」;示例改用 codex sandbox 与名为 memory-mcp 的权限配置包裹原命令,把写入限制到 npm 缓存与数据目录并断网,再以 npx --offline 配合预置的包缓存启动。

回复区追问:postinstall 的连带放行与名单摩擦

截至北京时间 11 月 19 日 8 时 26 分,这条推文获得约 5 万次浏览、638 个点赞和 89 条回复。自述在 ADP Labs 负责 AI 代理产品的 Raz Bhimani 表态支持默认禁网:「对我们的报税代理来说,网络访问是我最先要锁死的东西。一次糟糕的文件修改会出现在 diff 里,数据悄悄离开机器却不会。」自述为安全与平台工程师、Docker Captain 的 Kaan Yagci 指出难办的情形:「需要 npm install 的任务。一旦给那条命令开了网络,依赖树里的每个 postinstall 脚本也一并拿到了。」用户 John Kocdr 则点出摩擦所在:「限制对外网络是正确的默认,但给 npm、pip 这类拉依赖的构建步骤管理允许名单,通常就是摩擦开始的地方。」

域名规则代理回应了「能否只放行注册表」:可以,但规则之外的域名每次仍需审批或被拦;而按官方写明的继承规则,单条命令拿到的扩展权限会随进程树传递。回复区里被反复追问的,正是这个场景——给 npm install 开了网络,它派生的 postinstall 脚本拿到什么、要不要逐条设防,博客与帖文都没有再往下写。

参考链接

  • Inside the Codex sandbox — OpenAI
  • @OpenAIDevs 推文线程(2026-11-18)
  • @OpenAIDevs 线程推文(默认权限与进程树继承)
  • Raz Bhimani 的回复
  • Kaan Yagci 的回复
  • John Kocdr 的回复