Nginx的反向代理

Nginx的反向代理

反向代理：reverse proxy，可代理外网用户的请求到内部的指定web服务器，并将数据返回给用户
nginx除了可以在企业提供高性能的web服务之外，另外还可以将本身不具备的请求通过某种预定义的协议转发至其它服务器处理，不同的协议就是nginx服务器与其他服务器进行通信的一种规范
主要在不同的场景使用以下模块实现不同的功能：
	ngx_http_proxy_module： 将客户端请求以http协议转发至后端服务器
	ngx_http_fastcgi_module：将客户端对php请求以fastcgi协议转发至后端
	ngx_http_uwsgi_module：将客户端对Python请求以uwsgi协议转发至后端
	ngx_stream_proxy_module：将客户端请求以tcp协议转发至后端服务器

ngx_http_proxy_module

ngx_http_proxy_module模块：
    转发请求至另一台主机
	proxy_pass URL;
	注意：proxy_pass后面路径不带uri时，会将location的uri传递（附加）给后端主机
		server {
			...
			server_name HOSTNAME;
			location /uri/ {
				proxy_pass http://host[:port]; 注意：最后没有/ 
			}
			...
		}
	上面示例：http://HOSTNAME/uri --> http://host/uri ，功能类似 root
	如果上面示例中有 /，即：http://host[:port]/ 此方式较少使用
	意味着：http://HOSTNAME/uri --> http://host/ 即置换，功能类似 alias

proxy_pass后面的路径是一个uri时，其会将location的uri替换为proxy_pass的uri
	server {
		...
		server_name HOSTNAME;
		location /uri/ {
			proxy_pass http://host/new_uri/;
		}
		...
	}
	http://HOSTNAME/uri/ --> http://host/new_uri/

如果location定义其uri时使用了正则表达式的模式，则proxy_pass之后必须不能使用uri; 用户请求时传递的uri将直接附加至后端服务器之后
	server {
		...
		server_name HOSTNAME;
		location ~|~* /uri/ {
			proxy_pass http://host; 不能加/ 
		}
		...
	}
	http://HOSTNAME/uri/ --> http://host/uri/

proxy_set_header field value;
	设定转发往后端主机的请求报文的请求首部的值；
	Context: http, server, location
	proxy_set_header X-Real-IP $remote_addr;
	proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
		请求报文的标准格式如下：
		X-Forwarded-For: client1, proxy1, proxy2

proxy_cache_path;
	定义可用于proxy功能的缓存；Context：http
	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 #定义缓存保存路径，proxy_cache会自动创建 
	levels=1:2:2 #定义缓存目录结构层次，1:2:2 可以生成2^4x2^8x2^8=1048576个目录 
	keys_zone=proxycache:20m #指内存中缓存的大小，主要用于存放key和metadata（如：使用次数） 
	inactive=120s； #缓存有效时间 
	max_size=1g; #最大磁盘占用空间，磁盘存入文件内容的缓存空间最大值

proxy_cache zone | off; 默认off
	指明调用的缓存，或关闭缓存机制；Context:http, server, location
proxy_cache_key string;
	缓存中用于“键”的内容
	默认值：proxy_cache_key $scheme$proxy_host$request_uri; 
proxy_cache_valid [code ...] time;
	定义对特定响应码的响应内容的缓存时长
	定义在http{...}中
	示例:
	proxy_cache_valid 200 302 10m;
	proxy_cache_valid 404 1m;

示例：在http配置定义缓存信息
proxy_cache_path /var/cache/nginx/proxy_cache 
	levels=1:2:2 keys_zone=proxycache:20m 
	inactive=120s max_size=1g; 
说明：proxycache:20m 指内存中缓存的大小，主要用于存放key和metadata（如：使用次数） 
	max_size=1g 指磁盘存入文件内容的缓存空间最大值
调用缓存功能，需要定义在相应的配置段，如server{...}；
	proxy_cache proxycache;
	proxy_cache_key $request_uri;
	proxy_cache_valid 200 302 301 1h;
	proxy_cache_valid any 1m;

proxy_cache_use_stale;
	proxy_cache_use_stale error | timeout | invalid_header | updating | http_500 | http_502 | http_503 | http_504 | http_403 | http_404 | off ...
	在被代理的后端服务器出现哪种情况下，可直接使用过期的缓存响应客户端
proxy_cache_methods GET | HEAD | POST ...;
	对哪些客户端请求方法对应的响应进行缓存，GET和HEAD方法总是被缓存

proxy_hide_header field;
	用于隐藏后端服务器特定的响应首部，默认nginx在响应报文中不传递后端服务器的首部字段Date, Server, X-Pad, X-Accel等
	示例：
	proxy_hide_header Etag; 
proxy_pass_header field;
	默认nginx在响应报文中不传递后端服务器的首部字段Date, Server, X-Pad, XAccel等参数，如果要传递的话则要使用 proxy_pass_header field声明将后端服务器返回的值传递给客户端

ngx_http_headers_module

ngx_http_headers_module模块
	向代理服务器给客户端的响应报文添加自定义首部，或修改指定首部的值
add_header name value [always];
	添加自定义首部
	add_header X-Via $server_addr;
	add_header X-Cache $upstream_cache_status;
	add_header X-Accel $server_name; 
add_trailer name value [always];
	添加自定义响应信息的尾部， 1.13.2版后支持

proxy_connect_timeout time;
	定义与后端服务器建立连接的超时时长，如超时会出现502错误，默认为60s，一般不建议超出75s
proxy_send_timeout time;
	对后端服务器send，将请求发送给后端服务器的超时时长；默认为60s
proxy_read_timeout time;
	从后端服务器read，等待后端服务器发送响应报文的超时时长，默认为60s
proxy_ignore_client_abort off；
	当客户端网络中断请求时，nginx服务器中断其对后端服务器的请求。即如果此项设置为on开启，则服务器会忽略客户端中断并一直等着代理服务执行返回，如果设置为off，则客户端中断后nginx也会中断客户端请求并立即记录499日志，默认为off

proxy_http_version 1.0；
	用于设置nginx提供代理服务的HTTP协议的版本，默认http 1.0
proxy_headers_hash_bucket_size 128；
	当配置了 proxy_hide_header和proxy_set_header的时候，用于设置nginx保 存HTTP报文头的hash表的上限
proxy_headers_hash_max_size 512；
	设置proxy_headers_hash_bucket_size的最大可用空间
server_namse_hash_bucket_size 512; 
	server_name hash表申请空间大小
server_names_hash_max_size 512; 
	设置服务器名称hash表的上限大小