Nginx配置文件详解

2023-09-13 07:45:00

一、nginx的配置文件

1、常见的配置文件及其作用

nginx常见配置文件位置：安装路径/conf目录中。


[root@centos7 nginx]# tree
.
├── conf
│   ├── fastcgi.conf
│   ├── fastcgi.conf.default
│   ├── fastcgi_params
│   ├── fastcgi_params.default
│   ├── koi-utf
│   ├── koi-win
│   ├── mime.types
│   ├── mime.types.default
│   ├── nginx.conf
│   ├── nginx.conf.default
│   ├── nginx.conf.old
│   ├── scgi_params
│   ├── scgi_params.default
│   ├── uwsgi_params
│   ├── uwsgi_params.default
│   └── win-utf
├── html
│   ├── 50x.html
│   └── index.html
└── sbin
    └── nginx

在这里插入图片描述

2、nginx主配置文件

nginx主配置文件：/usr/local/nginx/conf/nginx.conf

默认启动 nginx时，使用的配置文件是：安装路径/conf/nginx.conf文件。

可以在启动 nginx时通过 -c选项来指定要读取的配置文件。

2.1 nginx.conf原本配置

先看下原本的配置，这里加了说明注释。

[root@centos7 nginx]# cat ./conf/nginx.conf

# 1、main全局块（全局设置）， 作用域是全局

#Nginx用户及组：用户 组。window下不指定
#user  nobody;
#工作进程：数目。根据硬件调整，通常等于CPU数量或者2倍于CPU。
worker_processes  1;

#错误日志：存放路径。
#error_log  logs/error.log;
#error_log  logs/error.log  notice;
#error_log  logs/error.log  info;

#pid（进程标识符）：存放路径。
#pid        logs/nginx.pid;

# 2、events块（nginx工作模式）
events {
    #每个工作进程的最大连接数量。根据硬件调整，和前面工作进程配合起来用，尽量大，但是别把cpu跑到100%就行。
    #每个进程允许的最多连接数，理论上每台nginx服务器的最大连接数为。worker_processes*worker_connections
    worker_connections  1024;   
}

# 3、http块（http设置）
http {
  	#设定支持的mime类型,类型查看./conf/mime.types文件定义
    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 推送
    #tcp_nopush     on;

  	#连接超时时间。
    #keepalive_timeout  0;
    keepalive_timeout  65;

  	# 开启压缩文件
    #gzip  on;

	## ====sever块（主机设置）
    server {
    	# 提供服务的端口，默认80
        listen       80;
        # 提供服务的域名主机名
        server_name  localhost;

        #charset koi8-r;

		# 访问日志记录 以及位置
        #access_log  logs/host.access.log  main;

		# location块（URL匹配）：支持正则表达式
	    # 对 "/" 启用反向代理,第一个location区块开始 			  
        location / {
            #服务启动目录 默认在nginx安装目录下html目录
            root   html;
            # 默认的首页文件，多个用空格分开
            index  index.html index.htm;
        }

		# 错误页面路由
        # 出现对应的http状态码时，使用50x.html回应客户
        #error_page  404              /404.html;

        # 将服务器错误页重定向到静态页/50x.html
        # redirect server error pages to the static page /50x.html
        #
        error_page   500 502 503 504  /50x.html;        
        # location区块开始，访问50x.html
        location = /50x.html {
        	# 指定对应的站点目录为html
            root   html;
        }

        # 实例 入 将访问尾缀为 \.php 跳转到 127.0.0.1
        # proxy the PHP scripts to Apache listening on 127.0.0.1:80
        #
        #location ~ \.php$ {
        #    proxy_pass   http://127.0.0.1;
        #}

		# 将PHP脚本传递给正在侦听127.0.0.1:9000的FastCGI服务器
        # 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;
        #}

		# 拒绝访问.htaccess文件，如果Apache的文档根
        # 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;
    #    }
    #}

}

2.2 nginx.conf删简版

我们把原本配置中的注释都删掉，内容如下：

worker_processes  1;
events {
    worker_connections  1024;
}
http {
    include       mime.types;
    default_type  application/octet-stream;
    sendfile        on;
    keepalive_timeout  65;
    server {
        listen       80;
        server_name  localhost;
        location / {
            root   html;
            index  index.html index.htm;
        }
        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root   html;
        }
    }
}

