Codex 沙盒如何在用戶現有環境限制命令的檔案及網絡存取
Inside the Codex sandbox
OpenAI 詳解 Codex 沙盒如何透過作業系統的隔離機制,在用戶現有環境中限制命令對檔案系統及網絡的存取。內建 :workspace 權限設定允許工作區內寫入、廣泛讀取檔案並預設停用網絡,用戶亦可自訂權限設定檔,或透過 codex sandbox 將沙盒執行整合到其他工具。
文章串連權限設定、網絡代理與 macOS、Linux、Windows 的隔離實作,説明 Codex 如何在沿用本機開發環境時約束命令存取。
Codex 沙盒內部
Codex 如何在你可控制的限制下,於你的電腦上執行命令。
作者:Michael Bolin,技術團隊成員
聆聽文章 28:07
分享
選擇沙盒的界線
在 OpenAI,我們採用縱深防禦(在新視窗開啟)的方式保障 Agent 安全。我們在訓練和對齊方面的投入是這項工作的根本,同時亦在 Agent 執行框架 Codex(在新視窗開啟)中實作功能,提供額外保護。由於 Codex 最常做、亦可能帶來風險的事情之一,是在你的電腦上執行命令,因此我們建立了Codex 沙盒,讓 Codex 能在你現有的環境中工作,並遵守由你控制的檔案系統和網絡限制。
一個(在新視窗開啟)_沙盒_(在新視窗開啟)會限制程式執行期間可存取的內容。以整理相片的工作為例,你可以設定 Codex 沙盒,允許命令讀取及修改 ~/Pictures 中的檔案,同時封鎖網絡存取以防止上載。進行程式碼審查時,你可以允許存取網上文件,同時將原始碼檔案設為唯讀。用戶透過(在新視窗開啟)_權限設定檔_(在新視窗開啟)設定 Codex 沙盒;這些設定檔會界定 Codex 工作階段的檔案系統及網絡限制。
本文會先介紹 Codex 沙盒預設設定背後的取捨,再説明沙盒的設計,以及執行框架如何運用沙盒來執行命令。我們會展示最終用戶和企業如何按需要調整沙盒權限,以及開發人員如何在自己的工具中重用沙盒。最後,我們會探討如何在 macOS、Linux 和 Windows 上強制執行這些限制。
選擇沙盒的界線
在 Codex 中,我們的理念是為沙盒設定保守的預設值,同時仍能支援有意義的工作。例如,以 Git 儲存庫作為工作區根目錄時,內置的 :workspace 權限設定檔:
允許在工作區內寫入,同時將例如
.git和.codex設為唯讀。這讓 Codex 無須每次修改都先取得許可,便可編輯原始碼,同時防止直接修改.codex/config.toml或.git/hooks內的 Git hooks。可廣泛讀取檔案系統,但仍受用戶現有的作業系統權限限制。編譯器、執行環境及建置工具都依賴儲存庫以外的 SDK、程式庫和設定。若限制讀取範圍只限於工作區,許多日常工作流程便會無法運作。取捨是,電腦其他位置的敏感檔案可能仍可讀取,例如包含 API 金鑰的設定檔。
停用網絡存取。這會阻止直接上載至外部服務,包括試圖外洩指令可讀取資料的行為。這也會阻止下載依賴套件等需要額外存取權限的正常操作。
這些限制可防止大量不當行為,但仍有可能發生有害操作。例如,Agent 可以將惡意程式碼注入本機安裝的套件,例如 node_modules/prettier。這類改動可能不會顯示在 git status 中,因為 node_modules 通常會被 Git 忽略。如果用戶的編輯器在儲存時執行該版本的 Prettier,單是儲存檔案便可能在 Codex 沙盒外執行惡意程式碼。因此,我們採取縱深防禦策略:沙盒限制指令可存取的內容,而訓練和對齊則協助模型按照用戶意圖運用這些存取權限。
如需瞭解如何調整沙盒權限,並在企業環境中配合其他保護措施,請參閲Codex 安全指南(在新視窗開啟)。
設計沙盒
虛擬機器和容器(在新視窗開啟)是兩種常用的沙盒機制,但 Codex 沙盒採用不同做法。Codex 不會將運算移至獨立環境以提供隔離,而是利用各平台的沙盒功能,限制在用戶現有環境中執行的指令。
對許多開發人員來説,手提電腦就是專屬的開發環境,可以隨時按需要更改。要在 Docker 容器中重現該環境可能需要不少工夫,而且有些工作流程仍依賴在主機上執行的工具。
例如,假設你使用 Codex 在 Mac 上開發 iOS 應用程式。如果你決定在 Docker 內執行 Codex 來建立沙盒,Codex 便無法執行由原生 Mac 可執行檔組成的 iOS 建置工具鏈,也無法啟動 iPhone 模擬器來執行程式碼。採用 Docker 的工作流程可以將建置和模擬器操作交由 Mac 主機處理,但這些操作會在容器沙盒外執行,因此需要各自的限制。對 Codex 而言,我們選擇大力投入各作業系統專屬的沙盒機制,讓 Codex 可在最適合當前任務的環境中執行,從而簡化流程。
執行框架透過共用 API,在 macOS、Windows 和 Linux 上提供各自的沙盒機制。此 API 接收一個指令及一個權限設定檔。若權限設定檔允許有限度的網絡存取,呼叫端必須提供網絡代理伺服器,以強制執行這些限制:
Python
1# This is a simplified version of the actual API.2def spawn_command_under_sandbox(3 program_and_args: list[str],4 cwd: Path,5 env: dict[str, str],6 permission_profile: PermissionProfile,7 network_proxy: NetworkProxy | None,8) -> Child:
此函式會在沙盒中啟動程序,並傳回一個 Child 控制代碼,讓執行框架可用來等待程序完成。每個子程序都會繼承其父程序的沙盒限制,因此這些限制會套用於指令啟動的整個程序樹,包括存續時間超過原始程序的後代程序。
下圖展示各部分如何配合,從設定到執行沙盒化指令。接下來的各節會説明每個階段。

