AzuraCast磁盘空间异常占用问题分析与解决方案

问题现象

AzuraCast用户报告其服务器频繁出现磁盘空间耗尽的情况，导致所有电台服务中断。通过检查发现，Docker的overlay2目录占用了异常大量的磁盘空间（150GB以上），而实际的电台数据仅占20GB左右。系统日志显示存在大量临时备份文件未被清理。

根本原因分析

经过深入调查，发现问题的核心在于AzuraCast的备份机制存在以下设计缺陷：

1. 临时文件处理不当：即使配置了SFTP远程备份，系统仍会在本地/tmp目录创建完整的备份文件副本用于传输。当备份文件较大时（如50GB以上），会快速耗尽磁盘空间。

2. 失败清理机制缺失：当备份过程因磁盘空间不足或其他原因失败时，系统未能正确清理已生成的临时备份文件，导致这些"僵尸文件"持续占用空间。

3. 文件位置隐蔽：这些临时文件存储在Docker overlay2目录深处，普通用户难以发现和手动清理。

技术细节

在Docker环境下，AzuraCast的备份过程会：

1. 在容器内的/tmp目录创建临时备份文件
2. 将这些文件打包压缩
3. 传输到配置的远程位置
4. 理论上应删除本地临时文件

但实际运行中，步骤4可能在失败情况下被跳过。这些文件最终会出现在：

/var/lib/docker/overlay2/[container_id]/merged/tmp/
/var/lib/docker/overlay2/[container_id]/diff/tmp/

解决方案

临时解决方案

1. 手动清理临时文件：

find /var/lib/docker -type f -name "backup_*" -exec rm -f {} \;

2. 检查磁盘空间使用情况：

find /var/lib/docker -type f -size +100M -exec ls -lh {} \; | sort -k5 -hr | head -n 20

3. 调整备份策略：

• 减少备份保留数量
• 考虑仅备份关键数据（数据库），不包含媒体文件
• 改为手动备份

长期解决方案

1. 升级到最新版本：开发团队已在Rolling Release中修复了此问题，等待包含在下一稳定版中。

2. 优化存储架构：

• 将媒体文件存储在外部存储（如SFTP）
• 确保Docker所在分区有足够空间（建议至少是媒体库大小的2倍）

3. 监控机制：

• 设置磁盘空间监控告警
• 定期检查Docker存储使用情况

最佳实践建议

1. 对于大型媒体库（超过50GB），建议：

   • 使用外部存储解决方案
   • 实施分级备份策略
   • 考虑增量备份而非全量备份

2. 定期执行维护：

docker system prune -a --volumes

3. 监控关键指标：
   • /var/lib/docker分区使用率
   • 备份任务执行日志
   • 系统定时任务状态

通过以上措施，可以有效预防和解决AzuraCast因备份机制导致的磁盘空间异常问题，确保广播服务的稳定运行。