问我AI

自带 VPS(自建 VPS)

WenwoBot 可以把你自己已有的一台 Linux 服务器变成机器人的电脑。智能体进程仍留在你的电脑上;Docker 自带的 SSH 传输连到 VPS 上的守护进程,每个机器人在那里拥有一个受管理、经过加固的 Cua 容器——一个它能看到并操作的 Linux 桌面。整个过程只涉及 SSH 这一种凭据,也只暴露 SSH 这一个入口:WenwoBot 从不在 VPS 上开放公网端口,从不保存你的 SSH 密钥或密钥口令,也从不在远端运行智能体。

能做什么

  • 每个机器人在你的 VPS 上的受管容器里拥有一个 Linux 桌面,通过官方 Cua 工具来操作。
  • 在「电脑」面板和对话记录里实时预览屏幕,与云端桌面一样。
  • 明确选择 云端 并使用 自建 VPS 后端时,会创建或启动容器。自动 模式默认只复用已就绪的容器;另有一个默认关闭的 自动启动 VPS 开关,打开后该机器人可在需要时准备或唤醒自己的受管容器。定时运行和手动触发的例行任务总会启动它,并且在连不上 VPS 时绝不会退回使用这台电脑自己的桌面。
  • 可以在本机或已配对的桌面客户端上 接管控制:「电脑」面板里的画面会变成实时桌面。主机只把 noVNC 绑定到 127.0.0.1 上的一个随机端口,你交还控制后不久就关闭隧道,并且从不在 VPS 上公开 VNC。已配对的客户端只有在主机上为该设备开启了 云端桌面访问 之后,才会通过受管 HTTPS 或 Tailscale 拿到一个短时有效、限定该设备的中继。