可以发现，nginx.conf配置文件中的内容分为三个部分：

  • 第一部分：main全局块（全局设置）， 作用域是全局
  • 第二部分：events块（nginx工作模式）
  • 第三部分：http块（http设置）

下面逐一了解。

二、nginx.conf配置文件详解

1、main全局块（全局设置）

作用： 从配置文件开始到 events 块之间的内容，主要会设置一些影响nginx 服务器整体运行的配置指令，主要包括配 置运行 Nginx 服务器的用户（组）、允许生成的 worker process 数，进程 PID 存放路径、日志存放路径和类型以 及配置文件的引入等。作用域是全局的。

  • 配置运行Nginx服务器用户（组）
  • worker process数
  • Nginx进程
  • PID存放路径错误日志的存放路径
  • 一个nginx进程打开的最多文件描述符数目
#配置worker进程运行用户（和用户组），nobody也是一个linux用户，一般用于启动程序，没有密码
#user  nobody;   

#配置工作进程数目，根据硬件调整，通常等于CPU数量或者2倍于CPU数量
# 来指定了Nginx要开启的子进程数。每个Nginx进程平均耗费10M~12M内存。根据经验，一般指定1个进程就足够了，如果是多核CPU，通常等于CPU数量或者2倍于CPU数量。如果这里写2，那么就会开启2个子进程，总共3个进程。
worker_processes  1; 

# nginx支持的并发数

# 用来定义全局错误日志文件。日志输出级别有[debug | info | notice | warn | error | crit]，默认是error。其中，debug输出日志最为最详细，而crit输出日志最少。
# error_log  logs/error.log;
#error_log  logs/error.log  notice;
#error_log  logs/error.log  info;

#用来指定进程id的存储文件位置。
#pid        logs/nginx.pid;

#一个nginx进程打开的最多文件描述符数目，理论值应该是最多打开文件数（系统的值ulimit -n）与nginx进程数相除，但是nginx分配请求并不均匀，所以建议与ulimit -n的值保持一致, 使用命令“ulimit -n 65535”来设置。
# worker_rlimit_nofile 65535;
  • worker_processes 1：的意思是：Nginx 服务器并发处理服务的关键配置，worker_processes 值越大，可以支持的并发处理量也越多，但是会受到硬件、软件等设备的制约。

2、events块（nginx工作模式）

作用： events 块涉及的指令主要影响 Nginx 服务器与用户的网络连接，常用的设置包括是否开启对多 work process 下的网络连接进行序列化，是否 允许同时接收多个网络连接，选取哪种事件驱动模型来处理连接请求，每个 word process 可以同时支持的最大连接数等。

  • 事件驱动模型的选择
  • 最大连接数的配置
###### event 区域 #######
#use：用来指定Nginx的工作模式。Nginx支持的工作模式有select、poll、kqueue、epoll、rtsig和/dev/poll。
# 其中select和poll都是标准的工作模式，kqueue和epoll是高效的工作模式，不同的是epoll用在Linux平台上，而kqueue用在BSD系统中，对于Linux系统，epoll工作模式是首选。

#worker_connections：用于定义Nginx每个进程的最大连接数，即接收前端的最大请求数，默认是1024。
# 最大客户端连接数由worker_processes和worker_connections决定，即Max_clients=worker_processes*worker_connections，
# 在作为反向代理时，Max_clients变为：Max_clients = worker_processes * worker_connections/4。 
# 进程的最大连接数受Linux系统进程的最大打开文件数限制，在执行操作系统命令“ulimit -n 65536”后worker_connections的设置才能生效。

###### event 区域 #######
events {
  	# 指定运行模型
    use epoll;
    # #每个进程允许的最多连接数
    worker_connections  1024;
}
  • worker_connections 1024：表示每个 work process 支持的最大连接数为 1024。这部分的配置对 Nginx 的性能影响较大，在实际中应该灵活配置。

3、http块（http设置）

作用：这一部分是 Nginx 服务器配置最频繁的部分，因为关于代理、缓存和日志定义等绝大多数功能和第三方模块的配置都在这里进行。

需要注意的是：http 块也可以包括 http 全局块、server 块。

