請(qǐng)求進(jìn)入 → 檢查proxy_no_cache條件
    ├─ 滿足no_cache → 跳過緩存，直接回源
    └─ 不滿足 → 計(jì)算cache_key → 查找緩存
        ├─ HIT → 返回緩存內(nèi)容（可能帶stale邏輯）
        ├─ MISS → 回源獲取響應(yīng)
        │     ├─ 響應(yīng)可緩存 → 寫入緩存 + 返回
        │     └─ 響應(yīng)不可緩存 → 僅返回
        └─ EXPIRED → 根據(jù)revalidate/use_stale決定行為

http {
    # ========== 1. 緩存存儲(chǔ)定義 ==========
    proxy_cache_path /var/cache/nginx/proxy
                     levels=1:2                    # 兩級(jí)目錄，避免單目錄inode瓶頸
                     keys_zone=app_cache:50m       # 內(nèi)存索引50MB ≈ 40萬條key
                     max_size=20g                  # 磁盤上限20GB
                     inactive=24h                  # 24小時(shí)未訪問自動(dòng)清除
                     use_temp_path=off             # ? 避免臨時(shí)文件拷貝開銷
                     manager_sleep=100ms           # 清理線程休眠間隔
                     loader_threshold=200ms;       # 加載超時(shí)閾值
    upstream backend {
        server 10.0.1.1:8080;
        server 10.0.1.2:8080;
    }
    server {
        listen 443 ssl http2;
        # ========== 2. 緩存啟用與Key設(shè)計(jì) ==========
        proxy_cache app_cache;
        proxy_cache_key "$scheme$request_method$host$request_uri";
        # ========== 3. 分級(jí)有效期策略 ==========
        proxy_cache_valid 200 301 302 1h;     # 成功響應(yīng)緩存1小時(shí)
        proxy_cache_valid 404 5m;              # 404短緩存，防止錯(cuò)誤固化
        proxy_cache_valid 500 502 503 0;      # ? 服務(wù)端錯(cuò)誤不緩存
        proxy_cache_valid any 30s;             # 兜底策略
        # ========== 4. 緩存條件控制 ==========
        # 不緩存非GET/HEAD請(qǐng)求
        proxy_no_cache $request_method;
        # 不緩存帶Cookie的請(qǐng)求（個(gè)性化內(nèi)容）
        proxy_no_cache $http_cookie;
        # 不緩存Authorization請(qǐng)求
        proxy_no_cache $http_authorization;
        # 尊重后端Cache-Control頭
        proxy_ignore_headers Set-Cookie;
        proxy_pass_header Cache-Control;
        # ========== 5. 容災(zāi)與防擊穿 ==========
        proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;
        proxy_cache_lock on;                   # ? 防止緩存擊穿
        proxy_cache_lock_timeout 5s;
        proxy_cache_revalidate on;             # 過期后用If-None-Match驗(yàn)證
        proxy_cache_background_update on;      # 后臺(tái)異步更新，用戶無感知
        # ========== 6. 狀態(tài)透?jìng)髋c調(diào)試 ==========
        add_header X-Cache-Status $upstream_cache_status always;
        add_header X-Cache-Key $upstream_cache_key always;
        location / {
            proxy_pass http://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;
        }
        # ========== 7. 靜態(tài)資源獨(dú)立策略 ==========
        location ~* \.(js|css|png|jpg|woff2)$ {
            proxy_cache_valid 200 7d;
            proxy_cache_key "$host$request_uri";  # 靜態(tài)資源忽略method
            expires 7d;
            add_header Cache-Control "public, immutable";
        }
        # ========== 8. API接口禁用緩存 ==========
        location /api/ {
            proxy_no_cache 1;
            proxy_cache_bypass 1;
            proxy_pass http://backend;
        }
    }
}

# ? 過于寬泛：不同用戶的個(gè)性化內(nèi)容共享同一緩存
proxy_cache_key "$host$request_uri";
# ? 過于精細(xì)：每個(gè)請(qǐng)求都miss，緩存形同虛設(shè)
proxy_cache_key "$scheme$request_method$host$request_uri$http_cookie$http_authorization$args";
# ? 按業(yè)務(wù)語義分層設(shè)計(jì)
# 公共內(nèi)容（文章列表、配置項(xiàng)）
proxy_cache_key "$host$request_uri$args";
# 用戶級(jí)內(nèi)容（個(gè)人中心、訂單）
proxy_cache_key "$host$request_uri$cookie_session_id";
# 靜態(tài)資源（忽略method和query string）
proxy_cache_key "$host$request_uri";

proxy_cache_lock on;
proxy_cache_lock_timeout 5s;          # 等待超時(shí)后放行回源
proxy_cache_lock_age 5s;              # 鎖持有最大時(shí)間

proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;

# ? 所有響應(yīng)緩存相同時(shí)間
proxy_cache_valid 200 1h;
# ? 按狀態(tài)碼和內(nèi)容類型分級(jí)
proxy_cache_valid 200 301 302 1h;     # 正常響應(yīng)
proxy_cache_valid 404 5m;              # 404短緩存（資源可能剛上線）
proxy_cache_valid 500 502 503 0;      # 服務(wù)端錯(cuò)誤絕不緩存
proxy_cache_valid 301 1d;             # 永久重定向長(zhǎng)緩存

proxy_cache_revalidate on;

log_format cache_log '$remote_addr [$time_local] "$request" '
                     '$status $body_bytes_sent '
                     '$upstream_cache_status $request_time '
                     '$upstream_response_time';

# Grafana面板關(guān)鍵Panel
- nginx_cache_hit_ratio
- nginx_cache_miss_total
- nginx_cache_expired_total
- nginx_cache_stale_total
- nginx_cache_size_bytes

# 編譯時(shí)加入
git clone https://github.com/FRiCKLE/ngx_cache_purge.git
./configure --add-module=/path/to/ngx_cache_purge [原有參數(shù)...]

# 限制purge來源IP
location ~ /purge(/.*) {
    allow 10.0.0.0/8;
    deny all;
    proxy_cache_purge app_cache "$scheme$request_method$host$1";
}

# 精確清理
curl -X PURGE "https://example.com/purge/api/config"