clawk端口转发指南：如何快速双向打通宿主机与沙箱开发服务器

【免费下载链接】clawkGive coding agents a disposable Linux VM, not your laptop项目地址https://gitcode.com/gh_mirrors/cl/clawk点击查看免费下载 用clawk为编码 Agent 启动一次性 Linux VM 沙箱后开发服务器跑在 guest 里浏览器却开在宿主机上——中间隔着虚拟网络边界端口该怎么通这份 clawk 端口转发指南带你用forward add和forward add-reverse两条命令双向打通宿主机与沙箱让开发服务器秒开即用还能把宿主机本地服务反向暴露给 guest。clawk 启动沙箱后的工作场景沙箱里的 Agent 在干活网络访问受允许列表保护clawk 把整个虚拟机隔离得严严实实出站流量默认全部拒绝只有你显式放行的目的地才能访问。这种安全模型带来一个现实问题——guest 里起的开发服务器宿主机默认连不上反过来绑定在宿主机127.0.0.1的服务IDE WebSocket、本地 API mock、数据库guest 也摸不到。好消息是clawk 内置了双向端口转发一条命令一个方向无需配置 iptables、无需 sudo、不需要改 Docker 网络。本文按「原理 → 出站转发 → 反向转发 → 声明式配置 → 排查」的顺序讲透。 先搞清楚两种转发方向的区别clawk 的端口转发分两个方向命令前缀不同生效时机也不同命令方向用途生效时机forward add宿主机 → 沙箱把 guest 里的开发服务器暴露到宿主机 localhost下次clawk upforward add-reverse沙箱 → 宿主机把宿主机 localhost 的服务暴露给 guest立即生效一个容易混淆的点是 guest 里的127.0.0.1它是 guest 自己的回环地址不是你宿主机的回环。所以想让 guest 访问宿主机上绑定127.0.0.1的服务光加network allow是没用的——这正是反向转发存在的理由。 两个方向共用同一套端口规范宿主机端口在前HOST:GUEST只有「谁来拨号」这件事不同。 一键暴露forward add 把 guest 开发服务器搬到宿主机最典型的场景Agent 在沙箱里起了一个 Web 服务Next.js、FastAPI、Vite……你想在自己 Mac 的浏览器里打开它。基本用法clawk forward add my-project 3000这条命令把宿主机的localhost:3000绑定到 guest 的 3000 端口。之后宿主机上curl localhost:3000就能拿到 guest 开发服务器的响应了。端口映射HOST:GUEST 双端口写法端口规范支持两种格式解析逻辑见 forward.go 中的parsePortSpec规范含义3000宿主机 3000 → guest 30008080:80宿主机 8080 → guest 80两侧端口可以不同——比如 guest 里跑着一个标准 80 端口的 HTTP 服务宿主机端口 80 被占了就写8080:80。一条命令可以带多个端口规范clawk forward add my-project 3000 8080:80 5432:5432⚠️ 两个必须知道的坑1. guest 里的服务要绑定0.0.0.0别绑127.0.0.1。转发的流量是从 guest 网络接口进来的回环接口对宿主机不可见。如果你的开发服务器默认只监听 loopback记得显式加--host 0.0.0.0Next.js、Vite、FastAPI 都支持。2. 出站转发在下次启动时生效。forward add写入的是沙箱配置属于 VM 启动时固化的绑定。如果沙箱正在运行执行clawk down clawk up即可应用若忘记重启命令本身会提示(restart sandbox for new forwards to take effect)。验证与清理查看转发是否配好clawk status会把Forwards行直接打印出来clawk status my-project需要脚本化读取时forward list只提供 JSON 模式clawk forward list my-project --json用不上了就移除支持简写rmclawk forward remove my-project 3000 反向转发forward add-reverse 让 guest 摸到宿主机本地服务反向转发解决的是「反向」问题宿主机上绑定127.0.0.1的服务JetBrains/VS Code 插件的 IDE WebSocket、本地 API mock、loopback 数据库如何被 guest 访问clawk forward add-reverse my-project 63342之后 guest 里访问127.0.0.1:63342流量就会经 vsock 隧道回到宿主机的127.0.0.1:63342——同样的端口号同一个地址这正是那些「假设共享回环」的工具最舒服的工作方式。端口规范同样是宿主机在前clawk forward add-reverse my-project 5432:15432 # 含义guest 127.0.0.1:15432 → 宿主机 127.0.0.1:5432与出站转发的两点关键差异立即生效无需重启。反向转发由守护进程通过 vsock 隧道实时推送给运行中的 guest执行完命令马上可用沙箱没运行时会自动提示「下次 up 时生效」。最小暴露面。guest 只能访问你列出的端口——它报一个没配置的端口宿主机直接拒绝。所以这条路只开了你申请的那几个洞而不是整个宿主机回环。实战打通 Claude Code 的 IDE 插件这是反向转发最经典的使用场景。JetBrains 和 VS Code 的 Claude Code 插件会在宿主机回环上起一个 WebSocket 服务并把端口写进~/.claude/ide/port.lock锁文件。沙箱里的claude要连上它需要两样东西# 1. 把宿主机的锁文件目录共享进 guestclawk.mod 里声明 # shares ( # ~/.claude/ide /home/agent/.claude/ide ro # ) # 2. 反向转发锁文件里记录的端口 ls ~/.claude/ide # 看到 63342.lock clawk forward add-reverse my-project 63342然后在沙箱内执行/ide就像在宿主机上一样连上了。IDE 重启后端口会变——由于反向转发实时生效直接对新端口再跑一次add-reverse就行沙箱不用重启。移除反向转发clawk forward remove-reverse my-project 63342注意反向转发仅 macOS (vz) 可用firecrackerLinux 实验性 provider的 vsock 是单向的guest 监听、host 拨号guest 没有回连通道所以反向转发只在 vzmacOS上支持。在 Linux 上执行时 CLI 会明确告知而不是静默失败。 声明式配置在 clawk.mod 里写 forwards 块如果你不想每次启动后手敲转发命令可以在项目的 clawk.mod 里声明随沙箱创建自动应用forwards ( 3000 5432:5432 reverse 63342 # 宿主机 localhost:63342暴露给 guest )带reverse前缀的条目就是反向转发端口写法与 CLI 完全一致宿主机在前。这样新建沙箱时转发就已经就绪团队其他成员拉下项目也能得到相同的网络配置。完整的forwards块参考见 docs/configuration.md网络模型全貌见 docs/networking.md。 端口转发排查清单配置了却连不通按这个顺序检查#检查项怎么查1转发是否真的生效了clawk status name看Forwards/Reverse forwards行2出站转发是否漏了重启运行中的沙箱需要clawk down clawk up3guest 服务是否绑定了0.0.0.0沙箱内ss -tlnp或netstat -tlnp看监听地址4端口号写反了记住宿主机端口永远在前HOST:GUEST5guest 端口被重复反向转发一个 guest 端口只能绑一次CLI 会直接报错拒绝6沙箱被空闲停掉了见下方「别忘了」7反向转发在 Linux 上vz-onlyfirecracker 不支持别忘了空闲停机会让转发消失clawk 有个省电机制沙箱空闲 30 分钟会自动停机idle stop停机后所有出站端口转发随之消失直到下次启动。如果你的沙箱需要长期对外提供开发服务器在clawk.mod里关掉这个限制vm ( idle_timeout off ) 快速参考卡命令作用clawk forward add my-project 3000宿主机 3000 → guest 3000下次 up 生效clawk forward add my-project 8080:80宿主机 8080 → guest 80clawk forward add-reverse my-project 63342guest 127.0.0.1:63342 → 宿主机 127.0.0.1:63342立即生效clawk forward remove my-project 3000移除出站转发clawk forward remove-reverse my-project 63342移除反向转发clawk forward list my-project --jsonJSON 输出供脚本消费clawk status my-project人类可读的转发状态总览总结clawk 的端口转发把「安全隔离」和「开发便利」这两件看似矛盾的事解耦了出站方向forward add一条命令把 guest 开发服务器挂到宿主机 localhostHOST:GUEST写法灵活映射端口反向方向forward add-reverse让 guest 里的工具按原地址访问宿主机本地服务实时生效、只开最小端口面声明式clawk.mod的forwards块转发随项目走团队成员开箱即得。无需 Docker 网络、无需 iptables、无需 sudo——这正是 clawk 把网络过滤做在用户态、把转发做成 CLI 动词的回报双向打通快得不像话。更多网络细节允许列表、命名策略见 docs/networking.md完整命令参考见 docs/commands.md。赞分享【免费下载链接】clawkGive coding agents a disposable Linux VM, not your laptop项目地址https://gitcode.com/gh_mirrors/cl/clawk点击查看免费下载相关推荐OpenSandbox 单主机网络架构execd 反向代理如何用一个宿主机端口打通沙箱全部服务端口OpenSandbox 单主机网络架构execd 反向代理如何用一个宿主机端口打通沙箱全部服务端口 在单主机Docker部署形态下OpenSandbox人工智能AI 应用Agent 沙箱云原生后端代码智能体MNN Chat Android 端侧大模型推理从 APK 直装到 CMake 调参的实战指南MNN Chat Android 端侧大模型推理从 APK 直装到 CMake 调参的实战指南 MNN 是阿里开源的轻量级推理引擎MNN Chat 是它官方人工智能大模型推理引擎深度学习本地部署模型量化模型优化多模态计算机视觉嵌入式OpenSpace 沙箱降级执行指南e2b 失败后如何用 run_shell 直通宿主机运行 PythonOpenSpace 沙箱降级执行指南e2b 失败后如何用 run_shell 直通宿主机运行 Python 导读 execute_code_sandbox 是人工智能AI 技能MCP 服务AI 评测创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考