
Hotline Computer 发布:为 AI 代理提供基于 Nix 的无 root Linux 桌面容器
来源标题:Show HN: Hotline Computer – Rootless Linux desktop container with Nix for agents
Hotline Computer 发布了一个基于 Nix 的无 root Linux 桌面容器,AI 代理可通过 MCP 直接连接本地容器,无需账号或托管中继。该容器支持 Docker、Podman 或 Apple container 1.5+,需 4 GiB 内存,镜像覆盖 arm64 和 amd64 架构。部署时以丢弃全部 Linux 能力、禁止提权、仅绑定回环地址等方式加固,并需设置访问令牌。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
Agent 通过 MCP 直接连接本地容器。无需账号,也不需要托管的 relay。
一台兼容的 computer 在 /mcp 上通过可流式 HTTP 暴露同样的八个工具,另外还有一个无需认证的 /health 端点。
你需要 Docker、Podman 或 Apple container 1.5+,以及容器所需的 4 GiB 内存。镜像提供 arm64 和 amd64 版本。
$ export TOKEN=$(openssl rand -hex 24)
$ docker run -d --name computer \
--cap-drop=ALL --security-opt no-new-privileges \
--pids-limit 1024 --memory 4g --shm-size 1g \
-p 127.0.0.1:8787:8787 -e HOTLINE_COMPUTER_TOKEN="$TOKEN" \
-v computer-home:/home/agent \
ghcr.io/1broseidon/hotline-computer:0.11.0
| 参数 | 作用 |
|---|---|
--cap-drop=ALL |
computer 不需要任何 Linux capability |
--security-opt no-new-privileges |
容器内的任何东西都无法获得它启动时不具备的权限 |
--pids-limit 1024 --memory 4g |
把容器限制在 1,024 个进程和 4 GiB 内存 |
--shm-size 1g |
Chromium 需要一个有容量设定的 /dev/shm |
-p 127.0.0.1:8787:8787 |
仅绑定回环地址。绝不要发布到所有网络接口 |
-e HOTLINE_COMPUTER_TOKEN |
没有 token 时,所有路由都是开放的 |
-v computer-home:/home/agent |
home 在升级或重建后依然保留 |
要共享一个项目,加上 -v "$PWD:/home/agent/workspace"。挂载项目即可,绝不要挂载整个 home,也绝不要挂载容器运行时的 socket。
用同一个 token 让 agent 指向 MCP 端点。
$ claude mcp add --transport http computer \
http://127.0.0.1:8787/mcp \
--header "Authorization: Bearer $TOKEN"
Codex、ChatGPT desktop 以及其他 HTTP MCP 客户端在各自的配置里使用相同的 URL 和 Authorization 头。
agent 的前两次调用是 state info(给出正在运行的版本)和 state guide(返回该版本内置的指南)。指南来自正在运行的二进制文件,因此始终与镜像匹配。
$ open "http://127.0.0.1:8787/#$TOKEN"
工具
capture——截取屏幕的缩放 PNG,外加 AT-SPI 无障碍树:窗口、元素、角色、坐标、值和状态。传入 window 可读取单个应用,传入 region 可按原始尺寸查看屏幕的一部分。mode=png 则写入原始图像。
input——通过 XTEST 执行点击、移动、拖拽、滚动、输入、按键和粘贴。batch 可在一次锁内运行最多十个步骤。
browser——导航,以带元素 ref 的文本形式快照页面,并基于这些 ref 执行操作:click、fill、select、check、hover、upload、标签页、对话框和下载。fill 可输入文本,或按名称输入你存储的某个 secret。任何操作都不会运行超过一分钟。
jobs——以可读的标签启动任务,每个保留 4 MiB 输出,并允许 agent 读取、等待、写入或取消它们。最多同时运行 16 个,保留最新的 64 个。run 从 workspace manifest 启动一个命名条目。
files——获取、放入和列出 home 下的路径。下载 URL 和 GitHub release 资产,可选 SHA-256 校验,安全解压归档,并以受管任务方式运行脚本。
windows——列出、聚焦、关闭、最大化和平铺窗口,并验证结果。
wait——轮询无障碍树和浏览器页面文本,以查找某个短语。
state——正在运行的版本、按名称存储的 secret、版本指南、workspace manifest 与 Nix 准备、桌面租约、浏览器登录状态以及 home 的快照。
computer 提供自己的屏幕。/ 是一个带单个 canvas 的页面,/ws 是它背后的 socket。页面从 URL fragment 读取 token。fragment 在初始页面请求中被省略;随后查看器在其 WebSocket 和文件请求中发送该 token。
查看器以只读模式打开。在你按下 Take control 之前,鼠标和键盘输入处于禁用状态。当你拥有控制权时,agent 那些会改变屏幕的工具会被拒绝。当你按下 Give it back、关闭查看器,或十秒内没有输入时,控制权会回到 agent 手中。
顶栏显示谁在工作以及正在运行什么:agent at work、2 running · 5 done,或琥珀色的 you're driving。右侧的 jobs 观察器按标签显示每个任务,附带其输出,并在结束时显示 ✓ 或 ✗。Activity 窗口列出最近 500 次工具调用,包括失败。
查看器中的 Files 会打开 home:从中下载任何内容,或将文件拖放到页面上进行上传。
镜像包含桌面、浏览器和 Nix,不包含语言工具链。项目在 .hotline/manifest.json 中一次性描述其所需,然后由 agent 准备:
"packages": ["nodejs", "pnpm"],
"runs": {
"test": { "command": ["pnpm", "test"] },
"web": { "command": ["pnpm", "dev"], "kind": "web" }
包是 Nixpkgs 名称,或仓库自身的 flake。在 workspace 内启动的任务会获得准备好的环境。web 运行会获得一个空闲的 $PORT,并在开始监听后回复其 URL;desktop 运行会在窗口出现后回复,并附上一张截图。
准备好的环境、其缓存、任务历史和浏览器配置都存放在 home 中,因此当 home 是一个卷时,它们能在升级后保留。
容器就是边界。在容器内部,agent 可以执行容器用户能执行的任何操作。
每次会话都以 state info 和 state guide 开始,并遵循返回的指南:它对应的是实际正在运行的版本。网页优先使用浏览器文本和 ref,原生应用则用窗口进行捕获。用平实的语言为每个任务起一个标签,因为那是旁观者读到的东西。当某个步骤需要人参与时,例如登录或 2FA 点击,要说明并等待;他们可以从查看器接管控制。绝不要让人粘贴 secret。如果某项任务需要 state info 未列出的 secret,请让他们存储它。
Hotline Computer 是每位队友在 Hotline 中获得的桌面,现单独发布。Hotline 为每位队友启动一个容器,并把 token 交给它;本页面上的所有内容在没有 Hotline 的情况下也能正常工作。
各指南对每个主题有更详细的说明。
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。