【Nginx笔记】nginx配置文件具体解释

本文主要对nginx的配置做重点说明，关于nginx的其他基本概念。建议參考官网描写叙述。这里推荐Nginx Beginner's
Guide这篇文档。对刚開始学习的人高速认识nginx非常有帮助。

显然。发挥nginx强大优势的前提是熟悉其配置文件并进行合理的配置。而学习nginx配置时。最重要的一点是建立例如以下概念：

The most important is that nginx is a reverse proxy first and HTTP server second, its first concern is not files but rather URLs, this changes the way we have to configure nginx.

也即，nginx的强大之处在于其高性能的反向代理功能（接收请求并传递给下游真正处理请求的servers；等待下游响应并返回给请求发起方）。其次，它也能像普通webserver那样提供静态文件訪问功能。

我们以nginx源代码编译安装后的默认配置文件（conf/nginx.conf.default）为例。对重要的配置项进行说明。

#user  nobody;
worker_processes  1;

#error_log  logs/error.log;
#error_log  logs/error.log  notice;
#error_log  logs/error.log  info;

#pid        logs/nginx.pid;

events {
    worker_connections  1024;
}

http {
    include       mime.types;
    default_type  application/octet-stream;

    #log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
    #                  '$status $body_bytes_sent "$http_referer" '
    #                  '"$http_user_agent" "$http_x_forwarded_for"';

    #access_log  logs/access.log  main;

    sendfile        on;
    #tcp_nopush     on;

    #keepalive_timeout  0;
    keepalive_timeout  65;

    #gzip  on;

    server {
        listen       80;
        server_name  localhost;
        #charset koi8-r;
        #access_log  logs/host.access.log  main;

        location / {
            root   html;
            index  index.html index.htm;
        }

        #error_page  404              /404.html;

        # redirect server error pages to the static page /50x.html
        #
        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root   html;
        }

        # proxy the PHP scripts to Apache listening on 127.0.0.1:80
        #
        #location ~ \.php$ {
        #    proxy_pass   http://127.0.0.1;
        #}

        # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
        #
        #location ~ \.php$ {
        #    root           html;
        #    fastcgi_pass   127.0.0.1:9000;
        #    fastcgi_index  index.php;
        #    fastcgi_param  SCRIPT_FILENAME  /scripts$fastcgi_script_name;
        #    include        fastcgi_params;
        #}

        # deny access to .htaccess files, if Apache's document root
        # concurs with nginx's one
        #
        #location ~ /\.ht {
        #    deny  all;
        #}
    }

    # another virtual host using mix of IP-, name-, and port-based configuration
    #
    #server {
    #    listen       8000;
    #    listen       somename:8080;
    #    server_name  somename  alias  another.alias;

    #    location / {
    #        root   html;
    #        index  index.html index.htm;
    #    }
    #}

    # HTTPS server
    #
    #server {
    #    listen       443 ssl;
    #    server_name  localhost;
    #    ssl_certificate      cert.pem;
    #    ssl_certificate_key  cert.key;
    #    ssl_session_cache    shared:SSL:1m;
    #    ssl_session_timeout  5m;
    #    ssl_ciphers  HIGH:!aNULL:!MD5;
    #    ssl_prefer_server_ciphers  on;

    #    location / {
    #        root   html;
    #        index  index.html index.htm;
    #    }
    #}
}

1. Nginx配置文件区块层级关系

要熟悉nginx配置文件，首先要清楚区块划分及区块间的层级关系，关于这一点。UNDERSTANDING THE NGINX CONFIGURATION INHERITANCE
MODEL一文对各区块层级划分、层级或配置项类型、配置项的继承关系及嵌套区块定义等方面均做了具体且带实例的说明，这里不再赘述。

       我们须要牢记当中3个区块间的层级关系：http->server->location，它们是nginx配置过程中的关键区块。

2. Server区块（Virtual Host）

       server block主要目的是创建virtual server，其最重要的设置项有3个：

       1) listen 

       设置侦听地址、port号、UNIX-domain socket的路径。能够仅仅设置侦听地址（ip或hostname）。这样的情况下默认侦听80port，也能够仅仅指定侦听port号。此外，还能够设置是否是default server, connection是否ssl加密，proxy_protocol，等等。

