01
真正的桌面，就在浏览器里。
实时观看 Chromium 和原生应用的操作。调整分辨率、切换全屏，或用自己的鼠标和键盘接管。
已有 VPS，就从这里开始
让任何 VPS
让任何 VPS
成为你的
个人智能体。
个人智能体，不必再多一份订阅。 用你已有的 VPS，连接正在使用的 Codex、Claude Code 或其他智能体。桌面、浏览器、终端和文件都在自己的服务器上，控制权始终在你手中。
VPS 和你选择的智能体或模型服务，仍按各自规则计费。
连接你常用的智能体
以及其他 MCP 客户端
-
Codex
-
Claude Code
-
Cursor
-
Gemini CLI
-
GitHub Copilot
-
Windsurf
-
Cline
-
OpenCode
-
Kiro
-
Kimi Code
-
Qwen Code
-
TRAE
通过 MCP 接入。点击智能体，查看官方配置指南。
01 / 你们共用的电脑
它在远端工作。
它在远端工作。
你在眼前看见。
给智能体一套工具，也给你一个看得见的工作过程。
02
所有工作，都在同一个地方。
下载、代码和成果文件共享一个文件系统。结束会话后，文件和浏览器配置仍保留在 VPS 上。
03
你喜欢的智能体，由你选择。
连接 Codex、Claude Code 或其他 MCP 客户端。继续使用熟悉的智能体，为它的工具配上一台电脑。
一个工作空间，所有工具。
少一点文件搬运。
少一点文件搬运。
多一点事情完成。
从浏览器下载，到 Python 处理，再到生成仪表盘。每一步，都在你的 VPS 上完成。
你的智能体Codex / Claude Code / …
MCP / CLI
你的 VPS
浏览器Shell文件代码
02 / 准备你的电脑
下一个工作空间。
下一个工作空间。
现在就能开始。
准备一台 Ubuntu VPS 和 SSH 登录方式。选择自己安装，或把配置工作交给智能体。
Ubuntu 22.04 / 24.04
x64 或 ARM64 · 内存 2 GB 以上 · 可用磁盘 5 GB
需要 sudo 权限
使用文档
x64 或 ARM64 · 内存 2 GB 以上 · 可用磁盘 5 GB
需要 sudo 权限
01
在 VPS 上安装。
通过 SSH 登录你要交给智能体使用的 VPS，运行：
VPS 终端
curl -fsSL https://agentvps.ai-infra.org/install.sh -o install-agentvps.sh && sudo bash install-agentvps.sh安装 0.0.1 版本，包含 CLI、后台服务、Chromium 和 Linux 桌面。自动在已启用的 UFW 中放行桌面端口，并在当前终端显示 桌面地址和访问令牌。下载的安装包会通过预设 SHA-256 校验。 查看安装脚本 ↗
02
打开你的远程电脑。
打开安装完成后显示的桌面地址，将终端中的访问令牌粘贴到登录界面，即可使用。
如果页面无法打开，请在云服务商的防火墙或安全组中放行 TCP 8080。安装脚本会处理 VPS 上的 UFW；云端防火墙需在服务商控制台单独设置。
请妥善保管令牌。公网 IP 访问使用 HTTP；处理私人内容时，请使用 HTTPS 或 SSH 转发。需要分享网页预览时，可额外开放 8081 端口。
03
连接你的智能体。
在运行智能体的电脑上，使用 Node.js 22 或更新版本安装客户端：
运行智能体的电脑
npm install -g https://github.com/agentsdance/agentvps/releases/download/v0.0.1/agentsdance-agentvps-0.0.1.tgz
通过 SSH 复制令牌，然后连接。请将
YOUR_VPS_IP 换成你的 VPS IP；如果 SSH
用户名不同，也请替换 ubuntu：
运行智能体的电脑
mkdir -p ~/.config/agentvps
umask 077
ssh ubuntu@YOUR_VPS_IP 'sudo cat /var/lib/agentvps/token' > ~/.config/agentvps/vps.token
agentvps connect --url http://YOUR_VPS_IP:8080 --token-file ~/.config/agentvps/vps.token
agentvps status
codex mcp add agentvps -- agentvps mcp
最后一行用于注册 Codex。连接 Claude Code 或其他 MCP
客户端时，使用命令 agentvps，参数为
["mcp"]。 查看连接配置 ↓
一句提示词，一台真正的电脑。
把这段话交给智能体。
告诉智能体你的 VPS 地址和 SSH 用户名。使用现有 SSH 密钥；不要在聊天中发送私钥或访问令牌。
复制给 CODEX、CLAUDE CODE 或其他智能体
请在我的 VPS 上安装 AgentVPS：<SSH_USER>@<VPS_HOST>。
请按照 https://agentvps.ai-infra.org/zh/agent-guide.md 操作。
使用我现有的 SSH 访问方式，妥善保护凭据。
通过 MCP 执行一个无害操作，并在实时桌面上展示，
验证桌面和 MCP 均可用。完成后告诉我桌面地址、
连接方式和验证结果。
先确认目标机器。
安装前确认操作系统、CPU 架构、权限，以及连接的是你指定的 VPS。
用实际操作验证。
调用 MCP、操作原生应用，并在同一台电脑上检查生成的文件。
交付可用的工作空间。
提供桌面地址和连接说明，回复中不包含任何凭据。
03 / 连接你的智能体
熟悉的连接方式。
熟悉的连接方式。
全新的工作电脑。
本地 MCP 桥接程序会将操作转发到你的 VPS。也可以通过
http://YOUR_VPS_IP:8080/mcp 直接连接 Streamable
HTTP MCP，使用 Bearer 令牌认证。
STDIO MCP 配置
{
"mcpServers": {
"agentvps": {
"command": "agentvps",
"args": ["mcp"],
"env": {
"AGENTVPS_URL": "http://YOUR_VPS_IP:8080",
"AGENTVPS_TOKEN_FILE": "/absolute/path/to/token"
}
}
}
}
04 / 日常维护
电脑属于你。
完整 CLI 命令参考 ↗
电脑属于你。
维护也很简单。
确认一切就绪。
VPS
sudo agentvps status
sudo agentvps call health_check '{"browser":true}'检查工作空间标识与各项功能。服务正在运行，并不代表浏览器和桌面已正常工作。
升级，保留文件。
下载新版本安装包，然后运行：
VPS
sudo agentvps upgrade ./agentsdance-agentvps-VERSION.tgz文件、浏览器配置和服务配置会保留。重启时，运行中的命令和应用窗口会关闭。早期未使用 @agentsdance scope 的安装，请先重新运行安装脚本完成迁移。
按你的需要卸载。
VPS
agentvps uninstall --dry-run
sudo agentvps uninstall
默认保留数据。只有确定要永久删除工作空间和凭据时，才添加
--purge。
了解更多
你可能想知道。
还需要购买个人智能体服务的订阅吗？
不需要。使用 AgentVPS，无需订阅 OpenAI Dots、 Meta Muse、 Grok Bot 或 Manus Cue。 复用已有 VPS，连接你正在使用的智能体即可。AgentVPS 免费开源； VPS 和所选智能体、模型服务的费用及额度，仍遵循各自的规则。
现在已经是能自主工作的个人智能体了吗？
0.0.1 版本提供远程电脑和工具层，需要连接 Codex、Claude Code 或其他智能体来操作。内置对话和模型驱动的智能体循环仍在规划中。
能看到智能体的所有操作吗？
浏览器和原生桌面操作会实时显示在桌面上。后台 Shell 任务显示在 Commands 中，API 终端会话显示在 Remote desk 中。如果希望看到命令逐步输入，请让智能体使用原生终端。
我接管之后会怎样？
你可以用鼠标和键盘控制桌面。交还控制前，智能体无法发起新的浏览器和桌面修改操作。后台任务与已经开始的操作会继续运行。
重启后，哪些内容会保留？
工作空间文件、笔记、定时任务、已完成任务记录和 Chromium 配置会保留。运行中的命令、终端会话、应用窗口和预览链接不会保留。仅断开桌面查看器时，远程应用仍会继续运行。
它与 VPS 上的其他内容隔离吗？
AgentVPS 以一个非特权 Linux 用户运行，面向单一所有者使用，不提供多租户沙箱隔离。命令拥有该系统用户的权限。工具调用和桌面访问都需要身份认证。
启动失败，该从哪里排查？
运行 sudo systemctl status agentvps 和
sudo journalctl -u agentvps -n 50，检查云防火墙是否开放 8080 端口，再运行上面的健康检查。
提交问题
时请附上版本和错误详情，不要包含令牌。