######## http设置 ##########
#    http模块负责HTTP服务器相关属性的配置，有server和upstream两个子模块
# http全局块配置的指令包括文件引入、MIME-TYPE 定义、日志自定义、连接超时时间、单链接请求数上限等。

#include ：来用设定文件的mime类型,类型在配置文件目录下的mime.type文件定义，来告诉nginx来识别文件类型。
  
#default_type：设定了默认的类型为二进制流，也就是当文件类型未定义时使用这种方式，例如在没有配置asp的locate环境时，Nginx是不予解析的，此时，用浏览器访问asp文件就会出现下载了。
		
#log_format：用于设置日志的格式，和记录哪些参数，这里设置为main，刚好用于access_log来纪录这种类型。

######## http设置 ##########
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;

}

3.1 sever块（主机设置）

每个 http 块可以包括多个 server 块，而每个 server 块就相当于一个虚拟主机。而每个 server 块也分为全局 server 块，以及可以同时包含多个 locaton 块。

  • 全局 server 块：最常见的配置是本虚拟机主机的监听配置和本虚拟主机的名称或 IP 配置。
  • location 块：一个 server 块可以配置多个 location 块。
######### sever块（主机设置）##########
# sever块用来定一个虚拟主机，标志定义虚拟主机开始。虚拟主机从用户角度看，和一台独立的硬件主机是完全一样的，该技术的产生是为了 节省互联网服务器硬件成本。

#listen：用于指定虚拟主机的服务端口。

#server_name：用来指定IP地址或者域名，多个域名之间用空格分开。

#root ：表示在这整个server虚拟主机内，全部的root web根目录。注意要和locate {}下面定义的区分开来。

#index ：全局定义访问的默认首页地址。注意要和locate {}下面定义的区分开来。

#charset：用于设置网页的默认编码格式。

#access_log：用来指定此虚拟主机的访问日志存放路径，最后的main用于指定访问日志的输出格式。

######### sever块（主机设置）##########
http {
    server {
        listen       80;
        server_name  localhost;
        root   /Users/hk/www;
        index  index.php index.html index.htm; 
        charset utf-8;
        access_log  logs/host.access.log  main;
        aerror_log  logs/host.error.log   main;
    }
}
3.1.1 location块（URL匹配）

location块的主要作用是基于 Nginx 服务器接收到的请求字符串（例如 server_name/uri-string），对虚拟主机名称 （也可以是IP 别名）之外的字符串（例如 前面的 /uri-string）进行匹配，对特定的请求进行处理。 地址定向、数据缓 存和应答控制等功能，还有许多第三方模块的配置也在这里进行。

注意：一个 server 块可以配置多个 location 块。

############ location设置#############
# location模块 负载均衡,反向代理,虚拟域名等配置。是来定位的，定位URL，解析URL，它也提供了强大的正则匹配功能，也支持条件判断匹配，可以通过location指令实现Nginx对动,静态网页进行过滤处理。

#/表示匹配访问根目录。

#root指令用于指定访问根目录时，虚拟主机的web目录，这个目录可以是相对路径（相对路径是相对于nginx的安装目录）。也可以是绝对路径。

#proxy_pass：代理转发，如果在proxy_pass后面的url加/，表示绝对根路径；如果没有/，表示相对路径，把匹配的路径部分也给代理走。

#proxy_set_header：允许重新定义或者添加发往后端服务器的请求头。

#include：加载配置文件，后面介绍nginx多个配置文件时候会提到。

#root：定位localtion匹配的url资源路径。

#index：定义页面显示html，一般和alias配合使用。

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

        error_page  404              /404.html;       
        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root   html;
        }
        
        #反向代理配置
        location /jyb {
            proxy_pass http://qurt/;
            proxy_read_timeout 1800s;
            proxy_set_header   Host $host:$server_port;
            proxy_set_header   X-real-ip  $remote_addr;
            proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;  
            proxy_set_header   X-Forwarded-Proto  $scheme; 
         }
     
        
         #采用uwsgi方式
         location /python/ {
             include uwsgi_params;
             uwsgi_pass 127.0.0.1:33333;
         }
        
        # FastCGI方式
        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;
        }
        
        #访问nginx本机目录的文件
        location / {
            root   /home/hk/;
            index  index.html index.htm;
        }
        
        location  /static/ {
             alias /var/static/;
        }

        # 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;
        }
    }

