宝塔备份跳过缓存目录技巧

宝塔面板默认不支持图形化配置备份排除规则，但通过自定义Shell计划任务手动调用tar命令并精准设置--exclude参数（务必使用绝对路径+尾斜杠写法），既能安全跳过临时缓存目录（如runtime/、storage/等），又可避免修改易被升级覆盖的backup.py带来的风险；文中详解了路径匹配原理、常见踩坑点（如空归档报错、相对路径失效、shell数组展开陷阱）及关键验证方法——解压检查+grep过滤，确保每次备份真正轻量、可靠、可控，是运维人员提升备份效率与稳定性的实用利器。

宝塔面板备份脚本里怎么加 --exclude 参数

宝塔默认的站点/数据库备份不支持图形界面配置排除路径，必须手动修改其调用的备份脚本。核心逻辑是：宝塔执行备份时，最终会调用 tar 打包，而这个命令由 Python 脚本（/www/server/panel/class/backup.py）拼接生成。直接改这里风险高、升级后会被覆盖；更稳妥的做法是**在自定义备份任务中接管 tar 命令**。

• 进入「计划任务」→「添加计划任务」→ 类型选「Shell 脚本」
• 脚本内容以手动调用 tar 为主，绕过宝塔原生打包逻辑
• 关键点：必须保留宝塔备份目录结构（如 /www/backup/site/）和命名规范（含时间戳），否则「备份列表」无法识别
• 示例片段（备份站点 example.com，跳过 runtime/cache 和 public/storage）：

#!/bin/bash
SITE_DIR="/www/wwwroot/example.com"
BACKUP_DIR="/www/backup/site"
DATE=$(date +"%Y%m%d_%H%M%S")
EXCLUDE_LIST=( "--exclude=$SITE_DIR/runtime/cache" "--exclude=$SITE_DIR/public/storage" "--exclude=$SITE_DIR/.git" )

mkdir -p "$BACKUP_DIR"
tar -zcf "$BACKUP_DIR/example.com_$DATE.tar.gz" "${EXCLUDE_LIST[@]}" -C /www/wwwroot example.com

为什么不能直接改 backup.py 中的 tar 拼接逻辑

因为宝塔每次更新面板都会覆盖 /www/server/panel/class/backup.py，硬改等于白干。而且该文件中 tar 命令是动态拼接的，exclude 参数没预留扩展入口，强行插入容易破坏原有参数顺序（比如把 -C 放错位置导致路径错误）。

• 常见翻车点：在 backup.py 里写死 --exclude=xxx，结果 tar 报错 tar: Cowardly refusing to create an empty archive——本质是排除后没剩任何文件，但脚本没做空校验
• 另一个坑：用相对路径写 --exclude（如 --exclude=runtime/cache），但 tar 的 -C 切换工作目录后，排除路径失效；必须用绝对路径或确保与 -C 后的基准路径对齐
• 宝塔内部备份还会调用 mysql_dump，它不支持类似 exclude 的机制，所以数据库缓存表（如 wp_options 中的 transient）得靠 SQL 过滤，不是 tar 能解决的

--exclude 的路径写法和匹配规则要特别注意

tar --exclude 默认按**路径前缀匹配**，不是 glob 或正则，且区分斜杠结尾。比如 --exclude=/www/wwwroot/example.com/runtime 会排除整个 runtime 目录；但写成 --exclude=runtime/（不带绝对路径）只在 -C /www/wwwroot 且打包 example.com 目录时才生效。

• 推荐统一用绝对路径 + 尾部斜杠：--exclude=/www/wwwroot/example.com/runtime/（末尾 / 表示仅匹配目录，避免误删同名文件）
• 要排除多个模式，不能写成 --exclude="a b"，必须拆成多个 --exclude 参数，或用文件列表：--exclude-from=exclude.list
• 注意 shell 变量展开：如果路径含空格或特殊字符（如 My Site），"${EXCLUDE_LIST[@]}" 必须用双引号包裹数组展开，否则空格会导致参数断裂

备份后如何验证 --exclude 是否生效

别只看脚本有没有报错，得确认目标目录真没被打进去。最直接的办法是解压检查：

tar -tzf /www/backup/site/example.com_20241015_103022.tar.gz | grep -E "(runtime/cache|storage)"

• 如果输出为空，说明排除成功；如果有路径输出，说明排除规则没命中
• 常见失效原因：路径大小写不符（Linux 区分大小写）、多了一层 ./ 前缀、用了 --exclude='*/cache/*' 这种 tar 不支持的通配写法
• 注意：宝塔「备份列表」页面显示的文件大小是压缩包体积，不是原始目录大小，所以不能靠对比磁盘占用判断是否排除成功

今天关于《宝塔备份跳过缓存目录技巧》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！