ngx_http_mp4_module
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 开销,所以最好事先准备一个用于伪流传输的原始文件,而不是让 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
- | 说明 |
---|---|
语法 | mp4; |
默认 | —— |
上下文 | location |
启用对 location 模块处理。
mp4_buffer_size
- | 说明 |
---|---|
语法 | mp4_buffer_size size ; |
默认 | mp4_buffer_size 512K; |
上下文 | http、server、location |
设置用于处理 MP4 文件的缓冲区的初始大小。
mp4_max_buffer_size
- | 说明 |
---|---|
语法 | mp4_max_buffer_size time ; |
默认 | mp4_max_buffer_size 10M; |
上下文 | http、server、location |
在元数据处理期间,可能需要更大的缓冲区。它的大小不能超过指定的大小,否则 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
- | 说明 |
---|---|
语法 | mp4_limit_rate on | off | factor ; |
默认 | p4_limit_rate off; |
上下文 | http、server、location |
限制对客户响应的传输速率。速率限制基于所提供 MP4 文件的平均比特率。要计算速率,比特率将乘以指定的 factor
。特殊值 on
对应于因子 1.1 。特殊值 off
禁用速率限制。限制是根据请求设置的,所以如果客户端同时打开两个连接,总体速率将是指定限制的两倍。
该指令可作为我们商业订阅的一部分。
mp4_limit_rate_after
- | 说明 |
---|---|
语法 | mp4_limit_rate_after time ; |
默认 | mp4_limit_rate_after 60s; |
上下文 | http、server、location |
设置媒体数据的初始数量(在回放时计算),之后进一步传输到客户端的响应将受到速率限制。
该指令可作为我们商业订阅的一部分。
原文档
http://nginx.org/en/docs/http/ngx_http_mp4_module.html
ngx_http_perl_module
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
- | 说明 |
---|---|
语法 | perl module::function |'sub { ... }' ; |
默认 | —— |
上下文 | location、limit_except |
给指定的 location 设置一个 Perl 处理程序。
perl_modules
- | 说明 |
---|---|
语法 | perl_modules path ; |
默认 | —— |
上下文 | http |
为 Perl 模块设置额外的路径。
perl_require
- | 说明 |
---|---|
语法 | perl_require module ; |
默认 | —— |
上下文 | http |
定义每次重新配置期间将要加载的模块的名称。可存在多个 perl_require
指令。
perl_set
- | 说明 |
---|---|
语法 | perl_set $variable module::function |'sub { ... }' ; |
默认 | —— |
上下文 | http |
为指定的变量安装一个 Perl 处理程序。
从 SSI 调用 Perl
使用 SSI 命令调用 Perl 的格式如下:
<!--# perl sub="module::function" arg="parameter1" arg="parameter2" ...
-->
$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])
返回或设置指定变量的值。对于每个请求来说这些变量都是本地变量。