執行框架如何運用沙盒
如拆解 Codex Agent Loop一文所述,Codex 執行框架負責執行模型產生的工具呼叫。對於編碼工作,最常用的工具是 shell 工具,它會執行指令,方式與用戶在 Bash 等互動式 shell 中操作相似。以下會查看單次執行 (在新視窗中開啟)exec_command(在新視窗中開啟)shell 工具(在新視窗中開啟),説明執行框架如何運用沙盒,提供所需的保護。
以下簡化説明 Codex 執行框架在不使用沙盒時,如何處理 exec_command 工具呼叫:
Python
1# Illustrative implementation of the exec_command tool call.23class ExecCommandToolCall:4 cmd: str5 workdir: str | None = None6 shell: str | None = None7 login: bool = True8 timeout_ms: int = 10_00091011def perform_exec_command(tool_call: ExecCommandToolCall):12 program_and_args = [13 tool_call.shell or os.environ.get("SHELL") or "/bin/sh",14 "-lc" if tool_call.login else "-c",15 tool_call.cmd,16 ]17 child = subprocess.Popen(18 program_and_args,19 # workdir defaults to the turn's cwd, assumed here to be the process cwd.20 cwd=Path(tool_call.workdir or ".").absolute(),21 stdout=subprocess.PIPE,22 stderr=subprocess.STDOUT,23 )24 output, exit_code = collect_output(child, timeout_ms=tool_call.timeout_ms)25 return {"output": output, "exit_code": exit_code}
為了在沙盒中執行指令,執行框架會將呼叫 subprocess.Popen() 改為呼叫 spawn_command_under_sandbox()。執行框架會提供權限設定檔,並在需要時提供網絡代理:
Python
1# Honoring the exec_command tool call while enforcing sandbox constraints.23def perform_exec_command_with_sandboxing(4 tool_call: ExecCommandToolCall,5 permission_profile: PermissionProfile,6 network_proxy: NetworkProxy | None,7):8 # ...build program_and_args as in the previous example...9 child = spawn_command_under_sandbox(10 program_and_args=program_and_args,11 cwd=Path(tool_call.workdir or ".").absolute(),12 env=os.environ.copy(),13 permission_profile=permission_profile,14 network_proxy=network_proxy,15 )16 output, exit_code = collect_output(child, timeout_ms=tool_call.timeout_ms)17 return {"output": output, "exit_code": exit_code}
exec_command 工具亦容許模型為個別指令要求不同權限,但是否授予權限由執行框架決定:
Python
1class ExecCommandToolCall:2 # ...command-related fields...34 # Per-command sandbox override. Defaults to "use_default".5 sandbox_permissions: Literal[6 "use_default",7 "with_additional_permissions",8 "require_escalated",9 ] = "use_default"1011 # User-facing approval question; only for "require_escalated".12 justification: str | None = None1314 # Expand network or filesystem access; only for "with_additional_permissions".15 # AdditionalPermissions supports fine-grained options.16 additional_permissions: AdditionalPermissions | None = None
指定 use_default 時,執行框架會在該回合使用預設的沙盒設定。with_additional_permissions 會要求在沙盒內擴大存取權限,而 require_escalated 則會要求在沙盒外執行。執行框架會根據用戶的偏好評估要求,然後才執行指令。(例如,Codex 可能會直接提示用戶,也可能將要求交由自動審核(在新視窗中開啟)處理。)如獲授權執行,Codex 會連同原始 ExecCommandToolCall 的指令引數,將適用的 permission_profile 和 network_proxy 傳遞給 perform_exec_command_with_sandboxing()。
shell 工具是 spawn_command_under_sandbox() 的主要使用者,而執行框架亦會重用其沙盒基礎設施,執行讀取及修改本機檔案等操作。這種重用方式亦不限於執行框架:codex sandbox 指令可讓你在自己的工具中加入沙盒化的指令執行功能,稍後會再作介紹。接下來,我們會看看如何定義權限設定檔。
設定沙盒
具名權限設定檔可讓你在不同項目中重用相同的檔案系統及網絡限制。你可以在 config.toml 的 [permissions] 中定義自己的設定檔。例如,以下定義了一個名為 dev 的設定檔,並擴充(在新視窗中開啟)內置的 :workspace 設定檔:
TOML
1# Use the dev profile by default.2default_permissions = "dev"34[permissions.dev]5# This is displayed when /permissions is run in the Codex CLI.6description = "Development with extra read-only protections."78# A profile can be derived from an existing profile.9# Profiles starting with ":" are provided by Codex.10extends = ":workspace"1112[permissions.dev.filesystem]13"~/build-cache" = "write"1415[permissions.dev.filesystem.":workspace_roots"]16".devcontainer" = "read"17".vscode" = "read"18"**/*.env" = "deny"19"secrets" = "deny"
dev 設定檔會為 ~/build-cache 加入寫入權限,並對工作區內的檔案施加額外限制。檔案系統項目可授予唯讀權限(read)、授予讀取及寫入權限(write),或完全封鎖存取(deny)。
:workspace_roots 表格可讓你為相對於項目工作區根目錄的路徑定義規則。預設情況下,Codex CLI 會以其工作目錄作為唯一的工作區根目錄,而 ChatGPT 桌面應用程式則會使用項目的原始碼資料夾。Codex 會將每項規則套用至所有根目錄,因此,dev 中的 .vscode 項目會令每個根目錄下的 .vscode 目錄變成唯讀。
除了自身的規則外,dev 亦會沿用 :workspace 的以下保護措施:
TOML
1[permissions.":workspace".filesystem.":workspace_roots"]2".agents" = "read"3".aws" = "read"4".codex" = "read"5".git" = "read"
網絡權限
在 Codex 中設定沙盒的網絡權限,大致有以下三種選項:
停用所有網絡存取(
:workspace設定檔的預設值)啟用完整的直接網絡存取權(
:danger-full-access設定檔的預設值)將網絡存取限制為透過代理,並由代理根據權限設定檔決定允許哪些連線
如要讓 dev 直接存取網絡,請在 config.toml 的頂層設定 permissions.dev.network.enabled = true。停用網絡代理時,這會授予完整的網絡存取權。
如要將 dev 的存取範圍限制為一組網域,請啟用網絡代理並設定網域規則:
TOML
1[permissions.dev.network]2enabled = true34[permissions.dev.network.domains]5"*.openai.com" = "allow"6# Allow requests to local services by hostname or by IPv4/IPv6 loopback address.7"localhost" = "allow"8"127.0.0.1" = "allow"9"::1" = "allow"10"evil.example" = "deny"1112[features]13# If neither local config nor managed requirements enable the proxy,14# this profile allows direct network access; domain rules are not enforced.15network_proxy = true
網域規則支援精確名稱和萬用字元模式,明確拒絕規則的優先次序高於允許規則。對其他網域的請求須經批准,否則會被封鎖,詳情請參閲下文的「網絡代理」。
分層設定與強制限制
個別用戶可以設定適用於所有專案的預設值,亦可以為特定受信任專案設定覆寫值。企業管理員亦可能需要為用戶設定預設值,並限制用戶可以變更的設定。Codex 透過分層設定和受管理要求支援這兩種做法。
如設定優先次序(在新視窗開啟)一節所述,Codex 會合併多個 config.toml 檔案中的設定。表格會以遞迴方式合併;值有衝突時,以優先次序較高的來源為準。陣列則會整個取代。
因此,權限設定檔會以表格設定檔案系統路徑和網域。團隊可以在自己的設定中新增或覆寫個別項目,並自動沿用組織基本設定中其他所有項目的變更:
TOML
1[permissions.dev.filesystem.":workspace_roots"]2".idea" = "read"34[permissions.dev.network.domains]5"example.com" = "allow"
管理員亦可透過 requirements.toml 提供受管理要求(在新視窗開啟),限制用戶可選擇的設定。這些要求可以來自多個來源,包括系統檔案和雲端提供的政策。一個常見用途是指定 allowed_permission_profiles,以限制企業用戶可選擇的權限設定檔範圍。例如,管理員可以指定以下雲端要求:
TOML
1default_permissions = ":read-only"23[allowed_permission_profiles]4":read-only" = true5":danger-full-access" = false
雲端要求的優先次序高於 /etc/codex/requirements.toml 中的系統要求檔案,因此該檔案中的項目無法覆寫上述明確指定的 ":danger-full-access" = false。不指定 :workspace,可讓另一層要求提供該項目。項目值為 false 或未出現在最終合併表格中的設定檔均無法使用。
這種分工讓組織能夠強制執行限制,同時讓用戶在限制範圍內自訂設定。接下來會介紹如何讓 harness 使用這些權限設定檔,或直接將其套用至指令。
使用 codex sandbox 指令
Codex CLI 提供 sandbox 指令,方便用戶在 Codex 設定中定義的權限設定檔下執行任意指令。這通常用於測試設定檔,確保沙盒能阻止其原本旨在封鎖的行為。
例如,以下指令會嘗試設定 VS Code,讓它在儲存時執行惡意的自動格式化工具。假設 .vscode 已存在,上文定義的 dev 設定檔應會阻止這項寫入操作,因為該目錄是唯讀的(codex sandbox 預設會將 cwd 視為工作區根目錄):
Bash
1codex sandbox --permission-profile dev -- \2 bash -c 'cat > .vscode/settings.json' <<'JSON'3{4 "prettier.prettierPath": "./node_modules/evil-prettier",5 "[typescript]": {6 "editor.defaultFormatter": "esbenp.prettier-vscode",7 "editor.formatOnSave": true8 }9}10JSON
在 macOS 上,這項操作確實會失敗並顯示:
純文字
1bash: .vscode/settings.json: Operation not permitted
codex sandbox 指令讓 Codex 的沙盒機制可以在 Agent 工作階段之外使用。你可以使用相同的設定語言和平台專屬的強制執行機制,限制由你自己的工具啟動的指令。
範例:為 MCP 伺服器使用沙盒
對於在 config.toml 中設定的 stdio MCP 伺服器,Codex harness 不會嘗試為啟動伺服器的指令套用沙盒。Codex 無法可靠地推斷伺服器需要哪些檔案或網絡服務,因此套用預設沙盒設定檔可能會令原本有效的設定無法運作。
以下是設定@modelcontextprotocol/server-memory(在新視窗開啟) MCP 伺服器以供 Codex 使用的標準做法:
TOML
1[mcp_servers.memory]2command = "npx"3args = [4 "-y",5 "@modelcontextprotocol/server-memory@1.0.0"6]78[mcp_servers.memory.env]9MEMORY_FILE_PATH = "~/mcp-data/memory.jsonl"
由於這個 npx 指令未在沙盒中執行,因此可以使用執行 Codex 的用戶帳戶所擁有的相同權限寫入檔案及發出網絡請求,權限過於寬鬆。要收緊限制,我們可以定義名為 memory-mcp 的權限設定檔,然後使用 codex sandbox --permission-profile memory-mcp 包裝原本的 npx 指令,限制伺服器可寫入的位置,並禁止伺服器存取網絡:
TOML
1[permissions.memory-mcp.filesystem]2# Allow broad reads for Node.js/npm dependencies and configuration.3":root" = "read"4"~/.npm" = "write"5"~/mcp-data" = "write"67[permissions.memory-mcp.network]8enabled = false910[mcp_servers.memory]11command = "codex"12args = [13 "sandbox",14 "--permission-profile",15 "memory-mcp",16 "--",17 "npx",18 "--offline",19 "@modelcontextprotocol/server-memory@1.0.0"20]2122[mcp_servers.memory.env]23MEMORY_FILE_PATH = "~/mcp-data/memory.jsonl"
啟動伺服器前,先建立其資料目錄,並將指定版本的套件放入 npm 快取。這樣 npx --offline 就能在停用網絡存取的設定檔下啟動伺服器:
Bash
1# The sandbox can write to this folder, but it cannot create it.2mkdir -p ~/mcp-data34# Installing the MCP server requires network access.5npx -y --package=@modelcontextprotocol/server-memory@1.0.0 -c true
套件快取完成後,Codex 就能在沒有網絡存取的情況下啟動記憶伺服器,並將寫入範圍限制於 npm 快取及伺服器的資料目錄。
Codex 沙盒實作
沙盒實作會將權限設定檔轉換成由作業系統強制執行的限制。網絡代理伺服器的核心請求處理及政策邏輯在三大作業系統之間共用,但代理伺服器的設定及與沙盒的整合則因作業系統而異。我們會先探討共用的代理伺服器,再介紹 macOS、Linux 和 Windows 的實作。
網絡代理伺服器
為了強制執行權限設定檔中的網絡限制,執行框架會啟動網絡代理伺服器,並設定沙盒允許連線至該代理伺服器,同時封鎖直接連線至外部主機。代理伺服器會根據設定檔中的網域規則檢查每項請求,以決定是否轉發該請求。
在 Codex 儲存庫中,網絡代理伺服器由 codex-network-proxy(在新視窗中開啟) crate 實作,執行框架會以程式庫形式使用它;此外,它也可以建置為獨立 CLI(在新視窗中開啟)。啟用後,codex-network-proxy 預設會同時啟動 HTTP 代理伺服器和 SOCKS5 代理伺服器。這些代理伺服器的位址會透過環境變數傳送給沙盒所啟動的程序。除了注入 HTTP_PROXY、HTTPS_PROXY 和 ALL_PROXY 等標準環境變數外,也會注入一些常見的應用程式專用環境變數(在新視窗中開啟)(例如 PIP_PROXY)。誠然,並非所有程式都會遵從這些環境變數。如果程式嘗試直接連線至外部主機,作業系統的沙盒限制便會封鎖連線,詳情見下文各平台專屬的章節。
網絡代理伺服器負責實作權限設定檔所定義的網絡限制。例如,先前展示的 dev 設定檔允許向 *.openai.com 發出請求,並明確拒絕向 evil.example 發出請求。當請求的目標網域不符合任何允許或拒絕規則時,代理伺服器可以暫停請求,並交由執行框架徵求核准。與 shell 指令範例一樣,Codex 可以直接提示用戶,也可以將請求轉交auto-review(在新視窗中開啟)。收到決定後,代理伺服器會允許請求繼續,或以錯誤回應拒絕請求。
這個先後次序很重要,因為即使是 DNS 查詢,也可能洩露編碼在主機名稱中的資訊。因此,代理伺服器只會在確認請求獲準或已獲批准後,才解析所要求的主機名稱。請注意,過於寬泛的萬用字元規則或存取 DNS 服務,仍可能容許透過 DNS 外洩資訊。
macOS
在 macOS 上,Codex 會使用 Seatbelt(在新視窗開啟),這是 Apple 以核心強制執行的沙盒機制。Seatbelt 政策以 Sandbox Profile Language (SBPL) 編寫;這是一種以 Scheme 為基礎、用於表達沙盒限制的語言。Codex 透過 macOS 的 /usr/bin/sandbox-exec 指令呼叫 Seatbelt。與 codex sandbox 一樣,它會接收描述沙盒的選項,後接要執行的指令:
Bash
1sandbox-exec -p PROFILE [-Dkey=value]* -- PROG ARGS...
PROFILE 是一段 SBPL 字串,包含用來設定沙盒的項目。例如,以下 SBPL 片段會根據沙盒政策,令 /dev/null 和 /dev/zero 可讀取及寫入:
Scheme
1(allow file-read* file-test-existence file-write-data2 (literal "/dev/null")3 (literal "/dev/zero"))
執行沙盒時啟用網絡代理,設定檔中便會注入類似以下的規則,以限制連線至適當的本機連接埠:
Scheme
1; local HTTP proxy launched by Codex2(allow network-outbound (remote ip "localhost:3128"))34; local SOCKS proxy launched by Codex5(allow network-outbound (remote ip "localhost:8081"))
Codex 的基本設定檔以 (deny default) 開始,因此除非明確允許,否則對外連線會一直遭到封鎖。
最後,SBPL 可以使用 (param) 作為佔位符:
Scheme
1; Pass -DWRITABLE_ROOT_0=/path/to/dir to specify a folder that cannot be removed.2(deny file-write-unlink3 (require-all4 (literal (param "WRITABLE_ROOT_0"))5 (vnode-type DIRECTORY)))
這些佔位符會由傳遞給 sandbox-exec 的 -Dkey=value 選項填入。
為了實作自己的沙盒 API,Codex 會逐步組成要傳給 sandbox-exec 的引數清單(在新視窗開啟),並以基本政策(在新視窗開啟)為起點,再利用 permission_profile 和其他上下文資訊作出修訂,以產生完整的 Seatbelt 設定檔。產生的設定檔及其配套的 -D 引數會設定由 Seatbelt 強制執行的限制,而網絡代理則會強制執行額外的網絡規則。組成完整的引數清單後,呼叫 sandbox-exec 就很直接。
要產生正確的 SBPL 並不容易,因為 Apple 沒有為第三方用途提供該語言的文件。事實上,man sandbox-exec 指明 The sandbox-exec command is DEPRECATED;sandbox_init() 程式庫函式(文件見於 man 3 sandbox_init)亦有相同説明。儘管有棄用警告,macOS 仍在 /usr/share/sandbox 中附帶 Seatbelt 設定檔,而包括 Google Chrome 和 Chromium(在新視窗開啟) 在內的第三方軟件,至今仍依賴 Seatbelt。因此,我們計劃在可預見的未來繼續使用 Seatbelt。
Linux
要在 Linux 上建立沙盒,Codex 會結合使用 bubblewrap(在新視窗開啟)(bwrap)——一種用來建構隔離環境的命令列工具——以及 seccomp-bpf(在新視窗開啟),這是 Linux 核心用來篩選系統呼叫的機制。名為 codex-linux-sandbox 的內部輔助程式負責協調設定。與 macOS 上的 sandbox-exec 一樣,它會接收沙盒設定,後接要執行的指令:
Bash
1codex-linux-sandbox SANDBOX_ARGS... -- PROG ARGS...
當需要檔案系統隔離或代理路由時,codex-linux-sandbox 會呼叫 bwrap 建立初始沙盒環境。然後,bwrap 會在其中啟動 codex-linux-sandbox --apply-seccomp-then-exec。第二次呼叫會在執行用戶的指令前,使用 seccomp-bpf 套用額外限制。
為建立該初始沙盒環境,Codex 會使用 bubblewrap,在獨立的掛載命名空間中建立檔案系統視圖,以反映權限設定檔的檔案系統規則。由於這是沙盒實作的基礎,Codex 會自行附帶一份 bwrap,以備用戶未有自行安裝;但如有提供,會優先使用相容的安裝版本(在新視窗中開啟)bwrap(在新視窗中開啟),該版本可在 PATH 找到。根據實際觀察,部分 Linux 發行版預設會停用用戶命名空間的存取權限(在新視窗中開啟),但會為系統 bwrap 授予例外。
與 sandbox-exec 一樣,bwrap 會接收沙盒設定,後接要在沙盒內執行的命令。bwrap 不使用 SBPL 這類自訂設定語言,而是使用個別旗標進行設定。Codex 使用以下選項建立檔案系統視圖:
--bind用來指定可寫入的檔案或目錄--ro-bind用來指定唯讀的檔案或目錄--perms 000 --tmpfs DIR --remount-ro DIR用來拒絕存取DIR--perms 000 --ro-bind-data FD FILE用來拒絕存取FILE(其中FD是指向/dev/null的已開啟檔案描述符)
要使用這些選項套用拒絕存取的 glob 模式,Codex 會在啟動每個命令前,將模式展開為具體路徑。新出現而符合模式的路徑不會自動加入該命令的沙盒限制。
Codex 亦會指定 --unshare-ipc 和 --unshare-pid 等選項,防止沙盒存取主機上的其他類型資源,因此 bubblewrap 影響的不只是檔案可見性。
使用 bubblewrap 時,只要停用網絡或必須透過網絡代理連線,Codex 就會傳入 --unshare-net,為沙盒建立新的網絡命名空間。之後,我們會使用 seccomp-bpf,進一步限制命令可使用的網絡系統呼叫和 socket 類別。
具體而言,我們會使用 seccompiler 套件(在新視窗中開啟),根據所需篩選條件動態編譯 BPF 程式(在新視窗中開啟),並將其套用至沙盒中的啟動器程序,讓整個程序樹繼承這些限制。因此,bwrap 不會執行用戶的命令,而是執行 codex-linux-sandbox 啟動器,先傳入啟動器本身的設定引數,再接上用戶的命令:
Bash
1bwrap BWRAP_ARGS... -- \2 codex-linux-sandbox --apply-seccomp-then-exec CODEX_LINUX_SANDBOX_ARGS... -- \3 PROG ARGS...
要在沒有提升權限的情況下套用 seccomp 篩選條件,啟動器會設定 Linux 的 no_new_privs 旗標(在新視窗中開啟)。子程序會繼承這個旗標;執行其他程式(例如 setuid 可執行檔)時,這個旗標會阻止它們取得額外權限。
seccomp 篩選條件會因應網絡設定而定。停用網絡存取時,我們會封鎖多個與網絡相關的系統呼叫,例如 connect(2) 和 bind(2)。不過,當沙盒啟用網絡代理時,我們會允許 IP sockets,讓 codex-linux-sandbox 建立的 TCP 監聽器可供連線;但預設會封鎖建立獨立的 Unix domain sockets,因為這些 socket 可能令沙盒意外存取主機資源。
連接網絡代理
當沙盒設定需要使用網絡代理時,Codex 執行框架會建立一個代理實例,供同一 Codex 對話串內多次呼叫 codex-linux-sandbox 時重用。每個沙盒都需要一種方式,從隔離的網絡命名空間連接至這個共用代理。Codex 會在該命名空間內提供一個 loopback TCP 監聽器,並安排沙盒外的程序接收連線,再將連線轉送至代理。
以下示意圖展示單一代理端點的這種設定;最後一幅圖則展示一條經由該端點的連線。啟動 bubblewrap 前,codex-linux-sandbox 會建立一對 Unix socket,作為控制通道,然後建立自身的子程序。子程序會執行 run_host_bridge(),並等待透過該通道接收監聽器的檔案描述符:
在這個例子中,父程序會使用 exec,以 bwrap 取代自身的程式映像。這會設定沙盒,並在其中啟動 codex-linux-sandbox --apply-seccomp-then-exec,同時傳遞控制通道的 FD:
在沙盒的網絡命名空間內,第二次呼叫 codex-linux-sandbox 會建立一個迴環 TCP 監聽器,並透過通訊端傳遞其檔案描述符。監聽器仍與沙盒的網絡命名空間關聯,讓一直留在沙盒外的子程序可以接受來自沙盒程式的連線,同時在主機的網絡命名空間中建立上游連線。交接完成後,兩個程序都會關閉其控制通道描述符,而沙盒內的程序則會關閉其持有的監聽器副本。
TCP 監聽器準備就緒後,沙盒內的程序會為 HTTP_PROXY設定適當的值(在新視窗開啟),並設定相關環境變數,使其指向該監聽器。接着,它會先套用 seccomp,再建立子程序並執行用戶的命令:
沙盒外的程序會保持監聽器開啟。每當接受一個連線,它便會連接至已設定的代理伺服器,並雙向轉送數據。
這些額外機制讓命令擁有自己的網絡命名空間,包括獨立的迴環介面。在 macOS 上,Seatbelt 允許命令直接連接至主機迴環介面上的指定連接埠。在 Linux 上,命令則會連接至其隔離命名空間內的監聽器,再由沙盒外的程序將這些連線轉送至已設定的代理伺服器。透過描述符交接,即可建立這種連線,而無須向命令公開主機的網絡命名空間。
Windows
今年較早時,我們已實作並撰文介紹我們在 Windows 上的沙盒工作。此後,Microsoft 推出了名為 MXC 的程式庫,以及 Windows 作業系統內用於程序隔離的新功能。我們目前正以採用 MXC 程式庫的沙盒取代現有沙盒。
MXC 是甚麼?
MXC(Microsoft eXecution Container)是 Microsoft 推出的沙盒化程式碼執行系統(在新視窗開啟),支援 Windows、Linux 和 macOS 上的多種隔離後端。Codex 在相容的 Windows 裝置上支援以 MXC 為基礎的沙盒,利用原生程序隔離,在用戶現有的環境中限制命令。
我們正轉用 MXC,以提升安全性和易用性,同時解決現有 Windows 沙盒的多項限制:
設定沙盒需要提升權限/管理員權限
ACL 檢查及設定操作耗費資源/速度緩慢
主機上持續存在的沙盒設定狀態,包括
ACLs
防火牆規則
沙盒用戶
控制平面檔案
MXC 提供JSON 設定結構描述(在新視窗開啟)。Codex 使用MXC SDK(在新視窗開啟),按照該結構描述建構執行要求,當中包含命令、工作目錄、環境和權限。這些權限涵蓋檔案系統及網絡存取,也包括桌面和剪貼簿等 Windows 資源。
將政策轉換為 MXC 呼叫
Codex 會為多項控制項採用固定設定,以平衡相容性和安全性。它允許讀取登錄檔,並保留 PowerShell 在啟動期間所需的 Win32k 和桌面存取權限。剪貼簿存取、輸入注入,以及桌面和系統設定控制項均會停用。最後,MXC 不會退而修改主機的檔案系統權限。
Codex 會將權限設定檔中的檔案系統及網絡規則轉換為 MXC 設定。使用前述的 dev 設定檔,並假設:
C:\、D:\和Z:\是這部機器唯一的本機磁碟機。工作空間根目錄和工作目錄都是
C:\work\demo。用戶的主目錄是
D:\Users\dev,因此~/build-cache會解析為D:\Users\dev\build-cache。拒絕 glob 模式只會匹配
C:\work\demo\config\dev.env和C:\work\demo\config\prod.env。
相應的 MXC 設定會包括:
JSON
1{2 ...3 "filesystem": {4 "readwritePaths": [5 "C:\\work\\demo",6 "D:\\Users\\dev\\build-cache",7 ...8 ],9 "readonlyPaths": [10 "C:\\",11 "D:\\",12 "Z:\\",13 "C:\\work\\demo\\.agents",14 "C:\\work\\demo\\.aws",15 "C:\\work\\demo\\.codex",16 "C:\\work\\demo\\.devcontainer",17 "C:\\work\\demo\\.git",18 "C:\\work\\demo\\.vscode",19 ...20 ],21 "deniedPaths": [22 "C:\\work\\demo\\config\\dev.env",23 "C:\\work\\demo\\config\\prod.env",24 "C:\\work\\demo\\secrets"25 ]26 },27 "network": {28 "egress": {29 "default": "deny",30 "allow": [{31 "to": [32 {"cidr": "127.0.0.0/8"},33 {"cidr": "::1/128"}34 ]35 }]36 },37 "ingress": {38 "default": "deny",39 "hostLoopback": "allow"40 }41 },42 ...43}
磁碟機根目錄存取權
MXC 的檔案系統政策預設會拒絕存取。因此,Codex 會為本機磁碟機根目錄新增唯讀授權,以提供此設定檔允許的廣泛讀取權限。這些授權會遞迴套用,但仍受用戶現有的作業系統權限限制。
有一點需要注意:可寫入的磁碟機根目錄授權不會遞迴套用,因此 Codex 會將授權範圍擴展至磁碟機現有的直接子項目。
互相衝突的授權
較具體的路徑會覆寫祖先路徑的授權,因此 C:\work\demo 可在唯讀的 C:\ 之下設為可寫入,而 C:\work\demo\.git 則維持唯讀。
如果不同的路徑寫法,或符號連結/目錄聯接別名指向同一路徑,MXC 會套用較嚴格的權限:拒絕優先於唯讀,而唯讀優先於讀寫。
拒絕 glob 模式
MXC 只接受具體的拒絕路徑,因此 Codex 會在啟動前,將拒絕 glob 模式展開為符合條件的檔案和目錄。指令執行期間,新出現且符合 glob 模式的路徑不會自動加入。
網絡存取
*.openai.com 等網域規則由前文所述、共用的 Codex 網絡代理執行。Codex 會在沙盒外執行該代理,並透過前文提及的相同標準 *_PROXY 環境變數,將代理的位址傳給指令。MXC 會封鎖直接對外連線,但允許主機迴環連線,包括連線至代理。其他本機服務仍可存取。
在 macOS、Linux 和 Windows 上,執行框架都會使用相同的沙盒 API,按權限設定檔啟動指令。各平台的實作則會處理套用這些限制所需的設定。
以 Codex 沙盒為基礎
編寫及執行程式碼,讓 Agent 能靈活解決軟件開發以外的問題。Codex 沙盒讓 Agent 能在用戶現有的環境中運用這項能力,同時明確限制檔案系統和網絡存取。它是執行框架內可重用的基本元件,而 codex sandbox 指令則讓你自行建置的工具也能使用這項能力。
隨着 Agent 負責更多工作,我們希望讓更多工具和環境都能實際採用沙盒機制。這意味着要讓權限設定更容易,並在更完善的作業系統防護措施推出時加以利用。我們的目標是在擴展 Agent 能做的事之餘,讓用戶繼續掌控 Agent 可存取的內容。
作者
OpenAI
致謝
特別感謝 David Wiesen、Charlie Weems、Viyat Bhalodia 和 Fotis Chantzis 對本文作出的貢獻。
來源:OpenAI News · openai.com