📦 Proxima VPS 自动化

v1.0.0

在远程 Ubuntu VPS 上为非 root Electron runtime 的 Proxima 部署进行搭建、修复或文档化,使用虚拟桌面 GUI、仅回环 VNC/noVNC/REST…

1· 23·0 当前·0 累计
alkindivv 头像by @alkindivv (MooNear)
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(常见故障与确切修复)。
数据来源ClawHub ↗ · 中文优化:龙虾技能库