Nginx 反向代理配置實戰教程

場景

服務器同時運行 PHP（端口 80/443）與 Java/Tomcat（端口 8080）應用，需通過域名將請求路由到對應後端。

核心配置示例：代理 Tomcat 應用

server {
    listen 80;
    server_name portal.jser.io;
    server_tokens off;  # 隱藏 Nginx 版本號

    location / {
        proxy_pass https://localhost:8080/;
        proxy_redirect off;

        # 傳遞客戶端真實信息
        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 支持（可選）
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";

        # 超時設置
        proxy_connect_timeout 60s;
        proxy_send_timeout 60s;
        proxy_read_timeout 60s;
    }
}

關鍵指令解析

多站點部署策略

• 每個域名一個 server 塊，配置在 /etc/nginx/conf.d/ 下獨立文件
• 靜態資源直接由 Nginx 服務（root + location），動態請求 proxy_pass 到後端
• SSL 終結在 Nginx，後端走 HTTP，減輕應用服務器負擔

負載均衡擴展（可選）

upstream tomcat_cluster {
    server 127.0.0.1:8080 weight=3;
    server 127.0.0.1:8081 weight=2;
    server 192.168.1.10:8080 backup;  # 熱備
}

server {
    location / {
        proxy_pass https://tomcat_cluster;
        # ... 其他 proxy_set_header
    }
}

常見問題排查

• 502 Bad Gateway：上游未啟動、端口錯誤、防火牆阻擋、SELinux
• 靜態資源 404：後端生成的絕對路徑不匹配，需配置 proxy_redirect 或前端使用相對路徑
• Header 丟失：Nginx 默認隱藏下劃線 Header，添加 underscores_in_headers on;
• 大文件上傳截斷：設置 client_max_body_size 100M;