边缘 OAuth 2.1 + 代次隔离
拆分为 AuthCoordinator 与 BridgeRelay 双 SQLite Durable Objects,强制 PKCE S256、零脚本 CSP 同意书与密码轮换代次作废。
能做到什么程度(已实现能力)
AuthCoordinator)与长连接中继(BridgeRelay)双 SQLite DO,通过 WSS /bridge 反向连回本机,无需路由器开端口。Approve.cmd 与先消费防重放:除 computer_context、command_status、stop_command 外,全部读写与执行工具须在本机人工确认完整参数 SHA-256 摘要,并先删 .approved.json 再记入 24 小时持久账本。--read-only、--cap-drop ALL(仅留 SETUID/SETGID)、UID/GID 1000、--network none 的一次性 Linux 容器内,并检查 Windows NTFS DACL 与 expected_sha256 CAS。明确不能做什么(非目标与硬限制)
owner 与单个显式 /workspace 挂载,不支持多租户共享;生产凭据 loadSecrets(DPAPI)与 Windows ACL 守护明确依赖 Windows x64(Linux/macOS 仅能跑云端与回归测试)。/mcp 的参数与结果正文,且已批准的工程目录内文件可被工具读取(须自行防范目录内文本提示词注入)。POST /mcp(仅 JSON-RPC 2.0,无 SSE 流)限制入站 1 MiB / 回包 2 MiB / 110s 超时;若 docker rm -f 清理未获确认,连接器立即闭锁拒接新任务。实现口径提示:拓扑图中的外层节点概括了边缘网关到隔离沙箱的四段分工;当前源码实际采用的协议与接口为
POST /mcp(JSON-RPC 2.0,而非 SSE 流)、OAuth 2.1 + PKCE (S256)、连接器主动发起的WSS /bridge长连接以及本地经Approve.cmd确认后的docker start --attach容器执行。
在 Node.js 24+ 与 pnpm@12.6.0 环境验证源码语法与跨平台测试(Linux/macOS 会自动跳过 15 项依赖 Windows DPAPI/ACL 或开启 Docker 的用例):
pnpm install --frozen-lockfile
pnpm run check
pnpm test实际生产配置须依次完成 Cloudflare Worker 部署(wrangler deploy)与 Windows x64 受保护运行副本安装(Setup.ps1 + Install-Hardened.ps1)。在远端 MCP 客户端填入你的网关端点:
https://<your-bridge-domain>/mcp按照读者需求快速跳转
.agentdock-bridge 安装与密码轮换;healthz、Approve.cmd、ACL 报错与 cleanup_confirmed 快速定位根因;