logo
搜索
我的图书馆

发文章

发文工具

其他工具

留言交流
搜索
分享

nginx.conf配置——Nginx

 一本正经地胡闹 2019-07-25

Nginx在运行时候，至少要加载几个核心模块和一个事件类模块。这些模块运行时所支持的配置项称为基本配置——所有其他模块执行时都依赖的配置项。

由于配置项较多，所以把它们按照用户使用时的预期功能分成以下4类：

  1. 用于调试、定位问题的配置项；
  2. 正常运行的必备配置项；
  3. 优化性能的配置项；
  4. 事件类配置项（有些事件类配置项归纳到优化性能类，这是因为它们虽然也属于event{}块，但作用是优化性能）

有一些配置项，几十没有显式的进行配置，他们会有默认的值，如：daemon，即是在nginx.conf中没有对它进行配置，也相当于打开了这个功能，这点需要注意。

官网对各个模块参数配置的解释说明网址： Nginx中文文档

  1. ##代码块中的events、http、server、location、upstream等都是块配置项##
  2. ##块配置项可以嵌套。内层块直接继承外层快，例如：server块里的任意配置都是基于http块里的已有配置的##
  4. ##Nginx worker进程运行的用户及用户组 
  5. #语法：user username[groupname]    默认：user nobody nobody
  6. #user用于设置master进程启动后，fork出的worker进程运行在那个用户和用户组下。当按照"user username;"设置时，用户组名与用户名相同。
  7. #若用户在configure命令执行时，使用了参数--user=usergroup 和 --group=groupname,此时nginx.conf将使用参数中指定的用户和用户组。
  8. #user  nobody;
  10. ##Nginx worker进程个数：其数量直接影响性能。
  11. #每个worker进程都是单线程的进程，他们会调用各个模块以实现多种多样的功能。如果这些模块不会出现阻塞式的调用，那么，有多少CPU内核就应该配置多少个进程，反之，有可能出现阻塞式调用，那么，需要配置稍多一些的worker进程。
  12. worker_processes  1;
  14. ##ssl硬件加速。
  15. #用户可以用OpneSSL提供的命令来查看是否有ssl硬件加速设备：openssl engine -t
  16. #ssl_engine device;
  18. ##守护进程(daemon)。是脱离终端在后台允许的进程。它脱离终端是为了避免进程执行过程中的信息在任何终端上显示。这样一来，进程也不会被任何终端所产生的信息所打断。##
  19. ##关闭守护进程的模式，之所以提供这种模式，是为了放便跟踪调试nginx，毕竟用gdb调试进程时最繁琐的就是如何继续跟进fork出的子进程了。##
  20. ##如果用off关闭了master_proccess方式，就不会fork出worker子进程来处理请求，而是用master进程自身来处理请求
  21. #daemon off;   #查看是否以守护进程的方式运行Nginx 默认是on 
  22. #master_process off; #是否以master/worker方式工作 默认是on
  24. ##error日志的设置#
  25. #语法： error_log /path/file level;
  26. #默认： error_log / log/error.log error;
  27. #当path/file 的值为 /dev/null时，这样就不会输出任何日志了，这也是关闭error日志的唯一手段；
  28. #leve的取值范围是debug、info、notice、warn、error、crit、alert、emerg从左至右级别依次增大。
  29. #当level的级别为error时，error、crit、alert、emerg级别的日志就都会输出。大于等于该级别会输出，小于该级别的不会输出。
  30. #如果设定的日志级别是debug，则会输出所有的日志，这一数据量会很大，需要预先确保/path/file所在的磁盘有足够的磁盘空间。级别设定到debug，必须在configure时加入 --with-debug配置项。
  31. #error_log  logs/error.log;
  32. #error_log  logs/error.log  notice;
  33. #error_log  logs/error.log  info;
  35. ##pid文件（master进程ID的pid文件存放路径）的路径
  36. #pid        logs/nginx.pid;
  39. events {
  40.  #仅对指定的客户端输出debug级别的日志： 语法：debug_connection[IP|CIDR]
  41.  #这个设置项实际上属于事件类配置，因此必须放在events{……}中才会生效。它的值可以是IP地址或者是CIRD地址。
  42.  	#debug_connection 10.224.66.14;  #或是debug_connection 10.224.57.0/24
  43.  #这样，仅仅以上IP地址的请求才会输出debug级别的日志，其他请求仍然沿用error_log中配置的日志级别。
  44.  #注意：在使用debug_connection前，需确保在执行configure时已经加入了--with-debug参数，否则不会生效。
  45. 	worker_connections  1024;
  46. }
  48. ##核心转储(coredump):在Linux系统中，当进程发生错误或收到信号而终止时，系统会将进程执行时的内存内容(核心映像)写入一个文件(core文件)，以作为调试只用，这就是所谓的核心转储(coredump).
  50. http {
  51. ##嵌入其他配置文件 语法：include /path/file
  52. #参数既可以是绝对路径也可以是相对路径（相对于Nginx的配置目录，即nginx.conf所在的目录）
  53.     include       mime.types;
  54.     default_type  application/octet-stream;
  56.     #log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
  57.     #                  '$status $body_bytes_sent "$http_referer" '
  58.     #                  '"$http_user_agent" "$http_x_forwarded_for"';
  60.     #access_log  logs/access.log  main;
  62.     sendfile        on;
  63.     #tcp_nopush     on;
  65.     #keepalive_timeout  0;
  66.     keepalive_timeout  65;
  68.     #gzip  on;
  70.     server {
  71. ##listen监听的端口
  72. #语法：listen address:port [ default(deprecated in 0.8.21) | default_server | [ backlog=num | rcvbuf=size | sndbuf=size | accept_filter=filter | deferred | bind | ssl ] ]
  73. #default_server: 如果没有设置这个参数，那么将会以在nginx.conf中找到的第一个server块作为默认server块
  74. 	listen       8080;
  76. #主机名称：其后可以跟多个主机名称，开始处理一个HTTP请求时，nginx会取出header头中的Host，与每个server中的server_name进行匹配，以此决定到底由那一个server来处理这个请求。有可能一个Host与多个server块中的server_name都匹配，这时会根据匹配优先级来选择实际处理的server块。server_name与Host的匹配优先级见文末。
  77. 	 server_name  localhost;
  79.         #charset koi8-r;
  81.         #access_log  logs/host.access.log  main;
  83.         #location / {
  84.         #    root   html;
  85.         #    index  index.html index.htm;
  86.         #}
  88. ##location 语法： location [=|~|~*|^~] /uri/ { ... }
  89. # location的使用实例见文末。
  90. #注意：location时有顺序的，当一个请求有可能匹配多个location时，实际上这个请求会被第一个location处理。
  91. 	location / {
  92. 	proxy_pass http://192.168.1.60;
  93.         }
  95.         #error_page  404              /404.html;
  97.         # redirect server error pages to the static page /50x.html
  98.         #
  99.         error_page   500 502 503 504  /50x.html;
  100.         location = /50x.html {
  101.             root   html;
  102.         }
  104.         # proxy the PHP scripts to Apache listening on 127.0.0.1:80
  105.         #
  106.         #location ~ \.php$ {
  107.         #    proxy_pass   http://127.0.0.1;
  108.         #}
  110.         # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
  111.         #
  112.         #location ~ \.php$ {
  113.         #    root           html;
  114.         #    fastcgi_pass   127.0.0.1:9000;
  115.         #    fastcgi_index  index.php;
  116.         #    fastcgi_param  SCRIPT_FILENAME  /scripts$fastcgi_script_name;
  117.         #    include        fastcgi_params;
  118.         #}
  120.         # deny access to .htaccess files, if Apache's document root
  121.         # concurs with nginx's one
  122.         #
  123.         #location ~ /\.ht {
  124.         #    deny  all;
  125.         #}
  126.     }
  130.     # another virtual host using mix of IP-, name-, and port-based configuration
  131.     #
  132.     #server {
  133.     #    listen       8000;
  134.     #    listen       somename:8080;
  135.     #    server_name  somename  alias  another.alias;
  137.     #    location / {
  138.     #        root   html;
  139.     #        index  index.html index.htm;
  140.     #    }
  141.     #}
  144.     # HTTPS server
  145.     #
  146.     #server {
  147.     #    listen       443 ssl;
  148.     #    server_name  localhost;
  150.     #    ssl_certificate      cert.pem;
  151.     #    ssl_certificate_key  cert.key;
  153.     #    ssl_session_cache    shared:SSL:1m;
  154.     #    ssl_session_timeout  5m;
  156.     #    ssl_ciphers  HIGH:!aNULL:!MD5;
  157.     #    ssl_prefer_server_ciphers  on;
  159.     #    location / {
  160.     #        root   html;
  161.     #        index  index.html index.htm;
  162.     #    }
  163.     #}
  165. }

 

