Nginx 的配置文件
核心概念:
-
指令 (Directives): 配置文件的基本构建块。每条指令以分号
;
结束。指令可以设置参数(如worker_processes auto;
)。 -
上下文 (Contexts): 指令被组织在特定的块(用花括号
{}
包围)中,称为上下文。上下文定义了指令的作用范围,并可以嵌套。不同上下文中的指令可以继承或覆盖外层上下文的值。 -
继承性: 内层上下文中的指令可以继承外层上下文的值(如果内层没有显式设置该指令)。内层指令的设置会覆盖外层指令的设置。
主要配置文件结构:
一个典型的 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/, 再找不到则返回 404try_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/2server_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; # 默认权重为 1server backup.example.com:8080 backup; # 标记为备份服务器,主服务器不可用时才启用# server unix:/tmp/backend.sock; # 也可以使用 Unix 域套接字} }