基本配置格式

Nginx全局配置参数

使用include文件

HTTP的server部分

虚拟服务器部分

location —— where,when,how。

mail的server部分。

完整的示例配置文件。

基本配置格式:

Nginx的配置文件由若干部分组成,每一个部分都是通过下列方法定义的。

<section> {
  <directive>  <parameters>
}

每一个指令行都由分号结束,这标记着一行的结束。大括号实际上表示一个新配置的上下文,但是在大多数情况下,将他们作为“节、部分(section)”来读。

Nginx全局配置参数

全局配置部分包含配置指令,例如:user和worker_processes,也包括“节,部分(section)”。例如:events,

nginx useragent 含空格 nginx的include_nginx useragent 含空格

 使用include文件

在Nginx配置文件中,include文件可以在任何地方,以便增强配置文件的可读性。

在路径中出现通配符,表示可以配置多个问价。

include /opt/local/etc/nginx/vhost/*.conf

如果没有给定全路径,Nginx将会依据它的主配置文件路径进行搜索。Nginx测试配置文件很容易,通过下面的命令来完成。

Nginx -t -c <path-to-nginx.conf>

该命令将测试Nginx的配置文件,包括include文件,但是它只检查语法错误。

HTTP的server部分

在HTTP中,server部分或者HTTP配置context是可用的,除非在编译安装Nginx时没有包含HTTP模块(也就是使用了--without-http)。

1、客户端指令

 

nginx useragent 含空格 nginx的include_nginx useragent 含空格_02

 

nginx useragent 含空格 nginx的include_Nginx_03

2、文件I/O指令

这些指令用于控制Nginx如何投递静态文件以及如何管理文件描述符。

nginx useragent 含空格 nginx的include_Nginx_04

nginx useragent 含空格 nginx的include_配置文件_05

3、Hash指令

这组hash指令控制Nginx分配给某些变量多大的静态内存。在启动和重新配置时,Nginx会计算需要的最小值。在Nginx发出警告时,只需要调整一个*_hash_max_size指令的参数值就可以达到效果。*_hash_bucket_size变量被设置了默认值,以便满足多处理器缓存行降低检索所需要的检索查找,因此基本不需要改变,额外更详细的内容参考http://nginx.org/en/docs/hash.html。

nginx useragent 含空格 nginx的include_配置文件_06

4、socket指令

socket指令描述了Nginx如何设置创建TCP套接字的变量选项。

nginx useragent 含空格 nginx的include_nginx useragent 含空格_07

nginx useragent 含空格 nginx的include_nginx useragent 含空格_08

虚拟服务器部分

  任何有关键字server开始的部分都被称作“虚拟服务器”部分。它描述的是一组根据不同的server_name指令逻辑分割的资源,这些虚拟服务器响应HTTP请求,因此他们都包含在http部分中。

  一个虚拟服务器有listen和server_name指令组合定义,listen指令定义了一个IP地址/端口组合或者是UNIX域套接字路径。

  listen address [:port);
  listen port;
  listen unix:path;

  如图,listen指令唯一地标识了在Nginx下的套接字绑定,此外还有一些其他的可选参数。

nginx useragent 含空格 nginx的include_nginx useragent 含空格_09

server_name指令是相当简单的,但可以用来解决一些配置问题。它的默认值为“”,这意味着server部分没有server_name指令,对于没有设置host头字段的请求,它将会匹配该server处理。这种情况可用于如丢弃这种缺乏host头的请求。

server {
  listen  80;
  return  444;}

在这个例子中,使用的HTTP非标准代码444将会使得Nginx立即关闭一个连接。

除了普通的字符串之外,Nginx也接受通配符作为server_name指令的参数。

  • 通配符可以替代部分子域名:*.example.com
  • 通配符可以替代部分顶级域:www.example.*
  • 一种特殊形式将匹配子域或域本身:.example.com(匹配*.example.com也包括example.com)

通过在域名前面加上波浪号(~),正则表达式也可以被作为参数应用于server_name。

server_name ~"www\.example\.com$;
server_name ~"www(\d+) .example\. (com)$;

  后一种形式是利用捕获,可以在以后引用中进一步配置($1、$2等)指令中使用。

  对于一个特定的请求,确定哪些虚拟服务器提供该请求的服务时,Nginx应该遵循下面的逻辑。

  1、匹配IP地址和listen指令指定的端口。

  2、将Host头字段作为一个字符串匹配server_name指令。

  3、将host头字段与server_name指令值字符串的开始部分做匹配。

  4、将host头字段与server_name指令值字符串的结尾部分做匹配。

  5、将host头字段与server_name指令值进行正则表达式匹配。

  6、如果所有host头匹配失败,那么将会转向listen指令标记的default_server。

  7、如果所有的host头匹配失败,并且没有default_server,那么将会转向第一个server的listen指令,以满足第一步。

这个逻辑体现在图2-1中。

  参数default_server被用于处理其他没有被处理的请求。因此,总是明确的推荐设置default_server,以便这些没有被处理的请求通过这种定义的方式处理。

nginx useragent 含空格 nginx的include_配置文件_10

除了这个用法外,default_server也可以使用同样的listen指令配置若干个虚拟服务器。

这里设置的任何指令都将会在匹配的server区段有效。

 

 Locations——where,when,how

location指令可以用在虚拟服务器server部分,并且意味着提供来自客户端的URI或者内部重定向访问。除少数情况外,location也可以被嵌套使用,他们被作为特定的配置尽可能的处理请求。

  location定义如下。

location [modifier] uri {...}

或者是命名location。

location  @name  {...}

命名location仅对内部访问重定向,在进入一个location之前,他会保留被请求的URI部分。命名location只能在server级别定义。

nginx useragent 含空格 nginx的include_服务器_11

   当一个请求进入时,URI将会被检测匹配一个最佳的location。

  • 没有正则表达式的location被作为最佳的匹配,独立于含有正则表达式的location顺序。
  • 在配置文件中按照查找顺序进行正则表达式匹配。在查找到第一个正则表达式匹配之后结束查找。由这个最佳的location提供请求处理。

  这里比较匹配描述的是解码URI,例如,在URI中的“%20”,将会匹配location中的“ ”(空格)。

  命名location仅可以在内部重定向的请求中使用。表2-8中的指令仅在location中使用。

nginx useragent 含空格 nginx的include_服务器_12

  另外,http部分的其他指令也可以在location中指定,附录A指令参考有完整列表。

   指令try_files在这里也值得一提,它也可以用在server部分,但是最常见的还是在location部分中。try_file指令将会按照给定它的参数列出顺序进行尝试,第一个被匹配的将会被使用。它经常被用于从一个变量去匹配一个可能的文件,然后将处理传递到一个命名location,如下面的示例所示。

location  I {
    try _ files $uri $uri @mongrel;
}
location  @mongrel  {
    proxy _ pass  http://appserver;
}

  在这里有一个隐含的目录索引,如果给定的URI作为一个文件没有被找到,那么处理将会通过代理被传递到APPserver。我们将会在本书的其他部分讨论如何最好地使用location、try_files和proxy_pass来解决特定的问题。

  除以下前缀外,location可以被嵌套。

  •  具有“=”前缀。
  • 命名location。

最佳实践表明正则表达式location被嵌套在基于字符串的location内,如下面的示例所示。

#first, we enter through the root
location / {
  # then we find a most-specific substring
  #  note  that  this  is  not  a  regular  expression
  location  A ~/ css  {
    #  here  is  the  regular  expression  that  then  gets  matched
    location  ~*  /css/ . *\.css$  {    }
  }
}

 

小结

server来定义每一个请求如何被处理,以便请求被路由到特定的IP地址和端口上;

使用locations来匹配URI请求,这些location可以被嵌套使用,或者按其它顺序使用。