发布时间: 2015-01-03 07:34:00
refer to: http://nginx.com/resources/admin-guide/caching/
这个例子是可以拿来就用的：
# 注意这里是顶层。
http {
# 这里定义了缓存的格式
log_format my_format '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" $upstream_cache_status';
access_log /var/log/nginx/access.log my_format;
# 这里定义了缓存的具体信息。 叫做 cache_one , cache_zone 是在下面定义的。
# 该段代码一定要出现在 include /etc/nginx/sites-enabled/*; 之上
proxy_cache_path /tmp/nginx_cache keys_zone=cache_one:100m
loader_threshold=300 loader_files=200
max_size=200m;
include /etc/nginx/sites-enabled/*;
}
下面则是 sites-enabled/test_cache文件
# 下面就是缓存的部分 （有汉字注释的地方都不能省略）
server {
listen 1600;
server_name localhost;
charset utf-8;
# 这个需要走cache
location /current_time {
# 删掉无用的参数 a=1&b=2&_=152913 中的 _
if ($request_uri ~ "([^\?]*)\?(.*)_=([^&]*)&?(.*)") {
set $original_path $1;
set $args1 $2;
set $unwanted $3;
set $args2 $4;
set $args "";
rewrite ^ "${original_path}?${args1}${args2}" permanent;
}
proxy_hide_header "cache-control";
proxy_hide_header Expires;
proxy_hide_header Set-Cookie;
proxy_ignore_headers Set-Cookie;
proxy_ignore_headers Cache-Control;
proxy_ignore_headers Expires;
proxy_ignore_headers X-Accel-Expires;
proxy_cache cache_one;
# 任何内容，都缓存2小时。 5s: 5秒钟。
proxy_cache_valid any 2h;
# 注意：这里是可以缓存 POST的。 默认是 GET HEAD
proxy_cache_methods GET;
proxy_pass http://rails_servers;
proxy_redirect default;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header Host $http_host;
# 非常重要。缓存的东西，返回的时候不要带有cookie . 否则不安全了。
proxy_set_header Cookie "";
proxy_next_upstream http_502 http_504 error timeout invalid_header;
proxy_cache_key $host$uri$is_args$args;
}
# 其他的则正常走
location / {
proxy_pass http://api_servers;
proxy_redirect default;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header Host $http_host;
proxy_next_upstream http_502 http_504 error timeout invalid_header;
}
}
# 这里就是我们的 后台程序
upstream api_servers{
server localhost:4200;
}
上面的代码是可以直接用的。 其中 4200 跑着一个 rails应用，访问 /current_time 后可以返回当前的服务器时间。
其他的内容看下面的就 可以了。 是个参考。
注意:
1. nginx 建议使用 1.7.9 以上版本, 亲测 1.7.9, 1.8.0 可用. 1.4.x 不可用. 所以,不要使用ubuntu 默认的 apt-get install 方式的nginx. 它是1.4的.
2. proxy_cache_path 务必出现在 proxy_cache 关键字之前, (也就是说,如果你用了include sites-enabled/*; , 那么,这句话要放在 proxy_cache_path之后!) 否则会报错: nginx: [emerg] the size 10485760 of shared memory zone "cache_one" conflicts with already declared size 0
3. proxy_cache_key 是关键.
location / {
proxy_hide_header "cache-control";
proxy_hide_header Expires;
proxy_ignore_headers Set-Cookie;
proxy_ignore_headers Cache-Control;
proxy_ignore_headers Expires;
proxy_ignore_headers X-Accel-Expires;
proxy_cache cache_one;
proxy_cache_valid any 60s; # 任何内容，都缓存60秒钟
proxy_pass http://tidev_servers;
proxy_redirect default;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header Host $http_host;
proxy_next_upstream http_502 http_504 error timeout invalid_header;
proxy_cache_key $host$uri$is_args$args;
}
例子：
http {
...
proxy_cache_path /data/nginx/cache keys_zone=one:10m;
server {
proxy_cache one;
location / {
proxy_pass http://localhost:8000;
}
}
}
参与cache 过程 的，有两个角色， cache manager 和 cache loader:
1. cache manager 会循环的检查 cache的状态。当它发现 缓存的文件超过了 max_size 这个数目后，就会删掉最少访问的cache page.
2. cache loader： 仅仅在nginx启动后 随之启动一次。它把之前的cache 信息加载到 shared memory中去。这在nginx启动的前几分钟会拖累nginx的速度。
以上的iteration, 比 loader_threshold（默认是200ms) 要少。 每次加载的文件数目小于 loader_files(默认是100），每个iteration 间隔 loader_sleeps (默认50ms）。
下面是个例子：
proxy_cache_path /data/nginx/cache keys_zone=one:10m
loader_threshold=300 loader_files=200;
如果某个response来自 proxy_server, 并且request是 GET/HEAD 方法，则nginx 默认会把它做缓存.
而且默认使用的key就是 url ，你也可以指定这个key, 例如：
proxy_cache_key "$host$request_uri$cookie_user";
如果我们希望某个 url 至少被请求5次之后才被缓存，就这样：
proxy_cache_min_uses 5;
如果希望对POST和 DELETE进行缓存：
proxy_cache_methods GET HEAD POST；
下面的例子：对于 200 , 302的response, 缓存 10分钟，
proxy_cache_valid 200 302 10m; # 对于 200， 302，缓存10分钟
proxy_cache_valid 404 1m; # 缓存1分钟
proxy_cache_valid any 10m; # 对于所有的响应，都缓存10分钟。
也可以根据条件来判断是否使用cache: （ cookie 中的变量：nocache, parameter中的变量：nocache 或者 comment, 只要有一个 不是空，也不是 0, 那么这个request就不会使用cache)
proxy_cache_bypass $cookie_nocache $arg_nocache$arg_comment;
对于下面的例子：压根就不使用cache:
proxy_no_cache $http_pragma $http_authorization;
http {
...
# 定义了一个 proxy_cache_path, :
proxy_cache_path /data/nginx/cache keys_zone=one:10m
loader_threshold=300 loader_files=200
max_size=200m;
# 这个server中有两个backend, 对应两种不同的cache策略
server {
listen 8080;
# cache的名字叫做 one （注意上面的 keys_zone=one:10m)
proxy_cache one;
# 对所有的 / 请求，都尽可能长久的缓存，不存在过期
location / {
proxy_pass http://backend1;
}
location /some/path {
proxy_cache_valid any 1m; # 任何内容，都缓存1分钟
proxy_cache_min_uses 3; # 访问3次后，触发缓存
proxy_cache_bypass $cookie_nocache $arg_nocache$arg_comment; # 设置好不使用缓存的规则
proxy_pass http://backend2;
}
}
}
注意: 如何调试呢?
1. 要设置log format, 把日志打印出来. 例如,配置文件为: (注意其中的 $upstream_cache_status, 这个变量最重要, 从它我们可以知道, 是HIT 还是MISS )
log_format my_format '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" $upstream_cache_status';
access_log logs/my_access.log my_format;
2. 要有对应的 ignore headers, 如果后端返回的结果中,增加了 cache-control (也有一说是 set-cookie) 或者 啥的,就不行了.
server{
proxy_ignore_headers "cache-control";
proxy_hide_header "cache-control";
}
下面是一个完整的 nginx.conf例子;
http{
# 其他内容
proxy_cache_path /tmp/nginx_cache keys_zone=cache_one:10m
loader_threshold=300 loader_files=200
max_size=200m;
log_format my_format '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" $upstream_cache_status';
access_log logs/my_access.log my_format;
server {
listen 80;
location / {
proxy_ignore_headers "cache-control";
proxy_hide_header "cache-control";
proxy_cache cache_one;
proxy_cache_valid any 10s; # 任何内容，都缓存10秒钟
proxy_pass http://rails_api;
}
}
upstream rails_api{
server localhost:3000;
}
缓存用的哪些文件?
我们可以在 proxy_cache_path中设置, 例如:
proxy_cache_path /tmp/nginx_cache keys_zone=cache_one:10m
loader_threshold=300 loader_files=200
max_size=200m;
然后, 找到 /tmp/nginx_cache 目录, 如果某个 cache被命中过, 就会看到出现一个以md5 结果命名的文件:
:/tmp/nginx_cache$ ll total 20 drwxrwxrwx 2 nobody sg552 4096 Sep 10 11:39 ./ drwxrwxrwt 10 root root 12288 Sep 10 11:38 ../ -rw------- 1 nobody nogroup 594 Sep 10 11:39 f8924891f34a941a8342ccd19c4cf290上面中, 这个文件 "f89..." 就是缓存文件. 它的内容如下.
���U���������Ud����0""b4945c5f2d4b62faae53f44f44a5e946" KEY: http://rails_api/prices/say_hi HTTP/1.1 200 OK X-Frame-Options: SAMEORIGIN X-XSS-Protection: 1; mode=block X-Content-Type-Options: nosniff Content-Type: text/html; charset=utf-8 ETag: "b4945c5f2d4b62faae53f44f44a5e946" Cache-Control: max-age=0, private, must-revalidate X-Request-Id: 90fbc91b-e5a4-4279-8832-5d484cba7ba8 X-Runtime: 0.007120 Connection: close Server: thin 1.6.2 codename Doc Brown time is: 2015-09-10 11:39:58 +0800可以看出, 该静态文件, 以文本的形式缓存了 所有的response信息. Back