模块 ngx_http_gzip_static_module 允许发送以“.gz”作为文件扩展名的预压缩文件,以替代发送普通文件。 这个模块不是默认编译的,因此需要指定 --with-http_gzip_static_module 编译选项。 配置范例 gzip_static on; gzip_proxied expired no-cache no-store private auth; 指
ngx_http_charset_module模块为响应头的“Content-Type”添加指定的字符集。 此外,这个模块可以把数据从一个字符集转换为另一个字符集,但也有以下限制: 只能单向转换,即从服务端到客户端, 只有单字节字符集能被转换 或者单字节字符集和UTF-8之间的互相转换。 配置示例 include conf/koi-win; charset wind
ngx_http_addition_module 是一个过滤模块,它可以在回复正文前后加上内容。 这个模块默认不会编译进去,若要开启需加上编译选项:--with-http_addition_module。 配置示例 location / { add_before_body /before_action; add_after_body /after_action; } 指令 语
ngx_http_random_index_module模块在文件夹中随机选择一个文件作为默认页。 使用此模块前要先配置 ngx_http_index_module 模块。 nginx默认不编译这个模块, 需要开启 --with-http_random_index_module 编译选项。 配置示例 location / { random_index on; } 指令 语法: rand
ngx_http_limit_conn_module 模块可以按照定义的键限定每个键值的连接数。特别的,可以设定单一 IP 来源的连接数。 并不是所有的连接都会被模块计数;只有那些正在被处理的请求(这些请求的头信息已被完全读入)所在的连接才会被计数。 配置范例 http { limit_conn_zone $binary_remote_addr zone=addr:10m; .
模块ngx_http_mp4_module为H.264/AAC文件,主要是以 .mp4、.m4v、和.m4a为扩展名的文件, 提供伪流媒体服务端支持。 伪流媒体是与Flash播放器一起配合使用的。 播放器向服务端发送HTTP请求,请求中的查询串是以开始时间为参数的(以 start简单命名),而服务端以流响应,这样流的开始 位置就能于请求中的时间相对应。 例如: http://example.co
模块ngx_http_flv_module 为Flash Video(FLV)文件 提供服务端伪流媒体支持 通过返回以请求偏移位置开始的文件内容,该模块专门处理 在查询串中有start参数的请求, 和有预先设置到FLV头部的请求。 这个模块并不是默认构建的,必须通过配置参数 --with-http_flv_module 来启用。 配置范例 location ~ \.flv$ { flv;
ngx_http_referer_module模块允许拦截“Referer”请求头中含有非法值的请求,阻止它们访问站点。 需要注意的是伪造一个有效的“Referer”请求头是相当容易的, 因此这个模块的预期目的不在于彻底地阻止这些非法请求,而是为了阻止由正常浏览器发出的大规模此类请求。 还有一点需要注意,即使正常浏览器发送的合法请求,也可能没有“Referer”请求头。 配置实例 valid_r
模块ngx_http_auth_basic_module 允许使用“HTTP基本认证”协议验证用户名和密码来限制对资源的访问。 也可以通过 地址来限制访问。 使用satisfy 指令就能同时通过地址和密码来限制访问。 配置范例 location / { auth_basic "closed site"; auth_basic_user_file conf/ht
模块 ngx_http_access_module 允许限制某些IP地址的客户端访问。 也可以通过 密码来限制访问。 使用 satisfy 指令就能同时通过IP地址和密码来限制访问。 配置范例 location / { deny 192.168.1.1; allow 192.168.1.0/24; allow 10.1.1.0/16; allow 2001:0d
ngx_http_geo_module 模块创建变量,并根据客户端IP地址对变量赋值。 配置示例 geo $geo { default 0; 127.0.0.1/32 2; 192.168.1.0/24 1; 10.1.0.0/16 1; } 指令 语法: geo [$address] $variable { ... } 默认值: — 上
ngx_http_rewrite_module模块允许正则替换URI,返回页面重定向,和按条件选择配置。 ngx_http_rewrite_module模块指令按以下顺序处理: 处理在server级别中定义的模块指令; 为请求查找location; 处理在选中的location中定义的模块指令。如果指令改变了URI,按新的URI查找location。这个循环至多重复10次,之后nginx返回错误5
ngx_http_log_module模块按指定的格式写访问日志。 请求在处理结束时,会按请求路径的配置上下文记访问日志。 如果在请求处理期间产生了内部跳转, 请求结束时的路径可能不同于原始的请求路径。 配置实例 log_format gzip '$remote_addr - $remote_user [$time_local] ' '"$request" $st
ngx_http_image_filter_module 模块(0.7.54+)是一个 过滤器,它可以对JPEG,GIF和PNG等图像进行变换。 这个模块并不是默认编译的,需要通过 --with-http_image_filter_module编译选项来启用。 这个模块使用了 libgd 库。 推荐使用这个库可用的最新版本;在写这个文档时它的最新版本是2.0.35。 配置例子 location
ngx_http_upstream_module模块 允许定义一组服务器。它们可以在指令proxy_pass、 fastcgi_pass和 memcached_pass中被引用到。 配置例子 upstream backend { server backend1.example.com weight=5; server backend2.example.com:8080