萬盛學電腦網

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

Nginx 緩存機制全解析:proxy_cache 與 fastcgi_cache 實戰配置指南

Nginx 內建兩大緩存子系統:proxy_cache (反向代理/上游伺服器回應緩存) 與 fastcgi_cache (FastCGI 應用回應緩存,如 PHP-FPM)。正確配置可將動態頁面響應時間從 100ms 降至 1ms 以內,大幅降低上游壓力。本文系統講解核心指令、快取鍵設計、清除策略與生產調優參數。

一、proxy_cache:反向代理緩存

核心指令速查

指令作用域功能範例
proxy_cache_pathhttp定義快取區路徑、層級、大小、非活動過期、鍵區名稱proxy_cache_path /data/nginx/cache levels=1:2 keys_zone=my_cache:100m inactive=24h max_size=10g;
proxy_cachehttp/server/location啟用指定 zoneproxy_cache my_cache;
proxy_cache_keyhttp/server/location定義快取鍵 (支援變數)proxy_cache_key "$scheme$request_method$host$request_uri$args";
proxy_cache_validhttp/server/location針對狀態碼設定緩存 TTLproxy_cache_valid 200 302 10m; proxy_cache_valid 404 1m;
proxy_cache_methodshttp/server/location可緩存的 HTTP 方法proxy_cache_methods GET HEAD POST;
proxy_cache_min_useshttp/server/location最少請求次數才緩存 (防洪)proxy_cache_min_uses 3;
proxy_no_cachehttp/server/location條件不緩存 (如登入用戶)proxy_no_cache $cookie_sessionid $arg_nocache;
proxy_cache_bypasshttp/server/location條件繞過快取直接請求上游proxy_cache_bypass $cookie_sessionid $arg_nocache;
proxy_cache_lockhttp/server/location開啟快取鎖 (防擊穿)proxy_cache_lock on; proxy_cache_lock_timeout 5s;
proxy_cache_use_stalehttp/server/location上游錯誤/更新時使用舊快取proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;

完整配置範例

http {
    # 1. 定義快取區 (放在 http 區塊)
    proxy_cache_path /data/nginx/proxy_cache levels=1:2 keys_zone=proxy_zone:100m inactive=1h max_size=5g use_temp_path=off;
    proxy_temp_path /data/nginx/proxy_temp;

    # 2. 上游定義
    upstream backend {
        server 10.0.0.10:80 weight=3;
        server 10.0.0.11:80 weight=2;
        keepalive 64;
    }

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

        location / {
            proxy_pass https://backend;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

            # 3. 啟用快取
            proxy_cache proxy_zone;
            proxy_cache_key "$scheme$request_method$host$request_uri$args";
            proxy_cache_valid 200 301 302 30m;
            proxy_cache_valid 404 1m;
            proxy_cache_valid any 5m;

            # 4. 防擊穿與舊快取服務
            proxy_cache_lock on;
            proxy_cache_lock_timeout 5s;
            proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;

            # 5. 登入用戶不緩存 (示例:Cookie 中有 sessionid)
            set $skip_cache 0;
            if ($cookie_sessionid) { set $skip_cache 1; }
            if ($arg_nocache) { set $skip_cache 1; }
            proxy_no_cache $skip_cache;
            proxy_cache_bypass $skip_cache;

            # 6. 快取狀態回應頭 (除錯用)
            add_header X-Cache-Status $upstream_cache_status;
        }

        # 7. 手動清除快取端點 (需 ngx_cache_purge 模組)
        location ~ /purge(/.*) {
            allow 127.0.0.1;
            allow 10.0.0.0/8;
            deny all;
            proxy_cache_purge proxy_zone "$scheme$request_method$host$1$is_args$args";
        }
    }
}

二、fastcgi_cache:FastCGI 應用緩存 (PHP-FPM 等)

核心指令對照 (語法與 proxy_cache 幾乎一致)

指令對應 proxy 指令備註
fastcgi_cache_pathproxy_cache_path必須在 http 區塊,路徑需同檔案系統
fastcgi_cacheproxy_cache
fastcgi_cache_keyproxy_cache_key常用 "$scheme$request_method$host$request_uri$args"
fastcgi_cache_validproxy_cache_valid
fastcgi_cache_methodsproxy_cache_methods預設 GET HEAD
fastcgi_cache_min_usesproxy_cache_min_uses
fastcgi_no_cacheproxy_no_cache
fastcgi_cache_bypassproxy_cache_bypass
fastcgi_cache_lockproxy_cache_lock
fastcgi_cache_use_staleproxy_cache_use_stale

PHP-FPM 緩存配置範例

http {
    fastcgi_cache_path /data/nginx/fastcgi_cache levels=1:2 keys_zone=php_zone:100m inactive=30m max_size=2g use_temp_path=off;
    fastcgi_temp_path /data/nginx/fastcgi_temp;

    server {
        location ~ \.php$ {
            fastcgi_pass unix:/run/php-fpm/www.sock;
            fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
            include fastcgi_params;

            fastcgi_cache php_zone;
            fastcgi_cache_key "$scheme$request_method$host$request_uri$args";
            fastcgi_cache_valid 200 301 302 20m;
            fastcgi_cache_valid 404 1m;

            fastcgi_cache_lock on;
            fastcgi_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;

            # 後台登入態不緩存
            set $no_cache 0;
            if ($cookie_php_session_id) { set $no_cache 1; }
            if ($request_method = POST) { set $no_cache 1; }
            fastcgi_no_cache $no_cache;
            fastcgi_cache_bypass $no_cache;

            add_header X-FastCGI-Cache $upstream_cache_status;
        }
    }
}

三、緩存清除策略

  1. ngx_cache_purge 模組 (第三方):提供 proxy_cache_purge / fastcgi_cache_purge 指令,支援 URL 精確清除。編譯時 --add-module=../ngx_cache_purge。
  2. 非活動過期:inactive=24h 自動清理未訪問項目。
  3. 最大空間淘汰:max_size=10g 達標時按 LRU 淘汰。
  4. 手動清理腳本:find /data/nginx/cache -type f -mmin +60 -delete (謹慎,可能誤刪活躍項)。
  5. API 驅動清除:應用層發布新內容時調用清除端點 (如 /purge/url)。

四、關鍵調優參數建議

  • levels=1:2:兩層子目錄 (1 字元 + 2 字元),平衡 inode 消耗與查找速度。
  • use_temp_path=off:直接在快取目錄寫入臨時檔,避免跨分區移動開銷 (需 Nginx 1.7.10+)。
  • proxy_cache_key:務必包含 $args (查詢字串),否則不同參數頁面會命中同一快取。
  • proxy_cache_valid any 5m:兜底規則,防止未匹配狀態碼永不緩存導致上游壓力。
  • 監控指標:$upstream_cache_status (HIT/MISS/BYPASS/EXPIRED/STALE/UPDATING) 納入日誌分析,目標 HIT Rate > 85%。

五、常見誤區

  • ❌ 在 server 區塊定義 proxy_cache_path → 必須在 http 區塊。
  • ❌ 快取目錄與 proxy_temp_path 不在同一分區 → 移動檔案觸發 I/O 瓶頸。
  • ❌ 未設定 proxy_cache_key 導致預設鍵不含查詢參數,造成不同參數頁面內容錯亂。
  • ❌ 緩存 POST 請求 → 極度危險,除非極度確認冪等且無副作用。
  • ❌ 忽略 proxy_cache_use_stale updating → 快取更新瞬間大量請求穿透上游 (擊穿)。
copyright © 萬盛學電腦網 all rights reserved