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)
每个工作树按检入仓库的 recipe(orca.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 |
落地练习:画一张运行拓扑
- 画出你现在的开发环境,标注每台机器适合哪种模式
- 在笔记本上确认 Orca 跑本地工作树无异常
- 如果你有 SSH 主机:在 Settings → SSH 加一个目标并 Test
- 阅读 Settings → Experimental → Cloud VM,了解 recipe 入口
- 用一句话写下你的「默认模式 + 两个备选」
怎么判断做对了?——你能说出四种模式的「运行所有者」区别,并为自己当前场景选出主模式。
卡住了怎么办? 不确定模式:本地模式永远最稳;远程模式逐个来,先 SSH 后 Server,别一上来就四线并行。
小结
- 四种模式:本地 / SSH / Remote Orca Server / Cloud VM
- 关键区分是「谁拥有运行时」与「谁提供 UI」
- Orca 不提供托管 VPS,机器与云账号都是你的
- SSH 适合已有盒子,Server 适合常驻共享,Cloud VM 适合一次性沙箱
- 选型一句话:够快就本地,有盒子就 SSH,要常驻就 Server,要新鲜沙箱就 VM
下一节,SSH 工作树实操。