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

↑ ↓ 导航 ↵ 打开 esc 关闭

使用 rdev

备份和设置

rdev 会备份难以重建的内容,并且备份始终保存在您自己拥有的存储中。

智能体设置

您的 AI 智能体设置、规则和技能(Claude Code 和 Codex 的设置、智能体、技能、命令、钩子,以及您的 git 和 SSH 配置)每晚都会备份到您自己拥有的 git 仓库。凭据和密钥绝不会被复制。如果您设置了新服务器,您的智能体会带着相同的配置回来。所有套餐均包含此功能。

创建一个空的私有仓库,然后在服务器上运行:

sudo rdev backup setup git [email protected]:you/rdev-settings.git

它会打印一个 SSH 密钥;请将其作为具有写入权限的部署密钥添加到仓库,然后用 rdev backup run --settings 执行首次备份。每个环境写入各自的文件夹,因此在 Team 套餐中,团队共用一个仓库,每位开发者一个文件夹。

夜间备份

在 Pro 和 Team 套餐中,您的 MySQL、MariaDB、PostgreSQL 和 MongoDB 数据库以及 ~/Code 文件夹每晚都会备份到您自己拥有的兼容 S3 的存储桶:Amazon S3、Cloudflare R2、Hetzner、Backblaze 或您自己的 MinIO。node_modules、vendor 和其他可重建的文件夹不包含在内。备份经过加密和去重;rdev 保留 7 份每日、4 份每周和 6 份每月的副本。

最简单的方式是使用面板:在服务器页面中,进入备份存储 > 设置备份存储。选择您的服务商,填写端点、存储桶以及一个可对其写入和删除的密钥,并保存好面板生成的加密密码(或输入该存储桶中已有备份的密码以延续它们)。您的浏览器会针对该服务器加密密钥和密码,因此面板永远看不到它们。随后服务器会向存储桶写入一个测试文件、将其删除,并打开加密仓库;只有成功后才会保留设置,否则会告诉您出了什么问题(没有这样的存储桶、密钥或区域错误、没有权限)。测试连接可在之后运行同样的检查。

在终端中则是:

sudo rdev backup setup s3 --endpoint s3.eu-central-1.amazonaws.com --bucket my-backups \
  --access-key AKIA… --secret-key …

它会运行同样的检查(sudo rdev backup test 可重复检查),当端点未指明区域时可使用 --region,并只打印一次加密密码。请将其保存在安全的地方,且在服务器之外:没有它就无法恢复备份。用 rdev backup run --data 执行首次备份。

存储桶由您选择,凭据由您保管;我们永远无法访问您的备份。如果备份失败,您会在自己的渠道上收到通知。

团队备份存储

在 Team 套餐中,所有者或管理员可以在 您的团队 页面为整个团队设置一个存储桶:团队备份存储 > 设置团队存储。输入端点、存储桶、可读写删除它的密钥,以及可选的文件夹前缀,并保管好加密密码。你的浏览器会为团队的每个环境分别加密密钥和密码,因此面板永远看不到它们。每个环境备份到自己的文件夹 <prefix>/<member>/<environment>,成员之间不会互相覆盖;持有密钥和密码的人可以恢复任何成员的备份。

每位成员在自己服务器页面的 备份存储 中选择:团队存储 或 我自己的存储。没有自有存储的环境会使用团队存储,包括之后加入的成员:他们从已在使用的环境获得设置。已有自己存储桶的环境会保留它,直到成员切换。rdev backup status 显示正在使用的存储和文件夹。在终端中,给 rdev backup setup s3 加上 --prefix 可将环境的备份放在你选择的文件夹中,例如共享的存储桶里。

选择备份内容

您可能希望备份智能体设置但不备份项目,或者相反。在面板中服务器的页面上,撤销并恢复 > 夜间备份为两者各设了一个开关:智能体设置和项目和数据库。服务器从下一个夜晚起应用该选择;rdev backup status 会显示它,无论如何选择,rdev backup run 仍可手动运行备份。选择功能需要 rdev 0.2.0-beta.20 或更高版本。

检查和恢复

  • rdev backup status 显示备份的去向以及最近几次运行的情况。
  • rdev backup snapshots 列出夜间快照。
  • 要从面板恢复,请打开您的服务器并使用撤销并恢复 > 数据备份:选择一个备份,然后选择要恢复文件的项目或要恢复的数据库。服务器会在几秒内完成,结果显示在最近的恢复下。
  • 或在服务器上:rdev backup restore <snapshot> --project shop 或 rdev backup restore <snapshot> --database mysql:shop(MariaDB 用 mariadb:<name>,PostgreSQL 用 postgres:<name>,一次恢复所有 MongoDB 数据库用 mongodb:all)。从 rdev 0.2.0-beta.19 起才会备份 MariaDB 和 MongoDB。

恢复的项目会替换项目文件夹;被替换的文件夹会移到 ~/rdev-restored,不会被删除。恢复的数据库会被删除并从备份加载,因此该备份之后所做的更改会丢失。面板会在每次夜间运行后获知备份和数据库的列表;恢复需要 rdev 0.2.0-beta.16 或更高版本。您仍然可以使用您的存储桶和您保存的密码,直接使用 restic。

您的代码

您的项目照常存放在 git 中,文件同步会在笔记本电脑上保留一份工作副本。rdev 不会取代您自己的 git 托管。