核心概念:
-
指令 (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/, 再找不到则返回 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 域套接字
}
}