Xiu项目HLS流媒体服务配置问题解析

在使用Xiu流媒体服务器(v0.9.0版本)搭建HLS直播服务时，开发者可能会遇到无法访问.m3u8播放列表文件的问题。本文将从技术角度分析这一常见配置错误的成因及解决方案。

问题现象

当用户通过OBS推流到Xiu服务器后，虽然服务器日志显示RTMP连接已建立，但尝试通过HTTP访问HLS播放列表时返回"Not Found"错误。具体表现为：

• 服务器启动正常，监听1936(RTMP)和8091(HLS)端口
• OBS显示推流成功
• 文件系统中有TS分片文件生成，但缺少.m3u8索引文件
• HTTP请求返回404状态

根本原因分析

经过排查发现，这是由于OBS推流URL配置不当导致的。Xiu作为RTMP服务器时，完整的推流地址应包含：

1. 协议类型(rtmp://)
2. 服务器地址和端口
3. 应用名称(对应Xiu中的app_name)
4. 流密钥(stream_key)

典型错误配置是仅提供了前三部分而遗漏了流密钥，例如：

rtmp://server:1936/live/test

而正确的配置应该类似于：

rtmp://server:1936/live/stream_key

解决方案

1. OBS配置修正：

   • 在OBS的"流"设置中，确保"流密钥"字段不为空
   • 服务器URL格式应为：rtmp://[服务器地址]:1936/live
   • 流密钥可设置为任意字符串标识符

2. Xiu服务器验证：

   • 启动Xiu时建议添加-l debug参数获取详细日志
   • 确认日志中显示的stream_name与配置的流密钥一致

3. HLS访问验证：

   • 成功配置后，可通过以下URL访问HLS流：

     http://[服务器地址]:8091/live/[流密钥]/index.m3u8
     

技术建议

对于流媒体服务器开发者，可以考虑以下改进：

1. 在服务器启动时验证必要参数
2. 对缺失流密钥的情况返回更有意义的错误信息
3. 在文档中明确说明OBS等常见推流工具的配置示例

Xiu作为轻量级流媒体服务器，正确配置后能够稳定提供RTMP接收和HLS分发功能。理解其URL结构设计原理是成功部署的关键。