Webmin Filesystem Backup提示恢复完成无错误但实际未生效

基础运行环境 #

• 操作系统：Debian 10（Buster）
• 管理面板版本：Webmin 1.970
• 异常模块：Webmin 内置 Filesystem Backup（文件系统备份） 功能

故障复现全流程 #

1. 按模块官方指引完成备份创建，操作过程无报错，可正常生成备份归档文件
2. 手动修改备份覆盖范围内的目标文件，人为制造当前文件状态与备份归档的内容差异
3. 选中对应备份归档执行恢复操作，等待流程跑完返回完成提示

异常现象说明 #

• 恢复操作执行结束后，模块返回日志明确标记全流程完成、无任何错误提示
• 逐一对目标路径下的文件做内容校验，发现文件状态完全停留在手动修改后的版本，未按照备份归档内容完成回滚
• 在Webmin模块独立日志、系统/var/log/syslog中，均未检索到可定位故障原因的有效报错堆栈

排查思路与解决方向 #

• 定位文件实际落点：Webmin文件系统备份模块支持自定义恢复映射路径，且默认会在临时目录完成解压后再迁移，需确认操作时是否因参数配置错误，将归档解压到了临时缓存目录、而非原备份对应的源路径。可优先检查Webmin默认的临时工作目录/tmp/webmin-backup下的内容，核对是否有解压完成的文件未被迁移到目标路径
• 验证备份归档完整性：直接手动调用tar -tf 备份文件路径 核对归档内的文件清单，再解压部分文件到独立临时目录，确认归档内的内容是否与创建备份时的文件状态一致，排除备份创建阶段就存在归档残缺、内容为空的问题
• 校验写入权限连通性：确认Webmin进程运行用户（默认为root）对目标恢复路径是否有写入权限，检查是否存在ACL规则、AppArmor强制访问策略拦截了Webmin进程的文件写入动作，可手动在目标路径创建测试文件验证写入连通性
• 排查版本已知缺陷：Webmin 1.970为2021年发布的旧版本，该版本的文件系统备份模块存在恢复路径参数传递异常的公开已知问题，升级到1.980及以上的稳定版本即可修复该逻辑bug
• 临时应急方案：如果需紧急完成文件恢复，可绕过Webmin模块，手动从备份归档中提取目标文件覆盖对应路径，避免受模块逻辑异常影响

内容的提问来源于stack exchange，提问作者Kriffin