AzuraCast 流媒体录制功能故障排查指南

问题现象

在使用Docker方式部署的AzuraCast滚动发布版本（Rolling Release #7b16397）时，用户发现尽管在电台设置中启用了流媒体录制功能，但系统未能正确保存任何录制文件。该问题同时影响同一AzuraCast实例上的两个电台。

故障排查过程

初步检查

1. 配置验证：确认电台管理界面中的"录制流媒体广播"选项已正确启用
2. 目录权限检查：系统尝试将录制文件从临时目录(/tmp)移动到最终存储位置时出现异常
3. 日志分析：发现定时任务(temp_cleanup)执行时出现异常提示

关键发现

通过深入分析，发现系统日志中存在以下关键信息：

time="2024-08-13T12:30:00Z" level=info msg="(PID 1106047) Back from recursing down Niklas H.'." 

这表明系统在处理包含特殊字符（空格和句点）的用户名时出现了问题。

解决方案

根本原因

AzuraCast的文件处理机制对包含特殊字符（特别是空格和句点）的用户名兼容性不足，导致：

1. 临时文件清理任务执行失败
2. 录制文件无法从临时目录正确移动到最终存储位置

修复步骤

1. 登录AzuraCast管理后台
2. 进入用户管理界面
3. 修改用户名，移除所有空格和特殊字符（如句点）
4. 建议使用纯字母数字组合的用户名（如将"Niklas H."改为"NiklasH"）

验证方法

1. 修改用户名后，重新启动流媒体广播
2. 等待约5-10分钟（系统定时任务执行周期）
3. 检查录制文件是否出现在"录制"列表中

技术建议

1. 用户名规范：在AzuraCast系统中，建议始终使用不含空格和特殊字符的用户名
2. 文件系统监控：可定期检查/tmp目录和录制目录的文件权限设置
3. 日志监控：关注定时任务(temp_cleanup)的执行日志，确保无异常

总结

AzuraCast的流媒体录制功能依赖于系统定时任务和文件操作，当用户名包含特殊字符时可能导致文件处理异常。通过规范用户名格式，可以有效避免此类问题。对于系统管理员而言，建立规范的用户命名策略是预防类似问题的有效方法。