全部產品
Search
文件中心

API Gateway:瀏覽器緩衝控制外掛程式

更新時間:Jan 10, 2025

cache-control外掛程式實現了基於 URL 檔案尾碼來為請求的回應標頭部添加 Expires 和 Cache-Control 頭部,從而方便瀏覽器對特定尾碼的檔案進行緩衝,例如 jpgpng 等圖片檔案。

運行屬性

外掛程式執行階段:認證階段 外掛程式執行優先順序:420

配置欄位

名稱

資料類型

填寫要求

預設值

描述

suffix

string

選填,表示匹配的檔案尾碼名,例如 jpgpng 等。

如果需要匹配多種尾碼,需要用 | 進行分割,例如 png|jpg

如果不填寫,表示匹配所有尾碼

-

配置用於匹配的請求檔案尾碼

expires

string

必填,表示緩衝的最長時間。

當填入的字串為數字時,單位為秒,例如需要緩衝1小時,需填寫 3600。

另外,還可以填寫 epoch 或 max

,與 nginx 中語義相同。

-

配置緩衝的最大時間

配置樣本

  1. 緩衝尾碼為 jpgpngjpeg 的檔案,緩衝時間為一小時。

    suffix: jpg|png|jpeg
    expires: 3600

    根據該配置,下列請求在訪問時,將會在回應標頭中添加 Expires 和 Cache-Control 欄位,且到期時間為 1 小時後。

    curl http://example.com/test.png
    curl http://exmaple.com/test.jpg
  2. 緩衝所有檔案,且緩衝至最大時間 “Thu, 31 Dec 2037 23:55:55 GMT”

    expires: max