本地可播放的HLS流经局域网服务器无法播放问题排查

我开发了一个应用，使用GStreamer的appsrc pipeline将原始RGBA帧转换为HLS流。生成的文件存储在本地时，用VLC本地播放完全正常，但启动本地Web服务器指向存储目录后，局域网内其他设备的VLC或浏览器均无法播放该流。

Web服务器无报错，且确认先收到m3u8的GET请求，再收到单个.ts文件的请求，但播放仍无法进行。其他文件（如jpeg）可正常通过该服务器访问，因此几乎可以排除服务器或防火墙问题。

运行的Pipeline配置 #

appsrc
  - video/x-raw
    - format=RGBA
    - width=720
    - height=1550
    - framerate=25/1
    - stream-type=0
    - is-live=TRUE
    - format=GST_FORMAT_TIME

videoconvert
openh264enc
  - profile=high
  - bitrate=1000

h264parse
  - config-interval=1

mpegtsmux
hlssink
  - max-files=5
  - target-duration=25
  - playlist-length=3
  - location=.../%04.ts
  - playlist-location=.../video.m3u8

1. HLS播放列表中的TS路径不匹配Web服务结构 #

hlssink生成的m3u8文件里，TS文件的路径可能是本地绝对路径，或者相对路径不符合Web服务器的访问逻辑。本地播放时系统能识别绝对路径，但Web服务器只能返回相对于根目录的资源。

解决方法：

• 打开生成的video.m3u8，检查其中TS文件的URI是否为相对路径（如0001.ts），而非/home/xxx/xxx/0001.ts这类绝对路径。
• 调整hlssink的location参数为相对路径，比如Web服务器根目录直接指向HLS存储目录时，设为%04.ts即可，不要带本地路径前缀。

2. TS文件的权限限制 #

本地播放用的是当前用户权限，但Web服务器进程（如www-data、nginx）可能没有读取TS文件的权限，导致服务器虽收到请求但无法返回有效内容。

解决方法：

• 查看TS和m3u8文件的权限，执行ls -l确认其他用户是否有读取权限。
• 临时测试可执行chmod o+r *.ts *.m3u8，长期解决需调整文件所在目录的权限，确保Web服务器进程能访问。

3. Target-Duration设置不合理 #

你设置了target-duration=25，意味着每个TS片段目标时长为25秒，但live流场景下过大的片段时长可能导致播放器解析超时，或m3u8中声明的时长与实际片段时长不匹配。

解决方法：

• 降低target-duration到合理值，比如1秒或5秒，匹配帧率的同时提升播放器兼容性。
• 检查m3u8中的#EXTINF字段值，确认是否与实际TS片段的时长一致。

4. H264的SPS/PPS信息未正确插入 #

虽然设置了h264parse config-interval=1，但live模式下可能SPS/PPS未被插入到每个TS片段开头，部分网络播放器需要每个片段都包含完整的解码参数才能正常播放。

解决方法：

• 将h264parse的config-interval改为0，强制在每个关键帧前插入SPS/PPS。
• 使用工具（如ffmpeg）检查TS文件，确认每个片段开头是否包含H264的SPS/PPS NAL单元。

5. Web服务器MIME类型配置错误 #

HLS要求服务器正确返回MIME类型：.m3u8对应application/vnd.apple.mpegurl，.ts对应video/MP2T。如果类型错误，播放器无法识别流格式。

解决方法：

• 针对常用Web服务器调整配置：
  • Nginx：在配置文件的types块中添加：

    application/vnd.apple.mpegurl m3u8;
    video/MP2T ts;
    

  • Apache：在.htaccess或主配置中添加：

    AddType application/vnd.apple.mpegurl .m3u8
    AddType video/MP2T .ts
    

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