Nginx

这一课你将能做到

1. 配置 Nginx 反向代理：把 443 端口的 HTTPS 流量转发给本机 8080 的 Spring Boot
2. 配置静态资源服务、gzip 压缩、访问日志与限流等生产必备项
3. 用 nginx -t 验证配置并优雅重载，定位 502/504 等常见网关错误

为什么要学

你的 Spring Boot 应用监听 8080 端口，但用户访问的是 https://api.example.com 的 443 端口。中间的转换——HTTPS 卸载、域名匹配、请求转发、静态文件直出、负载均衡——就是 Nginx 干的活。它是几乎所有 Java 后端的「门面」：一台低配 Nginx 能扛几万并发连接，而它身后的 Java 应用只需要专注业务。

人话：Nginx 是餐厅的前台。顾客（用户）不直接进厨房（Java 应用），而是先找前台：前台收下点单（接收请求）、转给厨房（反向代理）、把菜端出去（返回响应）。加菜加人（扩容）时，前台还能把顾客均匀分到多个厨房窗口（负载均衡）。

先建立图像

用户 HTTPS 请求
     │ 443
     ▼
┌─────────────────────────────────────────┐
│                 Nginx                    │
│  ┌──────────────┐    ┌────────────────┐ │
│  │ TLS 卸载      │ →  │ location 路由   │ │
│  │ (证书/密钥)   │    │ /api/* → 后端   │ │
│  └──────────────┘    │ /*     → 静态文件│ │
│                      └───────┬────────┘ │
└──────────────────────────────┼──────────┘
                               │ proxy_pass http://127.0.0.1:8080
                               ▼
                      Spring Boot (8080)
                               │
                    ┌──────────┴──────────┐
                    ▼                     ▼
                MySQL (3306)         Redis (6379)

Nginx 配置的核心结构：

nginx.conf
├── events { worker_connections }     ← 全局：连接模型
└── http {                            ← HTTP 层：gzip、日志格式、限流区
    ├── upstream { 后端列表 }          ← 负载均衡池
    └── server {                      ← 虚拟主机：按域名区分站点
        ├── listen 443 ssl
        ├── server_name
        └── location { proxy_pass }   ← URL 路由规则
    }

跟着做

步骤 1：安装与基础命令

# Ubuntu
sudo apt install nginx -y

# 配置文件位置
ls /etc/nginx/           # nginx.conf 主配置，conf.d/ 和 sites-enabled/ 放站点配置

# 四个保命命令
sudo nginx -t                      # 改完配置先验证语法！
sudo systemctl reload nginx        # 优雅重载：不断开现有连接
sudo tail -f /var/log/nginx/access.log
sudo tail -f /var/log/nginx/error.log

步骤 2：反向代理 Spring Boot（核心配置）

创建 /etc/nginx/conf.d/myapp.conf：

server {
    listen 80;
    server_name api.example.com;

    # HTTP 全部 301 到 HTTPS（证书配好后启用）
    # return 301 https://$host$request_uri;

    location / {
        proxy_pass http://127.0.0.1:8080;

        # 这四个头必须传，否则后端拿不到真实信息
        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;

        # 超时控制：防止后端慢请求拖死连接
        proxy_connect_timeout 5s;
        proxy_read_timeout 60s;
    }
}