Nginx 的配置系统由一个主配置文件和其他一些辅助的配置文件构成。这些配置文件均是纯文本文件，全部位于 Nginx 安装目录下的 conf 目录下

配置文件中以 # 开始的行，或者是前面有若干空格或者 TAB，然后再跟 # 的行，都被认为是注释；

配置文件中可以包含若干配置项，每个配置项由 “配置指令” 和 “指令参数” 2个部分构成，并以 ; 结尾，指令参数也就是配置指令对应的配置值。举个例子：

# 这一行是注释，下一行中的 error_page 为 “配置指令”，其后跟着的是对应的 “指令参数”
error_page   500 502 503 504  /50x.html;

配置指令

配置指令分为两种：

• 简单配置指令：指令的参数全部由简单字符串构成，不包含复合配置块，上述的 “error_page” 即为简单配置项；

• 复杂配置指令：包含复合配置块，复合配置块是由 {} 括起来的一堆指令，其中可能包含一个或多个简单配置指令和复杂配置指令，例如：

events {worker_connections   1024;
}

指令参数

指令的参数使用一个或者多个空格或者 TAB 字符与指令分开，由一个或者多个 TOKEN 字符串组成，TOKEN 字符串之间由空格或者TAB键分隔开来；

指令上下文

复杂配置指令中的 http、location、server、mail 会产生指令上下文，指令上下文存在嵌套关系，比如：

# main 上下文
user  nginx;
worker_processes  1;
error_log  logs/error.log  info;events {worker_connections  1024;
}http {server {listen          80;server_name     www.example.com;location / {index index.html;}}
}mail {auth_http  127.0.0.1:80/auth.php;pop3_capabilities  "TOP"  "USER";imap_capabilities  "IMAP4rev1"  "UIDPLUS";server {listen     110;protocol   pop3;proxy      on;}
}

main 上下文主要用来配置与具体的业务（http 或者邮件）无关的逻辑，比如例子中的：

• error_log 配置错误日志路径；

• worker_processes worker 进程数

• user 指定可以运行 Nginx 服务的用户和用户组；

• events 配置 Nginx 服务器与用户的网络连接，比如上述 worker_connections 用来配置 worker 进程可以同时支持的最大连接数；

main 上下文中还包含了 http 指令，http 是 Nginx 服务器配置中最重要的部分，代理、缓存等绝大多数功能和第三方模块的配置都可以放到这个模块中来；mail 可用来定义电子邮件代理服务器相关的配置；

常见指令

include

从其他文件引入配置，可用来对复杂的 Nginx 配置做拆分；