server_name与Host的匹配优先级
首先选择所有字符串完全匹配的server_name 如：www.testwab.com
其次选择通配符在前面的server_name 如：*.testwab.com
其次选择通配符在后面的server_name 如：www.testwab.*
最后选择使用正在表达式才匹配的server_name 如：~^\.testwab\.com$
location的使用实例 
  1. location  = / {
  3.   # matches the query / only.
  4.   [ configuration A ] 
  5. }
 只有当用户请求是/时，才会使用该location下的配置 
  1. location  / {
  2.   # matches any query, since all queries begin with /, but regular
  3.   # expressions and any longer conventional blocks will be
  5.   # matched first.
  6.   [ configuration B ] 
  7. }
 可以匹配所有请求 
  1. location ^~ /images/ {
  2.   # matches any query beginning with /images/ and halts searching,
  3.   # so regular expressions will not be checked.
  5.   [ configuration C ] 
  6. }

匹配以/images/开头的任何查询并停止搜索

表示匹配URL时忽略字母大小写问题

 
  1. location ~* \.(gif|jpg|jpeg)$ {
  2.   # matches any request ending in gif, jpg, or jpeg. However, all
  3.   # requests to the /images/ directory will be handled by
  5.   # Configuration C.   
  6.   [ configuration D ] 
  7. }

