网站导航
> 文章列表 > nginx配置文件介绍

nginx配置文件介绍

网友: 文章列表 2024-03-21 21:48:05

nginx配置文件介绍

nginx配置文件介绍

nginx默认的配置文件是在安装目录下的 conf目录下，后续对 nginx 的使用基本上都是对此配置文件进行相应的修改。

配置文件中用#符号表示注释内容。

配置文件主要包括三部分，main、events和http

main

用于进行nginx全局信息的配置。

user

定义 nginx 运行的用户和用户组,默认由 nobody 账号运行。

worker_processes

指定nginx要开启的子进程数量，通常数量是CPU内核数量的整数倍。该值越大，可以支持的并发处理量也越多，但是会受到硬件、软件等设备的影响。

如果是在本地运行nginx可以通过任务管理器中的性能选项中查看电脑cpu核数。

nginx配置文件介绍

error_log

定义错误日志文件的位置及输出级别（debug / info / notice / warn / error / crit）。

pid

用来指定进程id的存储文件的位置（windows下可以注释掉）。

worker_rlimit_nofile

用于指定一个进程可以打开最多文件数量的描述。理论值应该是最多打开文件数（系统的值ulimit -n）与nginx进程数相除，但是nginx分配请求并不均匀，所以建议与ulimit -n的值保持一致。

events

针对nginx服务器的工作模式的一些操作配置。

worker_connections

指定单个进程最大连接数（最大连接数=连接数*进程数）。该值受系统进程最大打开文件数限制，需要使用命令ulimit -n 查看当前设置。

multi_accept

配置指定nginx在收到一个新连接通知后尽可能多的接受更多的连接

use epoll

配置指定了线程轮询的方法，如果是linux2.6+，使用epoll，如果是BSD如Mac请使用Kqueue

http

作为web服务器，http模块是nginx最核心的一个模块，配置项也是比较多的（比如代理，日志，缓存、第三方模块等等），项目中会设置到很多的实际业务场景，需要根据硬件信息进行适当的配置。不过常规情况下，使用默认配置即可！

