至少输入两个字母,即可搜索文档的所有页面。

↑ ↓ 导航 ↵ 打开 esc 关闭

使用 rdev

连接您的笔记本电脑

您的笔记本电脑是编辑器和浏览器。代码、服务和智能体都留在您的服务器上。

您自己的 tailnet

您的笔记本电脑和服务器通过一个私有的 Tailscale 网络通信,该网络属于您的 Tailscale 账户。rdev 永远不会加入其中。安装程序使用您账户中的密钥连接服务器,笔记本电脑应用则连接您的笔记本电脑。

文件同步

rdev 让您的项目文件在笔记本电脑和服务器之间双向保持同步。无需传输的文件夹,例如 node_modules、vendor 和构建产物,从一开始就被忽略。

您可以在面板的仪表盘 > 您的服务器 > 设置下选择同步的内容:

  • 同步到笔记本电脑: 关闭后可完全远程工作。不会向笔记本电脑复制任何内容;您的编辑器通过 SSH 打开项目(ssh rdev、VS Code 或 Cursor Remote-SSH、PhpStorm Gateway)。站点和 .dev.test 继续可用。
  • 笔记本电脑上的项目: 取消勾选某个项目可使其只保留在服务器上。笔记本电脑上已有的副本不会被动,因此不再需要时请自行删除。之后该项目再次同步时,较旧的笔记本电脑副本会先移到 ~/Code-rdev-old/,然后下载服务器上的副本。
  • 从未同步: 默认排除项(每一项都可以关闭),以及您自己的规则(使用类似 .gitignore 的语法)。

笔记本电脑会在几分钟内应用新规则。运行 rdev laptop sync 可立即应用。

编辑器和浏览器

在同步的文件上使用您熟悉的编辑器,例如 VS Code 或 PhpStorm。在您常用的浏览器中通过 https://<name>.dev.test 打开站点;笔记本电脑应用会为这些地址设置域名解析和受信任的证书。

文件共享

服务器上的终端无法粘贴文件,因此 rdev 为您的智能体提供了一个共享文件夹。笔记本电脑上 ~/rdev-share 中的任何内容都会在几秒内复制到服务器的 ~/Share/<laptop name>,即使文件同步已关闭;每台笔记本电脑在那里都有自己的文件夹,因此多台笔记本电脑可以同时共享。让您的智能体“查看最后一张截图”或“打开我刚发送的文件”,它就会打开最新的一个。任何类型的文件都可以:图片、PDF、日志、导出文件。

  • 应用中的发送剪贴板(菜单栏或托盘图标中也有)会发送您在访达、资源管理器或文件管理器中复制的文件,否则发送剪贴板上的图片。它会等待文件到达服务器,并将它们在服务器上的路径放入剪贴板;将其粘贴到智能体中即可。在终端中:rdev laptop share send 或 rdev laptop share send <files>。
  • 将文件拖放到应用窗口上,也会以同样的方式发送。
  • **反方向:**智能体放在服务器 ~/Share/<laptop name>/out 中的文件会到达笔记本电脑上的 ~/rdev-share/from-server。让它“把报告放到 out 里”即可。
  • 将 macOS 截图保存到此处会让 Shift-Command-3、4 和 5 保存到 ~/rdev-share(rdev laptop share macos)。Shottr 或 CleanShot 等截图应用也可以保存到那里。
  • 文件在两端都会于 7 天后删除;可在应用的文件保留天数中或用 rdev laptop share keep <days> 更改(0 表示保留)。keep 文件夹中的文件永远不会被删除。
  • 超过 500 MB 的文件不会发送;请用 scp 或 rsync 移动。所有内容都直接发送到您的服务器,绝不经过 rdev.cloud。可使用应用中的开关或 rdev laptop share off 关闭共享。

在 1.2.0 之前,这是截图文件夹:~/rdev-shots 会自动移到 ~/rdev-share,~/Shots 移到 ~/Share,且 ~/Shots 仍可作为链接使用。

支持的笔记本电脑

