全局变量

    变量 说明 变量 说明
    $args 这个变量等于请求行中的参数,同$query_string $remote_port 客户端的端口。
    $content_length 请求头中的Content-length字段。 $remote_user 已经经过Auth Basic Module验证的用户名。
    $content_type 请求头中的Content-Type字段。 $request_filename 当前请求的文件路径,由root或alias指令与URI请求生成。
    $document_root 当前请求在root指令中指定的值。 $scheme HTTP方法(如http,https)。
    $host 请求主机头字段,否则为服务器名称。 $server_protocol 请求使用的协议,通常是HTTP/1.0或HTTP/1.1。
    $http_user_agent 客户端agent信息 $server_addr 服务器地址,在完成一次系统调用后可以确定这个值。
    $http_cookie 客户端cookie信息 $server_name 服务器名称。
    $limit_rate 这个变量可以限制连接速率。 $server_port 请求到达服务器的端口号。
    $request_method 客户端请求的动作,通常为GET或POST。 $request_uri 包含请求参数的原始URI,不包含主机名,如:/foo/bar.php?arg=baz。
    $remote_addr 客户端的IP地址。 $uri 不带请求参数的当前URI,$uri不包含主机名,如/foo/bar.html。
    $document_uri 与$uri相同。 - -

    例如请求:http://localhost:3000/test1/test2/test.php

    $host:localhost
    $server_port:3000
    $request_uri:/test1/test2/test.php
    $document_uri:/test1/test2/test.php
    $document_root:/var/www/html
    $request_filename:/var/www/html/test1/test2/test.php

    例如,”8k”,”1m” 代表字节数计量。
    例如,”1h 30m”,”1y 6M”。代表 “1小时 30分”,”1年零6个月”。

    配置文件

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

    指令由 nginx 的各个模块提供,不同的模块会提供不同的指令来实现配置。
    指令除了 Key-Value 的形式,还有作用域指令。

    nginx.conf 中的配置信息,根据其逻辑上的意义,对它们进行了分类,也就是分成了多个作用域,或者称之为配置指令上下文。不同的作用域含有一个或者多个配置项。

    下面的这些上下文指令是用的比较多:

    Directive Description Contains Directive
    main nginx 在运行时与具体业务功能(比如 http 服务或者 email 服务代理)无关的一些参数,比如工作进程数,运行的身份等。 user, worker_processes, error_log, events, http, mail
    http 与提供 http 服务相关的一些配置参数。例如:是否使用 keepalive 啊,是否使用 gzip 进行压缩等。 server
    server http 服务上支持若干虚拟主机。每个虚拟主机一个对应的 server 配置项,配置项里面包含该虚拟主机相关的配置。在提供 mail 服务的代理时,也可以建立若干 server. 每个 server 通过监听的地址来区分。 listen, server_name, access_log, location, protocol, proxy, smtp_auth, xclient
    location http 服务中,某些特定的 URL 对应的一系列配置项。 index, root
    mail 实现 email 相关的 SMTP/IMAP/POP3 代理时,共享的一些配置项(因为可能实现多个代理,工作在多个监听地址上)。 server, http, imap_capabilities
    include 以便增强配置文件的可读性,使得部分配置文件可以重新使用。 -
    valid_referers 用来校验Http请求头Referer是否有效。 -
    try_files 用在server部分,不过最常见的还是用在location部分,它会按照给定的参数顺序进行尝试,第一个被匹配到的将会被使用。 -
    if 当在location块中使用if指令,在某些情况下它并不按照预期运行,一般来说避免使用if指令。 -

    例如我们再 nginx.conf 里面引用两个配置 vhost/example.com.conf 和 vhost/gitlab.com.conf 它们都被放在一个我自己新建的目录 vhost 下面。nginx.conf 配置如下:

    简单的配置: example.com.conf

    1. server {
    2. #侦听的80端口
    3. listen 80;
    4. server_name baidu.com app.baidu.com; # 这里指定域名
    5. index index.html index.htm; # 这里指定默认入口页面
    6. root /home/www/app.baidu.com; # 这里指定目录
    7. }

    反向代理

    反向代理是一个Web服务器,它接受客户端的连接请求,然后将请求转发给上游服务器,并将从服务器得到的结果返回给连接的客户端。下面简单的反向代理的例子:

    1. server {
    2. listen 80;
    3. server_name localhost;
    4. client_max_body_size 1024M; # 允许客户端请求的最大单文件字节数
    5. location / {
    6. proxy_pass http://localhost:8080;
    7. proxy_set_header Host $host:$server_port;
    8. proxy_set_header X-Forwarded-For $remote_addr; # HTTP的请求端真实的IP
    9. }
    10. }

    复杂的配置: gitlab.com.conf。

    1. server {
    2. #侦听的80端口
    3. listen 80;
    4. server_name git.example.cn;
    5. location / {
    6. proxy_pass http://localhost:3000;
    7. #以下是一些反向代理的配置可删除
    8. proxy_redirect off;
    9. #后端的Web服务器可以通过X-Forwarded-For获取用户真实IP
    10. proxy_set_header Host $host;
    11. client_max_body_size 10m; #允许客户端请求的最大单文件字节数
    12. client_body_buffer_size 128k; #缓冲区代理缓冲用户端请求的最大字节数
    13. proxy_connect_timeout 300; #nginx跟后端服务器连接超时时间(代理连接超时)
    14. proxy_send_timeout 300; #后端服务器数据回传时间(代理发送超时)
    15. proxy_read_timeout 300; #连接成功后,后端服务器响应时间(代理接收超时)
    16. proxy_buffer_size 4k; #设置代理服务器(nginx)保存用户头信息的缓冲区大小
    17. proxy_buffers 4 32k; #proxy_buffers缓冲区,网页平均在32k以下的话,这样设置
    18. proxy_busy_buffers_size 64k; #高负荷下缓冲大小(proxy_buffers*2)
    19. }
    20. }

    代理到上游服务器的配置中,最重要的是proxy_pass指令。以下是代理模块中的一些常用指令:

    指令 说明
    proxy_connect_timeout Nginx从接受请求至连接到上游服务器的最长等待时间
    proxy_send_timeout 后端服务器数据回传时间(代理发送超时)
    proxy_read_timeout 连接成功后,后端服务器响应时间(代理接收超时)
    proxy_cookie_domain 替代从上游服务器来的Set-Cookie头的domain属性
    proxy_cookie_path 替代从上游服务器来的Set-Cookie头的path属性
    proxy_buffer_size 设置代理服务器(nginx)保存用户头信息的缓冲区大小
    proxy_buffers proxy_buffers缓冲区,网页平均在多少k以下
    proxy_set_header 重写发送到上游服务器头的内容,也可以通过将某个头部的值设置为空字符串,而不发送某个头部的方法实现
    proxy_ignore_headers 这个指令禁止处理来自代理服务器的应答。
    proxy_intercept_errors 使nginx阻止HTTP应答代码为400或者更高的应答。

    upstream指令启用一个新的配置区段,在该区段定义一组上游服务器。这些服务器可能被设置不同的权重,也可能出于对服务器进行维护,标记为down。

    每个请求按时间顺序逐一分配到不同的后端服务器,如果后端服务器down掉,能自动剔除。

    负载均衡:

    upstream模块能够使用3种负载均衡算法:轮询、IP哈希、最少连接数。

    轮询: 默认情况下使用轮询算法,不需要配置指令来激活它,它是基于在队列中谁是下一个的原理确保访问均匀地分布到每个上游服务器;
    IP哈希: 通过ip_hash指令来激活,Nginx通过IPv4地址的前3个字节或者整个IPv6地址作为哈希键来实现,同一个IP地址总是能被映射到同一个上游服务器;
    最少连接数: 通过least_conn指令来激活,该算法通过选择一个活跃数最少的上游服务器进行连接。如果上游服务器处理能力不同,可以通过给server配置weight权重来说明,该算法将考虑到不同服务器的加权最少连接数。

    RR

    简单配置 ,这里我配置了2台服务器,当然实际上是一台,只是端口不一样而已,而8081的服务器是不存在的,也就是说访问不到,但是我们访问 http://localhost 的时候,也不会有问题,会默认跳转到http://localhost:8080具体是因为Nginx会自动判断服务器的状态,如果服务器处于不能访问(服务器挂了),就不会跳转到这台服务器,所以也避免了一台服务器挂了影响使用的情况,由于Nginx默认是RR策略,所以我们不需要其他更多的设置

    1. upstream test {
    2. server localhost:8080;
    3. server localhost:8081;
    4. }
    5. server {
    6. server_name localhost;
    7. location / {
    8. proxy_pass http://test;
    9. proxy_set_header Host $host:$server_port;
    10. }
    11. }
    1. upstream test {
    2. server localhost:8080;
    3. server localhost:8081;
    4. }

    权重

    指定轮询几率,weight和访问比率成正比,用于后端服务器性能不均的情况。 例如

    1. upstream test {
    2. server localhost:8080 weight=9;
    3. server localhost:8081 weight=1;
    4. }

    那么10次一般只会有1次会访问到8081,而有9次会访问到8080

    ip_hash

    上面的2种方式都有一个问题,那就是下一个请求来的时候请求可能分发到另外一个服务器,当我们的程序不是无状态的时候(采用了session保存数据),这时候就有一个很大的很问题了,比如把登录信息保存到了session中,那么跳转到另外一台服务器的时候就需要重新登录了,所以很多时候我们需要一个客户只访问一个服务器,那么就需要用iphash了,iphash的每个请求按访问ip的hash结果分配,这样每个访客固定访问一个后端服务器,可以解决session的问题。

    fair

    这是个第三方模块,按后端服务器的响应时间来分配请求,响应时间短的优先分配。

    1. upstream backend {
    2. fair;
    3. server localhost:8080;
    4. server localhost:8081;
    5. }

    url_hash

    这是个第三方模块,按访问url的hash结果来分配请求,使每个url定向到同一个后端服务器,后端服务器为缓存时比较有效。 在upstream中加入hash语句,server语句中不能写入weight等其他的参数,hash_method是使用的hash算法

    1. upstream backend {
    2. hash $request_uri;
    3. hash_method crc32;
    4. server localhost:8080;
    5. server localhost:8081;
    6. }

    以上5种负载均衡各自适用不同情况下使用,所以可以根据实际情况选择使用哪种策略模式,不过fair和url_hash需要安装第三方模块才能使用

    server指令可选参数:

    1. weight:设置一个服务器的访问权重,数值越高,收到的请求也越多;
    2. fail_timeout:在这个指定的时间内服务器必须提供响应,如果在这个时间内没有收到响应,那么服务器将会被标记为down状态;
    3. max_fails:设置在fail_timeout时间之内尝试对一个服务器连接的最大次数,如果超过这个次数,那么服务器将会被标记为down;
    4. down:标记一个服务器不再接受任何请求;

    keepalive指令:

    Nginx服务器将会为每一个worker进行保持同上游服务器的连接。

    屏蔽ip

    1. include blockip.conf;

    在blockip.conf里面输入内容,如: