backup_OBS/readme.md

backup_OBS

基于 bash + obsutil 的 OBS 备份脚本，包含备份上传和历史清理两个入口：

• backup.sh：打包目录、生成 sha256、上传到 OBS、下载远端校验文件做一致性校验
• clean_backups.sh：按文件名日期清理旧备份

配置

先复制模板并填写实际配置：

cp env.conf.example env.conf

重点配置项：

• OBS_BUCKET：OBS 桶名
• LABEL：机器或业务标识
• BACKUP_DIR：要备份的目录，当前格式为以空格分隔的路径列表
• TG_BOT_TOKEN / TG_USER_ID：Telegram 通知配置，可留空

使用方式

备份：

./backup.sh

仅做打包自检，不上传：

./backup.sh --dry-run

检查远端前缀是否可访问：

./backup.sh --verify

清理旧备份：

./clean_backups.sh --retain-days=5

exclude.list 规则

exclude.list 由 tar --exclude-from 读取，匹配的是归档内的相对路径，不是磁盘上的绝对路径。

不要写：

/root/data/project/src/main.js
cache/

应该写相对路径或通配规则。

排除单个文件：

project/src/main.js

或者：

*/project/src/main.js

排除某类文件：

*.log
*.tmp

排除一个目录，建议写两行：

*/node_modules
*/node_modules/*

例如排除 project/cache：

*/project/cache
*/project/cache/*

当前自带的 exclude.list 已对常见目录采用这种写法，避免 .cache/、node_modules/ 这类规则匹配不到的问题。