服务器与部署文章更新：2026年2月27日 3 分钟阅读

Nginx 配置指南

Nginx 安装、反向代理、HTTPS 配置、负载均衡与性能优化

目录 23 节

Nginx 配置指南

这页适合作为“反向代理与静态站点配置入口”。Nginx 真正常用的不是花哨指令，而是把站点入口、代理、TLS、缓存和限流几件事稳定拼起来。

安装

# Ubuntu/Debian
apt install nginx -y
systemctl enable nginx

# Docker
docker run -d --name nginx -p 80:80 -p 443:443 nginx:alpine

常用命令

nginx -t                  # 测试配置
nginx -s reload           # 重载配置
nginx -s stop             # 停止
systemctl status nginx    # 查看状态

基础配置

# /etc/nginx/sites-available/example.conf
server {
    listen 80;
    server_name example.com;
    root /var/www/example;
    index index.html;

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

启用站点：

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

常见场景

单页前端应用

前端路由项目通常需要 try_files 回退到入口文件，否则刷新子路由会 404。

反代后端 API

核心不是 proxy_pass 一条指令，而是把 Host、X-Forwarded-* 等头补齐，不然后端经常拿不到真实来源信息。

反向代理

server {
    listen 80;
    server_name api.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;
    }
}

WebSocket 支持

location /ws {
    proxy_pass http://127.0.0.1:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
}

HTTPS（Let's Encrypt）

配合 Certbot：

apt install certbot python3-certbot-nginx -y
certbot --nginx -d example.com -d www.example.com

手动配置 SSL：

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_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;
    ssl_prefer_server_ciphers on;

    # HSTS
    add_header Strict-Transport-Security "max-age=31536000" always;
}

# HTTP 重定向到 HTTPS
server {
    listen 80;
    server_name example.com;
    return 301 https://$host$request_uri;
}

负载均衡

upstream backend {
    server 127.0.0.1:3001;
    server 127.0.0.1:3002;
    server 127.0.0.1:3003;
}

server {
    listen 80;
    location / {
        proxy_pass http://backend;
    }
}

静态文件与缓存

# 静态资源缓存
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff2)$ {
    expires 30d;
    add_header Cache-Control "public, immutable";
}

# Gzip 压缩
gzip on;
gzip_types text/plain text/css application/json application/javascript text/xml;
gzip_min_length 1000;

限流

# 定义限流区域
limit_req_zone $binary_remote_addr zone=api:10m rate=10r/s;

server {
    location /api/ {
        limit_req zone=api burst=20 nodelay;
        proxy_pass http://127.0.0.1:3000;
    }
}