📦 Proxima VPS 自动化
v1.0.0在远程 Ubuntu VPS 上为非 root Electron runtime 的 Proxima 部署进行搭建、修复或文档化,使用虚拟桌面 GUI、仅回环 VNC/noVNC/REST…
1· 23·0 当前·0 累计
运行时依赖
无特殊依赖
安装命令
点击复制官方npx clawhub@latest install proxima-vps
镜像加速npx clawhub@latest install proxima-vps --registry https://cn.longxiaskill.com
技能文档
Proxima VPS Setup 用此技能端到端新建或修复 Proxima-on-VPS 部署。
核心规则
- 以专用非 root Linux 用户(通常 proxima)运行 Proxima。
- GUI、VNC、noVNC、REST 及内部 IPC 默认绑定回环,除非用户明确要求其他暴露方式。
- 优先使用 SSH 隧道与 SSH stdio 传输,而非公开 TCP 监听。
- 若未建立 SSH 隧道,不得在用户笔记本上将 curl http://localhost:3210/... 视为有效。
- 默认不得直接向公网开放 VNC、noVNC、REST 或 MCP。
- 每改一层即验证:服务状态、监听端口、本地 curl、远程隧道行为。
- 明确警告:Proxima 存在显著运维风险,不建议部署于主力个人机。
工作流
- 确认主机前提及 Proxima 是否已安装。
- 在向用户做安全声明前,先读 references/security-and-architecture.md。
- 读 references/server-setup-runbook.md,执行或修复服务器端配置。
- 配置 SSH 隧道或本地 IDE MCP 客户端时,读 references/local-access-and-mcp.md。
- 若 REST、GUI、VNC 或 MCP 异常,读 references/troubleshooting.md。
- 用真实检查而非假设验证最终状态。
输出要求 报告状态时保持简洁,包含:
- proxima-app.service 是否活跃
- 127.0.0.1:3210、127.0.0.1:5902、127.0.0.1:6081、127.0.0.1:19222 是否按预期监听
- VPS 本地 curl http://127.0.0.1:3210/v1/models 是否通
- 用户侧 ssh -T proxima-mcp 是否通
- 若仍阻塞,指出具体障碍
参考资料
- 先读 references/security-and-architecture.md(风险框架、绑定模型、路由注意)。
- 读 references/server-setup-runbook.md(包安装、systemd 服务、配置、封装与验证)。
- 读 references/local-access-and-mcp.md(SSH 配置、隧道、IDE MCP 配置片段)。
- 读 references/troubleshooting.md(常见故障与确切修复)。