解决nginx-vod-module中HLS多字幕与多码率配置问题

nginx-vod-module是一个强大的视频点播处理模块，但在实际使用中可能会遇到一些配置上的挑战。本文将详细介绍如何正确配置HLS多码率视频流与多语言字幕的组合方案。

问题背景

在使用nginx-vod-module处理HLS流时，开发者尝试同时配置4种不同码率的视频流和2种语言的字幕文件。初始配置虽然单独使用多码率或多字幕都能正常工作，但组合使用时却出现了503错误。

错误分析

从错误日志中可以发现关键信息："mapping size 1241 greater than limit 1024"。这表明模块在处理映射响应时超出了默认的大小限制(1024字节)。当配置内容较复杂时(如同时包含多码率和多字幕)，生成的映射响应会变得较大，从而触发这个限制。

解决方案

要解决这个问题，需要在nginx配置中增加以下指令：

vod_max_mapping_response_size 10k;

这个配置将映射响应大小限制提高到10KB，足以容纳复杂的多码率多字幕配置。建议根据实际需求调整这个值，对于大多数场景，10KB已经足够。

完整配置示例

以下是经过验证可用的完整JSON配置示例：

{
    "sequences": [
        {
            "clips": [
                {
                    "type": "source",
                    "path": "/path/to/video_1080p.mp4"
                }
            ]
        },
        {
            "clips": [
                {
                    "type": "source",
                    "path": "/path/to/video_720p.mp4"
                }
            ]
        },
        {
            "clips": [
                {
                    "type": "source",
                    "path": "/path/to/video_480p.mp4"
                }
            ]
        },
        {
            "clips": [
                {
                    "type": "source",
                    "path": "/path/to/video_360p.mp4"
                }
            ]
        },
        {
            "clips": [
                {
                    "type": "source",
                    "path": "/path/to/english_sub.srt"
                }
            ],
            "language": "eng"
        },
        {
            "clips": [
                {
                    "type": "source",
                    "path": "/path/to/swedish_sub.srt"
                }
            ],
            "language": "swe"
        }
    ]
}

注意事项

1. 字幕配置中的"label"属性在某些版本中可能导致503错误，建议先使用"language"属性确保基本功能正常后再尝试添加标签。

2. 文件路径需要确保nginx进程有读取权限。

3. 不同码率的视频文件应该保持相同的编码参数(如帧率、关键帧间隔等)，以确保流畅的码率切换体验。

通过以上配置和调整，开发者可以成功实现同时支持多码率视频流和多语言字幕的HLS服务。nginx-vod-module的强大功能为视频点播服务提供了灵活的解决方案。