学习了一下varnish

等了N久还不见新的版本出来，于是忍不住先学习一下，主要是看man page


基本明白，但英语还是太差，有些细微之处不很明白，比如pass和pipe的区别等等


准备再次尝试一下，暂时把本站域名指到一台跑varnish的烂PC上，测试一下看看，获取些实际运行经验。打算跑个几天再改回来。


man page意译如下：


VCL语法比较简单，和C类似，if(){}的形式，=和==的区别，!、&&和||等等。但\符号没有特别的意思。
VCL里除了用==、!、&&、||做逻辑判断意外，还可以用~来表示与正则表达式或ACL的匹配。
VCL其实只是配置，并不是真正的编程语言，没有循环，没有自定义变量。


声明Backend
backend 名称 {
    set backend.host = "域名";
    set backend.port = "端口";
}
比如
backend www {
    set backend.host = "www.example.com";
    set backend.port = "http";
}    
声明的Backend可以用在判断请求针对哪个后端服务器
if (req.http.host ~ "^(www.)?example.com$") {
{
    set req.backend = www;
}


声明ACL
acl 名称 {
             "IP";
             "IP子网"/反掩码位数;
             ! "IP或IP子网"/反掩码位数;
         }
比如
acl local {
             "locahost";         /* myself */
             "10.0.0.1"/8;       /* and everyone on the local network */
             ! "10.0.0.23";      /* except for the dialin router */
         }
判断ACL也很简单
if (client.ip ~ local) {
    pipe;
}


还可以定义子程序
sub pipe_if_local {
    if (client.ip ~ local) {
        pipe;
    }
}
用call来调用
call pipe_if_local;


内置的例程
vcl_recv
有请求到达后成功接收并分析时被调用，一般以以下几个关键字结束。
error code [reason]  返回code给客户端，并放弃处理该请求
pass    进入pass模式，把控制权交给vcl_pass
pipe    进入pipe模式，把控制权交给vcl_pipe
lookup  在缓存里查找被请求的对象，根据查找结果把控制权交给vcl_hit或vcl_miss


vcl_pipe
进入pipe模式时被调用。请求被直接发送到backend，后端和客户端之间的后继数据不进行处理，只是简单传递，直到一方关闭连接。一般以以下几个关键字结束。
error code [reason]
pipe


vcl_pass
进入pass模式时被调用。请求被送到后端，后端应答数据送给客户端，但不进入缓存。同一连接的后继请求正常处理。一般以以下几个关键字结束。
error code [reason]
pass


vcl_hash
目前不使用


vcl_hit
在lookup以后如果在cache中找到请求的内容事调用。一般以以下几个关键字结束。
error code [reason]
pass
deliver  将找到的内容发送给客户端，把控制权交给vcl_deliver.


vcl_miss
lookup后但没有找到缓存内容时调用，可以用于判断是否需要从后端服务器取内容。一般以以下几个关键字结束。
error code [reason]
pass
fetch  从后端取得请求的内容，把控制权交给vcl_fetch.




vcl_fetch
从后端取得内容后调用。一般以以下几个关键字结束。
error code [reason]
pass
insert  将取到的内容插入缓存，然后发送给客户端，把控制权交给vcl_deliver




vcl_deliver
缓存内容发动给客户端前调用。一般以以下几个关键字结束。
error code [reason]
deliver  内容发送给客户端


vcl_timeout
在缓存内容到期前调用。一般以以下几个关键字结束。
fetch  从后端取得该内容
discard  丢弃该内容


 


vcl_discard
由于到期或者空间不足而丢弃缓存内容时调用。一般以以下几个关键字结束。
discard  丢弃
keep  继续保留在缓存里


如果这些内置例程没有被定义，则执行缺省动作




一些内置的变量
now  当前时间，标准时间点（1970？）到现在的秒数


backend.host  后端的IP或主机名
backend.port  后端的服务名或端口


请求到达后有效的变量
client.ip  客户端IP
server.ip  服务端IP
req.request  请求类型，比如GET或者HEAD或者POST
req.url  请求的URL
req.proto  请求的HTTP版本号
req.backend  请求对应的后端
req.http.header  对应的HTTP头


往后段的请求时有效的变量
bereq.request  比如GET或HEAD
bereq.url  URL
bereq.proto  协议版本
bereq.http.header  HTTP头


从cache或后端取到内容后有效的变量
obj.proto  HTTP协议版本
obj.status  HTTP状态代码
obj.response  HTTP状态信息
obj.valid  是否有效的HTTP应答
obj.cacheable  是否可以缓存的内容，也就是说如果HTTP返回是200、203、300、301、302、404、410并且有非0的生存期，则为可缓存
obj.ttl  生存期，秒
obj.lastuse  上一次请求到现在间隔秒数


对客户端应答时有效的变量
resp.proto  response的HTTP版本
resp.status  回给客户端的HTTP状态代码
resp.response  回给客户端的HTTP状态信息
resp.http.header  HTTP头




变量可以通过set来赋值或通过remove来删除（清空）
sub vcl_recv {
    if (req.http.host ~ "^(www.)?example.com$") {
         set req.http.host = "www.example.com";
    }
}


sub vcl_fetch {
             remove obj.http.Set-Cookie;
}