宝塔面板添加--exclude参数需通过自定义shell计划任务实现，而非修改backup.py；脚本中用绝对路径+尾斜杠写法（如--exclude=/www/wwwroot/example.com/runtime/），配合数组展开调用tar，并解压验证排除效果。
宝塔面板备份脚本里怎么加 --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 不支持的通配写法 - 注意：宝塔「备份列表」页面显示的文件大小是压缩包体积，不是原始目录大小，所以不能靠对比磁盘占用判断是否排除成功
--exclude 看似简单，但路径语义、tar 工作目录、shell 展开顺序这三者咬合稍有偏差，备份就 quietly 漏掉排除项——建议每次新增排除规则后都跑一次验证命令。
