nginx proxy cache配置參數解讀

alanoddsoff 發布于2019-07-25 14:08 / 3469人閱讀

序

本文主要解析一下nginx ngx_http_proxy_module中的cache相關配置參數。

proxy_cache

名稱	默認配置	作用域	官方說明	中文解讀	模塊
proxy_cache	proxy_cache off;	http, server, location	Defines a shared memory zone used for caching. The same zone can be used in several places. Parameter value can contain variables (1.7.9). The off parameter disables caching inherited from the previous configuration level.	設置是否開啟對后端響應的緩存，如果開啟的話，參數值就是zone的名稱，比如proxy_cache mycache	ngx_http_proxy_module
proxy_cache_valid	沒有默認值，實例如proxy_cache_valid 200 302 10m;	http, server, location	Sets caching time for different response codes.	針對不同的response code設定不同的緩存時間，如果不設置code，默認為200,301,302,也可以用any指定所有code	ngx_http_proxy_module
proxy_cache_key	proxy_cache_key $scheme$proxy_host$request_uri;	http, server, location	Defines a key for caching	給緩存設定key，默認值相當于proxy_cache_key $scheme$proxy_host$uri$is_args$args;	ngx_http_proxy_module
proxy_cache_path	沒有默認值，實例proxy_cache_path /var/cache levels=1:2 keys_zone=imgcache:100m inactive=2h max_size=1g;	http	Sets the path and other parameters of a cache. Cache data are stored in files. The file name in a cache is a result of applying the MD5 function to the cache key. The levels parameter defines hierarchy levels of a cache: from 1 to 3, each level accepts values 1 or 2.	指定緩存存儲的路徑，文件名為cache key的md5值，然后多級目錄的話，根據level參數來生成，比如levels=1:2:3，第一個目錄名取md5值的倒數第一個值，第二個目錄名取md5值的第2和3個值，第三個目錄名取md5值的第4，5，6個值；key_zone參數用來指定在共享內存中緩存的元數據的名稱和內存大小，比如keys_zone=imgcache:100m，所有的緩存查找首先經過這里查找元數據，如果命中再去文件系統查找相應的緩存；inactive用來指定緩存沒有被訪問超時移除的時間，默認是10分鐘，也可以自己指定比如inactive=2h ；max_size 用來指定緩存的最大值，超過這個值則會自動移除最近最少使用的緩存	ngx_http_proxy_module
proxy_cache_bypass	沒有默認值	http, server, location	Defines conditions under which the response will not be taken from a cache. If at least one value of the string parameters is not empty and is not equal to “0” then the response will not be taken from the cache.	指定哪些響應在某些值不為空或不為0的情況下不走緩存，比如proxy_cache_bypass $http\_pragma $http_authorization;	ngx_http_proxy_module
proxy_cache_min_uses	proxy_cache_min_uses 1;	http, server, location	Sets the number of requests after which the response will be cached.	指定在多少次請求之后才緩存響應內容	ngx_http_proxy_module
proxy_cache_use_stale	proxy_cache_use_stale off;	http, server, location	Determines in which cases a stale cached response can be used during communication with the proxied server. The directive’s parameters match the parameters of the proxy_next_upstream directive.	指定在后端服務器在返回什么狀態碼的情況下可以使用過期的緩存，比如proxy_cache_use_stale error timeout invalid_header http_500 http_502 http_503 http_504;	ngx_http_proxy_module
proxy_cache_lock	proxy_cache_lock off;	http, server, location	When enabled, only one request at a time will be allowed to populate a new cache element identified according to the proxy_cache_key directive by passing a request to a proxied server. Other requests of the same cache element will either wait for a response to appear in the cache or the cache lock for this element to be released, up to the time set by the proxy_cache_lock_timeout directive.	默認不開啟，開啟的話則每次只能有一個請求更新相同的緩存，其他請求要么等待緩存有數據要么限時等待鎖釋放;nginx 1.1.12才開始有	ngx_http_proxy_module
proxy_cache_lock_timeout	proxy_cache_lock_timeout 5s;	http, server, location	Sets a timeout for proxy_cache_lock. When the time expires, the request will be passed to the proxied server, however, the response will not be cached.	等待緩存鎖超時之后將直接請求后端，結果不會被緩存 ; nginx 1.1.12才開始有	ngx_http_proxy_module