# main 上下文
user  nginx;
worker_processes  1;
error_log  logs/error.log  info;events {worker_connections  1024;
}http {server {listen          80;server_name     www.example.com;location / {index index.html;}}include /etc/nginx/conf.d/*.conf;
}

server

server 块用来配置 “虚拟服务器” ，每一个 server 块都相当于一台 “虚拟服务器”，“虚拟服务器” 是一个与实体服务器相对应的概念，将一台实体服务器进行划分，对外表现为多个服务器，可以充分利用服务器的硬件资源，并且可以不用为每一个要运行的网站提供单独的 Nginx 服务器；

server {listen 80;server_name a.com;location / {proxy_pass https://www.baidu.com;}
}
server {listen 80;server_name b.com;location / {proxy_pass https://www.google.com;}
}

server 中最重要的两条指令为 listen 和 server_name ，这两条指令共同决定了一个请求究竟会打到哪一个 “虚拟服务器中”；

listen

用来配置 “虚拟服务器” 监听的 ip 和 port，只能配置在 server 块中，具体语法：

# 只监听来自 127.0.0.1 这个 IP，请求 8000 端口的请求
listen 127.0.0.1:8000;
# 只监听来自 127.0.0.1 这个IP，请求 80端 口的请求（不指定端口，默认80）
listen 127.0.0.1;
# 监听来自所有 IP，请求 8000 端口的请求
listen 8000;
# 监听 80 端口的请求，且如果没有其他 server_name 能匹配上的话将会默认匹配该 server
listen 80 default_server;

server_name

用来配置 “虚拟服务器” 的网址，只能配置在 server 块中，具体语法：

server_name    myserver.com    www.myserver.com;
# 还可以使用通配符 *
server_name    myserver.*    *.myserver.com;
# 还可以使用正则
server_name    ~^(?<www>.+).example.org$;

存在通配符以及正则的话，则存在多个 server_name 被同时匹配上的可能，当有多个匹配上的话，会按照下面的优先级来决定请求打到哪一个 “虚拟服务器”：

1. 准确匹配的 server_name；

2. 通配符在开始时匹配的 server_name；

3. 通配符在结尾时匹配的 server_name；

4. 正则表达式匹配的 server_name；

server 中使用 listen 和 server_name 来区分 “虚拟服务器”，location 指令则让 server 可以非常灵活的处理请求；

location 的语法结构：

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

location 有五种匹配方式：

空	location 后没有参数直接跟着 标准 URI，表示前缀匹配，代表跟请求中的 URI 从头开始匹配；
=	用于标准 URI 前，要求请求字符串与其精准匹配，成功则立即处理，nginx停止搜索其他匹配。
^~	用于标准 URI 前，并要求一旦匹配到就会立即处理，不再去匹配其他的那些个正则 URI，一般用来匹配目录
~	用于正则 URI 前，表示 URI 包含正则表达式，区分大小写
~*	用于正则 URI 前，表示 URI 包含正则表达式，不区分大小写

Nginx 中不会直接按照 location 出现的先后顺序进行匹配，而是按照下面的规则进行匹配：

1. 先精准匹配 = ，精准匹配成功则会立即停止其他类型匹配；
2. 没有精准匹配成功时，进行前缀匹配。先查找带有 ^~ 的前缀匹配，带有 ^~ 的前缀匹配成功则立即停止其他类型匹配，普通前缀匹配（不带参数  ^~  ）成功则会暂存，继续查找正则匹配；
3. = 和 ^~ 均未匹配成功前提下，查找正则匹配 ~ 和 ~* 。当同时有多个正则匹配时，按其在配置文件中出现的先后顺序优先匹配，命中则立即停止其他类型匹配；
4. 所有正则匹配均未成功时，返回步骤 2 中暂存的普通前缀匹配（不带参数  ^~  ）结果；
5. 所有匹配都不命中时，默认进入 / ；

rewrite 和 proxy_pass

rewrite 可以出现在 server、location、if 块中，用来改写请求地址，具体的语法如下：

rewrite regex replacement [last|break|redirect|permanent];

proxy_pass 只能出现在 location、if 块中，用来将请求转发至对应的服务，具体语法如下：

proxy_pass uri;

举个例子：

server {rewrite /a.html /b.html break;return 200 'ok';location /a.html {return 200 'a.html';}location /b.html {return 200 'b.html';}location /c.html {proxy_pass http://www.google.com;}
}

使用场景

域名 -> 域名

将某一个域名的请求在本地拦截之后，转发到 nginx 中，nginx 将请求转发到其他域名；

server {listen 80;server_name www.baidu.com;location / {proxy_pass http://www.google.com;}
}

域名 -> 本地 ip

将某一个域名的请求拦截之后，转到到 nginx 中，nginx 将对应的请求打到本地的其他 ip；

server {listen 80;server_name www.baidu.com;location / {proxy_pass http://127.0.0.1:8001;}
}

路径 -> 域名

根据不同路径将请求转发至不同的域名；

server {listen 80;server_name www.baidu.com;location ^~ /to_google {proxy_http_version 1.1;rewrite .* /;proxy_pass http://google.com/;}
}

接口跨域

解决前端本地开发环境调用线上接口时跨域的问题；

server {listen 80;location ^~ /api {proxy_pass http://example.com;add_header Access-Control-Allow-Methods *;add_header Access-Control-Max-Age 3600;add_header Access-Control-Allow-Credentials true;add_header Access-Control-Allow-Origin $http_origin;if ($request_method = OPTIONS){return 200;}}
}