笔记本电脑应用和 rdev laptop 可在 macOS(Apple 芯片和 Intel)、Linux(x64 和 ARM64)以及 Windows 10 和 11(x64 和 ARM64)上运行;请在下载页面获取应用。在 Linux 上,您也可以用一条命令安装,它在 Debian 和 Ubuntu 上使用 .deb,在 Fedora 上使用 .rpm,在其他系统(例如 Arch 和 CachyOS)上使用 AppImage:curl -fsSL https://rdev.cloud/install | sh -s -- app。AppImage 会放在 ~/.local/bin 中并出现在应用程序菜单里;如果您移动该文件,应用会让这个菜单项继续指向它(1.4.4 或更高版本)。如果您自己下载 .deb,请从 /tmp 安装(sudo apt install /tmp/rdev-linux-arm64.deb,或 -x64);从您的主目录安装 apt 也能工作,但会提示其沙盒用户无法读取该文件。在 Linux 上,rdev 通过大多数发行版使用的 systemd-resolved 将 *.dev.test 指向您的服务器。如果它被关闭或屏蔽(某些虚拟机镜像中就是如此),rdev laptop connect 会指出这一点并说明如何开启:sudo systemctl unmask systemd-resolved && sudo systemctl enable --now systemd-resolved,然后 sudo ln -sf /run/systemd/resolve/stub-resolv.conf /etc/resolv.conf,再重新连接。当 NetworkManager 在正在运行的 systemd-resolved 旁边保留自己的 /etc/resolv.conf 时(Tailscale 随后会报告二者“wired together incorrectly”),查询永远不会到达 rdev 的路由;rdev laptop connect 和 rdev laptop status 会指出这一点(1.4.4 或更高版本),同一条 ln -sf 命令即可修复。rdev 会在 Debian、Ubuntu、Fedora、openSUSE、Arch 和 CachyOS 上把它的证书添加到系统信任的证书中;在 1.4.4 之前,Arch 和 CachyOS 上的连接会停在这一步。

分步连接

  1. 在笔记本电脑上安装 Tailscale,并使用与服务器相同的 Tailscale 账户登录。在 Linux 上可以跳过这一步:如果缺少 Tailscale,rdev laptop connect 会从 Tailscale 官方仓库安装它并启动登录,您在浏览器中完成登录即可。
  2. 在笔记本电脑上安装 rdev 并连接。请以您自己的身份在终端中运行以下命令,并在提示时输入笔记本电脑的密码;安装 rdev、信任证书和设置域名解析都需要它:
curl -fsSL https://rdev.cloud/install | sh -s -- laptop

它会安装 rdev 命令并运行 rdev laptop connect,后者会在您的 tailnet 上找到服务器,在您的 SSH 配置中添加一个 rdev 条目,信任您环境的证书,将 *.dev.test 指向服务器,并开始将您的 ~/Code 文件夹与服务器上的 ~/Code 同步。

您无需事先安装任何其他东西。如果缺少文件同步工具,rdev 会在 ~/.local/share/rdev/bin 中安装一份固定版本且经过校验和验证的副本;您已有的工具会照原样使用。在 Linux 上,它还会在同一次密码提示下,通过您的包管理器安装用于截图的剪贴板工具(wl-clipboard、xclip)以及将证书放入 Chrome 的 certutil。如果您在安装时为服务器指定了其他名称,请添加 --server <name>;要同步其他文件夹,请添加 --code-dir <folder>。随时可以再次运行 rdev laptop connect 来重做设置。

在询问密码之前,rdev laptop connect 会检查要同步的文件夹。如果另一个同步会话已经在同步该文件夹或其上级文件夹,它会停止并建议使用 --code-dir <文件夹>(再用 rdev 同步会让所有内容在三台机器间复制);仍要同步时,用 --force 运行,或在应用中选择 仍然同步。超过 5 GB 的文件夹也能连接,只会提示首次同步需要一些时间(rdev 1.1.10 及以后;之前会停止)。

如果 Mac 已经将 dev.test 指向其他位置,例如另一台开发服务器,rdev 会把该设置保留下来,并在您断开连接或卸载时恢复。

在 Windows 上,上面的 curl 命令不适用:请从下载页面安装应用,并通过应用连接。从笔记本电脑应用 1.4.2 起,应用还会把 rdev 命令安装到 %USERPROFILE%\.local\share\rdev\bin,并将该文件夹添加到您的 PATH;打开新的终端即可使用。它无需管理员权限,并会随应用一起更新。

如果在文件同步的同时,应用一直显示 Check connection,并且 rdev laptop status 提示 *.dev.test resolves to …, not the server,请查看 Tailscale 管理控制台的 DNS 页面。为 dev.test 设置的、指向另一台机器(例如旧服务器)的 split DNS 条目,在 Windows 上优先于 rdev 的设置。请删除它,或将其指向您的服务器。

