一、ngx_http_proxy_module模块
ngx_http_proxy_module模块可根据用户请求的uri传递至后端服务器,实现反向代理
命令:
1.proxy_pass
设置一个代理服务器的地址,协议,和一个可选的URI的位置应该映射。作为一个协议,“HTTP”或“https”可以指定。地址可以被指定为一个域名或IP地址,和一个可选的端口
语法:proxy_pass URL;
可用的上下文:location, if in location, limit_except
注意:proxy_pass后面的路径不带uri时,其会将location的uri传递给后端主机;proxy_pass后面的路径是一个uri时,其会将location的uri替换为proxy_pass的uri;如果location定义其uri时使用了正则表达式的模式,则proxy_pass之后必须不能使用uri; 用户请求时传递的uri将直接附加代理到的服务的之后;
2.proxy_set_header
设定发往后端主机的请求报文的请求首部的值
语法:proxy_set_header FIELD VALUE;
可用的上下文:http, server, location
示例:
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
3、proxy_cache_path
定义可用于proxy功能的缓存
语法:proxy_cache_path path [levels=levels] [use_temp_path=on|off] keys_zone=name:size [inactive=time] [max_size=size] [manager_files=number] [manager_sleep=time] [manager_threshold=time] [loader_files=number] [loader_sleep=time] [loader_threshold=time] [purger=on|off] [purger_files=number] [purger_sleep=time] [purger_threshold=time];
可用上下文:http
示例:
proxy_cache_path /var/cache/nginx/proxy_cache levels=1:1:1 keys_zone=pxycache:20m max_size=1g;
4、proxy_cache
指明要调用的缓存,或关闭缓存机制
语法:proxy_cache ZONE | off;
可用上下文:http, server, location
5、proxy_cache_key
缓存中用于“键”的内容;
语法:proxy_cache_key STRING;
默认值:proxy_cache_key $scheme$proxy_host$request_uri;
可用上下文:http, server, location
6、proxy_cache_valid
定义对特定响应码的响应内容的缓存时长;
语法:proxy_cache_valid [code ...] time;
可用上下文:http, server, location
示例:
定义在http{...}当中
proxy_cache_path /var/cache/nginx/proxy_cache levels=1:1:1 keys_zone=pxycache:20m max_size=1g;
定义在需要调用缓存功能的配置段,例如server{...}
proxy_cache pxycache;
proxy_cache_key $request_uri;
proxy_cache_valid 200 302 301 1h;
proxy_cache_valid any 1m;
7、proxy_cache_use_stale
不确定缓存的响应可以用代理服务器的通信过程中出现错误时,使用该指令的参数匹配的proxy_next_upstream指令的参数
语法:proxy_cache_use_stale error | timeout | invalid_header | updating | http_500 | http_502 | http_503 | http_504 | http_403 | http_404 | off ...;
可用上下文:http, server, location
8、proxy_cache_methods
如果客户端请求方法在这个指令中列出,那么响应将被缓存。“获取”和“头”的方法总是添加到列表中,虽然建议明确指定它们。又见proxy_no_cache指令。
语法:proxy_cache_methods GET | HEAD | POST ...;
可用上下文:http, server, location
9、proxy_hide_header
隐藏所定义的首部,用户不可见
语法:proxy_hide_header FIELD;
可用上下文:http, server, location
10、proxy_connect_timeout
定义了用于建立与代理服务器连接超时,这个超时通常不能超过75秒。
语法:proxy_connect_timeout time;
可用上下文:http, server, location
11、proxy_buffers
集数和用于从代理服务器读取响应缓冲区的大小,为一个单一的连接。默认情况下,缓冲区大小等于一个内存页,4K或8K
语法:proxy_buffers NUMBER SIZE;
可用上下文:http, server, location
二、ngx_http_headers_module模块