ZLMediaKit RTP推流鉴权失败问题分析与解决方案

问题背景

在使用ZLMediaKit进行RTP推流时，开发者遇到了"禁止RTP推流"的错误提示。具体表现为使用ffmpeg命令进行RTP推流时，服务端日志显示鉴权失败，导致推流被拒绝。

错误现象

当执行以下ffmpeg推流命令时：

ffmpeg -re -i peter.mp4 -vcodec h264 -acodec aac -f rtp_mpegts rtp://127.0.0.1:10000

服务端日志会显示如下错误信息：

禁止RTP推流:[auth failed]: code:-1 msg:"failed"

根本原因分析

该问题的核心在于ZLMediaKit的Hook鉴权机制。当配置文件中启用了Hook功能(enable=1)并设置了on_publish回调地址时，ZLMediaKit会在每次推流请求时向该地址发起HTTP请求进行鉴权验证。

如果Hook服务返回的响应不符合预期，或者Hook服务本身不可用，就会导致鉴权失败，进而拒绝推流请求。

解决方案

方案一：正确配置Hook服务

1. 确保Hook服务(on_publish配置的URL)可正常访问
2. Hook服务需要返回正确的JSON响应格式：

{
    "code": 0,
    "msg": "success"
}

其中code为0表示鉴权通过，非0表示拒绝。

3. Hook服务应正确处理ZLMediaKit发送的请求参数，包括流应用名(app)、流ID(stream)、推流IP(ip)等信息。

方案二：临时禁用Hook鉴权

如果暂时不需要鉴权功能，可以通过以下配置禁用：

[hook]
enable=0

这将关闭所有Hook功能，包括推流鉴权，使任何推流请求都能被接受。

最佳实践建议

1. 生产环境中建议保持Hook鉴权开启，确保流媒体服务的安全性
2. 开发测试阶段可以临时禁用Hook功能，简化测试流程
3. 实现Hook服务时，建议记录详细的鉴权日志，便于问题排查
4. 对于RTP推流场景，Hook服务需要考虑UDP协议的特殊性，做好超时和重试机制

总结

ZLMediaKit通过Hook机制提供了灵活的鉴权方案，开发者需要正确理解其工作原理并合理配置。当遇到RTP推流被拒绝的问题时，应首先检查Hook服务的可用性和响应格式，确保鉴权流程能够正常完成。