Nginx 【location配置路径详解、反向代理、负载均衡】_nginx 代理 location

前言

在使用nginx时，我们配置最多的就是location项了。方向代理、负载均衡、静态资源服务器这些高频使用的共能点，几乎主要都在location配置。本文内容将包含上诉功能，并详细介绍location的匹配规则。

一、匹配语法及规则

1.基本语法

location [=|^~|~|~*] uri {
	...
}
1
2
3

location的匹配语法分成两个部分，[]括号中的是匹配符，决定以何种方式进行匹配，uri表示请求路径,例如http://www.baidu.com:8888/index/abc的uri就是/index/abc

---

2.匹配修饰符

匹配修饰符分为两种字符串匹配：= ^~和正则匹配：~ ~*
注意下面表格中的优先级描述是针对同类型匹配规则的描述，不同类型匹配优先级，请看匹配优先级[^1]

字符串匹配

• 字符串匹配不区分大小写 location = /index 同时匹配 /index | /INDEx
• location = index | location ^~ index 不能匹配 /index ,因为字符串匹配是从uri开头开始匹配的
• 如果没有使用匹配修饰符，则默认为普通匹配，如： location /index 等效于 location ^~ /index

正则匹配

如果想从uri最开头进行匹配则可以通过控制正则表达式来实现 location ~ ^/index$,只匹配/index

内部定义 @

在使用过程我们一般还会使用@符号，它的作用相当于一个跳转规则的变量

location /index {
	error_page 404 @index_error; // 如果没有匹配到服务 则使用@index_error的跳转规则
}

location @index_error{
	...
}
1
2
3
4
5
6
7

---

3.匹配优先级

=为精准匹配、^~为普通匹配 、 ~ ~*为正则匹配

二、常用的一些操作

1.url反向代理

location /index {
	// 这里只能替换ip和端口,即便设置成http://127.0.0.1:80/index2 也只替换ip和端口
	proxy_pass http://127.0.0.1:80; 
	
	rewrite /index /index2 break;
	// 使用正则表达式 $1为匹配到的值，在此为/index,本语句将/index => /index/index2
	rewrite ^\/index $1/index2;
}
1
2
3
4
5
6
7
8

---

• 1.rewrite

是一个比较常用的指令，它的语法是这样的

rewrite regex|string replacement [flag];
1

---

• 2.控制请求头

location /index {
	add_header key value; # 添加自定义响应头
	// 反向代理
	proxy_set_header key value; # 反向代理，向目标服务器转发的请求添加请求头
	proxy_hide_header key; # 反向代理，隐藏目标服务器响应头字段
	
}
1
2
3
4
5
6
7

小提示：

• 有时候明明设置了响应头，但是前端确没有得到，那是因为浏览器约束了前端能够获取到的响应头字段，可以通过色设置Access-Control-Expose-Headers:headerKey,headerKey2响应头进行放开
• nginx进行代理时会将请求头字段及参数全量传递给下一级服务器

请注意! add_header只会在最底层生效，如果你在server 和 server内部的location中都定义了add_header。那么只有最底层的location中的add_header会生效

server {
	add_header key val; # 如果底层存在add_header语句，则此语句不生效
	location / {
		add_header key2 val;
	}
}
1
2
3
4
5
6

---

2.负载均衡

一个基本的负载均衡配置

http {
	# 建立模拟服务器
	server {
		listen 3001;
		server_name 127.0.0.1;
		location / {
			return 200 <p>服务器3001</p>;
		}
	}

	server {
		listen 3002;
		server_name 127.0.0.1;
		location / {
			return 200 <p>服务器3002</p>;
		}
	}

	server {
		listen 3003;
		server_name 127.0.0.1;
		location / {
			return 200 <p>服务器3003</p>;
		}
	}
	
	# 定义服务器上游 名为myServerName
	upstream myServerName {
		server 127.0.0.1:3001 weight=1; # weight表权重,这里有 1 / (1+1+1)的几率访问到这个服务器
		server 127.0.0.1:3002 weight=1;
		server 127.0.0.1:3003 weight=1;
	}

	# 访问服务器
	server {
		listen 3000;
		server_name 127.0.0.1;
		location / {
			proxy_pass http://myServerName break; # 这里myServerName 为上游服务器名
		}
		
	}
	
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

上面的配置只包含了最基础的负载均衡处理，一个成熟的负载均衡策略应该还要包含以下几点特性：

• 热备：当主服务器出现问题时，应该自动将请求转发至备用服务器
• 分配策略：不同的情况应该有不同的分配策略，详细情况下面会有表格描述
• 服务器超时处理：当某一个或多个服务器处理请求长时间无响应时，
• 服务器宕机处理

以上这些特性都可以在upstream项中进行配置

upstream myServerName {
	server 127.0.0.1:3004 backup; # 热备
	server 127.0.0.1:3005 down; #宕机 暂不参与负载均衡
	server 127.0.0.1:3006 max_fails=5 fail_timeout=300; # 失败次数5次之后 停止负载均衡300秒； max_fails默认1 fail_timeout默认10
}
1
2
3
4
5

分配策略有多种，这里我们列一个表格预览

还有一种第三方的负载均衡策略，可以根据页面大小、加载时间长短智能地进行负载均衡。它的使用需要第三方模块的支持
下载地址

https://github.com/gnosek/nginx-upstream-fair
1

解压\重命名

unzip nginx-upstream-fair-master.zip
mv nginx-upstream-fair-master fair
1
2

编译

./configure --add-module=/root/fair # nginx加入模块
make # 编译
1
2

在编译的过程中可能出现

error // nginx_http_upstream_srv_conf_t结构中缺少default_port

// 解决方案

# step1:在Nginx的源码中src/http/nginx_http_upstream.h，找到ngx_http_upstream_srv_conf_s，
# step2:在模块中添加default_port属性：in_port_t default_port
1
2
3
4
5
6

然后再进行make。

更新nginx

#step1:将sbin目录下的nginx进行备份
mv /usr/local/nginx/sbin/nginx /usr/local/nginx/sbin/nginxold
 
#step2:将安装目录下的objs中的nginx拷贝到sbin目录
cd objs
cp nginx /usr/local/nginx/sbin
 
#step3:更新
cd ../
1
2
3
4
5
6
7
8
9

使用

upstream myServerName {
	fair;
	server 127.0.0.1:3001;
}
1
2
3
4

三、set、if 语句

if 可以作为判断语句，set可以定义内部变量。它们的放置位置为server、location、if。
定义的变量也是有作用域的，定义在location中的变量不能被它的外层位置server中引用，定义在server中的位置可以被内层中location引用

location /index {
	
	set $key value; # 变量名需要以$开头
	set $key2 $key;# 使用其他变量作值
	set $key3 $host;# 使用内置变量
	
	
	
	if ($key = 1) {
		return 101;
	}
	
	# 正则匹配 正则匹配值必须使用双引号包裹
	if($key ~ "123"){
		return 102;
	}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

---

四、语句的放置位置

location>if 表示location块下面的if块

五、常用的location 配置项

location / {
	root html;
	index index.html index.hml;
	
	try_files $uri /filePath...;
}
1
2
3
4
5
6

六、nginx常用命令

window

start nginx  或  nginx.exe # 启动nginx
nginx.exe -s stop # 停止当前启动的nginx
nginx.exe -s reload # 重启nginx
tasklist /fi "imagename eq nginx.exe" # 查看当前nginx进程
tasklist /fi "imagename eq nginx.exe" # 查看所有nginx进程
taskkill /f /t /im nginx.exe # 停止所有nginx进程
1
2
3
4
5
6

---

七、常用的内置变量