– 求知若饥，虚心若愚。

更多推荐

【Java核心】JDK、JRE、 JVM的联系与区别

个人简介：Java领域新星创作者；阿里云技术博主、星级博主、专家博主；正在Java学习的路上摸爬滚打，记录学习的过程~个人主页：.29.的博客学习社区：进去逛一逛~JDK、JRE、JVM的联系与区别1.简述2.是什么3.联系和区别1.简述简单来说：JDK是开发Java程序所需的工具包，包含了JRE，并且额外提供了开发工

Linux高性能服务器编程 学习笔记 第四章 TCP/IP通信案例：访问Internet上的Web服务器

Web客户端和服务器之间使用HTTP协议通信。我们按以下方式来部署通信实例：在Kongming20上运行wget客户端程序（一个在命令行下使用的网络下载工具，它支持通过HTTP、HTTPS和FTP协议下载文件），在ernest-laptop上运行squid代理服务器程序（主要用于缓存和转发网络请求，从而提高网络性能、安

免费IP类api接口：含ip查询、ip应用场景查询、ip代理识别、IP行业查询...

免费IP类api接口：含ip查询、ip应用场景查询、ip代理识别…IP归属地-IPv6区县级：根据IP地址（IPv6版本）查询归属地信息，包含国家、省、市、区县和运营商等信息。IP归属地-IPv6城市级：根据IP地址（IPv6版本）查询归属地信息，支持到中国大陆地区（不含港澳台地区）城市级别，包含国家、省、市和运营商等

酷开科技打造更好体验服务用户

智能电视以其海量资源、智慧大屏、高清画质等特点在国内快速普及。然而，随着用户量的增加、用户群体的需求多元化，导致消费者对智能电视的应用要求越来越高，不仅希望智能电视内容丰富，最好还能拥有“多合一”的功能。好在，一些科技企业关注到市场痛点，致力于将技术创新与完善的内容输出相结合，为广大消费者带来更多惊喜。酷开科技就是其中

Kafka开篇

前言从本篇开始对个人Kafka学习做一个总结,目标有这么几个。从概念架构角度,对消息中间件形成概要认知;从使用角度,掌握其常见用法;从性能角度,探究其高性能实现机制;消息中间件的用途从消息生产和消费的角度,平衡消费者和消费者的速率差。基于该点可以做到削峰填谷,比如流量突发,日志处理等。从系统解耦的角度,解耦生产者和消费

React 全栈体系（九）