具体的设置语法和设置项能够參考这里的官方文档。

       2) server_name

       设置该server block的域名，支持精确域名、带通配符的域名和正則表達式这3种格式，详细规则见这里。

nginx接收到请求URL后，会根据各server block配置的server_name搜索处理本次请求的server，第1个match成功（请求URL的header指定的域名与server_name做匹配）的server
block负责处理URL请求。从文档可知，详细的搜索顺序优先级例如以下（由高到低）：

        a. the exact name

        b. the longest wildcard name starting with an asterisk, e.g. “*.example.com”

        c. the longest wildcard name ending with an asterisk, e.g. “mail.*”

        d. the first matching regular expression (in order of appearance in the configuration file)

       实际上，配置server_name时，精确域名、由*开头的通配域名、由*结尾的通配域名被会分别存储在与listen port关联的3个hash表中。nginx依据server_name搜索server block时。会按上述顺序依次搜索这3个hash表，仅仅要有1个hash表的某项配置命中。则搜索结束，此时，用户请求URL会交给该成功匹配的server_name所属的server区块来处理。若3个hash表均搜索失败，则会依次搜索正則表達式格式的server_name。因为reg
exp match相对最慢。故其搜索优先级最低。

因此。在实际使用时，我们应该尽可能配置精确域名。

此外，若需配置非常多server名或某个server域名非常长。则应该分别优化server_names_hash_max_size和server_names_hash_bucket_size这2个配置项。详细说明可见这篇文档的Optimization部分。

3) location

       详见下一小节的说明

3. Location区块

       关于location block，须要清楚例如以下几个重要规则：

       1) 除命名location（named location）区块外。其余location区块均作用在不带query參数的URL上，且每次仅仅会有1个location区块起作用。

这也是文件夹配置通常置于最顶层区块的原因，因为定义在location /的root文件夹设置不能被用于location /images，而若将root文件夹设置在server区块，则全部的location区块均可使用该设置（当然，在location区块中能够改写本区块的root文件夹设置）。不管是消除反复代码还是兴许维护方面，均要方便得多。

2) nginx会依据location区块的server_name来分配请求URL。

nginx对URL和location区块的match规则例如以下（官网文档在这里）：

        a. 首先查找由前缀字符串（prefix string）定义的location区块。在前缀字符串匹配成功的全部location区块中，最长前缀匹配的那个block会由nginx记录下来；

        b. 接着nginx按在配置文件里定义的先后顺序检查由正則表達式定义的location区块，当正则匹配成功某个区块后。查找结束，该区块负责处理URL，整个match过程随之结束；

        c. 若没有由正则指定的location区块匹配成功。则返回第1步记录的最长前缀匹配的区块。整个match过程结束。

        几点特别说明：

        a. 由正則表達式定义的location区块具有较低的搜索优先级。但具有较高的匹配优先级。

这一点与nginx搜索server_name的规则不同（server_name是按搜索优先级匹配，一旦匹配成功就马上结束搜索）。需引起特别注意。

        b. location还能够用等号（=）做精确配置，它具有最高的匹配优先级，仅仅要命中精确匹配的location。nginx对location区块的搜索马上结束。

3) 配置的详细语法规则详见官网文档，这里不赘述。

4. 反向代理设置

       在熟悉主要区块（http/server/location）基本配置规则的前提下。配置nginx来实现反向代理服务器事实上非常easy。在location区块通过配置proxy_pass或fastcgi_pass就可以实现。

此外，还能够配置哪个source address的request代理到哪个下游服务（proxy_bind），是否对下游响应头做buffer及buffer区大小（proxy_buffering/proxy_buffer_size）。是否对响应结果做cache（proxy_cache）。等等。

具体的配置语法可分别參考文档Module ngx_http_proxy_module和Module
ngx_http_fastcgi_module。

【參考资料】

1. UNDERSTANDING THE NGINX CONFIGURATION INHERITANCE MODEL  

2. NGINX CONFIGURATION PRIMER  

3. Nginx Beginner’s Guide 



======================= EOF ===================