herdr-gpui 云设备指南:一键创建 Coder、Daytona 与 Railway 云端开发工作区
herdr-gpui 云设备指南:一键创建 Coder、Daytona 与 Railway 云端开发工作区
herdr-gpui 是 Herdr 的 Rust + GPUI 原生客户端,支持 macOS、Linux 和 Windows。它的 Cloud Devices(云设备) 功能可以把 Coder、Daytona、Railway 三家云服务商的机器"变成设备":在 Add Device 对话框里点击几下,就能完成登录、创建云端开发工作区、自动安装 Herdr 并建立连接,全程无需手写 SSH 配置。
云设备是什么?
普通设备靠 SSH 连接;云设备则由服务商"现场造机器"。herdr-gpui 用统一流程驱动每家服务商:
- 认证(OAuth2、API Key 或 SSH 密钥)
- 创建/挂载机器(Workspace、Sandbox 或 VM)
- 等待就绪(对话框实时显示 Creating… / Building… / Checking for Herdr… / Installing Herdr…)
- 保存为设备,之后随时一键重连
任务在后台执行:对话框立即关闭,你可以在设备选择器的 Adding 分组里看到每台机器的进度,就绪后会弹出 toast 提示;关闭窗口会取消未完成的任务。
一键创建 Coder 工作区:完整流程
🚀 Coder 是首个集成的云服务商,适合已有自托管 Coder 部署的团队:
- 打开 Settings > Cloud Devices,在 Coder 卡片中填写部署 URL 与 OAuth 应用信息(对应 config-gpui.example.toml 中的
[coder]配置;client secret 会存入系统凭证库而不是配置文件) - 在 Add Device… 中选择 Coder,通过 OAuth2(PKCE)在浏览器中登录
- 表单会列出账号可用的 模板(templates)、预设(presets)和已有工作区,并预填一个随机工作区名
- 点击创建——默认开启的 Install Herdr if it is missing 开关会在缺少 Herdr 的新工作区中运行官方安装脚本(校验发布 checksum 后装入
~/.local/bin),这是 GUI 唯一执行的远程安装 - 连接走
coder ssh隧道(需要coderCLI),自动启动已停止的工作区,再运行 Herdr 远程桥接
相关实现见 coder/setup.rs 与 coder/oauth.rs。登录凭证按平台存入 Keychain / Secret Service,令牌到期自动续期。
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。
- 在 Settings > Cloud Devices > Railway 中选择一把现有私钥,或按名字生成一把无口令的 ed25519 密钥(存入
~/.ssh,绝不覆盖已有文件) - 点击 Connect and set up:若该密钥还没有 VM 就现场创建,按开关决定是否安装 Herdr,然后以"密钥路径"(而非密钥本身)作为设备的账号保存
- 之后每次重连都复用同一把密钥:绝不重复建 VM、绝不重复安装,并严格校验密钥指纹与公私钥配对
需要 ssh 与 ssh-keygen 在 PATH 中。提醒:Railway 的 VM 是临时的,有生命周期和网络配额限制。细节见 railway/setup.rs 与 railway/keys.rs。
三种方案怎么选?
| 维度 | 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,一套统一的设备体验就能覆盖云端开发工作区的创建、安装与重连。