前提条件

  • 本机: 一个 docker 命令行客户端,版本 18.09 或更新(docker -H ssh:// 从这个版本开始提供)。本机不需要运行 Docker 守护进程——只用到命令行客户端;用下面对应你平台的一行命令安装即可。
  • VPS 上: x86_64 Linux 上正在运行的 Docker 守护进程(dockerd)。
  • SSH 用户 必须在 VPS 上属于 docker 组,这样不用 sudo 也能运行 docker info。

请清醒地认识最后这一点:docker 组成员在那台机器上等同于 root。任何能与守护进程通信的人都能把主机文件系统挂载进容器。使用这个功能,就意味着完全信任这台 VPS——以及其他所有能访问它的 Docker 守护进程的人。请给机器人一台专用服务器,不要用一台还存放着你不愿交给智能体的东西的服务器。

安装 Docker 客户端

你自己的电脑上只需要客户端;守护进程留在 VPS 上。每个平台一行命令:

brew install docker                     # macOS
winget install -e --id Docker.DockerCLI # Windows 10 或 11
sudo apt install docker-ce-cli          # Debian 或 Ubuntu,使用 Docker 官方 apt 软件源

Windows 还需要它自带的 OpenSSH 客户端(ssh.exe,Windows 10 1809 起已内置),因为 Docker 的 SSH 传输要调用它。这里不能用 Podman 代替 Docker 命令行:这个后端只会运行 docker -H ssh://<alias>。

必需的 SSH config 别名

WenwoBot 只通过你 ~/.ssh/config 里的一个具名别名来连接——你只需在 设置 → API 密钥 里填入这个别名,别的都不用填。机器人的每个操作都会变成一次经 SSH 的 docker exec,所以应用会自行提供连接复用和快速失败的超时:它通过自己的 ssh_config(位于 ~/.wenwobot/ssh/ 下)运行每条 VPS 命令,这份配置先包含你自己的配置文件,再在你的别名没有设置的地方补上 ControlMaster、ControlPersist、保活和连接超时。你的别名里设置的任何项都优先。启动、预览、机器人工具及其连接探测都使用同一套设置。实时桌面的隧道是例外:它会单独建立自己的连接(ControlPath=none),因此关闭它永远不会断开 docker 命令共享的那条连接。数据目录路径较长时,应用会把控制套接字放在 /tmp 下一个私有、归当前用户所有的目录里,以免超出 OpenSSH 对套接字路径长度的限制;配置文件仍留在应用数据目录中。Windows 版 OpenSSH 不支持连接复用,所以在该平台上保持普通的 SSH 设置。下面这段仍是推荐的写法,也是你在应用之外自己使用 ssh 时生效的配置:

Host my-vps
  HostName 203.0.113.7
  User deploy
  IdentityFile ~/.ssh/id_ed25519
  ControlMaster auto
  ControlPath ~/.ssh/cm-%r@%h-%p
  ControlPersist 60m
  ServerAliveInterval 15
  ServerAliveCountMax 3
  ConnectTimeout 10
  • ControlMaster/ControlPath/ControlPersist——机器人的每个操作都是一次 docker-over-SSH 执行;连接复用让每条命令的连接在一条持久连接上只需几毫秒。实时桌面隧道不共享这条连接。
  • ServerAliveInterval/ServerAliveCountMax/ConnectTimeout——VPS 掉线时必须快速失败(一分钟以内,连接限时十秒),而不是让一轮对话一直挂在一个已失效的 TCP 会话上等待。

每个机器人一台服务器

应用级别的别名(设置 → API 密钥)是所有机器人的默认服务器。也可以让某个机器人使用它自己的别名:只要选择了 自建 VPS 后端,机器人设置 → 访问 里就会出现 服务器(SSH 别名),留空表示「使用默认」。此后,凡是与这个机器人相关的事都以它自己的服务器为准——创建、状态检查、预览、截图、被查看的桌面会话、它的电脑工具,以及删除时的清理。设置里的清单涵盖所有正在使用的服务器,并为每台电脑标注它所在的别名。

机器人的电脑还在旧服务器上时,不能把这个机器人移到另一台服务器;只要默认别名管理的任何电脑还存在,默认别名就不能更改:请先在 设置 → 本地虚拟机(Local VM)→ 自建 VPS 上的电脑 中删除那台电脑(或手动执行:docker -H ssh://old-server rm -f wenwobot-vps-<bot>-<hash>)。连不上的服务器绝不会把机器人困住:把机器人移到另一台服务器、切换它的电脑或删除它,都会照常进行,应用会说明那台服务器上可能还留着什么,以及服务器恢复后用来删除它的命令。(更改默认别名仍要等到能列出它那台服务器上的内容。)只需要你 ~/.ssh/config 里的任意一个别名,且其主机密钥已手动验证过,就够了。这个字段在已保存的机器人的设置里;新建的机器人从默认服务器开始。

先手动确认主机密钥。 在让 WenwoBot 使用这个别名之前,先手动连接一次:

ssh my-vps true

这样主机密钥就会按你自己的判断写入 known_hosts。应用从不自动接受主机密钥——主机未知的别名在你手动连过一次之前只会直接失败。

安全

  • 不开放公网端口。 受管容器创建时不发布任何端口,WenwoBot 也拒绝使用任何发布了端口的容器——这项检查在每次连接前都会运行,而不只是在创建时。实时画面通过 SSH 访问容器的私有网桥地址,并且在你的电脑上只监听本机回环地址。
  • 给 VPS 配置防火墙,只放行 SSH,最好只允许你的 IP。WenwoBot 做的任何事都不需要开放其他入站端口,所以多开的任何端口都纯粹是攻击面。
  • 不保存任何敏感信息。 WenwoBot 唯一持久保存的就是别名名称本身(~/.wenwobot/config.json,机器人有自己的别名时还包括 bots.json 里的该别名);密钥、密钥口令和智能体状态都留在 SSH 那里。已配对的手机和共享工作区成员收到的设置和机器人记录里也不包含别名——他们只能看到是否已配置,永远看不到名称。不过,机器人在对话中报告的 SSH 或 Docker 错误仍可能带出服务器的名称。
  • 容器本身以加固方式运行:去掉了各项 capabilities,使用私有的网络/IPC/cgroup 命名空间,不挂载主机目录或设备,也不会自动删除。复用容器时,归属、镜像固定版本和隔离检查依然生效;不通过检查的容器会被拒绝,而不是被修复。

容器生命周期

每个机器人在 VPS 上拥有一个容器,名为 wenwobot-vps-<bot>-<hash>——重启后保持不变,也与机器人的显示名称无关。它位于这个机器人的服务器上:默认别名,或者机器人有自己的别名时就用它自己的。

新容器默认配置为 4 GiB 内存且不额外分配 swap、2 个 CPU、512 个 PID、512 MiB 共享内存,以及 unless-stopped 重启策略。这些是创建时的默认值,不是兼容性要求。已有的受管容器可以保留自定义的资源和 OOM 设置、不限额度,或其他重启策略,包括旧版的 no 策略。WenwoBot 不会为了强制使用默认值而重置这些设置或重建容器。重启行为遵循所选的 Docker 策略;例如,always 会在 Docker 守护进程重启后唤醒一个已休眠的容器。

  • 创建(为机器人选择 云端,或点面板上的按钮):需要时在 VPS 上构建固定版本的 Cua 镜像,容器不存在就创建,已停止就启动,并一直等到桌面有响应。
  • 启动 只唤醒一个已存在且已停止的容器;它从不创建新容器。
  • 休眠 停止容器。VPS 不再为它消耗 CPU;文件系统保持原样。
  • 删除 由你负责,在机器人不再需要这台服务器时手动执行:docker -H ssh://my-vps rm -f <container>。WenwoBot 从不自行删除容器。

哪些操作会保留什么:休眠/启动会保留容器的文件系统;删除——包括 Cua 镜像升级后随之进行的重建,因为固定在旧镜像上的容器会被拒绝而不是被复用——会清空它。请把容器文件系统视为 可丢弃的:机器人必须保留的任何东西,都应在容器被删除前离开 VPS(推送、上传,或粘贴回聊天里)。

设为 自动 的机器人默认对生命周期只读。只有当容器已经在运行并通过验证时,它才会连接。如果没有本地备选,这轮对话仍会运行,所以不需要屏幕的工作(队友的书面总结、Chief 的后续跟进)绝不会因为一台它用不到的 VPS 而被阻止;机器人会被告知 VPS 为什么不可用以及该怎么处理,于是它会如实说明,而不会声称自己在做屏幕操作。定时运行则会失败,并说明原因。按机器人开启 自动启动 VPS,就能让自动模式准备或唤醒该机器人的受管容器;这个开关特意默认关闭。

每轮对话开始时都会检查容器,因为引擎一启动电脑工具,它们就会连进正在运行的容器。同时开始的几轮对话共用一次检查,而不是各自排队检查。

同时进行多轮对话

每个机器人只有一个容器,但瓶颈不是容器,而是容器里的桌面。机器人任意数量的线程(聊天、任务、例行任务)都可以同时挂载 VPS 运行。桌面归第一个调用电脑工具的线程所有(截图、点击、通过 Cua 驱动执行命令),并一直归那一轮对话使用,直到它结束;从不使用电脑工具的线程永远不会被阻塞。当一个线程想用屏幕而另一个线程正占用时,会显示

正在排队使用这台电脑——队列中第 位置 位——机器人 正在运行 线程。前面的轮次结束后会自动开始。

它的电脑调用会等待桌面,最多 45 秒,桌面一空出来就立即响应;等待超时的调用会告诉模型桌面仍被占用,让它再发起一次调用继续等待,而不要结束这一轮。等待超过五秒的调用即使等到了也不会执行——这么晚才开始的操作可能超过引擎对单次工具调用的时限,并在模型重试时执行两次——因此模型会再调用一次,而那次调用会立即执行:到那时桌面已经归它这一轮了。桌面到手时,提示条会变成「电脑已空闲——继续」;如果这一轮先结束了,则显示「已停止等待电脑」。长时间等待会让这一轮停在上限处(默认 30 分钟),并仍然注明占用者;电脑空闲后它会自行恢复。有人接管控制时发出的调用也会这样等待;他们交还控制后,这次调用不会执行(屏幕可能已经变了),模型会重新截一张图。占用时间已超过同一上限的情况不再等待:机器人会停下来,说明它在等控制权交还。容器的生命周期操作(创建、启动、停止)对每个容器仍然一次只执行一个。

故障排查

正常的屏幕刷新不应让新的对话轮次因为「VPS 正在准备中」而中止。轮次准备会等待尚未完成的预览,重叠的准备请求会共用同一个操作。停止和删除仍然是独占的;它们不会与尚未完成的截图抢跑,也不会悄悄重建它的容器。如果一条 Docker-over-SSH 命令超时,应用会先清理该命令的 Docker/SSH 进程,再释放它。重试需要明确发起:可能产生修改的命令绝不会自动重放。

按照应用自己的路径逐级排查,先看最省事的信号:

  1. 别名能手动使用: ssh my-vps true 无输出地返回。出现密码提示说明密钥/代理没有配置好;出现主机密钥提示说明还没有进行第一次手动连接。
  2. 经 SSH 的 Docker 能连到守护进程: docker -H ssh://my-vps info 会打印服务器详情。出现权限错误说明 SSH 用户不在 docker 组里。
  3. 创建: 在机器人的「电脑」面板中选择 云端 并使用 自建 VPS 后端。第一次创建会在 VPS 上拉取并构建 Cua 镜像,可能需要几分钟;之后就很快。
  4. 查看状态。 面板会按检查顺序如实显示服务器检查到的情况:别名未配置 → 守护进程无法访问 → 镜像缺失 → 容器缺失/已停止 → 容器不受管理或不安全(端口、挂载、加固)→ 桌面尚未就绪。每条消息都会指出需要修复的那一步。
这篇有帮助吗?
没有找到答案?告诉我们