第五章React路由一、相关理解1.SPA的理解单页Web应用（singlepagewebapplication，SPA）。整个应用只有一个完整的页面。点击页面中的链接不会刷新页面，只会做页面的局部更新。数据都需要通过ajax请求获取,并在前端异步展现。2.路由的理解2.1什么是路由?一个路由就是一个映射关系(key:

Mysql的常见错误总结

Mysql的常见错误总结Datatruncation:Outofrangevalueofforcolumn在执行一个update语句的时候，报错Datatruncation:Outofrangevalueofforcolumn‘CLAIM_QUANTITY’…update语句是把’CLAIM_QUANTITY’这个字段

使用Python编写一个多线程的12306抢票程序

国庆长假即将到来，大家纷纷计划着自己的旅行行程。然而，对于很多人来说，抢购火车票人们成了一个令人头疼的问题。12306网站的服务器经常因为流量高而崩溃，导致抢票变得越来越严重异常困难。首先，让我们来了解一下12306抢票的难点。由于很多人都在同一时间段内访问12306网站，服务器的负载率非常高，导致网站响应变慢甚至崩溃

【uniapp】小程序开发：3 分包配置

分包加载配置，此配置为小程序的分包加载机制。因小程序有体积和资源加载限制，各家小程序平台提供了分包方式，优化小程序的下载和启动速度。所谓的主包，即放置默认启动页面/TabBar页面，以及一些所有分包都需用到公共资源/JS脚本；而分包则是根据pages.json的配置进行划分。在小程序启动时，默认会下载主包并启动主包内页

ReactNative 网络库

WhatJS判断网络状态不准确react-native-netinfo在Android中的结构type-CellularGeneration：G网模式枚举type-ConnectionType：网络连接类型AmazonFireDeviceConnectivityPoller：Amazon设备网络适配，可忽略Broadc

字符串函数和内存函数详解（2）

🐵本文会将会对剩余的字符串库函数和内存函数进行讲解1.strstr📚1.1函数用法✏️strstr函数原型：strstr用于在字符串中找子串，strstr会返回str1中出现str2的起始地址，如果在str1中没有找到str2，则返回空指针1.2具体实现🖊️#include<stdio.h>#include<st

热文推荐
  1. pycharm中恢复原始界面布局_常用快捷键_常用设置

    文章目录1恢复默认布局1.1直接点击file→ManageIDESettings→RestoreDefaultSettings（如下图所示）：1.2直接点击RestoreandRestart，然后Pycharm就会自动重启，重启之后的界面就是最原始的界面了2改变主题2.1在PyCharm的右上角，点击“齿轮,然后点击:

  2. ThreadPoolExecutor的使用

    1.在SpringBoot项目中使用ThreadPoolExecutor:SpringBoot中可以通过创建一个配置类来定义ThreadPoolExecutor，然后在需要使用的地方直接注入即可。@ConfigurationpublicclassThreadPoolConfig{@BeanpublicExecutora

  3. 【OpenSSL】VC编译OpenSSL

    VC编译OpenSSL编译工具准备编译OpenSSL建立`HelloWorld`工程创建VS工程编译工具准备安装好VisualStudio。安装Perl,主要是用来生成nmake的。准备好汇编语言编译工具nasm,并添加到path路径。下载好OpenSSL源代码。编译OpenSSL安装Perl,并加入到path路径，检

  4. Sentinel控制台配置 持久化到nacos

    sentinel控制台，使用方便，功能强大。使用官方的jar包，配置不会持久化，sentinel重启后会导致，之前的规则全部丢失，下面一起改造源码实现规则数据的持久化sentinel源码地址（github访问太慢，直接上镜像版）Sentinel:Sentinel是什么随着微服务的流行，服务和服务之间的稳定性变得越来越重

  5. 深入了解代理服务器：Socks5、IP代理与网络安全

    在当今数字化时代，网络安全和数据采集对于网络工程师和爬虫开发者来说至关重要。代理服务器是一项关键技术，为保护隐私、绕过访问限制和提高网络安全提供了有力工具。本文将深入探讨几种不同类型的代理服务器，包括Socks5代理、IP代理，以及它们在网络安全和爬虫开发中的作用。1.Socks5代理：全能的代理协议Socks5代理协

  6. 什么是网络安全?网络安全包括哪几个方面?

    提及网络安全，很多人都是既熟悉又陌生，所谓的熟悉就是知道网络安全可以保障网络服务不中断。那么到底什么是网络安全?网络安全包括哪几个方面?通过下文为大家介绍一下。什么是网络安全?网络安全是指网络系统的硬件、软件及系统中的数据受到保护，不因偶然的或者恶意的原因而遭受到破坏、更改、泄露，系统连续可靠正常地运行，网络服务不中断

  7. 由于数字化转型对集成和扩展性的要求，定制化需求难以满足，百数低代码服务商该如何破局？

    当政策、技术环境的日益成熟，数字化转型逐步成为企业发展的必选项，企业数字化转型不再是一道选择题，而是决定其生存发展的必由之路。通过数字化转型升级生产方式、管理模式和组织形式，激发内生动力，成为企业顺应时代变化，实现高质量发展的必然选择。一般来说，实现数字化转型的方式有3种：采购已有的标准系统、定制外包或者选购低代码平台

  8. iOS17适配指南-新版

    文章目录一、iOS17适配点二、具体代码一、iOS17适配点UIView与UIViewController。可以设置数据为空时的占位视图，增加SymbolAnimations，通过addSymbolEffect()与removeSymbolEffect()方法，可以实现SFSymbols图标的添加与移除动画。UIPag

  9. 通讯网关软件007——利用CommGate X2Mbt实现Modbus TCP访问MSSQL服务器

    本文介绍利用CommGateX2Mbt实现ModbusTCP访问MSSQL数据库。CommGateX2MBT是宁波科安网信开发的网关软件，软件可以登录到网信智汇(wangxinzhihui.com)下载。【案例】如下图所示，实现上位机通过ModbusTCP来获取MSSQL数据库的数据。【解决方案】设置网关机，与MSSQ