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

↑ ↓ 导航 ↵ 打开 esc 关闭

使用 rdev

团队

管理谁在您的 Team 套餐服务器上工作:邀请开发者,为他们分配角色和专属环境。

邀请成员

在仪表盘中打开您的团队。输入开发者的电子邮件地址,选择角色并发送邀请。他们会收到一封带有链接的电子邮件,链接有效期为 7 天;他们使用同一个地址登录或创建账户即可接受邀请。

每位成员和每个待处理的邀请都占用一个席位。席位用完后,请先在仪表盘上通过更改套餐来增加席位。撤销待处理的邀请会立即释放其席位。

角色

角色 可以
所有者 一切:为许可证付费,且不能被移除
管理员 邀请、重新发送和撤销邀请,更改角色,移除成员
成员 使用团队的服务器;可以离开团队

每位成员一个环境

每位成员在您的团队页面保存自己的 SSH 公钥,每行一个:为其使用的每台电脑各一个密钥(例如 ~/.ssh/id_ed25519.pub 的内容)。页面会显示其环境的名称,例如 rdev-alice;没有密钥的成员会被标出。 服务器的 SSH keys 标签页会在服务器自身密钥上方的单独卡片中列出这些团队密钥。

在团队服务器上,以 root 身份运行一次以下命令,并使用来自您 Tailscale 账户的可重复使用的认证密钥:

sudo rdev host member sync --tailscale-key tskey-auth-…

它会为每位已保存密钥的成员创建环境,此后每 15 分钟重复一次:新成员获得其环境,密钥变更会被更新,已离开团队的人的环境会被移除。他们的数据保留在服务器上;可使用 sudo rdev host member remove <name> --delete-data 删除。

每位成员都有一个独立的容器,包含自己的代码、数据库、服务和 shell;成员之间看不到彼此的工作。它以 <server name>-<name> 加入您的 tailnet,成员通过 ssh dev@<server name>-<name> 或 rdev 笔记本电脑应用连接。所有者继续使用服务器的主环境。

  • sudo rdev host status 列出成员以及其环境是否在运行。
  • sudo rdev host update 同时更新服务器上的每个环境。
  • sudo rdev host member add <name> --ssh-key "…" 手动添加环境,但如果此人不在团队中,下一次同步会将其移除。

每个环境都有自己的同步和环境变量设置。成员可在您的团队页面的您的环境下找到自己的设置:文件同步开关、哪些项目同步到其笔记本电脑、排除项,以及其项目的环境变量。只有成员本人可以更改自己的环境;所有者和管理员更改主环境。rdev 笔记本电脑应用中同样如此。

新成员环境中的 PHP。 开启新成员从主环境的 PHP 开始(默认开启,位于您的团队页面)时,新成员的环境在创建时会获得主环境的 PHP 版本、其默认版本以及每个版本的目录扩展,因此团队的项目可立即运行。现有环境不会改变,每位成员之后可以自行更改自己的 PHP。这需要团队服务器上有 rdev 0.2.0-beta.36 或更高版本;关闭时,新环境使用默认 PHP 开始。

多台团队服务器。 大团队可以把环境分布到多台服务器:在每台服务器上用 Team 许可证安装 rdev,并在每台上运行 rdev host member sync。团队有多台服务器时,Your team 页面的 Members 表会出现 服务器 列,所有者和管理员可在此为每位成员分配服务器;未分配的成员在团队的第一台服务器上工作。每台服务器会在下一次同步(15 分钟内)时为分配给它的成员创建环境,并移除其他人的容器;文件会留在旧服务器上,直到你在那里运行 sudo rdev host member remove <名称> --delete-data 删除,因此移动成员前请先 commit 和 push。每台团队服务器都需要 rdev 1.1.10 或更高版本。

将项目复制给成员

所有者和管理员可以把项目交给成员,而无需先经过 git。在服务器页面打开 项目,在项目菜单中选择 复制给团队成员,选择成员以及要一同复制的内容:

  • 同时复制数据库(默认开启):与项目同名的 MySQL、MariaDB 或 PostgreSQL 数据库。
  • 同时复制 .env(默认关闭):其中的密码和 API 密钥会一并发出,且无法收回。保持关闭,让成员使用自己的值。

