ngx_http_subrange_module 使用指南

最新推荐文章于 2025-02-18 13:57:54 发布

汤璞亚Heath

最新推荐文章于 2025-02-18 13:57:54 发布

阅读量609

点赞数 20

本文链接：https://blog.youkuaiyun.com/gitblog_00903/article/details/140981119

版权

ngx_http_subrange_module 使用指南

ngx_http_subrange_moduleSplit one big HTTP/Range request to multiple subrange requesets项目地址:https://gitcode.com/gh_mirrors/ng/ngx_http_subrange_module

项目介绍

ngx_http_subrange_module 是一个为 Nginx 设计的 HTTP 子范围模块. 该模块由奇虎360研发并贡献给开源社区，旨在增强Nginx处理HTTP子范围请求的能力，特别适用于视频点播(VoD)场景.

模块的主要特点是：

高效性：采用高效的数据结构和算法，优化了对大文件的随机访问性能.
兼容性：遵循HTTP规范，兼容各种HTTP子范围请求.
灵活性：支持多种配置选项，可根据实际需求调整策略.

ngx_http_subrange_module 提供了一个可选的方式来处理HTTP RANGE请求。通常，对于HTTP RANGE请求，Nginx会使用内存映射文件(map file)技术来提高文件的访问速度.然而，在一些情况下，尤其是在大规模并发请求下，这种方法可能会导致较高的CPU占用率和较大的内存消耗。

为此，该模块引入了一种新的数据结构，名为“chunked file”，用以替代传统的map file技术.相比于map file, chunked file有以下优势：

减少内存使用：chunked file只保留文件的部分数据，而非整个文件的内容。这大大降低了处理大量并发请求时所需的内存。
提高CPU效率：chunked file采用了更高效的算法，减少了计算开销。
更好的缓存效果：chunked file能更好地利用操作系统级别的缓存机制，从而进一步提升文件访问的速度。

总之，ngx_http_subrange_module通过对传统方法的改进，显著提升了Nginx在处理HTTP RANGE请求时的性能和稳定性。

快速启动

在你的系统中安装并集成ngx_http_subrange_module到Nginx之前，需要确保已经具备必要的构建工具和依赖项，例如gcc，make以及pcre-devel。

接下来，按照以下步骤操作：

下载ngx_http_subrange_module的源代码:

git clone https://github.com/Qihoo360/ngx_http_subrange_module.git

进入到Nginx的源码目录(如果你还没有Nginx源码，则需先获取)，并执行以下命令以启用ngx_http_subrange_module模块：
```
./configure --add-module=/path/to/ngx_http_subrange_module
```
替换 /path/to/ngx_http_subrange_module 为你刚刚克隆的模块路径。
构建并安装Nginx：
```
make && sudo make install
```
这将在Nginx的安装目录中构建和安装包含ngx_http_subrange_module的新版本Nginx。

应用案例与最佳实践

应用案例

视频点播（VoD）

假设我们正在运行一个视频点播平台，其中包含大量的高质量视频资源。使用ngx_http_subrange_module可以帮助我们的服务器更有效地处理来自不同用户的并发视频播放请求，特别是在快进或拖动播放进度时。

配置示例

在nginx.conf中的适当位置（通常是http或server层级），增加以下配置：

http {
    # 开启module
    include modules/ngx_http_subrange_module.conf;
}

或者更详细的配置：

server {
    listen       80;
    server_name  example.com;

    location /video/ {
        root   /data/videos;
        types_hash_max_size 2048;

        add_header Cache-Control "public";

        # 开启ngx_http_subrange_module的支持
        add_header X-Accel-Buffering no;
        
        if (-f $request_filename) {
            break;
        }
    
        sendfile on;
        sendfile_max_chunk 1m;
    }
}

在此配置中，我们开启了sendfile特性，以便利用内核层面的文件传输加速，并设置了sendfile_max_chunk选项以控制每次传输的最大数据包大小.