Orbit
转移 Orbit 项目
A project can be moved to a different Kapsule account without redeploying it or rebuilding its configuration. The move is email-verified, reversible only by transferring it back, and takes…
Orbit 项目转移
项目可以移动到另一个 Kapsule 账户,无需重新部署或重新构建配置。此转移经过电子邮件验证,只能通过转回来撤销,并且会带走所有内容:环境、部署、环境变量、Webhook 和设置。
何时转移项目
- 代理商将完成的网站交给从现在起拥有该网站的客户。
- 项目从个人账户移至公司账户。
- 团队分裂,项目随维护人员转移。
转移与添加协作者不同。如果你想让某人在你保留项目的情况下参与项目,请将他们添加到项目团队:请参阅 Orbit 项目设置。
开始转移
打开 Orbit,点击项目,选择 Settings,在 Danger zone 中找到 Transfer project。该卡片说明了将发生的情况:项目移至另一个 Kapsule 账户,收件人收到接受电子邮件,所有数据随项目转移。
- 输入接收账户所有者的电子邮件地址。
- 点击 Initiate transfer。
卡片显示 Transfer email sent 确认,然后显示 Transfer pending,列出等待的对象和过期时间。

只有账户所有者可以转移项目。如果你的角色是管理员、开发者或查看者,卡片会告诉你,该字段不可用。请所有者来操作。
一次只能有一个待处理转移
启动新转移会替换该项目已待处理的任何转移。之前的链接立即停止工作,这也是纠正地址拼写错误的最快方法:使用正确的地址重新启动。
收件人看到的内容
收件人收到一封包含接受链接的电子邮件。打开它会显示一个确认页面,页面标题为 Accept project transfer,显示发送账户、项目及其 slug,以及转移所发送到的电子邮件地址。
下方,页面明确说明了范围:所有环境、部署、环境变量、Webhook 和设置都将转移,以及链接的过期时间。
点击 Accept transfer 完成移动。页面随后显示 Transfer complete 并将他们重定向到该项目,现在该项目在他们的账户中。
收件人必须以该地址登录
接受检查已登录用户的电子邮件是否与转移所发送到的地址相匹配。如果不匹配,请求被拒绝,并显示一条消息,说明它被发送到的地址,并要求他们使用该账户登录。
这就是使整个过程安全的安全属性:仅知道链接是不够的。你必须是它所发送到的对象。
如果收件人还没有 Kapsule 账户,他们需要先使用该确切地址创建一个账户,然后再打开链接。
48 小时窗口
转移链接在创建后 48 小时过期。之后,接受页面显示转移不再有效,并给出原因:已过期。
同一页面处理其他终端状态,因此单击旧链接的收件人会被告知它是已被接受、已取消还是已过期,而不是看到一般性错误。
如果转移过期,请启动新转移。无法延长现有链接。
取消待处理的转移
转移待处理时,卡片提供 Cancel 选项。取消会立即使链接无效,因此即使收件人在电子邮件前打开,接受页面也会拒绝它。
一旦意识到转移发送到了错误的地址,立即取消。不要依靠 48 小时过期来为你处理。
什么随项目转移,什么不转移
附加到项目的所有内容都随项目转移:
- 每个环境,包括暂存和预览。
- 完整的部署历史。
- 环境变量,包括机密。
- Webhook、cron 作业、边缘函数和设置。
- 附加到项目的自定义域。
环境变量随项目转移,包括机密。转移后拥有该项目的任何人都可以读取和更改它们。在将项目转移给你不完全信任的一方之前,轮换其中的每个凭据:API 密钥、数据库密码、第三方令牌。请参阅 Orbit 中的环境变量。
有两件值得单独考虑的事情:
- 域名注册。 如果项目使用在你的 Kapsule 账户中注册的自定义域,该域不会随项目转移。作为单独的步骤转移或重新指向域名:请参阅 转移域外。
- 存储库连接。 项目继续指向同一存储库。接收账户需要对该存储库有自己的访问权限,以便将来的部署能够正常工作,因此请同时规划存储库交接。
转移后
从发送者的角度来看,项目简单地从 Orbit 列表中消失。没有存档副本,撤销意味着要求新所有者将其转移回来。
从收件人的角度来看,项目出现在他们的 Orbit 列表中,仍已部署且仍在提供流量。无需重新部署任何内容。
新所有者应该做的第一件事是检查项目的使用情况是否符合他们自己的计划。构建分钟数和带宽额度是账户范围的,因此一个繁忙的项目会改变双方的数字:请参阅 Orbit 计划限制。
通过 API 转移
转移也可以通过编程驱动:启动、取消和检查状态都可作为端点使用,在面板 API 参考中有记录。请参阅 Orbit API 令牌和 REST API。相同的规则适用,包括仅限所有者启动和电子邮件验证接受。
故障排除
转移字段不可用。 你不是账户所有者。
收件人说链接不起作用。 检查三件事:它是否已过期、是否已被取消或被较新的转移替换,以及他们是否使用转移所发送到的确切地址登录。
收件人没有 Kapsule 账户。 他们需要使用转移所发送到的地址注册,然后重新打开链接。
项目部署在转移后停止了。 新账户无权访问存储库。重新连接:请参阅 连接 GitHub 存储库。
自定义域停止解析。 该域仍在旧账户中。重新指向或转移它。
接下来的步骤
- Orbit 项目设置,了解协作者、存档和其他危险区域功能。
- Orbit 中的环境变量,了解交接前要轮换的内容。
- Orbit 计划限制,了解接收账户的额度。