团队服务器会在下一次同步时(15 分钟内)把项目复制到成员的环境中;项目下方的 复制给团队成员 列表会显示每次复制何时完成,或失败的原因。之后成员在自己的副本上工作,修改通过 git 回流。构建产物(target、.next、.nuxt、.svelte-kit、.turbo、.dart_tool、.gradle、__pycache__)不会被复制,因此副本中的第一次构建会从头开始;vendor 和 node_modules 会被复制。如果成员已有同名项目,在其删除或重命名该项目之前,复制会失败。

复制只在同一台服务器上的环境之间进行,并且该服务器必须运行 rdev host member sync(见上文);在此之前,复制对话框和 您的团队 页面会提示复制正在等待。团队服务器需要 rdev 1.4.6 或更高版本。

共享数据库

所有者的环境兼作团队的共享数据库服务器。每个成员环境都通过名称 rdev-team 访问其数据库和服务(MySQL、MariaDB、PostgreSQL、MongoDB、Redis 等)(例如在 Laravel 的 .env 中使用 DB_HOST=rdev-team 和端口 3306),同时也拥有自己的私有服务。请将其用于整个团队共同使用的数据,例如共享的预发布副本;个人实验请放在您自己环境的数据库中。

共享变量

所有者和管理员可以在您的团队页面的共享变量下,与整个团队共享 API 密钥等变量。选择添加变量,填写名称(例如 STRIPE_SECRET)、适用的项目或所有项目,以及其值。团队的每个环境会在几秒内将其写入这些项目的 .env,之后创建的项目也会写入;之后加入的成员会从已有该变量的环境获得它。针对某个项目的变量优先于同名的针对所有项目的变量。针对所有项目的变量只会写入有 .env 的文件夹,因此不是应用的文件夹保持不变。

用铅笔图标更改值,或移除变量以将其从每个 .env 中删除。表格显示每个变量有多少个环境拥有;将鼠标悬停在数字上可查看哪些环境尚未拥有。

您的浏览器会在值离开页面之前,针对每个环境分别加密,因此 rdev 的面板只保存名称,绝不保存值。在环境内部,该值是普通的 .env 行,因此使用该环境的人可以读取它,与任何 .env 一样。共享变量会在每次同步时覆盖项目 .env 中的同一行,因此请在这里更改,而不是在文件中。每个环境都需要 rdev 0.2.0-beta.34 或更高版本。

团队备份存储

所有者和管理员可以在 您的团队 页面的 团队备份存储 中为所有成员设置一个备份存储桶。每个环境备份到其中自己的文件夹,每位成员仍可在服务器页面选择自己的存储桶。参见备份与设置。

启动你的团队

使用 Team 套餐时,所有者会在仪表盘上看到 设置你的团队 框,按顺序列出入门步骤:在团队的第一台服务器上安装 rdev、邀请团队、成员安装各自的环境、连接笔记本电脑、添加第一个项目。每一步都链接到所需的页面或指南,完成后会被勾选。预约在线入门通话 会打开一个支持请求,你发给我们几个方便的时间,我们就与你的团队安排通话。我不需要 会永久隐藏此框。

团队渠道

所有者和管理员可以在您的团队页面添加 Slack 或 Discord 传入 webhook 作为团队渠道。下次同步时,团队服务器上的每个环境(包括所有者的)也会将其智能体通知(完成、等待批准、错误)发送到那里,与每位成员用 rdev notify 设置的渠道并行。清空该字段即可停止。

面向 AI 智能体的团队规则

所有者和管理员可以在您的团队页面编写面向 AI 智能体的团队规则,例如您的编码规范或新项目使用的数据库。下次同步时,团队服务器上的每个环境都会将其加入智能体配置,因此 Claude Code 和 Codex 会在每个项目中遵循这些规则。成员可在同一页面看到这些规则。

如果许可证停止

当 Team 许可证不再有效时,无人可以再加入团队,服务器上的每个环境对于新项目都会变为只读,就像单台服务器一样。