第 02 模块 · 1 节

四种运行方式:本地、SSH、远程服务器与云 VM

《Orca 生产级工程》02 远程与多机运行 · 本节时长 26 分钟

Orca 不绑死你的笔记本每个工作树都在「某个地方」运行:面前的机器、你已有的盒子、一台常开的共享服务器、或为这一个工作区临时拉起的云 VM。本课是四张运行方式的全景地图。

四种模式一览

模式 文件与 Agent 在哪 机器归谁 最适合
本地 你的桌面 日常编码、快速迭代
SSH target 你 SSH 连接的远程主机 你(或团队) 开发箱、GPU 主机、常开 VPS
Remote Orca Server 跑着 Orca 桌面或 orca serve 的机器 你(或团队) 常驻共享运行时、移动端、自动化
Cloud VM / per-workspace env 每个工作区一个一次性 VM/沙箱 你的云账号(BYO) 隔离、临时的 Agent 计算

重要边界:Orca 不卖托管 VPS。远程模式永远使用你掌控的机器与云账号。


1. 本地桌面

装 Orca、加项目、建工作树。Agent、终端、浏览器与 UI 同机运行。大多数人的默认路径(基础课整门都在讲它)。

2. SSH target

把 Orca 指向任意 SSH 主机——更强的 Mac mini、Linux VPS、GPU 盒子、带 SSH 的云沙箱。创建工作树时在 Run on 里选该主机:Agent 与 git worktree 跑在远程,编辑器、diff、UI 留在笔记本。

  • 适用:远程已经有你的仓库、工具与凭据,一个笔记本 Orca 驱动多台机器
  • 搭建:Settings → SSH 加目标 → 测试连接(主机需有 git)→ 建工作树时 Run on 选 SSH

3. Remote Orca Server

在你掌控的机器上常驻 Orca(旧笔记本、Mac mini、家庭服务器、云 VPS、团队机器),笔记本 / 浏览器客户端 / 手机配对到那个运行时。server 持有项目、工作树、终端与 Agent 进程;client 只是 UI。

  • 适用:笔记本休眠后 Agent 继续跑、移动端复用同一批会话、自动化/后端在稳定主机上起会话
  • 最简搭建:两台电脑装 Orca + Tailscale;server 端 Advertise 生成访问链接,client 端 Add Server 粘贴(下节详解)

4. Cloud VM(per-workspace environments)

每个工作树按检入仓库的 recipeorca.yaml + 生命周期脚本)拉起自己的按需环境——云沙箱、VM 或本地 Docker。Create 拉起,suspend/resume/destroy 回收。Orca 只是薄包装:你的 provider 账号、镜像与账单仍归你

  • 现有人接法:Vercel Sandbox、Fly、Modal、普通 SSH 主机、本地 Docker
  • 连接方式:Orca server(recipe 启动 orca serve 返回配对 URL)或 SSH(recipe 返回连接信息)
  • 开启:Settings → Experimental → Cloud VM,启用技能后让 Agent 为仓库写 recipe

怎么选

你的情况
笔记本够快、Agent 短命 本地
已有 VPS / 开发箱,不想装第二套运行时 SSH
要一个常开运行时供移动端 / 浏览器 / 自动化 Remote Orca Server
每个任务要全新、recipe 定义的沙箱 Cloud VM

落地练习:画一张运行拓扑

  1. 画出你现在的开发环境,标注每台机器适合哪种模式
  2. 在笔记本上确认 Orca 跑本地工作树无异常
  3. 如果你有 SSH 主机:在 Settings → SSH 加一个目标并 Test
  4. 阅读 Settings → Experimental → Cloud VM,了解 recipe 入口
  5. 用一句话写下你的「默认模式 + 两个备选」

怎么判断做对了?——你能说出四种模式的「运行所有者」区别,并为自己当前场景选出主模式。

卡住了怎么办? 不确定模式:本地模式永远最稳;远程模式逐个来,先 SSH 后 Server,别一上来就四线并行。


小结

  1. 四种模式:本地 / SSH / Remote Orca Server / Cloud VM
  2. 关键区分是「谁拥有运行时」与「谁提供 UI」
  3. Orca 不提供托管 VPS,机器与云账号都是你的
  4. SSH 适合已有盒子,Server 适合常驻共享,Cloud VM 适合一次性沙箱
  5. 选型一句话:够快就本地,有盒子就 SSH,要常驻就 Server,要新鲜沙箱就 VM

下一节,SSH 工作树实操。