匹配任何以gif、jpg或jpeg结尾的请求。然而,所有
location的使用实例 —— 以root方式设置资源路径

location /download/ {

           root    /opt/wab/html/;

}          [[[意思是有一个请求的URL是 /download/index/test.html， 那么Web服务器就会返回服务器上 /opt/wab/html/download/index/test.html 文件的内容]]]
location的使用实例 —— 以alias方式设置资源路径

alias也是用来设置文件资源路径的，它与root不同点主要在于如何解读紧跟location后面的uri参数，这将会致使alias与root以不同的方式将用户请求映射到真正的磁盘文件上。

例如：如果有一个请求的URI是/conf/nginx.conf，而用户实际想访问的是 /usr/local/nginx/conf/nginx.conf，则两种方式如下：

         alias：

                           location  /conf {

                                             alias    /usr/local/nginx/conf

                          }

 

        root:

                         location    /conf{

                                            root    /usr/local/nginx

                         }

使用alias时，在URI向实际文件路径的映射过程中，已经把location后配置的 /conf这部分字符串丢弃掉了，因此若path中不加/conf这部分，直接映射回的地址是/usr/local/nginx/nginx.conf 与用户实际想访问的路径不符。root可以放置在http、server、location或if块中，而alias只能放置在location块中。
location的使用实例 —— 以index方式访问首页

有时，访问站点时的URI是/ ，这时返回网站的首页，而这与root和alias都不同。这里用ngx_http_index_module模块提供的index配置实现。index后可以跟多个文件参数，Nginx将会按照顺序来访问这些文件。

location  /　｛

　　　root    path;

           index   /index.html　　　/html/index.php          /index.php

｝
接受到请求后，Nginx首先会尝试访问path/index.php 文件，如果可以访问，就直接返回文件内容结束请求，否则再试图返回path/html/index.php 文件的内容，以此类推。（从后向前）

    本站是提供个人知识管理的网络存储空间，所有内容均由用户发布，不代表本站观点。请注意甄别内容中的联系方式、诱导购买等信息，谨防诈骗。如发现有害或侵权内容，请点击一键举报。
    转藏 分享 献花（0）

    来自： 一本正经地胡闹 > 《待分类》

    举报/认领

    0条评论

    发表

    请遵守用户 评论公约

    类似文章 更多