Nginx 內建兩大緩存子系統:proxy_cache (反向代理/上游伺服器回應緩存) 與 fastcgi_cache (FastCGI 應用回應緩存,如 PHP-FPM)。正確配置可將動態頁面響應時間從 100ms 降至 1ms 以內,大幅降低上游壓力。本文系統講解核心指令、快取鍵設計、清除策略與生產調優參數。
一、proxy_cache:反向代理緩存
核心指令速查
| 指令 | 作用域 | 功能 | 範例 |
proxy_cache_path | http | 定義快取區路徑、層級、大小、非活動過期、鍵區名稱 | proxy_cache_path /data/nginx/cache levels=1:2 keys_zone=my_cache:100m inactive=24h max_size=10g; |
proxy_cache | http/server/location | 啟用指定 zone | proxy_cache my_cache; |
proxy_cache_key | http/server/location | 定義快取鍵 (支援變數) | proxy_cache_key "$scheme$request_method$host$request_uri$args"; |
proxy_cache_valid | http/server/location | 針對狀態碼設定緩存 TTL | proxy_cache_valid 200 302 10m; proxy_cache_valid 404 1m; |
proxy_cache_methods | http/server/location | 可緩存的 HTTP 方法 | proxy_cache_methods GET HEAD POST; |
proxy_cache_min_uses | http/server/location | 最少請求次數才緩存 (防洪) | proxy_cache_min_uses 3; |
proxy_no_cache | http/server/location | 條件不緩存 (如登入用戶) | proxy_no_cache $cookie_sessionid $arg_nocache; |
proxy_cache_bypass | http/server/location | 條件繞過快取直接請求上游 | proxy_cache_bypass $cookie_sessionid $arg_nocache; |
proxy_cache_lock | http/server/location | 開啟快取鎖 (防擊穿) | proxy_cache_lock on; proxy_cache_lock_timeout 5s; |
proxy_cache_use_stale | http/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_path | proxy_cache_path | 必須在 http 區塊,路徑需同檔案系統 |
fastcgi_cache | proxy_cache | |
fastcgi_cache_key | proxy_cache_key | 常用 "$scheme$request_method$host$request_uri$args" |
fastcgi_cache_valid | proxy_cache_valid | |
fastcgi_cache_methods | proxy_cache_methods | 預設 GET HEAD |
fastcgi_cache_min_uses | proxy_cache_min_uses | |
fastcgi_no_cache | proxy_no_cache | |
fastcgi_cache_bypass | proxy_cache_bypass | |
fastcgi_cache_lock | proxy_cache_lock | |
fastcgi_cache_use_stale | proxy_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;
}
}
}
三、緩存清除策略
- ngx_cache_purge 模組 (第三方):提供
proxy_cache_purge / fastcgi_cache_purge 指令,支援 URL 精確清除。編譯時 --add-module=../ngx_cache_purge。
- 非活動過期:
inactive=24h 自動清理未訪問項目。
- 最大空間淘汰:
max_size=10g 達標時按 LRU 淘汰。
- 手動清理腳本:
find /data/nginx/cache -type f -mmin +60 -delete (謹慎,可能誤刪活躍項)。
- 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 → 快取更新瞬間大量請求穿透上游 (擊穿)。