https://blog.liuts.com/index.php zh-cn https://blog.liuts.com/post// root <admin@yourname.com> Tue, 21 Aug 2007 15:45:21 +0000 https://blog.liuts.com/post//
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;
} ]]> https://blog.liuts.com/post//#blogcomment <user@domain.com> Thu, 01 Jan 1970 00:00:00 +0000 https://blog.liuts.com/post//#blogcomment