實例

http {
    # we set this to be on the same filesystem as proxy_cache_path
    proxy_temp_path /usr/local/nginx/proxy_temp;
    # good security practice dictates that this directory is owned by the
    # same user as the user directive (under which the workers run)
    proxy_cache_path /usr/local/nginx/proxy_temp keys_zone=CACHE:10m levels=1:2 inactive=6h max_size=1g;

    server {
        location / {
            # using include to bring in a file with commonly-used settings
            include proxy.conf;
            # referencing the shared memory zone defined above
            proxy_cache CACHE;
            proxy_cache_valid any 1d;
            proxy_cache_bypass $http_pragma $http_authorization;
            proxy_cache_min_uses 3;
            proxy_cache_use_stale error timeout invalid_header updating http_500 http_502 http_503 http_504;
            proxy_pass http://upstream;
        }
    }
}

doc

ngx_http_proxy_module

nginx反向代理緩存配置

Understanding the nginx proxy_cache_path directive

云服務器 GPU云服務器服務器cpu參數解讀云服務器配置解讀 nginx配置 nginx網站配置

文章版權歸作者所有，未經允許請勿轉載,若此文章存在違規行為，您可以聯系管理員刪除。

轉載請注明本文地址：http://specialneedsforspecialkids.com/yun/39755.html

nginx gzip配置參數解讀

序本文主要解析一下nginx ngx_http_gzip_module以及ngx_http_gzip_static_module中的gzip相關配置參數。 gzip 名稱默認配置作用域官方說明中文解讀模塊 gzip gzip off; http, server, location, if in location Enables or disables gzipping of ...

付永剛 2019-07-25 14:08 評論0 收藏0
nginx lua api解讀

摘要：對于需要進一步注意的是參數的使用，可以傳入所定義的所有的狀態碼常量如等和兩個模塊內核常量只支持和這兩個，如果傳入其他的如等則進程住。序本文主要解讀下nginx lua module的主要方法和api。 ngx_lua運行階段 showImg(https://segmentfault.com/img/bVHFqI?w=1005&h=910); initialization phase...

shery 2019-07-25 14:08 評論0 收藏0
nginx http模塊配置參數解讀

摘要：名稱默認配置作用域官方說明中文解讀模塊是否開啟對后端的緩沖指定一個連接到代理服務器的超時時間，單位為秒，需要注意的是這個時間最好不要超過秒。序本文主要解析一下nginx http模塊配置參數。主要分socket相關參數，對clinet請求的buffer參數以及對response的buffer參數。 socket 名稱默認配置作用域官方說明中文解讀模塊 sendf...

pf_miles 2019-07-25 14:08 評論0 收藏0
Nginx 內容緩存及常見參數配置

摘要：設置一個共享內存區，該內存區用于存儲緩存鍵和元數據，有些類似計時器的用途。注意，非活動內容有別于過期內容。在兩次緩存管理器啟動的間隔，緩存的數據量可能短暫超過配置的大小。為在緩存響應之前必須使用相同密鑰的請求的最小次數。原文鏈接：何曉東博客使用場景:項目的頁面需要加載很多數據，也不是經常變化的，不涉及個性化定制，為每次請求去動態生成數據，性能比不上根據請求路由和參數緩存一下結果，...

KnewOne 2019-08-06 13:42 評論0 收藏0
Nginx 內容緩存及常見參數配置

摘要：設置一個共享內存區，該內存區用于存儲緩存鍵和元數據，有些類似計時器的用途。注意，非活動內容有別于過期內容。在兩次緩存管理器啟動的間隔，緩存的數據量可能短暫超過配置的大小。為在緩存響應之前必須使用相同密鑰的請求的最小次數。原文鏈接：何曉東博客使用場景:項目的頁面需要加載很多數據，也不是經常變化的，不涉及個性化定制，為每次請求去動態生成數據，性能比不上根據請求路由和參數緩存一下結果，...

olle 2019-07-01 12:46 評論0 收藏0