萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Nginx 反向代理與前端全站快取完整配置教學

近期深入研究 Nginx 反向代理與前端快取配置,網路上教程雜亂無章,本文整理出最精簡、可直接落地的兩套設定範本,並說明關鍵指令與注意事項,適合快速上線的專案場景。

前置提醒:配置生效指令

修改完成後,必須重新載入 Nginx 配置,任選一條執行:

/root/lnmp reload
/etc/init.d/nginx reload

一、最精簡反向代理配置

僅需修改兩個網址(server_name 與 proxy_pass),存為 .conf 放入 vhost 目錄即可:

server {
    listen 80;
    server_name your-domain.com;          # ← 修改為你的域名
    location / {
        proxy_pass https://backend-ip:port; # ← 修改為上游服務地址
        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_cache 相關指令,實現靜態資源與動態頁面快取:

# http 區塊內新增快取區域(僅需一次)
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m use_temp_path=off;

server {
    listen 80;
    server_name your-domain.com;          # ← 修改為你的域名

    location / {
        proxy_pass https://backend-ip:port; # ← 修改為上游服務地址
        proxy_cache my_cache;
        proxy_cache_valid 200 302 10m;
        proxy_cache_valid 404 1m;
        proxy_cache_key $scheme$proxy_host$request_uri;
        add_header X-Cache-Status $upstream_cache_status;
        
        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;
    }

    # 靜態資源長期快取,不經後端
    location ~* \.(jpg|jpeg|png|gif|ico|css|js|woff|woff2)$ {
        proxy_pass https://backend-ip:port;
        proxy_cache my_cache;
        proxy_cache_valid 200 365d;
        expires 365d;
        add_header Cache-Control "public, immutable";
    }
}

關鍵參數說明

  • proxy_cache_path:定義快取目錄、層級、區域名、大小、過期策略。
  • proxy_cache_valid:針對不同狀態碼設定快取時長。
  • proxy_cache_key:快取鍵值,避免不同協議/主機/URI 撞車。
  • add_header X-Cache-Status:回應標頭標示 HIT/MISS/BYPASS,便於驗證快取命中率。
  • 靜態資源區塊獨立設定長期快取與 immutable,最大化瀏覽器與 CDN 效益。

適用場景與限制

本教學針對「簡單應用、自動更新不講解」的場景;若需快取清除、條件式快取、HTTPS 強制導向等進階需求,請參考官方文件擴充。

copyright © 萬盛學電腦網 all rights reserved