随时可以使用 rdev laptop status 检查连接。rdev laptop disconnect 会停止同步并移除设置;两端的文件都会保留。

从笔记本电脑上移除 rdev

rdev laptop uninstall

它会断开连接,不再信任您环境的证书,并移除 rdev 命令、其设置以及它安装的工具。您同步的文件夹和 ~/rdev-share 会保留。如果其他同步会话仍在使用,rdev 安装的同步工具也会保留。它只会询问一次笔记本电脑密码,并需要 rdev 0.2.0-beta.21 或更高版本。

您的笔记本电脑必须能够登录服务器:安装程序会复制您安装时能够登录服务器的 SSH 密钥。要添加另一台笔记本电脑,请在面板中服务器的页面上的 SSH 密钥下添加其公钥(每行一个,因此可以一次添加多台电脑;添加时可以为其命名,例如“工作笔记本”,否则会显示密钥末尾的名称);服务器会在几秒内放行它。这需要 rdev 0.2.0-beta.33 或更高版本;在此之前,请将密钥放入服务器上的 /opt/rdev/home/.ssh/authorized_keys。如果 rdev laptop connect 提示无法登录,缺少的就是这个。

连接后,使用 ssh rdev 在服务器上打开终端并在那里启动智能体;在浏览器中通过 https://<folder>.dev.test 打开站点。 rdev open <项目> 会在持久会话中直接于服务器上的项目文件夹打开终端;不带名称时列出所有项目(rdev 1.1.11 及以后)。

Mac 应用

更喜欢点击而不是输入?请下载 Mac 版 rdev 应用(Apple 芯片和 Intel,已由 Apple 签名和公证),将其拖到“应用程序”并打开。它会显示笔记本电脑是否已连接,用一个按钮即可连接和断开,并可打开服务器上的终端。它执行与 rdev laptop connect 相同的设置,因此您需要 Tailscale(第 1 步),但不需要该命令;应用会自行安装同步工具。连接之前,您可以更改项目同步到的文件夹(默认为 ~/Code),这是应用中对应 --code-dir 的选项。

首次打开时,应用会一步步引导完成设置,只有每一步都成功后才会显示各个标签页:用 rdev 账户登录,检查 Tailscale 已安装并登录,从账户中选择服务器,允许这台笔记本访问(应用会自动把它的 SSH 密钥添加到服务器,没有密钥时先生成一个),用 浏览… 选择项目同步到的文件夹,然后连接。 之后,Sites 标签页中的 更换服务器 可为另一台服务器重新设置这台笔记本。当笔记本的服务器不存在(无法连接或已不在你的账户中)时,应用会提示并提供 重新设置。两种情况下文件都会保留在原处。当 rdev 命令比应用旧时,About 中会显示 在终端中运行,用更新命令打开你的终端。

应用有七个标签页:

  • 站点: 您的项目以 https://<name>.dev.test 链接的形式显示,以及服务器上的终端和您共享的文件。 每个站点都有 Open in Terminal,会在服务器上该项目的文件夹中打开终端。 Sites 标签页还有 Mail 和 Dumps 按钮,可打开捕获的邮件和转储页面。还有一个 Web terminal 按钮,可打开网页终端。 还有一个 Errors 按钮,用于打开错误跟踪。
  • 同步: 与面板相同的设置(同步开关、此笔记本电脑上的项目、排除项)。保存后会立即在此笔记本电脑上应用。
  • 环境变量: 读取并更改服务器上项目的 .env。应用通过 SSH 连接工作,因此会显示当前值,且这些值绝不经过 rdev.cloud。
  • Gotify: 如果您的通知发送到 Gotify 服务器,应用会监听它,并将每条消息显示为带声音的桌面通知。输入服务器的地址和客户端令牌(Gotify 的 Clients);添加应用令牌(Gotify 的 Apps)可发送测试消息。这些令牌保留在此笔记本电脑上。
  • 集成: 您服务器的 Git 访问:其密钥,您想添加多少个 GitHub、GitLab、Bitbucket 及其他账户都可以(每个账户有自己的 SSH 密钥或令牌),等待信任的主机以及访问测试。令牌通过 SSH 发送到服务器,绝不经过 rdev.cloud。
  • 设置: 服务器终端所打开的终端应用(任何已安装的终端,例如 Terminal、iTerm2 或 Warp;会一直保留直到您更改)、菜单栏图标(单色,跟随浅色或深色菜单栏,或彩色应用图标)、截图同步,以及您的账户:选择使用 rdev.cloud 登录,在浏览器中确认密码,检查其显示的代码是否相同,然后批准。已登录的应用会列在面板的设置 > 已连接的应用下,并可在那里断开。
  • 关于: 应用和 rdev 命令的版本,以及 rdev.cloud 上的最新应用。

