Nginx 的配置文件

核心概念:

  1. 指令 (Directives): 配置文件的基本构建块。每条指令以分号 ; 结束。指令可以设置参数(如 worker_processes auto;)。

  2. 上下文 (Contexts): 指令被组织在特定的块(用花括号 {} 包围)中,称为上下文。上下文定义了指令的作用范围,并可以嵌套。不同上下文中的指令可以继承或覆盖外层上下文的值。

  3. 继承性: 内层上下文中的指令可以继承外层上下文的值(如果内层没有显式设置该指令)。内层指令的设置会覆盖外层指令的设置。

主要配置文件结构:

一个典型的 nginx.conf 文件遵循以下层次结构:

复制代码
# 全局上下文 (Main Context) - 影响整个 Nginx 进程
user nginx;                         # 运行 worker 进程的用户和组
worker_processes auto;              # 工作进程数,通常设为 CPU 核心数或 'auto'
error_log /var/log/nginx/error.log warn; # 错误日志路径和级别 (debug, info, notice, warn, error, crit, alert, emerg)
pid /run/nginx.pid;                 # 存储主进程 ID 的文件

# 事件处理模型配置 (Events Context) - 配置网络连接处理
events {
    worker_connections 1024;        # 每个工作进程的最大并发连接数(直接影响最大并发量)
    # multi_accept on;              # 是否一次接受所有新连接 (默认 off)
    # use epoll;                    # 指定高效的事件模型 (Linux 下推荐 epoll)
}

# HTTP 核心配置 (HTTP Context) - 所有 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;                  # 在 sendfile 开启时启用,优化网络包发送
    tcp_nodelay on;                 # 禁用 Nagle 算法,降低延迟
    keepalive_timeout 65;           # 客户端保持连接的超时时间(秒)
    types_hash_max_size 2048;       # 类型哈希表大小,影响性能

    # Gzip 压缩
    gzip on;                        # 启用 Gzip 压缩
    gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript; # 压缩的文件类型
    gzip_min_length 1024;           # 最小压缩文件大小
    gzip_comp_level 2;              # 压缩级别 (1-9, 越高压缩率越高但越耗 CPU)
    gzip_vary on;                   # 根据客户端是否支持 Gzip 添加 Vary 头

    # 虚拟主机配置 (Server Context) - 定义一个网站或服务
    server {
        listen 80;                  # 监听端口 (常用 80 或 443)
        server_name example.com www.example.com; # 服务器名称(域名),用于区分不同虚拟主机

        # 根目录和索引文件
        root /var/www/example.com;  # 网站文件的根目录
        index index.html index.htm; # 默认索引文件名(按顺序查找)

        # 位置块 (Location Context) - 匹配特定 URI 路径,进行精细化配置
        location / {
            # 尝试访问文件 $uri, 找不到则尝试目录 $uri/, 再找不到则返回 404
            try_files $uri $uri/ =404;
        }

        # 处理静态文件 (如图片、CSS、JS) 的 location 示例 (通常有性能优化)
        location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
            expires 30d;            # 设置浏览器缓存过期时间 (30天)
            add_header Cache-Control "public"; # 添加缓存控制头
            access_log off;         # 可选:关闭此 location 的访问日志以减少日志量
        }

        # 反向代理配置示例 (将请求转发给后端应用服务器)
        location /api/ {
            proxy_pass http://backend_server; # 定义在 upstream 块中的后端服务器组名或具体地址
            proxy_set_header Host $host;      # 将原始请求的 Host 头发给后端
            proxy_set_header X-Real-IP $remote_addr; # 将客户端真实 IP 传给后端
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; # 传递代理链信息
            proxy_set_header X-Forwarded-Proto $scheme; # 传递原始请求协议 (http/https)
        }

        # 错误页面自定义
        error_page 404 /404.html;   # 自定义 404 错误页面
        location = /404.html {
            internal;               # 该页面只能由 Nginx 内部重定向访问
            root /usr/share/nginx/html; # 错误页面的根目录
        }
        error_page 500 502 503 504 /50x.html; # 自定义 5xx 错误页面
        location = /50x.html {
            internal;
            root /usr/share/nginx/html;
        }
    }

    # HTTPS 服务器配置示例 (在 server 块内)
    server {
        listen 443 ssl http2;       # 监听 443 端口,启用 SSL/TLS 和 HTTP/2
        server_name secure.example.com;

        # SSL 证书和密钥路径
        ssl_certificate /etc/nginx/ssl/example.com.crt; # 证书文件 (通常包含完整链)
        ssl_certificate_key /etc/nginx/ssl/example.com.key; # 私钥文件

        # SSL 协议和加密套件配置 (强调安全性和兼容性)
        ssl_protocols TLSv1.2 TLSv1.3; # 启用 TLS 1.2 和 1.3 (禁用不安全的 TLSv1, TLSv1.1)
        ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:...'; # 推荐的安全加密套件列表
        ssl_prefer_server_ciphers on; # 优先使用服务器端提供的加密套件
        ssl_session_cache shared:SSL:10m; # 配置 SSL 会话缓存以提高性能
        ssl_session_timeout 10m;    # SSL 会话超时时间

        # 其他配置 (root, location 等) 和 HTTP 服务器类似...
        # 通常会将 HTTP 请求重定向到 HTTPS
    }

    # 负载均衡配置 (Upstream Context) - 定义一组后端服务器
    upstream backend_server {
        # 负载均衡算法 (默认轮询 round-robin)
        # least_conn;               # 最少连接数
        # ip_hash;                  # 基于客户端 IP 的哈希 (用于会话保持)

        # 定义后端服务器
        server backend1.example.com:8080 weight=3; # 服务器地址:端口, weight 设置权重 (越高被分配请求越多)
        server backend2.example.com:8080;          # 默认权重为 1
        server backup.example.com:8080 backup;     # 标记为备份服务器,主服务器不可用时才启用
        # server unix:/tmp/backend.sock; # 也可以使用 Unix 域套接字
    }
}
相关推荐
胖虎16 小时前
iOS上传应用包错误问题 “Invalid bundle. The “UIInterfaceOrientationPortrait”“
ios·审核·苹果审核·苹果传包
安和昂7 小时前
【iOS】ARC 与 Autorelease
macos·ios·cocoa
豪冷啊9 小时前
iOS UIActivityViewController 组头处理
ios·objective-c·xcode
二流小码农12 小时前
鸿蒙开发:loading动画的几种实现方式
android·ios·harmonyos
wsxlgg12 小时前
IOS 打包账号发布上传和IOS Xcode证书配置
ios
Digitally12 小时前
iTunes 无法备份 iPhone:10 种解决方法
ios·gradle·iphone
胖虎115 小时前
SwiftUI 数据绑定与视图更新(@State、@ObservedObject、@EnvironmentObject)
ios·swiftui·swift
Macle_Chen18 小时前
ios版本的Tiktok二次安装不上,提示:Unable to Install “TikTok”
ios·职场和发展·蓝桥杯
解压专家66618 小时前
Mac/iOS 如何解压 RAR 格式压缩包:常用工具与详细操作步骤
macos·ios
依旧0020 小时前
react native webview加载本地HTML,解决iOS无法加载成功问题
react native·ios·html·vite·webview