Nginx官方文档(二十六)【ngx_http_mp4_module|ngx_http_perl_module】

矫情吗；* 2021-07-04 13:11 515阅读 0赞

# ngx\_http\_mp4\_module #

*  指令
    
     *  mp4
     *  mp4\_buffer\_size
     *  mp4\_max\_buffer\_size
     *  mp4\_limit\_rate
     *  mp4\_limit\_rate\_after

`ngx_http_mp4_module` 模块为 MP4 文件提供伪流服务端支持。这些文件的扩展名通常为 `.mp4`、`.m4v` 或 `.m4a`。

伪流与兼容的 Flash 播放器可以很好地配合工作。播放器在查询字符串参数中指定的开始时间向服务器发送 HTTP 请求（简单地以 `start` 命名并以秒为单位），服务器以流响应方式使其起始位置与请求的时间相对应，例如：

http://example.com/elephants_dream.mp4?start=238.88

这将允许随时执行随机查找，或者在时间线中间开始回放。

为了支持搜索，基于 H.264 的格式将元数据存储在所谓的 **moov atom** 中。它是保存整个文件索引信息文件的一部分。

要开始播放，播放器首先需要读取元数据。通过发送一个有 `start=0` 参数的特殊请求来完成的。许多编码软件在文件的末尾插入元数据。这对于伪流播来说很糟糕，因为播放器必须在开始播放之前下载整个文件。如果元数据位于文件的开头，那么 nginx 就可以简单地开始发回文件内容。如果元数据位于文件末尾，nginx 必须读取整个文件并准备一个新流，以便元数据位于媒体数据之前。这涉及到一些 CPU、内存和磁盘 I/O 开销，所以最好事先[准备一个用于伪流传输的原始文件][Link 1]，而不是让 nginx 在每个这样的请求上都这样处理。

该模块还支持设置播放结束点的 HTTP 请求（1.5.13）的 `end` 参数。`end` 参数可以与 `start` 参数一起指定或单独指定：

http://example.com/elephants_dream.mp4?start=238.88&end=555.55

对于有非零 `start` 或 `end` 参数的匹配请求，nginx 将从文件中读取元数据，准备有所需时间范围的流并将其发送到客户端 这与上面描述的开销相同。

如果匹配请求不包含 `start` 和 `end` 参数，则不会有开销，并且文件仅作为静态资源发送。有些播放器也支持 byte-range 请求，因此不需要这个模块。

该模块不是默认构建的，可以使用 `--with-http_mp4_module` 配置参数启用。

> 如果以前使用过第三方 mp4 模块，则应该禁用它。

ngx\_http\_flv\_module 模块提供了对 FLV 文件的类伪流式的支持。

## 示例配置 ##

location /video/ {
        mp4;
        mp4_buffer_size       1m;
        mp4_max_buffer_size   5m;
        mp4_limit_rate        on;
        mp4_limit_rate_after  30s;
    }

## 指令 ##

### mp4 ###

<table> 
 <thead> 
  <tr> 
   <th align="right">-</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="right"><strong>语法</strong></td> 
   <td><strong>mp4</strong>;</td> 
  </tr> 
  <tr> 
   <td align="right"><strong>默认</strong></td> 
   <td>——</td> 
  </tr> 
  <tr> 
   <td align="right"><strong>上下文</strong></td> 
   <td>location</td> 
  </tr> 
 </tbody> 
</table>

启用对 location 模块处理。

### mp4\_buffer\_size ###

<table> 
 <thead> 
  <tr> 
   <th align="right">-</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="right"><strong>语法</strong></td> 
   <td><strong>mp4_buffer_size</strong> <code>size</code>;</td> 
  </tr> 
  <tr> 
   <td align="right"><strong>默认</strong></td> 
   <td>mp4_buffer_size 512K;</td> 
  </tr> 
  <tr> 
   <td align="right"><strong>上下文</strong></td> 
   <td>http、server、location</td> 
  </tr> 
 </tbody> 
</table>

设置用于处理 MP4 文件的缓冲区的初始大小。

### mp4\_max\_buffer\_size ###

