以下是一个典型的 nginx.conf 配置文件,并附带中文注释,详细解释了各个配置项的作用:
# 全局配置段,配置影响整个 Nginx 服务器的设置

user nginx;  # Nginx worker 进程运行的用户
worker_processes auto;  # 自动设置 worker 进程的数量,通常设置为 CPU 核心数

error_log /var/log/nginx/error.log warn;  # 错误日志文件路径和日志级别

pid /var/run/nginx.pid;  # Nginx 主进程的 PID 文件路径

# events 配置段,配置 Nginx 的事件模型

events {
    worker_connections 1024;  # 每个 worker 进程的最大连接数
    multi_accept on;  # 启用多连接的接受模式
    use epoll;  # 使用 epoll 作为事件模型,可以是 epoll, kqueue, 或 select
}

# http 配置段,配置 HTTP 服务器

http {
    include /etc/nginx/mime.types;  # 引入 MIME 类型配置文件
    default_type application/octet-stream;  # 默认 MIME 类型

    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 /var/log/nginx/access.log main;  # 访问日志文件路径和使用的日志格式

    sendfile on;  # 启用 sendfile
    tcp_nopush on;  # 启用 TCP_NOPUSH
    tcp_nodelay on;  # 启用 TCP_NODELAY
    keepalive_timeout 65;  # 连接超时时间

    include /etc/nginx/conf.d/*.conf;  # 引入额外的配置文件

    server {
        # 虚拟主机配置

        listen 80;  # 监听端口

        server_name localhost;  # 服务器域名

        location / {
            root /usr/share/nginx/html;  # 静态文件根目录
            index index.html;  # 默认索引文件
        }

        error_page 500 502 503 504 /50x.html;  # 错误页面配置
        location = /50x.html {
            root /usr/share/nginx/html;
        }
    }
}

这个配置文件包含了 Nginx 的全局配置、事件配置和 HTTP 服务器配置。以下是配置文件的主要部分和注释:

  •  user 和 worker_processes:指定 Nginx 进程的运行用户和启动的 worker 进程数量。

  •  error_log:指定错误日志文件路径和日志级别。

  •  pid:指定 Nginx 主进程的 PID 文件路径。

  •  events 段:配置 Nginx 的事件模型,设置每个 worker 进程的最大连接数、多连接的接受模式以及使用的事件模型。

  •  http 段:配置 HTTP 服务器的一些全局设置,包括 MIME 类型、日志格式、静态文件处理等。

  •  log_format:定义日志的格式。

  •  access_log:指定访问日志文件路径和使用的日志格式。

  •  sendfile、tcp_nopush、tcp_nodelay、keepalive_timeout:配置文件传输相关的参数。

  •  include /etc/nginx/conf.d/*.conf;:引入额外的配置文件,通常用于组织复杂的配置结构。

  •  server 段:定义一个虚拟主机,包括监听的端口、服务器域名、静态文件根目录等。

  •  location / 段:定义了请求路径 / 的处理规则,包括静态文件根目录和默认索引文件。

  •  error_page 和 location = /50x.html:定义了错误页面的配置。


这个示例是一个简单的 Nginx 配置文件,实际的配置文件可能会更加复杂,根据具体的需求和场景进行调整。中文注释有助于理解各个配置项的作用。


转载请注明出处:http://www.zyzy.cn/article/detail/10161/Nginx