Nginx笔记nginx配置文件具体解释
Posted
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了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) 配置的详细语法规则详见官网文档，这里不赘述。
在熟悉主要区块（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 MODEL2. NGINX CONFIGURATION PRIMER
3. Nginx Beginner’s Guide
======================= EOF ===================
以上是关于Nginx笔记nginx配置文件具体解释的主要内容，如果未能解决你的问题，请参考以下文章
nginx.conf 忽略了 nginx-ingress 配置映射片段