hls_key_url

`hls_key_url` 指令指定用于检索 HLS 流的加密密钥的 URL。

语法hls_key_url URL;
默认值none
上下文
参数1

说明

hls_key_url 指令(位于 NGINX RTMP 模块中)允许指定一个外部 URL,从该 URL 获取 HLS(HTTP Live Streaming)内容的加密密钥。这在流式传输加密内容时特别有用,因为它将密钥管理与实际媒体文件分离,通过允许动态获取密钥来增强安全性。

当客户端请求分段 HLS 流时,也需要访问由 hls_key_url 指定的加密密钥。服务器会返回必要的播放列表文件(.m3u8),指导客户端如何处理流媒体分段,包括从何处检索密钥。可以使用 HTTPS 或任何受支持的 HTTP 协议安全地获取密钥,确保在流式传输期间密钥传输受到保护。

准确配置该指令很重要,以确保客户端在访问密钥时不会遇到问题,因为无法检索密钥会导致播放错误。该指令接受一个参数,该参数应为指向密钥文件的有效 URL,通常在 NGINX 配置的 HLS 应用块中设置。

配置示例

application myapp {
    live on;
    hls on;
    hls_key_url https://example.com/keys/key.bin;
}

确保密钥 URL 可访问;不可访问的 URL 将导致客户端播放失败。

使用不安全的 HTTP 可能在传输过程中暴露密钥;为安全起见,请优先使用 HTTPS。

密钥 URL 应以 HLS 客户端期望的正确格式返回密钥。

← 返回所有指令