http {#文件扩展名与文件类型映射表#include 是个主模块指令，可以将配置文件拆分并引用，可以减少主配置文件的复杂度include       mime.types;#默认文件类型default_type  application/octet-stream;#charset utf-8; #默认编码#定义虚拟主机日志的格式#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指令指定nginx是否调用sendfile函数来输出文件，对于普通应用设为 on，如果用来进行下载等应用磁盘IO重负载应用，可设置为off，以平衡磁盘与网络I/O处理速度，降低系统的负载。注意：如果图片显示不正常把这个改成off。sendfile        on;#autoindex on; #开启目录列表访问，合适下载服务器，默认关闭。#防止网络阻塞#tcp_nopush     on;#长连接超时时间，单位是秒，默认为0keepalive_timeout  65;# gzip压缩功能设置gzip on; #开启gzip压缩输出gzip_min_length 1k; #最小压缩文件大小gzip_buffers    4 16k; #压缩缓冲区gzip_http_version 1.0; #压缩版本（默认1.1，前端如果是squid2.5请使用1.0）gzip_comp_level 6; #压缩等级#压缩类型，默认就已经包含text/html，所以下面就不用再写了，写上去也不会有问题，但是会有一个warn。gzip_types text/plain text/css text/javascript application/json application/javascript application/x-javascript application/xml;gzip_vary on; //和http头有关系，加个vary头，给代理服务器用的，有的浏览器支持压缩，有的不支持，所以避免浪费不支持的也压缩，所以根据客户端的HTTP头来判断，是否需要压缩#limit_zone crawler $binary_remote_addr 10m; #开启限制IP连接数的时候需要使用# http_proxy服务全局设置client_max_body_size   10m;client_body_buffer_size   128k;proxy_connect_timeout   75;proxy_send_timeout   75;proxy_read_timeout   75;proxy_buffer_size   4k;proxy_buffers   4 32k;proxy_busy_buffers_size   64k;proxy_temp_file_write_size  64k;proxy_temp_path   /usr/local/nginx/proxy_temp 1 2;}

server

配置http模块中的一个子模块，用来定义一个虚拟访问主机，也就是一个虚拟服务器的配置信息。这部分是 nginx 服务器配置中最频繁的部分，代理、缓存和日志定义等绝大多数功能和第三方模块的配置都在这里。

一个http块可以包含多个server块。

核心配置如下：

  • listen：监听端口
  • server_name：指定ip地址或者域名（可以有多个），多个配置之间用空格分隔
  • root：表示整个server虚拟主机内的根目录，所有当前主机中web项目的根目录
  • index：用户访问web网站时的全局首页
  • charset：用于设置www/路径中配置的网页的默认编码格式
  • access_log：用于指定该虚拟主机服务器中的访问记录日志存放路径
  • error_log：用于指定该虚拟主机服务器中访问错误日志的存放路径
  • error_page：指定遇到错误状态码时应展示的页面
  • location：是nginx配置中出现最多的一个配置，主要用于配置路由访问信息。在路由访问信息配置中关联到反向代理、负载均衡等等各项功能。

location

语法：location [=|~|~*|^~] /uri/ { … }

  • =: 开头表示精确匹配
  • ~: 开头表示区分大小写的正则匹配
  • ~*: 开头表示不区分大小写的正则匹配
  • !~和!~*分别为区分大小写不匹配及不区分大小写不匹配的正则
  • ^~ 开头表示uri以某个常规字符串开头，理解为匹配 url 路径即可。nginx不对url进行编码，因此请求为/static/20%/aa，可以被规则^~ /static/ /aa匹配到（注意是空格）。
  • /: 通用匹配，可以匹配任何请求

可以配置多个location，不过请求的匹配也是有一定的顺序的：

  1. 匹配 =
  2. 匹配^~,
  3. 按文件中顺序的正则匹配
  4. / 通用匹配。

当有匹配成功时候，停止匹配，按当前匹配规则处理请求。

假设配置如下：

location = / {#规则1
}
location = /api {#规则2
}
location ^~ /static/ {#规则3
}
location ~ \\.(gif|jpg|png|js|css)$ {#规则4
}
location ~* \\.png$ {#规则5
}
location !~ \\.xhtml$ {#规则6
}
location !~* \\.xhtml$ {#规则7
}
location / {#规则8
}
  1. 当访问根目录 http://localhost/，匹配规则1
  2. 当访问http://localhost/api，匹配规则2
  3. 当访问http://localhost/static/1.png，^~会优先匹配规则3
  4. 当访问http://localhost/1.png，匹配规则4，规则5不生效
  5. 当访问http://localhost/1.PNG，匹配规则5，不会匹配规则4，规则5不区分大小写
  6. 当访问http://localhost/a.xhtml 不会匹配规则6和规则7，http://localhost/a.XHTML不会匹配规则7，因为不区分大小写。规则6，规则7属于排除法，符合匹配规则但是不会匹配到
proxy_pass

用于配置反向代理

server {listen       80;server_name  localhost;location / {root   html;index  index.html index.htm;proxy_pass  http://test.com:8080}
}

nginx监听 80端口，访问localhost（不加端口号时默认为 80端口）时会跳转到 test.com:8080（本地的话可以通过在host文件上设置ip域名映射） 路径上。

在location下，同时配置root和proxy_pass选项时，两个选项只会二选一执行。

uwsgi_pass

wsgi模式下的服务器配置访问方式

location / {include uwsgi_params;uwsgi_pass localhost:8888
}

upstream

负责负载均衡的配置，通过默认的轮询调度方式来分发请求到后端服务器。

核心配置信息如下：

  • server host:port：分发服务器的列表配置
  • -- down：表示该主机暂停服务
  • -- max_fails：表示失败最大次数，超过失败最大次数暂停服务
  • -- fail_timeout：表示如果请求受理失败，暂停指定的时间之后重新发起请求

nginx的负载均衡模块目前支持4种调度算法：

  • 轮询（默认）：每个请求按时间顺序逐一分配到不同的后端服务器，如果后端某台服务器宕机，故障系统被自动剔除，使用户访问不受影响。Weight 指定轮询权值，Weight值越大，分配到的访问机率越高，主要用于后端每个服务器性能不均的情况下。

    按请求时间逐一分配，如果某个服务器挂了，就自动剔除：

    # myserver为自定义的名称
upstream myserver{server 192.168.1.1:80; server 192.168.1.12:8080 max_fails=3 fail_timeout=20s;server 192.168.1.123:8080 down;
}

    使用权重：

    upstream myserver{server 192.168.1.1:80 weight=5; server 192.168.1.12:8080 weight=10;
}

  • ip_hash：每个请求按访问IP的hash结果分配，这样来自同一个IP的访客固定访问一个后端服务器，有效解决了动态网页存在的session共享问题。

    比如说用户A固定ip，第一次访问到192.168.1.1:80，那么后面就都是访问到这台机器

    upstream myserver{ip_hash;server 192.168.1.1:80; server 192.168.1.12:8080;
}

  • fair：这是比上面两个更加智能的负载均衡算法。此种算法可以依据页面大小和加载时间长短智能地进行负载均衡，也就是根据后端服务器的响应时间来分配请求，响应时间短的优先分配。nginx本身是不支持fair的，如果需要使用这种调度算法，必须下载nginx的upstream_fair模块。

    upstream myserver{server 192.168.1.1:80; server 192.168.1.12:8080;fair;
}

  • url_hash：此方法按访问url的hash结果来分配请求，使每个url定向到同一个后端服务器，可以进一步提高后端缓存服务器的效率（同一个资源多次请求，可能会到达不同的服务器上，导致不必要的多次下载，缓存命中率不高，以及一些资源时间的浪费。而使用url_hash，可以使得同一个url（也就是同一个资源请求）会到达同一台服务器，一旦缓存住了资源，再此收到请求，就可以从缓存中读取）。nginx本身是不支持url_hash的，如果需要使用这种调度算法，必须安装nginx 的hash软件包。

    upstream myserver{server 192.168.1.1:80; server 192.168.1.12:8080;hash $request_uri;
}server {listen 8083;server_name localhost;location /{proxy_pass http://myserver;}
}

注，当负载调度算法为ip_hash时，后端服务器在负载均衡调度中的状态不能是weight和backup

网络标签：

相关问题