herdr-gpui 云设备指南:一键创建 Coder、Daytona 与 Railway 云端开发工作区

原创2026-10-14 10:49:191,421 阅读

herdr-gpui 云设备指南:一键创建 Coder、Daytona 与 Railway 云端开发工作区

herdr-gpui 是 Herdr 的 Rust + GPUI 原生客户端,支持 macOS、Linux 和 Windows。它的 Cloud Devices(云设备) 功能可以把 Coder、Daytona、Railway 三家云服务商的机器"变成设备":在 Add Device 对话框里点击几下,就能完成登录、创建云端开发工作区、自动安装 Herdr 并建立连接,全程无需手写 SSH 配置。

herdr-gpui 侧边栏中的设备与云端工作区列表

云设备是什么?

普通设备靠 SSH 连接;云设备则由服务商"现场造机器"。herdr-gpui 用统一流程驱动每家服务商:

  1. 认证(OAuth2、API Key 或 SSH 密钥)
  2. 创建/挂载机器(Workspace、Sandbox 或 VM)
  3. 等待就绪(对话框实时显示 Creating… / Building… / Checking for Herdr… / Installing Herdr…)
  4. 保存为设备,之后随时一键重连

任务在后台执行:对话框立即关闭,你可以在设备选择器的 Adding 分组里看到每台机器的进度,就绪后会弹出 toast 提示;关闭窗口会取消未完成的任务。

herdr-gpui 设备布局与 Agents 分组视图

一键创建 Coder 工作区:完整流程

🚀 Coder 是首个集成的云服务商,适合已有自托管 Coder 部署的团队:

  1. 打开 Settings > Cloud Devices,在 Coder 卡片中填写部署 URL 与 OAuth 应用信息(对应 config-gpui.example.toml 中的 [coder] 配置;client secret 会存入系统凭证库而不是配置文件)
  2. 在 Add Device… 中选择 Coder,通过 OAuth2(PKCE)在浏览器中登录
  3. 表单会列出账号可用的 模板(templates)、预设(presets)和已有工作区,并预填一个随机工作区名
  4. 点击创建——默认开启的 Install Herdr if it is missing 开关会在缺少 Herdr 的新工作区中运行官方安装脚本(校验发布 checksum 后装入 ~/.local/bin),这是 GUI 唯一执行的远程安装
  5. 连接走 coder ssh 隧道(需要 coder CLI),自动启动已停止的工作区,再运行 Herdr 远程桥接

相关实现见 coder/setup.rs 与 coder/oauth.rs。登录凭证按平台存入 Keychain / Secret Service,令牌到期自动续期。

herdr-gpui 设置窗口中的主题与配置页面

Daytona 沙箱:实验性云端隔离环境

Daytona 适合需要一次性沙箱的场景(标记为 experimental):

  • 在 Settings > Cloud Devices > Daytona 填写 API URL(Daytona 云默认为 https://app.daytona.io/api)、可选的组织/区域/快照,API Key 存入凭证库
  • 点击 Create sandbox:用生成的名字创建沙箱,若开启 Install Herdr(默认开)则自动补装
  • 每次连接会先启动已停止的沙箱,向 API 申请 10 分钟有效期的 SSH 令牌,经由 Daytona 的 SSH 网关接入;令牌写入私有临时 ssh 配置文件,绝不暴露在命令行
  • 网关不发布主机密钥,因此首次见到的密钥会被固化到 daytona_known_hosts,一旦发现变化立即拒绝

注意:移除设备只是从列表中删除,Daytona 上的沙箱本身不会被删。源码见 daytona/setup.rs 与 daytona/gateway.rs。

Railway 免费 VM:零账号、零门槛

⚡ Railway 的玩法最轻:ssh railway.new 提供的临时 Linux VM 不需要任何账号或 token——你的 SSH 密钥就是身份,同一把密钥永远连到同一台 VM。

  1. 在 Settings > Cloud Devices > Railway 中选择一把现有私钥,或按名字生成一把无口令的 ed25519 密钥(存入 ~/.ssh,绝不覆盖已有文件)
  2. 点击 Connect and set up:若该密钥还没有 VM 就现场创建,按开关决定是否安装 Herdr,然后以"密钥路径"(而非密钥本身)作为设备的账号保存
  3. 之后每次重连都复用同一把密钥:绝不重复建 VM、绝不重复安装,并严格校验密钥指纹与公私钥配对

需要 ssh 与 ssh-keygen 在 PATH 中。提醒:Railway 的 VM 是临时的,有生命周期和网络配额限制。细节见 railway/setup.rs 与 railway/keys.rs。

herdr-gpui 在多台设备之间迁移会话的 Teleport 界面

三种方案怎么选?

维度 Coder Daytona Railway
状态 首个正式集成的提供商 实验性 实验性
认证方式 OAuth2(PKCE 浏览器登录) API Key SSH 密钥即身份
机器类型 持久化 Workspace 可暂停的 Sandbox 临时 VM
依赖 coder CLI ssh ssh、ssh-keygen
典型场景 团队标准化开发环境 隔离试验、临时构建 快速尝鲜、轻量任务

设备是如何保存的?

所有云设备统一存放在 GUI 状态目录的 cloud-devices.json 中(最多 64 台),而不是 Herdr 的 endpoints.json——因为后者的上游 schema 仅支持 SSH。每条记录保存服务商标识、机器 ID、展示名和账号信息;写入采用临时文件 + 原子替换,读改写由进程内互斥锁串行化,保证多窗口下不会交错。

其他实用细节:

  • 三家的接入命令准备逻辑集中在 cloud/command.rs,认证凭据只在子进程环境中传递
  • 云设备仅支持 Unix 客户端(macOS / Linux),Windows 上会明确提示不可用
  • coder、daytona、railway 均为默认开启的 Cargo feature,源码级说明见 crates/herdr-gpui/README.md

💡 小结:有了 Cloud Devices,herdr-gpui 不再只管理你手边的机器——从 Coder 的持久化工作区到 Railway 的"即开即用"临时 VM,一套统一的设备体验就能覆盖云端开发工作区的创建、安装与重连。

登录后查看全文
sheprd