PeerTube公共直播流媒体文件404错误问题分析

问题概述

PeerTube作为一款开源的分布式视频平台，其直播功能在6.2.1版本中出现了一个关键性问题：当用户创建公共(Public)直播时，系统错误地将流媒体播放列表文件存储在了私有(private)文件夹中，导致所有播放列表文件(如master.m3u8)返回404错误，使得直播无法正常播放。

技术背景

PeerTube的直播功能依赖于HLS(HTTP Live Streaming)协议，该协议通过将视频流分割成小片段并生成播放列表文件(m3u8)来实现自适应码率流媒体传输。正常情况下，公共直播的内容应该存储在公共可访问的目录中，而私有内容则存储在受保护的目录中。

问题重现步骤

1. 用户创建一个隐私设置为"Public"的普通直播
2. 在视频编辑界面获取RTMP密钥并配置到OBS推流软件
3. 从OBS开始推流
4. 在PeerTube客户端点击"更新"按钮
5. 等待直播在客户端开始
6. 系统尝试访问master.m3u8文件时返回404错误

根本原因分析

通过检查系统日志和文件存储结构，发现即使视频隐私设置明确为"Public"，系统仍然将流媒体文件错误地存储在/private/子目录下。这导致未经认证的用户无法访问这些文件，因为系统默认会检查私有目录的访问权限。

影响范围

该问题影响所有使用PeerTube 6.2.1版本且满足以下条件的实例：

• 启用了对象存储(object_storage.enabled: true)
• 未启用对象存储直播流(object_storage.store_live_streams: false)
• 尝试创建公共直播的用户

解决方案

该问题已在代码库中得到修复。修复方案主要涉及确保系统正确识别视频隐私设置，并将流媒体文件存储在适当的目录结构中。核心修改包括：

1. 修正直播创建流程中的隐私设置处理逻辑
2. 确保文件存储路径生成时考虑视频的隐私属性
3. 验证播放列表文件访问权限检查机制

最佳实践建议

对于遇到类似问题的管理员，建议：

1. 及时升级到包含修复的PeerTube版本
2. 创建直播时仔细检查各步骤的隐私设置
3. 直播开始前验证播放列表文件的可访问性
4. 定期检查系统日志中的权限相关错误

总结

PeerTube公共直播404错误是一个典型的权限与存储路径不匹配问题，通过理解HLS协议的工作机制和PeerTube的文件存储结构，可以更好地诊断和解决类似问题。该问题的修复确保了公共直播功能的正常运作，维护了PeerTube作为开源视频平台的核心功能完整性。