内置终端

Terminal on the server 打开 rdev 的内置终端:一个独立窗口,可以调整大小、最大化或全屏,下次以上次的大小打开。它通过 ssh rdev 登录并加入服务器的持久会话,因此关闭窗口或断网都不会停止代理;连接断开时会自动重连,回到你离开的地方。

  • 复制和粘贴: macOS 上用 Cmd-C 和 Cmd-V,Linux 和 Windows 上用 Ctrl-Shift-C 和 Ctrl-Shift-V。在服务器上复制的文本(例如在 vim 中)会进入笔记本的剪贴板。开启截图后,粘贴图片会把它发送到服务器并粘贴其路径,代理可以直接使用。
  • Shift-Enter 在 Claude Code 的提示中换行。
  • 用 Cmd-F 搜索(Linux 和 Windows 上为 Ctrl-Shift-F);用 Cmd 加 +、− 或 0 调整文字大小(Linux 和 Windows 上为 Ctrl)。
  • 链接在浏览器中打开,包括 https://<名称>.dev.test 站点。窗口在后台时如果终端响铃(例如代理需要你时),你会收到桌面通知。
  • Open in an external terminal 在终端应用中打开同一个会话:Terminal on the server 旁边的按钮、菜单栏图标的菜单,或在内置终端中按 Cmd-Shift-O(Ctrl-Shift-O)。要把某个终端应用设为默认,请在 Settings 中选择它。 使用哪个应用由 Settings 中的 External terminal 决定;起初是你之前选择的终端应用,在 Mac 上没有则为“终端”。

应用会在启动时、每六小时一次以及您打开关于时检查是否有新版本。有新版本时,标签页上方的栏会提示:选择更新,应用就会下载、检查其签名、安装并重启(在 Linux 上,.deb 和 .rpm 会询问您的密码;在 Windows 上,安装程序会自行运行)。在应用中更新需要 0.2.0-beta.34 或更高版本;更旧的版本请手动覆盖安装一次。 笔记本上的 rdev 命令需要单独更新:再次运行安装命令 curl -fsSL https://rdev.cloud/install | sh -s -- laptop。在 Windows 上,该命令随应用一起提供,并随应用一起更新。当命令比应用旧时,About 会显示这条命令并附带复制按钮。

关闭窗口会让 rdev 保留在菜单栏中,并将其从 Dock 和 Cmd-Tab 中移除;通过菜单栏图标菜单中的退出或 Cmd-Q 退出。

在 Settings 中(笔记本电脑应用 1.4.3 或更高版本),Open at login 会在您登录时让 rdev 在后台启动,直接进入菜单栏或系统托盘;Keep running when the window is closed(默认开启)决定关闭窗口后 rdev 是继续留在那里还是退出。开启时,窗口关闭后文件同步和通知仍会继续工作。GNOME 只有在安装 AppIndicator 扩展时才会显示托盘图标(Ubuntu 自带);没有它的话,关闭窗口后就没有可点击的图标,请从应用菜单重新打开 rdev。应用会在 Settings 中对此给出警告(笔记本电脑应用 1.4.4 或更高版本)。登录时打开无需管理员权限:rdev 只为您的用户添加登录项(macOS 上是 launch agent,Linux 上是 autostart 条目,Windows 上是您用户注册表中的 Run 条目)。

应用运行期间,还会每五分钟应用一次面板的同步规则。

Firefox 有自己的证书列表。在 Linux 上,rdev 会将其证书添加到 Chrome 以及它找到的每个 Firefox 配置文件,包括 Ubuntu 自带的 snap 版 Firefox 和 Flatpak 版(rdev 0.2.0-beta.34 或更高版本);之后请重启 Firefox。对于之后创建的 Firefox 配置文件,或在 macOS 和 Windows 上,请在设置 > 隐私与安全 > 证书下导入 ~/.config/rdev/ca.pem。