Nginx 配置文件详细说明

本文记录了 Nginx 服务器 nginx.conf 配置文件的详细说明，部分注释整理自网络资源。以下配置示例展示了基础结构及负载均衡的实现方式。

基础配置示例

以下为 Nginx 的基础配置文件结构，包含用户设置、进程管理、事件处理及 HTTP 服务的基本设定。

# 运行用户
user www-data;    

# 启动进程数，通常设置成和 CPU 的数量相等
worker_processes  1;

# 全局错误日志及 PID 文件
error_log  /var/log/nginx/error.log;
pid        /var/run/nginx.pid;

# 工作模式及连接数上限
events {
    # epoll 是多路复用 IO (I/O Multiplexing) 中的一种方式，仅用于 Linux 2.6 以上内核，可大大提高 Nginx 性能
    use   epoll;             
    # 单个后台 worker process 进程的最大并发链接数
    worker_connections  1024;
    # multi_accept on; 
}

# 设定 HTTP 服务器，利用它的反向代理功能提供负载均衡支持
http {
    # 设定 mime 类型，类型由 mime.types 文件定义
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;

    # 设定日志格式
    access_log    /var/log/nginx/access.log;

    # 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]\.(?!.*SV1)";

    # 设定请求缓冲
    client_header_buffer_size    1k;
    large_client_header_buffers  4 4k;

    include /etc/nginx/conf.d/*.conf;
    include /etc/nginx/sites-enabled/*;

    # 设定负载均衡的服务器列表
    upstream mysvr {
        # weight 参数表示权值，权值越高被分配到的几率越大
        server 192.168.8.1:3128 weight=5; # 本机上的 Squid 开启 3128 端口
        server 192.168.8.2:80  weight=1;
        server 192.168.8.3:80  weight=6;
    }

    server {
        # 侦听 80 端口
        listen       80;
        # 定义使用 www.xx.com 访问
        server_name  www.xx.com;

        # 设定本虚拟主机的访问日志
        access_log  logs/www.xx.com.access.log  main;

        # 默认请求
        location / {
            root   /root;      # 定义服务器的默认网站根目录位置
            index index.php index.html index.htm;   # 定义首页索引文件的名称

            fastcgi_pass  www.xx.com;
            fastcgi_param  SCRIPT_FILENAME  $document_root/$fastcgi_script_name; 
            include /etc/nginx/fastcgi_params;
        }

        # 定义错误提示页面
        error_page   500 502 503 504 /50x.html;  
        location = /50x.html {
            root   /root;
        }

        # 静态文件，nginx 自己处理
        location ~ ^/(images|javascript|js|css|flash|media|static)/ {
            root /var/www/virtual/htdocs;
            # 过期 30 天，静态文件不怎么更新，过期可以设大一点；如果频繁更新，则可以设置得小一点
            expires 30d;
        }

        # PHP 脚本请求全部转发到 FastCGI 处理，使用 FastCGI 默认配置
        location ~ \.php$ {
            root /root;
            fastcgi_pass 127.0.0.1:9000;
            fastcgi_index index.php;
            fastcgi_param SCRIPT_FILENAME /home/www/www$fastcgi_script_name;
            include fastcgi_params;
        }

        # 设定查看 Nginx 状态的地址
        location /NginxStatus {
            stub_status            on;
            access_log              on;
            auth_basic              "NginxStatus";
            auth_basic_user_file  conf/htpasswd;
        }

        # 禁止访问 .htxxx 文件
        location ~ /\.ht {
            deny all;
        }
    }
}

负载均衡配置说明

以上是一些基本的配置，使用 Nginx 最大的好处之一就是负载均衡。如果要使用负载均衡的话，可以修改配置 http 节点如下。以下示例展示了如何针对特定后缀（如 .aspx）的请求进行反向代理与负载分发。

# 设定 HTTP 服务器，利用它的反向代理功能提供负载均衡支持
http {
    # 设定 mime 类型，类型由 mime.type 文件定义
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;

    # 设定日志格式
    access_log    /var/log/nginx/access.log;

    # ... 省略上文有的一些配置节点 ...

    # 设定负载均衡的服务器列表
    upstream mysvr {
        # weight 参数表示权值，权值越高被分配到的几率越大
        server 192.168.8.1:3128 weight=5; # 本机上的 Squid 开启 3128 端口
        server 192.168.8.2:80  weight=1;
        server 192.168.8.3:80  weight=6;
    }

    upstream mysvr2 {
        # weight 参数表示权值，权值越高被分配到的几率越大
        server 192.168.8.1:80  weight=1;
        server 192.168.8.2:80  weight=6;
    }

    # 第一个虚拟服务器
    server {
        # 侦听 192.168.8.x 的 80 端口
        listen       80;
        server_name  192.168.8.1;

        # 对 aspx 后缀的进行负载均衡请求
        location ~ .*\.aspx$ {
            root   /root;      # 定义服务器的默认网站根目录位置
            index index.php index.html index.htm;   # 定义首页索引文件的名称

            proxy_pass  http://mysvr; # 请求转向 mysvr 定义的服务器列表

            # 以下是一些反向代理的配置，可根据需要删除或调整
            proxy_redirect off;

            # 后端的 Web 服务器可以通过 X-Forwarded-For 获取用户真实 IP
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

            client_max_body_size 10m;    # 允许客户端请求的最大单文件字节数
            client_body_buffer_size 128k;  # 缓冲区代理缓冲用户端请求的最大字节数
            proxy_connect_timeout 90;  # nginx 跟后端服务器连接超时时间 (代理连接超时)
            proxy_send_timeout 90;        # 后端服务器数据回传时间 (代理发送超时)
            proxy_read_timeout 90;         # 连接成功后，后端服务器响应时间 (代理接收超时)
            proxy_buffer_size 4k;             # 设置代理服务器（nginx）保存用户头信息的缓冲区大小
            proxy_buffers 4 32k;               # proxy_buffers 缓冲区，网页平均在 32k 以下的话，这样设置
            proxy_busy_buffers_size 64k;    # 高负荷下缓冲大小（proxy_buffers*2）
            proxy_temp_file_write_size 64k;  # 设定缓存文件夹大小，大于这个值，将从 upstream 服务器传
        }
    }
}

说明

  1. 版本时效性：文中部分注释（如 epoll 仅用于 Linux 2.6 以上内核、gzip_disable 针对 IE6 等）基于较早期的 Nginx 版本及操作系统环境。现代生产环境通常使用更新的 Linux 内核及 Nginx 稳定版，部分参数默认值可能已优化。
  2. 配置路径：示例中的文件路径（如 /root、/var/log/nginx/ 等）及 IP 地址均为示例值，实际部署时请根据服务器环境进行调整。
  3. 语法修正：原文注释中的拼写错误（如 weigth）已在代码块中修正为 weight，以确保术语准确性。