☁️ 云备份

🔒 高级功能

云备份为付费版功能，免费版用户需要先 解锁高级功能 后使用。

使用 GitHub Gist 将数据库备份到云端，实现跨设备同步和数据恢复。

---

登录方式

方式一：Token 登录（推荐）

最简单可靠的登录方式，无需额外配置。

1. 打开设置面板，切换到 云备份 页面
2. 点击 Token 登录 或「点击这里」链接
3. 打开 GitHub Token 创建页面
4. 创建新的 Personal Access Token（需勾选 gist 权限）
5. 复制生成的 Token
6. 粘贴到 Kkbar 输入框
7. 点击登录

创建 Token 详细步骤

1. 访问 GitHub Token 设置页面
2. 点击「Generate new token (classic)」
3. 填写 Note（如 Kkbar 备份）
4. 只勾选 gist 权限，不要勾选其他权限
5. 点击「Generate token」
6. 复制显示的 Token

方式二：GitHub 账号登录

通过 OAuth 网页授权，需要部署 Cloudflare Worker。

优点

• 不需要手动创建 Token
• 授权过程更方便

缺点

• 需要部署 Worker（配置较复杂）
• 适用于高级用户

---

备份数据

1. 确保已登录 GitHub
2. 在云备份页面点击 立即备份
3. 系统会将完整数据库上传到 GitHub Gist
4. 备份成功后显示版本列表

版本管理

每次备份都会创建一个新版本，可以在版本列表中：

• 查看备份时间
• 预览备份内容
• 删除旧版本释放空间

---

恢复数据

1. 在云备份页面查看备份版本列表
2. 选择要恢复的版本
3. 点击 恢复
4. 确认后数据将被覆盖

注意

恢复操作会覆盖当前所有数据，请谨慎操作。

---

自动备份

可开启自动备份功能：

1. 在云备份页面开启 自动备份
2. 设置备份间隔（每天/每周）
3. 系统会在指定时间自动备份

---

注意事项

安全提示

• Token 登录只需 gist 权限，不要勾选其他权限
• 妥善保管 Token，不要泄露给他人
• Gist 存储空间有限，定期清理旧版本

适用场景

• 多设备间同步配置
• 防止本地数据丢失
• 迁移到新电脑时恢复配置