Cron Backup

核心用法

cron-backup 提供一套 Shell 脚本工具集，实现 Linux/Unix 环境下的自动化备份工作流。核心功能包括：

1. 定时备份：通过 setup-cron.sh 将备份任务注册到系统 crontab，支持标准 cron 表达式
2. 版本感知备份：backup-versioned.sh 监控版本文件或命令输出，仅在软件更新时触发备份，避免冗余
3. 智能清理：cleanup.sh 按时间或数量策略清理旧备份，防止磁盘耗尽

典型工作流：

• 执行初始备份 → 配置定时任务 → 设置保留策略
• 对可变版本软件（如 OpenClaw）采用版本触发模式，每6小时检测一次变更

显著优点

• 零依赖：纯 Bash 实现，无需额外运行时
• 权限保留：使用 tar.gz 归档，完整保留文件权限与目录结构
• 自动排除：内置过滤 node_modules、.git 等临时目录
• 双保险策略：清理时同时满足"最少保留N份"和"保留M天"，防止误删

潜在局限

• 单节点存储：备份与源数据通常位于同一物理机，无法抵御硬件故障
• 无加密传输：本地归档明文存储，敏感数据需额外加密处理
• 恢复粒度：整包 tar.gz 恢复，无法单文件回滚
• 并发风险：未显式处理备份过程中的文件写入冲突

适合人群

• 个人开发者管理 ~/.config、项目代码库
• 运维人员为配置文件建立变更追踪
• 轻量级服务器需要低成本自动化方案

常规风险

| 风险点 | 说明 |

|--------|------|

| 权限配置不当 | 需确保脚本可执行、crontab 用户有目录读写权 |

| 磁盘空间耗尽 | 未配置 cleanup 或保留期过长可能导致 /backups 满 |

| 版本检测失效 | 若版本命令返回非零或格式变化，触发逻辑可能异常 |

| 定时任务静默失败 | 建议重定向 cron 输出到日志文件以便排查 |

核心用法

Cron Backup 是一套基于 Shell 脚本的自动化备份工具，提供定时备份、版本感知触发、自动清理三大核心能力。用户可通过简单命令快速配置每日/周期性备份任务，无需手动干预。

典型工作流：
1. 使用 backup.sh 执行一次性目录打包（tar.gz，保留权限结构）
2. 通过 setup-cron.sh 将备份任务注册到系统 cron（支持标准 cron 表达式）
3. 可选启用 backup-versioned.sh 实现"版本变更才备份"（适合软件更新场景）
4. 配合 cleanup.sh 自动删除 N 天前的旧备份，防止磁盘耗尽

显著优点

• 零依赖：纯 Shell 脚本，仅依赖系统标准命令（tar、crontab、date），无第三方包
• 即开即用：提供 5 个独立脚本覆盖完整生命周期，命令行接口清晰
• 智能保留策略：支持时间+数量双维度清理（默认保留 7 天且至少 3 个备份）
• 版本感知：通过监控版本文件或命令输出，避免无意义重复备份

潜在缺点与局限

• T3 来源：个人开发者维护，长期更新与漏洞响应依赖社区活跃度
• 单点执行风险：无分布式或多副本备份能力，不适合关键业务的高可用场景
• eval 使用：backup-versioned.sh 第 33 行使用 eval 执行版本命令，虽有多重前置校验，仍存在理论注入风险
• 无加密与校验：备份文件默认无加密，也未内置 SHA 校验机制，需用户自行加固

适合人群

• 个人开发者 / 小型团队需要自动化配置文件、代码仓库或用户数据的本地备份
• 需要"版本更新才备份"场景（如 OpenClaw 类应用的升级追踪）
• 对运维复杂度敏感、偏好轻量 Shell 方案而非重量级备份系统的用户

常规风险

• 权限配置不当：若备份目录权限过宽，可能导致敏感数据泄露
• cron 任务失败：系统 cron 服务异常或环境变量差异可能导致静默失败，建议配合日志监控
• 磁盘空间管理：虽内置清理策略，但若备份文件过大或频率过高，仍可能突发占满磁盘