nginx 配置详解

737 阅读2分钟

直接看核心配置文件

#运行用户
user nobody;
#启动进程,通常设置成和cpu的数量相等
worker_processes  1;
 
#全局错误日志及PID文件
#error_log  logs/error.log;
#error_log  logs/error.log  notice;
#error_log  logs/error.log  info;
 
#pid        logs/nginx.pid;
 
#工作模式及连接数上限
events {
    #epoll是多路复用IO(I/O Multiplexing)中的一种方式,
    #仅用于linux2.6以上内核,可以大大提高nginx的性能
    use   epoll; 
 
    #单个后台worker process进程的最大并发链接数    
    worker_connections  1024;
 
    # 并发总数是 worker_processes 和 worker_connections 的乘积
    # 即 max_clients = worker_processes * worker_connections
    # 在设置了反向代理的情况下,max_clients = worker_processes * worker_connections / 4  为什么
    # 为什么上面反向代理要除以4,应该说是一个经验值
    # 根据以上条件,正常情况下的Nginx Server可以应付的最大连接数为:4 * 8000 = 32000
    # worker_connections 值的设置跟物理内存大小有关
    # 因为并发受IO约束,max_clients的值须小于系统可以打开的最大文件数
    # 而系统可以打开的最大文件数和内存大小成正比,一般1GB内存的机器上可以打开的文件数大约是10万左右
    # 我们来看看360M内存的VPS可以打开的文件句柄数是多少:
    # $ cat /proc/sys/fs/file-max
    # 输出 34336
    # 32000 < 34336,即并发连接总数小于系统可以打开的文件句柄总数,这样就在操作系统可以承受的范围之内
    # 所以,worker_connections 的值需根据 worker_processes 进程数目和系统可以打开的最大文件总数进行适当地进行设置
    # 使得并发总数小于操作系统可以打开的最大文件数目
    # 其实质也就是根据主机的物理CPU和内存进行配置
    # 当然,理论上的并发总数可能会和实际有所偏差,因为主机还有其他的工作进程需要消耗系统资源。
    # ulimit -SHn 65535
 
}
 
 
http {
    #设定mime类型,类型由mime.type文件定义
    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 指令指定 nginx 是否调用 sendfile 函数(zero copy 方式)来输出文件,
    #对于普通应用,必须设为 on,
    #如果用来进行下载等应用磁盘IO重负载应用,可设置为 off,
    #以平衡磁盘与网络I/O处理速度,降低系统的uptime.
    sendfile     on;
    #tcp_nopush     on;
 
    #连接超时时间
    #keepalive_timeout  0;
    keepalive_timeout  65;
    tcp_nodelay     on;
 
    #开启gzip压缩
    gzip  on;
    gzip_disable "MSIE [1-6].";
 
    #设定请求缓冲
    client_header_buffer_size    128k;
    large_client_header_buffers  4 128k;
 
 
    #设定虚拟主机配置
    server {
        #侦听80端口
        listen    80;
        #定义使用 www.nginx.cn访问
        server_name  www.nginx.cn;
 
        #定义服务器的默认网站根目录位置 $document_root 变量将会取 root 指定的目录,如果未设置,则下面的 location 中可能无法找到正确的文件
        root html;
 
        #设定本虚拟主机的访问日志
        access_log  logs/nginx.access.log  main;
 
        #默认请求
        location / {
            #定义首页索引文件的名称
            index index.php index.html index.htm;   
            
            # 目前大多数框架都需要重定向 URL
            # try_files 指令告诉 Nginx ,首先检查文件 $uri ,其次检查目录(也就是第二个参数) $uri/ ,如果文件或者目录都不存在,则将路由重定向到 /index.php 文件,并且附加请求参数($args 是nginx的变量)
            # nginx 更多变量可参考   https://nginx.org/en/docs/http/ngx_http_core_module.html#var_scheme
            try_files $uri $uri/ /index.php?$args;
        }
        
        # 匹配其他路由
        location = /admin/auth/ {
        	# nginx 配置文件检测小技巧:如果不确定你写的路由是否能匹配,可采用下面的方法检测,如果路由跳转到百度首页,则说明 URL 能进入到当前 location 中
         	return http://www.baidu.com;
         
        	#try_files $uri $uri/ /admin/auth/index;
        }
 
        # 定义错误提示页面
        error_page   500 502 503 504 /50x.html;
        location = /50x.html {
            //可以自定义错误页面
        }
 
        #静态文件,nginx自己处理
        # 直接支持静态文件
        location ~* ^.+.(jpg|jpeg|gif|css|png|js|ico|html|woff|ttf)$ {
          access_log        off;
          expires           30d;
        }
 
        # PHP 脚本请求全部转发到 FastCGI处理. 使用FastCGI默认配置.
        location ~ .php$ {
            # 默认nginx 将 php 请求转发给 scok;如果使用该方式监听 FastCGI 的请求,则去掉 # 
            # unix: 后面的值来源于 /usr/local/php/etc/php-fpm.conf 文件的listen 配置项 listen = /var/run/php/php7.4-fpm.sock
            # fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
            
            # 大多数情况使用 9000 端口监听 fastcgi 发送的请求
            # 注意同时要修改 /usr/local/php/etc/php-fpm.conf 文件中的 listen=127.0.0.1:9000 
            fastcgi_pass 127.0.0.1:9000;
            fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
            include fastcgi_params;
        }
 
        #禁止访问 .htxxx 文件
            location ~ /.ht {
            deny all;
        }
 
    }
}


常见问题梳理:
1.报错 502,通常是 server 配置不正确
参考的解决步骤:

1)检查 php-fpm 启用情况
    systemctl status php-fpm

2)检查 9000 端口是否开启
    lsof -i:9000

3)必须保证 nginx 配置项 server fastcgi_pass 的配置项 与 /usr/local/php/php-fpm.conf 文件中的 listen=127.0.0.1:9000 一致!这样 nginx 将 php 请求转发给php-fpm后才能准确接收,
下图1为 nginx 的虚拟机配置文件,图2为 php-fpm.conf 配置文件,两个标记的地方必须保持一致

图1

图2