<table> 
 <thead> 
  <tr> 
   <th align="right">-</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="right"><strong>语法</strong></td> 
   <td><strong>mp4_max_buffer_size</strong> <code>time</code>;</td> 
  </tr> 
  <tr> 
   <td align="right"><strong>默认</strong></td> 
   <td>mp4_max_buffer_size 10M;</td> 
  </tr> 
  <tr> 
   <td align="right"><strong>上下文</strong></td> 
   <td>http、server、location</td> 
  </tr> 
 </tbody> 
</table>

在元数据处理期间，可能需要更大的缓冲区。它的大小不能超过指定的大小，否则 nginx 将返回 500（内部服务器错误）错误状态码，并记录以下消息：

"/some/movie/file.mp4" mp4 moov atom is too large:
    12583268, you may want to increase mp4_max_buffer_size

### mp4\_limit\_rate ###

<table> 
 <thead> 
  <tr> 
   <th align="right">-</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="right"><strong>语法</strong></td> 
   <td><strong>mp4_limit_rate</strong> <code>on</code> | <code>off</code> | <code>factor</code>;</td> 
  </tr> 
  <tr> 
   <td align="right"><strong>默认</strong></td> 
   <td>p4_limit_rate off;</td> 
  </tr> 
  <tr> 
   <td align="right"><strong>上下文</strong></td> 
   <td>http、server、location</td> 
  </tr> 
 </tbody> 
</table>

限制对客户响应的传输速率。速率限制基于所提供 MP4 文件的平均比特率。要计算速率，比特率将乘以指定的 `factor`。特殊值 `on` 对应于因子 1.1 。特殊值 `off` 禁用速率限制。限制是根据请求设置的，所以如果客户端同时打开两个连接，总体速率将是指定限制的两倍。

> 该指令可作为我们[商业订阅][Link 2]的一部分。

### mp4\_limit\_rate\_after ###

<table> 
 <thead> 
  <tr> 
   <th align="right">-</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="right"><strong>语法</strong></td> 
   <td><strong>mp4_limit_rate_after</strong> <code>time</code>;</td> 
  </tr> 
  <tr> 
   <td align="right"><strong>默认</strong></td> 
   <td>mp4_limit_rate_after 60s;</td> 
  </tr> 
  <tr> 
   <td align="right"><strong>上下文</strong></td> 
   <td>http、server、location</td> 
  </tr> 
 </tbody> 
</table>

设置媒体数据的初始数量（在回放时计算），之后进一步传输到客户端的响应将受到速率限制。

> 该指令可作为我们[商业订阅][Link 2]的一部分。

## 原文档 ##

