Simple Backup

💾 加密备份,一键归档上云

本地加密备份 agent 工作区与状态,支持 rclone 云端同步,AES256-GPG 加密保护数据安全。

收藏
16.3k
安装
5.3k
版本
1.0.3
CLS 安全性认证2026-07-08
点击查看完整报告 >

使用说明

核心用法

Simple Backup 是一款面向 AI agent 的轻量级备份工具,采用「本地归档 + 可选云同步」的双层架构。用户执行 simple-backup 命令后,脚本自动完成以下流程:

1. Staging — 聚合三个核心目录:~/clawd(工作区)、~/.clawdbot(状态持久化)、skills/(技能源码)
2. Compression — 使用 tar 打包为 .tgz 压缩档,节省存储空间

3. Encryption — 调用 GPG 执行 AES256 对称加密,需通过环境变量 BACKUP_PASSWORD~/.clawdbot/credentials/backup.key 提供密码

4. Rotation — 自动清理过期备份,支持按天(默认 7 天)和按小时(默认 24 小时)双维度保留策略

5. Sync — 若配置 REMOTE_DEST(如 gdrive:backups),通过 rclone 推送加密档案至云端

显著优点

  • 零配置开箱即用:依赖仅 rclone、gpg、tar,主流系统均可快速安装
  • 端到端加密:AES256-GPG 确保即使云端存储被攻破,数据仍不可读
  • 灵活保留策略:通过环境变量细粒度控制存储周期,避免磁盘无限膨胀
  • 云中立:rclone 支持 70+ 存储后端(S3、Google Drive、OneDrive、SFTP 等),无厂商锁定
  • 原子操作:tar 打包在本地完成后再加密上传,网络中断不会导致档案损坏

潜在缺点与局限性

  • 密码管理风险:密钥以明文环境变量或文件形式存放,若主机已被入侵,攻击者可读取 backup.key 解密历史备份;缺乏硬件安全模块(HSM)或密钥管理服务(KMS)集成
  • 无增量备份:每次全量打包,高频备份时磁盘 I/O 与存储成本较高
  • rclone 配置复杂度:云同步依赖用户自行完成 rclone config,配置错误可能导致数据泄露至错误 bucket
  • 无恢复验证:内置脚本未提供自动化的备份完整性校验或模拟恢复测试
  • 单点故障:若本地磁盘与云存储同时配置错误,可能导致备份链断裂

适合人群

  • 个人开发者或小型团队,需快速建立 agent 数据保护机制
  • 对数据主权敏感、希望加密后再上传公有云的用户
  • 已有 rclone 使用经验、熟悉 GPG 工作流的技术用户

常规风险

| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 密钥泄露 | `BACKUP_PASSWORD` 或 `backup.key` 被进程/日志泄露 | 使用 `export -n BACKUP_PASSWORD` 及时清除,文件权限设为 600 |
| 中间人攻击 | rclone 同步时 TLS 配置不当 | 验证 rclone remote 的 `server_side_encryption` 配置 |
| 备份腐败 | tar 压缩过程磁盘满或进程被杀 | 预留 2x 工作区大小的临时空间,监控退出码 |
| 恢复失败 | 长期未验证导致 GPG 密钥或密码遗忘 | 定期执行 `--dry-run` 解密测试,离线保存密码分片 |

安全解读

核心用法

Simple Backup 是一款专为 Clawdbot 设计的本地备份 Skill,通过简洁的 Shell 脚本实现工作空间(~/clawd)、状态数据(~/.clawdbot)和技能目录的完整备份流程。用户执行 simple-backup 即可触发五阶段操作:文件 staging、tar 压缩、GPG AES256 加密、本地备份轮替(按日/小时保留策略),以及可选的 rclone 云同步。

配置高度灵活,支持环境变量覆盖:

  • BACKUP_PASSWORD / ~/.clawdbot/credentials/backup.key:加密密钥来源
  • BACKUP_ROOT:本地备份存储位置(默认 ~/clawd/BACKUPS
  • REMOTE_DEST:rclone 远程路径(如 gdrive:backups
  • MAX_DAYS / HOURLY_RETENTION_HOURS:保留策略

显著优点

架构纯净:零 npm/python 依赖,仅依赖系统标准工具(tar、gpg、rclone、rsync),代码 205 行 Shell 脚本清晰可审计。

安全设计:强制 AES256-GPG 加密,密码绝不硬编码;临时目录使用 mktemp 创建并安全清理;执行前对所有外部工具进行存在性检查。

透明可控:rclone 云同步完全由用户配置驱动,无强制外连、无隐藏网络行为,网络流量 100% 用户可见。

来源可信:VACInc 发布的 MIT 许可开源项目,安全扫描 94 分 S 级,静态/动态/依赖/网络/隐私/威胁情报六项全通过。

潜在局限

密码管理责任:加密密钥由用户自行保管,丢失即永久不可恢复,无后门机制。

无增量备份:全量 tar 打包在数据量大时可能耗时且占用双倍本地磁盘空间(staging + 压缩)。

rclone 配置门槛:云同步需用户独立完成 rclone 远程配置,对新手有一定学习成本。

平台绑定:专为 Clawdbot 目录结构优化,迁移至其他环境需手动调整路径。

适合人群

  • 需要定期加密备份工作空间的开发者/AI Agent 用户
  • 对数据主权敏感、偏好本地-first 架构的隐私意识用户
  • 具备基础 Shell/rclone 使用经验的技术用户

常规风险

| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 密钥丢失 | 密码遗忘导致备份不可用 | 使用密码管理器妥善保管 |
| 本地磁盘满 | 全量备份占用空间较大 | 调整保留策略或扩展存储 |
| rclone 配置泄露 | 远程凭据存储不当 | 审查 rclone.conf 权限,避免明文密码 |
| 恢复未验证 | 备份文件损坏未发现 | 定期执行 `gpg --decrypt \| tar -tz` 验证 |

Simple Backup 内容

手动下载zip · 3.3 kB
package.jsonapplication/json
请选择文件