Nginx 配置速查：从基础到进阶常用配置

2026-08-05

前言

Nginx 是目前最流行的 Web 服务器和反向代理工具，性能高、配置灵活。本文整理了实际开发中最高频用到的配置，按场景分类，方便查阅。

一、基础配置

主配置文件结构

/etc/nginx/
├── nginx.conf          # 主配置
├── sites-available/    # 可用站点
└── sites-enabled/      # 已启用站点（软链接）

检查配置和重载

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
# 检查配置语法
nginx -t

# 平滑重载（不中断服务）
nginx -s reload

# 重启
systemctl restart nginx

# 查看状态
systemctl status nginx

最简单的静态站点

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
server {
    listen 80;
    server_name example.com;
    root /var/www/html;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

启用站点：

1
2
ln -s /etc/nginx/sites-available/example.conf /etc/nginx/sites-enabled/
nginx -t && nginx -s reload

二、反向代理

基础反向代理

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
server {
    listen 80;
    server_name app.example.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

带路径重写的代理

1
2
3
4
5
location /api/ {
    # 去掉 /api 前缀再转发
    rewrite ^/api/(.*)$ /$1 break;
    proxy_pass http://backend;
}

WebSocket 支持

1
2
3
4
5
6
7
location /ws {
    proxy_pass http://backend;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_read_timeout 86400;
}

负载均衡

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
upstream myapp {
    server 127.0.0.1:3000 weight=1;
    server 127.0.0.1:3001 weight=2;
    # ip_hash;  # 按 IP 哈希，保持会话
    # least_conn;  # 最少连接
}

server {
    location / {
        proxy_pass http://myapp;
    }
}

三、HTTPS / SSL

HTTP 强转 HTTPS

1
2
3
4
5
server {
    listen 80;
    server_name example.com;
    return 301 https://$host$request_uri;
}

HTTPS 配置

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
server {
    listen 443 ssl http2;
    server_name example.com;

    # 证书
    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

    # SSL 安全配置
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;
    ssl_prefer_server_ciphers on;

    # SSL 会话缓存
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;

    # HSTS（谨慎使用，一旦启用至少半年）
    # add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;

    location / {
        root /var/www/html;
    }
}

Let’s Encrypt 免费证书

1
2
3
4
5
6
7
8
# 安装 certbot
sudo apt install certbot python3-certbot-nginx -y

# 一键申请 + 配置
sudo certbot --nginx -d example.com -d www.example.com

# 自动续期（certbot 会自动配置，一般不用管）
sudo certbot renew --dry-run

四、性能优化

Gzip 压缩

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
gzip on;
gzip_vary on;
gzip_min_length 1k;
gzip_comp_level 6;
gzip_types
    text/plain
    text/css
    text/xml
    text/javascript
    application/json
    application/javascript
    application/xml+rss
    image/svg+xml;

静态资源缓存

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
# 图片、字体、CSS/JS 缓存 30 天
location ~* \.(css|js|png|jpg|jpeg|gif|ico|svg|woff2|ttf|eot)$ {
    expires 30d;
    add_header Cache-Control "public, immutable";
}

# HTML 不缓存
location ~* \.html$ {
    add_header Cache-Control "no-cache, no-store, must-revalidate";
}

静态文件高效发送

1
2
3
sendfile on;
tcp_nopush on;
tcp_nodelay on;

五、安全配置

安全头

1
2
3
4
add_header X-Frame-Options "SAMEORIGIN" always;
add_header X-Content-Type-Options "nosniff" always;
add_header X-XSS-Protection "1; mode=block" always;
add_header Referrer-Policy "no-referrer-when-downgrade" always;

隐藏 Nginx 版本号

1
server_tokens off;

禁止访问隐藏文件

1
2
3
4
5
location ~ /\. {
    deny all;
    access_log off;
    log_not_found off;
}

限制上传大小

1
2
# 放在 http 或 server 块
client_max_body_size 10M;

Basic Auth 密码保护

1
2
3
4
5
# 安装工具
sudo apt install apache2-utils -y

# 创建密码文件
htpasswd -c /etc/nginx/.htpasswd admin

1
2
3
4
5
location /admin/ {
    auth_basic "Restricted Area";
    auth_basic_user_file /etc/nginx/.htpasswd;
    proxy_pass http://backend;
}

六、常用场景

1. WordPress

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
server {
    listen 443 ssl http2;
    server_name example.com;
    root /var/www/wordpress;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
    }
}

2. Vue/React 单页应用

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
server {
    listen 80;
    server_name app.example.com;
    root /var/www/dist;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }

    # API 反代
    location /api/ {
        proxy_pass http://backend:3000;
        proxy_set_header Host $host;
    }
}

3. 文件下载目录

1
2
3
4
5
location /downloads/ {
    autoindex on;
    autoindex_exact_size off;
    autoindex_localtime on;
}

4. 维护页面

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
location / {
    # 如果存在维护文件就显示维护页
    if (-f $document_root/maintenance.html) {
        return 503;
    }
    try_files $uri $uri/ /index.html;
}

error_page 503 /maintenance.html;
location = /maintenance.html {
    root /var/www/html;
}

七、日志与监控

日志格式

1
2
3
4
5
6
log_format main '$remote_addr - $remote_user [$time_local] '
                '"$request" $status $body_bytes_sent '
                '"$http_referer" "$http_user_agent" '
                '$request_time';

access_log /var/log/nginx/access.log main;

禁止访问日志

1
2
3
4
5
6
7
8
9
location = /favicon.ico {
    log_not_found off;
    access_log off;
}

location ~* \.(js|css|png|jpg|gif|ico|svg)$ {
    access_log off;
    expires 30d;
}

实时看访问日志

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
# 实时查看访问日志
tail -f /var/log/nginx/access.log

# 实时看错误日志
tail -f /var/log/nginx/error.log

# 统计访问量前10的IP
awk '{print $1}' /var/log/nginx/access.log | sort | uniq -c | sort -rn | head -10

# 统计状态码分布
awk '{print $9}' /var/log/nginx/access.log | sort | uniq -c | sort -rn

八、排错常用

502 Bad Gateway

后端服务没启动或地址不对，检查：

1
2
3
4
5
# 后端能访问吗？
curl -v http://127.0.0.1:3000

# 看错误日志
tail -20 /var/log/nginx/error.log

403 Forbidden

文件权限不对？（nginx 用户读不到）
目录下没有 index.html？
SELinux 阻止？（CentOS 常见）

1
2
3
4
5
6
# 检查文件权限
ls -la /var/www/html/

# 改权限
chown -R www-data:www-data /var/www/html
chmod -R 755 /var/www/html

404 Not Found

root / alias 路径写错了？
try_files 配置有问题？
路径重写的正则不对？

总结

Nginx 配置看起来多，但常用的也就这些。收藏本文，需要的时候来查就够了。

Nginx 的强大在于灵活，但也别过度配置，够用就好 🚀