[http://nginx.org/en/docs/http/ngx\_http\_mp4\_module.html][http_nginx.org_en_docs_http_ngx_http_mp4_module.html]

--------------------

# ngx\_http\_perl\_module #

*  指令
 *  已知问题
    
     *  perl
     *  perl\_modules
     *  perl\_require
     *  perl\_set
 *  从 SSI 调用 Perl
 *  $r 请求对象方法

`ngx_http_perl_module` 模块用于在 Perl 中实现 location 和变量处理器，并将 Perl 调用插入到 SSI中。

此模块不是默认构建，可以在构建时使用 `--with-http_perl_module` 配置参数启用。

> 该模块需要 [Perl][] 5.6.1 或更高版本。C 编译器应该与用于构建Perl 的编译器兼容。

## 已知的问题 ##

该模块还处于实验阶段，以下是一些注意事项。

为了让 Perl 能在重新配置过程中重新编译已修改的模块，应使用 `-Dusemultiplicity=yes` 或 `-Dusethreads=yes` 参数来构建它。另外，为了让 Perl 在运行时泄漏更少的内存，应使用 `-Dusemymalloc=no` 参数来构建它。要检查已构建的 Perl 中这些参数值（在示例中已指定首选值），请运行：

$ perl -V:usemultiplicity -V:usemymalloc
    usemultiplicity='define';
    usemymalloc='n';

请注意，在使用新的 `-Dusemultiplicity=yes` 或 `-Dusethreads=yes` 参数重新构建 Perl 之后，所有二进制 Perl 模块也必须重新构建 — 否则它们将停止使用新的 Perl。

在每次重新配置后，master 进程和 worker 进程都有可能增加。如果 master 进程增加到不可接受的大小，则可以使用实时升级流程而无需更改可执行文件。

当 Perl 模块执行长时间运行的操作时，例如解析域名、连接到另一台服务器或查询数据库时，将不会处理分配给当前 worker 进程的其他请求。因此，建议仅执行可预测且执行时间短的操作，例如访问本地文件系统。

## 示例配置 ##

http {
    
        perl_modules perl/lib;
        perl_require hello.pm;
    
        perl_set $msie6 '
    
            sub {
                my $r = shift;
                my $ua = $r->header_in("User-Agent");
    
                return "" if $ua =~ /Opera/;
                return "1" if $ua =~ / MSIE [6-9]\.\d+/;
                return "";
            }
    
        ';
    
        server {
            location / {
                perl hello::handler;
            }
        }

The perl/lib/hello.pm module:

package hello;
    
    use nginx;
    
    sub handler { 
        my $r = shift;
    
        $r->send_http_header("text/html");
        return OK if $r->header_only;
    
        $r->print("hello!\n<br/>");
    
        if (-f $r->filename or -d _) { 
            $r->print($r->uri, " exists!\n");
        }
    
        return OK;
    }
    
    1;
    __END__

## 指令 ##

### perl ###

<table> 
 <thead> 
  <tr> 
   <th align="right">-</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="right"><strong>语法</strong></td> 
   <td><strong>perl</strong> <code>module::function</code>|<code>'sub { ... }'</code>;</td> 
  </tr> 
  <tr> 
   <td align="right"><strong>默认</strong></td> 
   <td>——</td> 
  </tr> 
  <tr> 
   <td align="right"><strong>上下文</strong></td> 
   <td>location、limit_except</td> 
  </tr> 
 </tbody> 
</table>

给指定的 location 设置一个 Perl 处理程序。

### perl\_modules ###

<table> 
 <thead> 
  <tr> 
   <th align="right">-</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="right"><strong>语法</strong></td> 
   <td><strong>perl_modules</strong> <code>path</code>;</td> 
  </tr> 
  <tr> 
   <td align="right"><strong>默认</strong></td> 
   <td>——</td> 
  </tr> 
  <tr> 
   <td align="right"><strong>上下文</strong></td> 
   <td>http</td> 
  </tr> 
 </tbody> 
</table>

为 Perl 模块设置额外的路径。

### perl\_require ###

<table> 
 <thead> 
  <tr> 
   <th align="right">-</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="right"><strong>语法</strong></td> 
   <td><strong>perl_require</strong> <code>module</code>;</td> 
  </tr> 
  <tr> 
   <td align="right"><strong>默认</strong></td> 
   <td>——</td> 
  </tr> 
  <tr> 
   <td align="right"><strong>上下文</strong></td> 
   <td>http</td> 
  </tr> 
 </tbody> 
</table>

定义每次重新配置期间将要加载的模块的名称。可存在多个 `perl_require` 指令。

### perl\_set ###

<table> 
 <thead> 
  <tr> 
   <th align="right">-</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="right"><strong>语法</strong></td> 
   <td><strong>perl_set</strong> <code>$variable module::function</code>|<code>'sub { ... }'</code>;</td> 
  </tr> 
  <tr> 
   <td align="right"><strong>默认</strong></td> 
   <td>——</td> 
  </tr> 
  <tr> 
   <td align="right"><strong>上下文</strong></td> 
   <td>http</td> 
  </tr> 
 </tbody> 
</table>

为指定的变量安装一个 Perl 处理程序。

## 从 SSI 调用 Perl ##

使用 SSI 命令调用 Perl 的格式如下：

## $r 请求对象方法 ##

*  `$r->args`
    
    返回请求参数。
 *  `$r->filename`
    
    返回与请求 URI 相对应的文件名。
 *  `$r->has_request_body(handler)`
    
    如果请求中没有请求体，则返回 0。如果存在，则为请求设置指定的处理程序，并返回 1。在读取请求体后，nginx 将调用指定的处理程序。请注意，处理函数应该通过引用传递。例：
    
        package hello;
        
        use nginx;
        
        sub handler { 
            my $r = shift;
        
            if ($r->request_method ne "POST") { 
                return DECLINED;
            }
        
            if ($r->has_request_body(\&post)) { 
                return OK;
            }
        
            return HTTP_BAD_REQUEST;
        }
        
        sub post { 
            my $r = shift;
        
            $r->send_http_header;
        
            $r->print("request_body: \"", $r->request_body, "\"<br/>");
            $r->print("request_body_file: \"", $r->request_body_file, "\"<br/>\n");
        
            return OK;
        }
        
        1;
        
        __END__
 *  `$r->allow_ranges`
    
    在发送响应时启用字节范围。
 *  `$r->discard_request_body`
    
    指示 nginx 放弃请求体。
 *  `$r->header_in(field)`
    
    返回指定的客户端请求头字段的值。
 *  `$r->header_only`
    
    确定整个响应还是仅将头部发送给客户端。
 *  `$r->header_out(field, value)`
    
    为指定的响应头字段设置一个值。
 *  `$r->internal_redirect(uri)`
    
    做一个内部重定向到指定的 uri。在 Perl 处理程序执行完成后重定向。
    
    > 目前不支持重定向到具名 location。
 *  `$r->log_error(errno, message)`
    
    将指定的消息写入 error\_log。如果 `errno` 不为零，则错误码及其描述将被附加到消息中。
 *  `$r->print(text, ...)`
    
    将数据传递给客户端。
 *  `$r->request_body`
    
    如果尚未将请求体写入临时文件中，则返回客户端请求体。为了确保客户端请求体在内存中，其大小应该由 client\_max\_body\_size 来限制，并且应该使用 client\_body\_buffer\_size 来设置足够的缓冲区大小。
 *  `$r->request_body_file`
    
    客户端请求体返回文件的名称。处理完成后，该文件将被删除。要始终将请求体写入文件，应启用 client\_body\_in\_file\_only。
 *  `$r->request_method`
    
    返回客户端请求的 HTTP 方法。
 *  `$r->remote_addr`
    
    返回客户端 IP 地址。
 *  `$r->flush`
    
    立即向客户端发送数据。
 *  `$r->sendfile(name[, offset[, length]])`  
    将指定的文件内容发送到客户端。可选参数指定要传输的数据的初始偏移量（`offset`）和长度（`length`）。数据在 Perl 处理程序完成之后开始传输。
 *  `$r->send_http_header([type])`
    
    将响应头发送给客户端。可选的 `type` 参数用于设置 **Content-Type** 响应头字段的值。如果该值为空字符串，则不会发送 **Content-Type** 头字段。
 *  `$r->status(code)`
    
    设置响应状态码。
 *  `$r->sleep(milliseconds, handler)`
    
    设置指定的处理程序（`handler`）和指定停止请求处理的时间（`milliseconds`）。在此期间，nginx 继续处理其他请求。在经过指定的时间后，nginx 将调用已安装的处理程序。请注意，处理函数应该通过引用传递。为了在处理程序之间传递数据，应使用 `$r->variable()`。例：
    
        package hello;
        
        use nginx;
        
        sub handler { 
            my $r = shift;
        
            $r->discard_request_body;
            $r->variable("var", "OK");
            $r->sleep(1000, \&next);
        
            return OK;
        }
        
        sub next { 
            my $r = shift;
        
            $r->send_http_header;
            $r->print($r->variable("var"));
        
            return OK;
        }
        
        1;
        
        __END__
 *  `$r->unescape(text)`
    
    解码 **％XX** 格式编码的文本。
 *  `$r->uri`
    
    返回请求 URI。
 *  `$r->variable(name[, value])`
    
    返回或设置指定变量的值。对于每个请求来说这些变量都是本地变量。

## 原文档 ##

[http://nginx.org/en/docs/http/ngx\_http\_perl\_module.html][http_nginx.org_en_docs_http_ngx_http_perl_module.html]

[Link 1]: http://flowplayer.org/plugins/streaming/pseudostreaming.html#prepare
[Link 2]: http://nginx.com/products/?_ga=2.21542971.1499146730.1522076644-1859001452.1520648382
[http_nginx.org_en_docs_http_ngx_http_mp4_module.html]: http://nginx.org/en/docs/http/ngx_http_mp4_module.html
[Perl]: https://www.perl.org/get.html
[http_nginx.org_en_docs_http_ngx_http_perl_module.html]: http://nginx.org/en/docs/http/ngx_http_perl_module.html