1

目次
なぜ Varnish Cache なのか....................................................................... 2
どのようなときに使用するか..................................................................... 3
静的コンテンツの配信.......................................................................... 3
動的コンテンツの配信.......................................................................... 5
Varnish を使うための環境........................................................................7
Varnish のインストール........................................................................... 7
まずは動かしてみよう............................................................................. 8
Varnish の設定について........................................................................... 9
VCL について....................................................................................... 12
基本的な言語仕様............................................................................. 12
Varnish の基本動作ステップ................................................................21
req.*の内容が bereq.*に転記されるタイミング.......................................27
簡易版アクションフロー図..................................................................28
起動時オプションについて...................................................................... 29
Varnish のデバッグ............................................................................... 32
応用的な使い方.................................................................................... 36
管理コンソールの利用方法..................................................................36
インライン C.................................................................................... 38
統計情報の見方................................................................................ 39
ストレージサイズと TTL の決め方.........................................................42
ヒット率の上げ方............................................................................. 43
Edge Side Includes (ESI)..................................................................44
gzip の利用..................................................................................... 47
VMOD の追加の仕方.......................................................................... 49
ストレージの高度な制御.....................................................................50
バックエンドの高度な利用..................................................................51
varnishtest の使い方......................................................................... 51
Varnish にやさしい ban の仕方............................................................54
Tip's.................................................................................................. 55
Appendix........................................................................................... 57
あとがき............................................................................................. 641

なぜ Varnish Cache なのか
世の中には様々なリバースプロキシが存在します。リバースプロキシとは下図のようにクライアント・サーバ間の中継を行い、セキュリティ向上、リクエスト分散、コン
テンツの圧縮・キャシュによる Web アクセラレータなどで利用します。

Web アクセラレータとして使う場合、以下のミドルウェアもしくはモジュールが候補によく上がります。
・プロキシ・リバースプロキシのデファクトスタンダード、多数の実績「Squid」

・ミドルウェアも足したくないし手軽に「mod_cache(Apache)」・Inktomi から Yahoo!までの実績「Apache TrafficServer」
・Nginx 使ってる時に手軽に「proxy_cache(Nginx)」
・余り表に出ないけど Steam などいろいろ使われている「Varnish Cache」

それぞれ利点と欠点が存在しますが、私が VarnishCache(以下 Varnish)を勧める一番大きな点が設定ファイルの柔軟さです。Varnish は VCL という C 言語に似た記述で動作をコントロールします。これを有名な Squid と比較してみてみましょう。
設定内容
・.js .css ファイルを一分キャッシュする。

・/ignore/ディレクトリにある場合はキャッシュしない。

Squid の場合
refresh_pattern /ignore/ 0 100% 0
refresh_pattern \.(js|css) 1 100% 1

Varnish の場合
sub vcl_fetch{
if(req.url ~"/ignore/"){beresp.ttl=0s;}elsif(req.url ~"\.(js|css)$"){
beresp.ttl=1m;}}

もし、あなたがプログラムの経験があるのであれば Varnish のほうが理解しやすいでしょう。そしてプログラムのように記述できるということは、複雑な条件も比較的頭を悩ませずに記述できることが期待できます。
2

どのようなときに使用するか
静的コンテンツの配信
Varnish に限らず Web アクセラレータを利用する際に最も一般的な使い方は、
静的なコンテンツ（画像や JS や CSS など）を Web サーバとユーザの中間で高速にレスポンスすることです。

なぜそんなことをするのでしょうか？小規模なサイトの場合は PHP などが動いているアプリケーションサーバに静的コンテンツを置いても特に問題は発生しません。
しかしサイトが大規模になりアクセスが増えるとそうも言えなくなってきます。
アプリケーションと配信を同じサーバで行った場合
トラフィックが増える↓
静的ファイルのアクセスが増える↓
ディスクアクセスが増え IO 待ちが発生↓
コネクションあたりの時間が長くなる↓
同時接続数を食いつぶしサイトにアクセスがしづらくなる

これはあくまで一例ではありますが起こりうる事態です。
そして下の図はその時のリソースの使われ方です。

Apache がリクエストを処理する体系に大きく2つあります。プロセスで動作する
Prefork モデルと、スレッドで動作する Worker モデルです。プロセスは独立性が高い半面、メモリを含む多くのリソースを使用します。スレッドは独立性が低くプロセスに属するスレッド間のリソースの共有も容易でリソースも節約します。しかしそのために、PHP といった動作するモジュールはスレッドセーフでないといけません。
さて、静的コンテンツの場合 Apache の機能だけで配信するので Worker で問題ありません、しかし PHP を使うには一般的に Prefork を利用します。Worker・

Prefork の混在はできないので Prefork を利用します。そのためプロセス数が同時接続数となります。プロセスはメモリを多く使うので、同時接続数が Worker よりも少なくなってしまいます。

そして1ページに複数静的コンテンツがあるのが一般的なので CPU・メモリ負荷の3

低い静的コンテンツに多くの接続数を利用されます。あまり効率が良くないのがわかります。ここで CPU に余力があるからとスペックを落としてメモリを増やしてバランスを取ろうとしても、一般的に CPU クロックを落とすとページの生成時間も長くなり秒間処理数が低くなってしまいます。また、ここでは IO 負荷も絡めていますがSSD にしたとしてもメモリの制限から同時接続数は大まかに以下になります。
同時接続数＝使えるメモリ/プロセスの平均メモリ使用量

さらに悪いケースについて考えてみましょう。同時接続数が超過した場合に発生する待ち行列についてです。
秒間接続数 秒間処理数
205
200
経過秒数
総コネクション数 待機数
1
205
5
10
2050
50
100
20500
500

秒間たった5アクセスが超過しただけで待機数はどんどん増えていくのがわかります。
仮に100秒後に秒間接続数が199まで落ちたとしても待機数が0になるのには500秒かかります（実際はタイムアウトもありますが）つまり超過させたら負けなのです。
さらに言うならこのサーバは、ページの生成と相乗りなのでページが見えないといった問い合わせが多数来るのが目に見えます。ではサーバを増やせば？もちろんそれも解決方法の一つですが、静的コンテンツが要因で超過したときにページが見えなくなってしまうのは解決しません。コントロールを容易にするるためにも、サーバを分けると同時に Web アクセラレータの導入をおすすめします。

上図のようにまずドメインとサーバををわけます(cdn.example.net/example.net)
静的コンテンツの実体は元々のサーバ(example.net)にあるとします。

4

Varnish はリクエストを受け取り、キャッシュを保持していればレスポンスします。
なければ、Apache に取得しキャッシュしてレスポンスします。つまり Apache への静的コンテンツのアクセスは最低限のレベルに収まり、動的コンテンツの生成に思う存分 CPU を使うことができるので、システム全体で処理できるリクエスト数は大幅に増えることを期待できます。また Varnish は高速なため Apache より多くのリクエストをさばくことができるのでユーザの体感で静的コンテンツの表示が速くなったと感じることもできるでしょう。
状況にもよりますがこれは単純に相乗りで二台に増やすよりシステムとしてのパフォーマンスが良いことが多いです。

動的コンテンツの配信
ある程度大きなサイトの場合、DB の負荷を抑えるために Memcache をはじめとした KVS の導入を行うところが多いです。

上図のような構成で以下のようなページについて考えてみましょう。
（ケース A）毎時更新されるランキングページ（ケース B）下層コンテンツのタイトルをグループ毎に表示しているページ

ケース A の場合、毎時でランキングを生成し DB に格納、リクエストのタイミング

で Memcache に有効時間を残り時間で値を設定し、負荷を減らすのが一般的です。
その場合このような順序で生成します。
ランキングページのリクエストを受ける↓
PHP が Memcache に値が存在するかチェックする↓
値があれば取得し、なければ MySQL から取得して Memcache に格納↓取得した値を整形してページを作る↓
レスポンスする

実にオーソドックスな処理ですが考えてみましょう。このページは動的コンテンツですが１時間は静的コンテンツです。つまり Varnish で一時間の間キャッシュしても5問題ありません。乱暴な言い方をすればキャッシュするのが Varnish なのかMemcache かの違いでしかありません。またそうすることで、余計な PHP の処理をすることなくユーザに高速にレスポンス出来ますし、システムの負荷も減ります。

次にケース B について考えてみましょう。若干イメージしづらいので図にしてみました。A にはユーザのアカウント名などの情報が、そして B・C には下層コンテン
ツのヘッドライン表示、D にはすべてのページで表示されるようなブロックと考えて下さい。それぞれが DB にアクセスして生成する必要があるブロックです。

通常、１ページ内に必ず動的でないといけない情報があるとキャッシュするのは難しいです。ここでいう A です。しかし B・C は下層コンテンツが更新されない限り表示は変わらないし、D に至ってはすべてのページで表示されるようなコンテンツです。ここだけでもキャッシュしてなんとか負荷を下げるにはどうするでしょうか？これを Varnish では ESI という技術で解決しています。ESI はページ中に以下の特殊なタグを埋め込み、タグの場所に他のコンテンツを埋め込むことが出来る技術です。
<esi:include src=”/esi/block/B.php” />ページ中に上記のように記述した場合 Varnish は src で指定された URL に対して取得を行いタグと置換します。もちろんキャッシュされていれば、それと置換します。
つまり B・C・D もキャッシュが可能で DB の負荷を減らすことができます。

そして残った A ですが、一見キャッシュするのは難しそうに見えます。ユーザごとにアカウント名は違うし、別のユーザの情報が表示されては大変な問題です。しかしこれも解決できます。Varnish では同じ URL で複数のコンテンツを格納することが可能です。その際にはユニークな識別子が必要です、多くの会員サイトの場合クッキーにログイン情報をいれています、つまりそのユーザ専用のキャッシュを行うことができます。以降の章でこのような点についても解説します。

6

Varnish を使うための環境
公式では以下の環境を推奨しています。
・最新64 bit カーネルの Linux・FreeBSD・Solaris・root 権

なお32 bit でも動作しますが検証ならともかく本運用で使うのはお勧めしません。
使えるメモリが少なすぎます。

また本書を書くに当たって Xen サーバ上で以下の構成で行っています。
OS:
Scientific Linux6(以下 SL6)
Kernel: 2.6.32-71.29.1.el6.x86_64
IP:
192.168.1.199
CPU: 仮想 CPU×４
RAM: 2048MB
Storage:HDD100GB HDD5GB SSD5GB
Varnish3.0

Varnish のインストール
ソースビルドもできますが、本誌では簡単に RPM でインストールします。
最初に Varnish のレポジトリを利用するように設定します。

rpm --nosignature -i http://repo.varnish-cache.org/redhat/varnish-3.0/el5/noarch/varnishrelease-3.0-1.noarch.rpm

次に yum でインストールを行います。
yum install -y varnish

この際以下のような依存関係のエラーが出る場合があります。
Error: Package: varnish-3.0.0-2.el5.x86_64 (varnish-3.0)
Requires: libjemalloc.so.1()(64bit)

jemalloc は SL6 では標準にレポジトリには含まれておらず、EPEL を追加する必要があります。その際に単純に EPEL レポジトリを追加するだけではなく SL6 では提供されていないパッケージのみをインストールするよう yum-priorities をインストールします。

yum -y install yum-priorities

7

次に/etc/yum.repos.d/sl.repo の内容を変更します。
[sl]name=Scientific Linux $releasever - $basearch[中略]
gpgkey=file:///etc /pki/rpm-gpg/RPM-GPG-KEY-sl file:///etc /pki/rpm-gpg/RPM-GPG-KEYdawson
priority=1 ←追加

次に EPEL リポジトリを導入します。
rpm -ivh http://download.fedora.redhat.com/pub/epel/6/x86_64/epel-release-65.noarch.rpm
yum -y update epel-release

これで yum install -y varnish で Varnish をインストールできます。

まずは動かしてみよう
何事もまずは触ってみないとわからないので早速動かしましょう。とりあえず以下の構成で動かします。

まずはそのまま Apache を起動します。
/etc /init.d/httpd start

適当なブラウザでページを見てみましょう。きっと以下の画面が出てきます。

8

次に Varnish を起動します。
/etc /init.d/varnish start

そしてブラウザでポートを6081でアクセスします。先ほどと同じ画面がのはずです。
さてあまりにもあっさり行きすぎていて本当に動いてるか不安を感じるかもしれません。試しに Apache を止めてみましょう。
/etc /init.d/httpd stop

まずはポート80にアクセスしてみます。もちろん Apache を落としているので閲覧できません。次に6081でアクセスします、おそらく先ほどと同じ画面が出てくるはずです。これできちんとキャッシュされていることを確認できます。ちなみにしばら
く経つとキャッシュの有効期限が切れて見えなくなってしまいます。なので上手く確認できない場合は素早くやってみましょう。
また、本誌で試す上で多くの設定を書き換えます。その際に動的に適用するには/etc /init.d/varnish reload

でおこないます。ここでは Varnish のデフォルトの設定で動かしてみて、キャッシュの動きを確認できました。次は Varnish の設定の仕方を説明します。

Varnish の設定について
Varnish の設定は大きく以下の二つに分かれます。
VCL（一般的に言う設定ファイルに相当）
起動オプションVCL はユーザからのリクエストをどのように処理するかを決めるための設定です。

設定とは言うものの最初で触れたように一種のプログラミングのように記述します。
起動オプションは Varnish の起動時に指定するオプションです。キャッシュの保存にメモリを使うかなどの指定を行います。まずは下記構成での VCL 例を見てみましょう。

9キャッシュ条件
共通①クエリに purge=1 を含む場合かつ192.168.1.0/24からアクセスの場合キャッシュを削除。
②ヘルスチェク対象は「/」blog.example.net③/admin/にマッチした URL はキャッシュしない。
④30分キャッシュする。

⑤同一 URL で携帯と PC にアクセスした場合デザインの違うページをそれぞれキャッシュして出力⑥ blog.example.net がダウンの際は cdn.example.net/sorry.html を1分キャッシュで出力。

cdn.example.net⑦ 全て6時間キャッシュ⑧同一 URL で携帯と PC で表示を切り返す。/a.jpg の場合、携帯は/_m/a.jpg PC は/_p/a.jpg

VCL（条件に関わる箇所には該当する番号を書いています）
acl local {"192.168.1.0"/24;}

・・・①//ヘルスチェック設定
probe healthcheck {.url = "/"; ・・・②.timeout = 1s; .window = 8; .threshold = 3; .interval = 5s;}//バックエンド設定
director cdn random{.retries = 5;{.weight = 5;.backend={.host="192.168.1.1";.probe=healthcheck;}}{.weight = 5;.backend={.host="192.168.1.2";.probe=healthcheck;}}}
director blog random{.retries = 5;{.weight = 5;.backend={.host="192.168.1.3";.probe=healthcheck;}}{.weight = 5;.backend={.host="192.168.1.4";.probe=healthcheck;}}}
sub vcl_recv{ //クライアントからのレスポンスを受け取る
if(req.url ~ "(\?|&)purge=1" && client.ip ~ local){//キャッシュ削除 ・・・①ban("obj.http.X-HOST ~ "+ req.http.host + " && obj.http.X-URL ~ " + regsub(req.url,"\?.*$",""));
error 200 "banned.";}//admin/以外のクッキー削除
if(req.http.Cookie && !(req.http.host ~ "^blog.example.net" && req.url ~ "^/admin/")){
unset req.http.Cookie;}
if(req.http.host ~ "^blog.example.net"){set req.backend = blog;
if( ! req.backend.healthy){//blog 死亡・・・⑥
set req.backend = cdn;//blog 死亡のため cdn/sorry.html に向ける
set req.url= "/sorry.html";}elseif(req.url ~ "^/admin/"){ //admin はキャッシュしない
return(pass); ・・・③}
}elseif(req.http.host ~ "^cdn.example.net"){10set req.backend = cdn;}

}else{//不明なホストは403
error 403 "Forbidden";}return(lookup);

sub vcl_hash { //キャッシュ格納・特定に使うハッシュキーを作成
hash_data(req.url);
if (req.http.host) {hash_data(req.http.host);} else {hash_data(server.ip);}
if(req.http.User-Agent ~"(DoCoMo|UP\.Browser|KDDI|SoftBank|J-PHONE|Vodafone)"){hash_data("mobile");//携帯の場合は同一 URL で別キャッシュ ・・・⑤if(req.http.host ~ "^cdn.example.net"){set req.url = "/_m" + req.url; ・・・⑧}
}elseif(req.http.host ~ "^cdn.example.net"){set req.url = "/_p" + req.url;
・・・⑧}
return (hash);}
sub vcl_fetch{ //バックエンドからのレスポンスヘッダを受信
set beresp.http.X-URL = req.url;
set beresp.http.X-HOST = req.http.host;if(beresp.status >= 400){ //キャッシュ時間設定
set beresp.ttl = 1m;}elseif(bereq.url == "/sorry.html"){set beresp.ttl = 1m; ・・・⑥
}elseif(bereq.http.host ~ "^blog.example.net"){set beresp.ttl = 30m; ・・・④
}elseif(bereq.http.host ~ "^cdn.example.net"){set beresp.ttl = 6h;・・・⑦}
return(deliver);}sub vcl_deliver{ //クライアントにレスポンスする直前
if(obj.hits > 0){
set resp.http.X-Cache = "HIT";}else{
set resp.http.X-Cache = "MISS";}}

ページの都合上若干圧縮した記述で申し訳ありあせん。Varnish は上記のような設定ファイル（VCL)で動作します。これはわざと色々組み込んで複雑にしています
が、本誌を全て読み終えた際には理解できると思います。
次ページから VCL の基本文法について解説します。

11

VCL について
VCL は Varnish での処理に特化した C 言語に近い言語です。実際のところ VCL は以下のように利用されます。
1.

VCL ファイルを読み込む

2.

C 言語に解釈する

3.

コンパイルして共有ライブラリを作る

4.

Varnish がそれをリンクする

見てわかるとおり、通常のミドルウェアがテキストベースの設定を読んで動くのとは全く違います。本当に言語です、また C 言語の記述も書くことが可能です。ではどのような言語なのでしょうか？

基本的な言語仕様
型の種類
数値
12345（整数）123.45(小数点付)

注：0 xC0 のような16進数での指定は出来ません。

時間とサイズ
数値の後に単位をつけることが可能
単位 説明
変換
単位
ms
B
ミリ秒
s
1000ms = 1s
KB秒
m
60s = 1m
MB
分
h
60m
=
1h
GB
時間
d
24h = 1dTB日w
7d = 1w
週
BOOL
true と false
IP 範囲“192.168.1.0”/24
文字列“text”

単行の場合
複数行の場合12{“longtext”}

説明
バイト
キロバイト
メガバイト
ギガバイト
テラバイト

演算子
比較演算子
符号
==
!=
<
>
<=
>=
~
!~

説明
等しい
等しくない
小さい
大きい
以下
以上
正規表現/ACLマッチする
正規表現/ACLマッチしない

代入演算子
符号 説明
= 代入
+= 加算して代入-= 減算して代入*= 乗算して代入/= 除算して代入

算術演算子
符号 説明
* 乗算
+ 加算
- 減算
/ 除算
&&
||
!

論理演算子
論理積
論理和
否定

文字列の結合には+を利用する。
その他に( )を利用することができる。

コメント# コメント行// コメント行/* コメント */条件文
if(式){処理}elseif(式){処理}
else{処理}※elseif は elsif とも表記可能です。

識別子
サブルーチン・バックエンド名などで使える文字です。以下の正規表現にマッチする必要があります。
[a-zA-Z][a-zA-Z0-9_-]*

正規表現
Varnish では Perl 互換の PCRE を利用しています。
正規表現にオプションをつけたい場合は(?の後にオプションを記述し)で閉じます。
if(req.http.host ~ “(?i)example\.net$”){～}

13

ACL
クライアントの IP アドレスと照合するためのリストです。
acl ACL 名 {"ホスト名｜IP アドレス｜サブネット";}
実際の定義
acl local {"localhost";"192.0.2.0"/24;! "192.0.2.23";}// 自分自身// ローカルネットワークは許可// ルータは除外

ホスト名を使い、起動時に名前解決できない場合は意図しない動作になります。
また、ACL でクライアント IP と比較する場合は以下のように行います。
If (client.ip ~ local) {～マッチする}
else{～マッチしない}

バックエンドVarnish はリバースプロキシとして動作しますので、クライアントからのリクエスト
をどこのサーバに中継するかの定義が必要です。そのためバックエンドは最低一つ指定しないといけません。以下のように定義します。
backend [バックエンド名] {.host = "[ホスト名もしくは IP アドレス]";.port = "[ポート番号かサービス名]";}
デフォルトの定義
backend default {.host = "127.0.0.1";.port = "80";}

これは最低限のオプションで、以下の追加指定も可能です。
.connect_timeout = 3s;
接続する際のタイムアウト時間.host_header = “example.net”;
bereq.http.host に指定がない場合のデフォルトの Host ヘッダ.first_byte_timeout = 3s;
最初のバイトを受信するまでのタイムアウト時間.between_bytes_timeout = 10s;
通信中に一時的に受信が待ったときのタイムアウト時間.max_connections = 50;
このバックエンドの最大コネクション数.saintmode_threshold = 10;
saintmode に入る際の閾値14

また Varnish はヘルスチェック機能を持っています。この機能はバックエンドが、何らかの原因でダウンしているかどうかを判定し、状況によってはリクエストをしないことが可能です。その際に以下のような指定を行います。
.probe = {.url = [ヘルスチェックファイル];.timeout = [タイムアウト時間];.window = [直近 ｎ アクセスを評価対象とするか];}.threshold = [何回失敗したら異常とするか];

以下の場合/chk.jpg に対してタイムアウト0.3秒で直近5回のうち2回失敗したら異常と判定します。

.probe = {.url = “/chk.jpg”;.timeout = 0.3s;.window = 5;.threshold = 2;}

若干 window と threshold の関係が分かりづらいので解説します。
例えば window=5 threshold=2 とした場合で考えてみましょう。
1 2 3 4 5 6 7 8 9 直近チェックの順番○ × ○ ○ × ○ ○ ○ × ヘルスチェックの成否
Healthy
5 4 3 2 1 チェックする範囲（window=5)
3 2 1
成否の数チェック(threshold=2)
直近5回のチェック中3回成功しているので Healthy(正常)です。

1 2 3 4 5 6 7 8 9 直近チェックの順番○ × ○ ○ × ○ × × × ヘルスチェックの成否
5 4 3 2 1 チェックする範囲（window=5)
1
成否の数チェック(threshold=2)

Sick

直近5回のチェック中1回しか成功していないので Sick（異常）と判定され正常になるまで切り離されます。ここで少し考えてみましょう起動時にはヘルスチェックをまだ行っていないので全て異常になりそうですが、それを防ぐために initial という指定があります。この指定回数成功しているとみなしています。
他には以下の指定が存在します。
.initial = 3;
起動時に既に何回成功しているとみなすか.expected_response = 200;
どのステータスを成功とみなすか.interval = 5s;
何秒毎にヘルスチェックを行うか.request = "GET / HTTP/1.1""Host: www.foo.bar""Connection: close";
ヘルスチェックする際の HTTP リクエスト、.url と同時指定はできない

15

組み合わせると以下の記述になります。
backend default {.host = "127.0.0.1";.port = "80";.probe = {.url = “/chk.jpg”;.timeout = 0.3s;.window = 5;.threshold = 2;}}

また probe は、以下のように外出ししての記述も可能です。
probe healthcheck {.url = “/chk.jpg”;.timeout = 0.3s;.window = 5;.threshold = 2;}
backend default {.host = "127.0.0.1";.port = "80";.probe = healthcheck;}

複数のバックエンドで同じヘルスチェックを行う場合は楽なのでおすすめです。

ディレクター
ディレクターは複数のバックエンドを、クラスタ化したグループです。Probe を指定
してヘルスチェックを行っている場合、異常なバックエンドを切り離してクラスタ内の他バックエンドにリクエストするなどが可能です。基本的な指定は以下です。
director [ディレクター名] [ディレクタータイプ] {{}{.backend = [バックエンド名];.backend = {

}

}

}

.host = “127.0.0.1”;～インラインでバックエンド記述も可能～

ディレクタータイプとは、バックエンド群からどれを使うかを決める際の方式です。
次のタイプが存在し、追加のパラメータが存在したりします。

16

random
バックエンド群からランダムに選択します。
director d1 random{.retries = 5; //バックエンドを選択する際に最大何回リトライを行うか
{

}
{

}

}

.backend=b1;.weight = 7; //バックエンドを使う際の重み付け指定.backend=b2;.weight = 3; //バックエンドを使う際の重み付け指定

round-robin
バックエンド群から順番に選択します。特に追加パラメータはありません。
DNS
バックエンドを選ぶ際に DNS を利用して定義済みの IP リストとマッチするものを
バックエンドとして選択します。以下のように記述します。
director d1 dns{{
.backend = b1; //バックエンドも指定可能}.list = {}.port = “80”;“192.168.15.0”/24; //IP 帯域を指定する"192.168.16.128"/25; //複数指定も可能.ttl = 5s; //DNS の結果をどの程度キャッシュするか（任意）}.suffix = “.sv.local”; //DNS 解決する際のホスト名の末尾に付ける文字列（任意）.list 内には.port 以外に以下も指定可能です。
.host_header.connect_timeout.first_byte_timeout.between_bytes_timeout.max_connections.saintmode_threshold

オプションの意味は先程のバックエンドのオプションと同じです。

これだけだと DNS ディレクターの動きが分かりづらいので詳しく解説します。

17

上記図でのディレクターの設定は以下です。
director d1 dns{
.list = {.port = “80”;“192.168.1.0”/24;}.ttl = 5s;.suffix = “.sv.local”;}

流れは以下です。
1.

クライアントが http://t1.example.net/を要求

2.

Varnish が t1.example.net を解決するため DNS に.suffix を付与して問い合わせする(t1.example.net.sv.local)

3.

1.

DNS が t1.example.net.sv.local は192.168.1.1と返却

2.

DNS の結果を5秒キャッシュする(.ttl)

192.168.1.1に対して Host を t1.example.net でリクエストする
1.

4.

結果を受け取る

クライアントにレスポンスする

ここで注意が必要です。名前解決する際は.suffix が付与されますが、バックエンドにリクエストするときは付与されません。公式を見ると sv.local の指定だけで動きそうなのですが単純に結合しているので「.」を付けないと

t1.example.netsv.local で名前解決しようとするので注意が必要です。
また、DNS が複数の IP を返してきた場合はそれでラウンドロビンします。
なお、.list で範囲指定を行う場合はヘルスチェックができません。
そのため backend で範囲分のサーバを、インラインで次のように全て定義してしまうのもいい手です。

18

probe healthcheck {.url = “/chk.jpg”;.timeout = 0.3s;.window = 5;.threshold = 2;
.interval = 1m;}

director d1 dns{{.backend={.host="192.168.1.1";.probe=healthcheck;}}{.backend={.host="192.168.1.2";.probe=healthcheck;}}～{.backend={.host="192.168.1.254";.probe= healthcheck;}}.ttl = 5s;.suffix = “sv.local”;}.list 表記でも Varnish 内部で最初に.backend に変換しているので、ヘルスチェッ
ク以外のオーバーヘッドの心配はほぼないと考えています。ただ台数が多いのでヘルスチェックの間隔はできるだけ長めにしたほうが良いです。
clientクライアントの識別情報(client.identify)に基づいてバックエンドを選択します。
簡単にいえば、クライアント A はバックエンド A を常に見に行き、またクライアン
ト B はバックエンド B を見に行く、といった制御が可能です。client.identity にクッキーのような識別子を指定すればセッションパーシステンス機能のように動作し、リクエスト URL を指定すればコンテンツスイッチング機能のように動作します。
追加パラメータは random ディレクターと同様に.retries と.weight が存在します。
hashリクエストされた URL のハッシュ値に基づいてバックエンドを選択します。
これは多段で構築している場合、そのバックエンド群で重複したキャッシュを保持しないため便利です。
追加パラメータは random ディレクターと同様に.retries と.weight が存在します。
fallback
Version3.0.1 で追加されたディレクターで、その名の通り fallback(縮退）します。
最初に定義されたバックエンドが正常な限り常に選択しますが、異常になった場合2番目に定義されたバックエンドを選択します。
特に追加パラメータはありません。
director b3 fallback {{ .backend = www1; }{ .backend = www2; } // www1 が異常状態の時に使用される{ .backend = www3; } // www1 と www2 の両方が異常状態の時に使用される
}

19

変数操作
変数に対し値を設定は以下のように行います。
set [変数] [代入演算子] [値];set req.http.test = “testtest”;
削除は以下のように行います。
unset [変数];
unset req.http.test;

その他記法
インライン CC{ C で書かれたコード }C
別ファイルの読み込み
include “filename”;※フルパスが望ましい

サブルーチンsub サブルーチン名{処理}サブルーチン呼び出し
call サブルーチン名;
以上が基本的な言語仕様です。次に Varnish がどのようにリクエストを受けてキャッシュしそれをレスポンスするかについて解説します。

20

Varnish の基本動作ステップ
1.

ユーザからのリクエストを受ける

2.

キャッシュの有無をチェック

3.

キャッシュがなければバックエンドに取得しに行く

4.

キャッシュしても良いデータならキャッシュする

5.

ユーザにレスポンスする

かなり端折って書いていますが、大まかな流れはこのような形です。Varnish では
各ステップで呼ばれるアクションが存在し、そこで様々な条件分岐を行います。
例えば特定の URL はキャッシュしなかったり、他より長めにキャッシュしたり、同じ URL だけど UserAgent で複数のキャッシュをもったり様々なことができます。
また、制御を行うための判断材料となる様々な変数は、アクションによってアクセスが制限されています。ちょっと考えてみましょう、バックエンドからのレスポンスをユーザからのリクエストを受けたときに把握することは不可能です。変数の一覧及び各アクションでのアクセス権、指定できる return 値は Appendix を参照してください。さて、それぞれのアクションについて代表的な使い方と一緒に解説します。

vcl_recv リクエストを受けた時に呼ばれるユーザからリクエストがあった際に一番最初に呼ばれるアクションです。
おそらく一番処理を書くことが多い箇所です。
ここでよく行う処理は以下です。それぞれ解説します。
1.

どのバックエンドを使うか指定する

2.

キャッシュしやすいようにホストなどを正規化する

3.

特定の IP からのアクセスを除外

4.

キャッシュの消去を行う(ban)5.

オブジェクトをどのように返却するか

どのバックエンドを使うか指定する
バックエンドとは Varnish がコンテンツを取得しに行くサーバのことです。
例えば t1.example.net の時は予め定義した b1 バックエンドで t2.example.net の時は b2 とした場合は次のような記述となります。
if(req.http.host ~”t1\.example\.net$”){set req.backend = b1;}elseif(req.http.host ~”t2\.example\.net$”){set req.backend = b2;}

なお、指定がない場合は default というバックエンドを使用します。

21

キャッシュしやすいようにホストなどを正規化する
例えば、あなたが運営しているサイトが以下のドメインを持っているとします。
•

www.example.net•

example.net

ドメインは違いますが、返す内容が同じ場合とします。しかし Varnish はホストが違うためそれぞれでキャッシュを保持します。
このような場合無駄なので以下のように正規化します。
if(req.http.host ~ "(?i)(www\.)?example\.net"){set req.http.host = “example.net”;}

このようにできるだけ同じ内容で微妙にドメインや URL が違ったりした場合は正規化することにより、ヒット率が向上します。
特定の IP からのアクセスを除外
例えば/_s/で始まる URL は、LAN 内のみの許可の場合は以下のように記述します。
acl local {"localhost";}"192.0.2.0"/24;! "192.0.2.23";// 自分自身// ローカルネットワークは許可// ルータは除外

sub vcl_recv{～
If (req.url ~”^/_s/” && client.ip !~ local) {error 403 “Forbidden”; //403 を返却}}～

キャッシュの消去を行う(ban)
運用するに当たって、しばしばキャッシュを削除したいことがあります。
PURGE / HTTP/1.0
Host: www.example.com

上記のようなリクエストで/を削除するには以下のように記述します。
if (req.request == "PURGE") {ban("req.http.host == " + req.http.host + "&& req.url == "+ req.url);error 200 “banned.”;}

若干分かりづらいので変数部を展開してみましょう。
req.http.host == “example.net” && req.url == “/”という文字列が ban 関数に渡されます。見てわかるとおり式なので例えば
req.http.host == “example.net” && req.url ~ “^/image/”のように image ディレクトリ配下の全てを対象とする事も可能です。
22しかし、ban は実行してすぐにキャッシュが消えるわけではありません。内部で

ban リストを作っており、それを lookup もしくは定期的に評価しマッチするものがあれば消去します。評価する際にはオブジェクトがキャッシュされた時間より後にリストされたものと照合しますが、全体的にオブジェクトが長い TTL を持っていて大量に ban している場合はパフォーマンスに影響を与える可能性もあるため注意してください。

また他に、即キャッシュから消去する purge というものもありますが後述します。
オブジェクトをどのように返却するか
例えば会員ページなど、キャッシュしてはいけないページや不明なメソッドを制御することができます。
if(req.request !~ "^(GET|HEAD|PUT|POST|TRACE|OPTIONS|DELETE)$"){
return(pipe); //不明なメソッドの通信はパイプする}elseif(req.url ~ “^/admin/”){return(pass); //admin ページはキャッシュしない}else{
return(lookup); //キャッシュの動作をする}

ここで出てきた pipe,pass,lookup ですが次の違いがあります。

pipe
クライアントとバックエンド間のコネクションが閉じられるまで、継続的にスルーします。Varnish は内容に対する操作は行いませんし、キャッシュも行いません。単純に右から左へ通信を中継するだけです。

pass
Varnish はキャッシュしません。しかし、返却時にレスポンスヘッダに追加
で項目を加えるなどの操作は可能です。

lookupキャッシュを保持している場合はキャッシュを返却し、保持していなければキャッシュしようとします。

vcl_pipe pipe 動作をするときに呼び出される
主に行うことは、バックエンドへのコネクションタイムアウト値を変更と pipe 時に
Varnish が bereq.*に転記しないヘッダの再設定をする程度であまり使いません。

vcl_pass pass 動作をするときに呼び出される
pass 動作時に、バックエンドへリクエストヘッダを改変する必要がある場合などに
使います。

23

vcl_hash オブジェクトを特定するハッシュを作成する
たとえば会員ページをどうしてもキャッシュしたい場合どうすればいいでしょうか？
他にも同じ URL だけど、携帯のキャリアごとにキャッシュする内容を変えたいといったこともあるかもしれません。通常 Varnish は URL やホストなどからハッシュ値を作成しこの値でキャッシュを格納しています。
sub vcl_hash {hash_data(req.url);
if (req.http.host) {hash_data(req.http.host);} else {hash_data(server.ip);}//ここに追加で増やす
return (hash);}

そして上記で示した「ここに追加で増やす」に追記していってハッシュを作成するときに使う値を追加で増やすことができます。
もし、vcl_hash の定義を消してみたらどうなるでしょうか？
sub vcl_hash {//ハッシュ値がいつも同じになるのでいつも同じキャッシュを返す
return (hash);}

ハッシュ値が同じになるため、最初にキャッシュしたオブジェクトを他の URL にアクセスしても返します。なので元の記述に対して修正する際は注意してください。
さて先程に例で出した会員ページをキャッシュしたい、と携帯キャリアごとに内容を変えたいを書いてみます。元の記述を消さずに追加する場所に追記してください。
会員ページをキャッシュしたい
認証情報にクッキーを使っていると仮定して/member/のページでユーザ毎にキャッシュを作ります。
if(req.url ~ “^/member/”){hash_data(req.http.Cookie);}

クッキーのデータに認証以外のデータが入っている場合、それも含めてハッシュ値作成に使われますので、認証データだけに正規化するとより効率が良くなります。
携帯キャリアごとに内容を変えたい

ip アドレスから判定してもいいのですがここは手軽に UserAgent で判定します。

24

if(req.http.User-Agent ~”DoCoMo”){
hash_data(“mobile-docomo”);}elseif(req.http.User-Agent ~”(UP\.Browser|KDDI)”){
hash_data(“mobile-kddi”);}elseif(req.http.User-Agent ~”(SoftBank|J-PHONE|Vodafone)”){hash_data(“mobile-softbank”);}

vcl_hit キャッシュオブジェクトが存在する
キャッシュオブジェクトが存在するときに呼ばれます。
主に後述の vcl_miss と合わせて特定のキャッシュの即消去（purge）に使われます。
sub vcl_hit {if (req.request == "PURGE") {purge;
error 200 "Purged.";}}

通常 GET や HEAD が入っている req.request に PURGE が入っていた場合、選択されたオブジェクトを即時に消去します。

vcl_miss キャッシュオブジェクトが存在しない
キャッシュオブジェクトが存在しないときに呼ばれます。
vcl_miss 時はキャッシュしていないので必要ないと思われますが、purge リクエス
トに対しコマンドが正しく受け付けられたことを示すためにも、同じ記述をするのが一般的です。

vcl_fetch バックエンドからレスポンスヘッダを受信
ファイルの有無(404)や、特殊なヘッダで動作を制御したい際に使います。これはpipe を除いたバックエンドとのやりとりをする際は必ず呼ばれます。様々な使い方がありますが、基本的な使い方はキャッシュの保持時間の設定です。
例えば画像は12時間、他は3時間キャッシュする場合以下のように記述します。
if(req.url ~ “\.(jpe?g|gif|png)(\?.*)?$”){
beresp.ttl = 12h;}else{
beresp.ttl = 3h;}

他の使い方として Squid でいう negative_ttl のように404の際に短期間キャッシュすることもよく行います。

25

if(beresp.status == 404){
beresp.ttl = 5m;}

また、何らかの条件でそもそもキャッシュしたくないこともあります。

Varnish は Pragma を無視しますが HTTP1.0 なサーバはこれをレスポンスしてくることがあります。

if(beresp.http.Pragma ~ “no-?cache”){
return(hit_for_pass);}

なお、ここで TTL の制御が可能なのは vcl_miss を通過するパタンのみ、つまりpass を指定していないことが必須です。既に pass されていて TTL を指定してもエラーにはなりませんが、設定してもキャッシュはされませんので注意してください。

vcl_deliver クライアントにレスポンスする直前
vcl_deliver は pipe 動作を除きクライアントにレスポンスする際に必ず呼ばれます。
何らかのヘッダを付与したり、または削除したりします。ここでよく行うのはどちらかというとデバッグのためにオブジェクトが HIT したのか MISS したのかを判定す
るヘッダを付与することです。
if(obj.hits > 0){
set resp.http.X-Cache = “HIT”;}else{
set resp.http.X-Cache = “MISS”;}

以上で VCL の基本的な記述は網羅しました。
補足する点がありますので次ページ以降で記述します。

26

req.*の内容が bereq.*に転記されるタイミング
いろんな場所で読み書きすることが可能な req.*ですが、バックエンドにリクエストする際に利用する bereq.*は req.*から生成されています。これが転記されるタイミ
ングは3つあります。
1.

vcl_recv で pipe を行い vcl_pipe が呼び出される前

2.

vcl_recv/vcl_miss/vcl_hit で pass を行い vcl_pass が呼び出される前

3.

vcl_hash を通過してキャッシュの有無判定を行いキャッシュがなく vcl_miss が呼び出される前です。つまり例えば vcl_miss で req.url を書き換えたて vcl_miss で pass を行わない場合はバックエンドに問い合わせに使う bereq.url には影響しません。
また、複数回 req.*から bereq.*に転記される場合既にあったものは破棄されます。
以下のルートを通った場合について考えましょう。
1.

vcl_recv で return(lookup)

2.

キャッシュが見つからず vcl_miss に突入以下の値を設定して return(pass)1.

bereq.http.X-TEST1 = 1 を設定

2.

req.http.X-TEST2 = 1 を設定

この場合、最終的にバックエンドへのリクエストに含まれるのは X-TEST2 です。
逆に pass せず fetch した場合は X-TEST1 が含まれます。

27

簡易版アクションフロー図
詳細図は Appendix を参照してください。

28

起動時オプションについて
Varnish は、ほとんどの処理は今までの多くのミドルウェアのような設定 ON/OFF
では行わず、先ほど説明した VCL で行います。しかし、いくつかのオプションは存在します。例えばどのポートで受付を行うかなどの設定などです。
以下は本誌を記述している際に ps でコマンドを確認、整形したものです。
/usr/sbin/varnishd \-P /var/run/varnish.pid \-a :6081 \-f /etc/varnish/default.vcl \-T :6082 \-t 120 \-w 1,1000,120 \-u varnish \-g varnish \-p vcl_trace=on \-p max_esi_depth=2 \-p esi_syntax=0x00000001 \-s Transient=malloc,100M \-s st1=file,/tmp/varnish_file2,200M \-s st2=malloc,200M

オプションの動作チェックで指定しているものがあるのでそのまま使用しないでください。また/etc/init.d/varnish で起動するときのオプションの指定は/etc/sysconfig/varnishに記述されています。通常の指定はこちらで行います。
さて様々な指定がありますが、この章では最低限の起動オプションについて説明します。sysconfig の該当箇所を書き換える際の参考にしてください。

-a address[:port][,address[:port][...]HTTP 要求を受け付けるインタフェース指定です。デフォルトでは:6081ですが本番で使う場合は:80を指定することが多いです。

-T address[:port]
Varnish の管理インタフェースにつなぐ指定です。非常に強力な機能（VCL の書き換
えや Varnish の停止など）があるので絶対にインターネットに公開しないように注意
して設定してください。

-f config
読み込む VCL ファイルを指定します。

29

-s [name=]type[,options]
キャッシュオブジェクトを保存するストレージを指定します。複数定義可能です。
Name は全体でユニークである必要があります。応用的な使い方で説明しますが、指定するとオブジェクトを保存するストレージを指定できたり便利です。
指定しない場合 s0,s1,s2・・・という風に内部で名前がつけられます。
名前は最大15文字です。それ以上を指定すると16文字目以降は切り捨てられます。
また Transient という名前のストレージを Varnish がつくるので名前を指定する場合
は ｓ[数値]と Transient という名前を避けたほうが無難でしょう。
Transient の使い方については Tip's の「よくわからないけどスワップする」を参照
してください。
各タイプで説明します。
file[,path[,size[,granularity]]]
ファイルにオブジェクトを保存します。ただし再起動すると消えてしまいます。
ストレージにはアクセスしますがメモリに余裕があれば OS でキャッシュされているので高速です。ただメモリサイズより大きくに指定する場合は SSD などの高速スト
レージをおすすめします。
また起動時に指定サイズを確保するわけではないので事前に dd コマンドなどで初期化しておくと断片化などの影響を受けずに済みパフォーマンスに好影響を与えます。
path 保存パス
size サイズ 単位として k M G T と空き容量の割合で変化する%がある 1 GB を指定する場合は1 G
granularity 粒度 オブジェクトが指定サイズ(kGMT)より小さい場合は指定サイズまで切り上げます

ちなみにサイズの単位を指定しない場合はバイト単位になります。
malloc[,size]
メモリにオブジェクトを保存します。再起動すると消えます。
基本的にこれを多く利用します。
size サイズ 単位として k M G T と空き容量の割合で変化する%がある 1 GB を指定する場合は1 G

persistent[,path[,size]]
条件によっては再起動してもキャッシュが消えないストレージです。
実際に試してみたところ、Varnish が panic を起こして自動再起動した際や管理イン
タフェースから stop/start をしたときにキャッシュが消えないだけです。
path 保存パス
size サイズ 単位として k M G T と空き容量の割合で変化する%がある 1 GB を指定する場合は1 G-d
デバッグモードで Varnish を起動し、そのまま管理コンソールに入った状態になります。またリクエストを受け付ける子プロセスは起動していないのでコンソール上でstart とタイプして動かさないとリクエストを処理することができません。

30

-C-d と-f オプションと組み合わせて指定した VCL ファイルを C 言語に解釈したときのコードを出力します。
varnishd -d -f /etc /varnish/default.vcl -C

といったように指定します。

-p param=value
様々なパラメータを指定できます。パフォーマンスに影響するチューニングやエラーを起こしたときに自動再起動するかなど様々な値を設定できます。結構危ないパラメータがあるので注意して変更する必要があります。また、複数指定も可能です。
ここではデバッグする際に便利なパラメータを紹介します。
vcl_trace on/off
VCL の実行トレースします。膨大なログがでるのでデフォルトで off です。
VCL_trace [VRT_count の第二引数] [VCL の行数],[行頭から何文字目か]

この VRT_count の第二引数ですが VCL を C に解釈した際に以下のようなコードが出力されるます。
VCL
行数
145

146
147

if (req.http.host) {hash_data(req.http.host);} else {C 言語に変換時
738

739
740
741
742
743
744
745
746 );

if ((VRT_GetHdr(sp, HDR_REQ, "\005host:") != 0)){
VRT_count(sp, 13);
VRT_hashdata(sp,
VRT_GetHdr(sp, HDR_REQ, "\005host:"),
vrt_magic_string_end

これを実行してログを取得すると以下の出力を得られます。
13 VCL_trace

c 13 146.9

C 変換時の VRT_count の13と VCL の146行が実行されたということがわかります。
また hash_data は行頭から9文字目に存在することもわかります。

31

また VCL_call も通常
12 VCL_call

c hashという出力なのですがこのオプションを有効にすると
12 VCL_call

c hash 12 142.1に変化します。付与された数値は同じ見方ができます。
vcc_err_unref on/off
定義したバックエンドや ACL を使用しないと Varnish は起動しません。しかしこのオプションを off に設定すると、定義したけど使っていないときに起こるエラーは警告となり起動できます。

Varnish のデバッグ
何事もデバッグをするにはログを見ることが重要です。しかし Varnish は、ほかのミ
ドルウェアで見るようなファイルには出力しません。一般的にファイルに書き出す処理は非常に重いため高速化のために Varnish では共有メモリに出力しています。
そしてその共有メモリの内容をログ参照用のコマンドを使い見たり、必要に応じてファイルに保存したりします。まずはデバッグの時によく使う varnishlog について
解説します。その他については後述します。
まず Varnish を起動したあと varnishlog を起動しますvarnishlog

特にオプションは必要ありません。そしてブラウザで Varnish にアクセスしてみま
しょう。そうすると以下のようなログが出力されます。
（一部抜粋）
15 TxHeaderb X-Varnish: 1829024782
15 TxHeaderb Accept-Encoding: gzip
15 RxProtocol b HTTP/1.1
15 RxStatusb 200

パッと見なんとなくわかるようで微妙にわからないので次ページで解説します。
基本的にスペース区切りで4ブロックに分かれています。

32

1.

トランザクショングループ 15 RxStatus
b 200
HTTP トランザクションのグループです。
同じ番号は同じ HTTP のトランザクションに属します。
あくまで HTTP なのでクライアント・Varnish 間と Varnish・バックエンド間は別の番号が振られます。

2.

メッセージタグ 15 RxStatusb 200
アクティビティの種別でタグが付きます。
Prefix に Rx,Tx が付いている場合は意味があります。
Rx・・・Varnish が受け取ったデータ(Receive)
Tx・・・Varnish が送信したデータ(Transfer)3.

データの流れ 15 RxStatusb 200
どこからデータが来たかを示します。
c・・・クライアントからのデータ
b・・・バックエンドからのデータ

4.

データ 15 RxStatus
実際のデータです。

b 200

図解すると以下です。

例を挙げると
12 RxHeader c Host: example.net

クライアント(c)から送出された Header を Varnish が受け取っています(Rx)
13 TxHeader b Host: example.net

Varnish がバックエンド(b)に対して Header を 送出しています(Tx)です。
しかしこのコマンド膨大なログが出ます。1アクセスずつ確認する場合はそこまで気になりませんが運用中に確認するのはまず無理でしょう。
そのため絞り込みのオプションがあります。主に使うオプションを紹介します。

33

-b

Varnish とバックエンド間のトラフィックのみ出力します。

例えば、キャッシュできるはずなのに何故かキャッシュできていない際の調査に役に
立ちます。
-c

Varnish とクライアント間のトラフィックのみを出力します。
-m tag:Regex

指定タグとメッセージが正規表現とマッチするトランザクションを出力します。また
複数指定可能です。（V3.0.0 では二個までしか動作確認できませんでした）

例えば、/test で始まるクライアントからのリクエストをステータス200で返せた
トランザクションを出力するとこうなります。

varnishlog -m 'RxUrl:^/test.*$' -m 'TxStatus:200'
13 SessionOpen c 192.168.1.123 37131 :6081～中略～
13 RxURLc /test
13 RxProtocol c HTTP/1.0
13 RxHeader
c User-Agent: Wget/1.11.4 Red Hat modified～中略～
13 TxStatus
c 200
～中略～
13 ReqEnd
c 1266506662 1311094899.230543137 1311094904.424874067
0.000063658 0.788361788 4.405969143-i tag (-x tag)-i は特定のタグのみを出力します。複数指定可能です。-m と違いトランザクション
まるごとではないので注意してください。

また、-x はその逆でマッチするものを除外します。
-I Regex (-X Regex)-I は正規表現でマッチしたデータの行のみ出力します。一つのみ指定可能です。例

えばクライアントから送出されるクッキーのヘッダのすべてを出力したい場合は以下のようなコマンドになります。
varnishlog -c -i RxHeader -I Cookie-d

通常 varnishlog は起動してからの情報しか出力しませんが、このオプションを指定すると共有メモリに残っているログをすべて表示します。何かしら問題が起きてす
ぐであれば運良くログが残っているかもしれません。
varnishlog -d -c -m TxStatus:503

上記の例では過去ログから503を出力したリクエストを取得します。

34

さて、デバッグをする際にもう一つよくやることがあります。
コード中にログを出力する関数を書いて、その時点で操作している変数がどのような値を示しているかなどを確認することです。行い方を解説します。
しかし Varnish は標準ではログ出力を行うことはできません。行うには別途モジュールを読み込む必要があります。このモジュールの仕組みは VMOD と呼ばれておりバージョン3より実装されました。

そして Varnish 本体と一緒に配布されている std という VMOD を使うことで log出力が可能です。一緒に配布されているので特にインストールの際に別の手順は必要ありません。早速使ってみましょう。
import std; //ファイルの先頭～中略～

sub vcl_recv{
std.log(“RequestUrl:” + req.url);
return(lookup);}

これを varnishlog でログを取得してみると以下の出力を得られます。
13 VCL_Log

c RequestUrl:/b

非常に簡単です。
また他にデバッグの際によく行うのがどのルートで実行されたかの確認ですが。

もちろん log 出力で行っても構いませんがスマートではないので先ほど紹介した
起動オプションで-p vcl_trace=on

を使い確認するのが良いでしょう。
また、-X はその逆でマッチするものを除外します。
以上で基本的な Varnish の使い方を説明しました。

次ページから運用時に実際に使ったり、知っておくと便利な応用的な記法などを説明
します。

35

応用的な使い方
管理コンソールの利用方法
Varnish を CLI で管理するツールに varnishadm があります。同一のサーバの場合はオプション無しで実行することで、そのままコンソールに繋ぐことができます。
まずは help と打ってみましょう。使えるコマンドの一覧が出力されます。
help
200
help [command]ping [timestamp]～中略～

コマンドの後に表示される数字（上記では200)はコマンドを実行した成否です。
200の場合は受付され処理されます。それ以外は何らかのエラーがあります。
また、よくわからないコマンドについては以下のようにすることで説明が見れます。
help <コマンド名>
help vcl.list
200
vcl.list
List all loaded configuration.

管理コンソールは非常に強力なツールです。よく使うコマンドについて解説します。
param.show 現在のパラメータ一覧を表示する
現在のパラメータの設定値を見ることができます。また以下のように指定することでそのパラメータの説明も含めてみることができます。
param.show <パラメータ名>
param.show vmod_dir
200
vmod_dir/usr/lib64/varnish/vmods
Default is /usr/lib64/varnish/vmods
Directory where VCL modules are to be found.

param.set パラメータの設定を行う

パラメータを動的に設定することができます。一部パラメータについては後述する子プロセスの再起動が必要だったりしますが、ほとんどが即時反映します。
param.set <パラメータ名> <値>
param.set shortlived 5s
200

36

stop 子プロセスの停止を行う
Varnish は管理する親プロセスとリクエストを受け付ける子プロセスが存在します。
その子プロセスの停止を行います。子プロセスの再起動が必要なパラメータを変更した際などに使います。

start 子プロセスの開始する
先程の stop で停止した、もしくは何らかの原因などで止まってる子プロセスを開始します。

panic.show 最後に子プロセスがパニックを起こした際のログを出力
Varnish の子プロセスが何らかの原因でパニックを起こして再起動を起こした際に追跡を行うためのログを採取します。原因となったリクエストなども採取できます。
panic.show
200
Last panic at: Wed, 20 Jul 2011 16:42:38 GMT
Panic from VCL:PANIC: panictest
thread = (cache-worker)～中略～ban キャッシュの ban を行う
VCL の時の Varnish と同じように ban が行えますban <ban を行う際の評価式>
ban req.http.host == "example.net" && req.url ~ "^/image/"ban.list アクティブな ban のリストを表示する
ban は即時に消去せずにリストに貯めておきリクエストが来た際に評価しきゃ
キャッシュの消去を行います。そのリストの確認ができます。大量の ban がエントリされているとパフォーマンスに若干の影響を与えることがあるので、大量に ban
を行うことが多い場合はたまに確認するとよいでしょう。
ban.list
200
0x2acd1b11f280 1311182960.361679
req.url ~ ^/image/

0 req.http.host == example.net &&なお RPM で配布されている varnishadm は readline が使えません。
（入力済み文字列を矢印キーで再度出す機能）
そのため rlwrap というコマンドを同時に使うことで解決できます。
rlwrap varnishadm

rlwrap が見つからない場合は yum でインストールすることができます。
37インライン CVCL の説明をしたときに C 言語を中に埋め込むことができると紹介しましたが、その方法について解説します。
C のコードを挿入するには VCL 中の任意の箇所に以下のように記述します。
C{

任意のコード}C

非常に簡単です。
実際に行いたい処理はそれぞれなので、例よりもポイントを説明します。
基本的に習熟は VCL をダンプして公式のドキュメントにはインライン C の詳細なドキュメントはありません。ではどのように使える関数などを調べるのでしょうか？

基本的に VCL を C 言語にダンプして覚えていくのが速いです。先程の起動オプショ
ンで解説したとおり。

varnishd -d -f [VCL ファイル] -Cで C 言語をダンプして書いてある内容で調べていきましょう。また巻末のAppendix において以下を紹介しています。

VCL で利用する各型を STRING に変換する関数
内部では IP 型や TIME 型等様々ありますがそれの全変換関数です。
インライン C 利用時にヘッダ操作をする関数
req.http.*を操作するときの関数と操作の仕方です。
VCL 変数一覧
req.url など全ての変数の使えるアクションとインライン C 時の関数一覧です。

include は忘れずに
VCL と混在なので忘れがちなのが include です。利用する際は VCL の先頭でC{
#include <stdlib.h>#include <stdio.h>}C

きちんと書きましょう。

38

libmemcached や libxml2 など共有ライブラリを使う方法
インライン C で書くだけで済む処理なら問題ないのですが、様々な共有ライブラリを使いたいことがあるかと思います。その際は cc_command という起動パラメー
タを使用します。この起動パラメータは、VCL をコンパイルする際に利用するコマ

ンドとなります。libmemcached を利用する場合はここに-lmemcached と加えます。デフォルト値は環境によって異なりますので、先ほど解説した管理コンソールから param.show でデフォルトを取得してから行ってください。筆者の環境では以下のように指定しました。

-p cc_command='exec gcc -std=gnu99 -O2 -g -pipe -Wall -Wp,-

D_FORTIFY_SOURCE=2 -fexceptions -fstack-protector --param=ssp-buffersize=4 -m64 -mtune=generic -pthread -fpic -shared -Wl,-x -lmemcached -o %o%s' \後はインライン C で呼び出すためのコードを書くことで利用することができます。

また当然ですが、デバッグなどでコマンドで叩く際はこのオプションを忘れずに指定してください。共有ライブラリが読み込めず、undefined symbol がでてハマることがあります。

統計情報の見方
Varnish で実運用をするうえで統計情報を見るのは欠かせません。その際に使うツールを簡単に解説します。
varnishtop
varnishlog での一行ごとにカウントをとっていきランキングを作ります。
list length 146
4.96 VCL_return4.79 CLI
4.62 VCL_Log
3.71 TxProtocoldeliver
Rd ping
reqlocalhost.localdomain
HTTP/1.1

よく使うオプションの組み合わせは以下です。
varnishtop -i rxurl

クライアントから多くリクエストされた URL がわかります。

varnishtop -i txurl

バックエンドに多く要求している URL がわかります。キャッシュ対象にもかかわらず重複が多い
場合上手くキャッシュ出来ていないので確認が必要です。

Varnishtop -i txstatus

クライアントに返却したステータスコードがわかります。400以上のステータスが多い場合は異常が起きていないか確認が必要です。

39

varnishhist
直近 n アクセスの応答時間を図で表示したものです。
1:2, n = 40

|
|
|
||
#
|||
##
+-----------------+-----------------+------------|1e-6
|1e-5
|1e-4
[|]はヒットしたアクセス[#]はミスヒットしたアクセスになります。
縦軸はアクセス数で比率は左隅に出力されています。
（図では1:3なので1キャラクタが3アクセス）-6-5

横軸は応答時間です。1 e-6 は10 ～10 つまり1 μ 秒～10 μ 秒を表します。

全体的にレスポンスが遅いようであればチューニングなどの検討の対象となります。

varnishsizes
1:2, n = 40

|
|
|
|
#
|
#
#
+-----------------+-----------------+------------|1e1
|1e2
|1e3
先程の varnishhist はレスポンスタイムでしたが varnishsizes はレスポンスサイ
ズです。

2

3

横軸はサイズとなり、 1 e2 は10 ～10 つまり1 kB～10kB を表します。

40

varnishstat
Varnish は様々なカウンタを保持しています。ミスヒットした件数、バックエンド

へのリクエスト数、今までの転送サイズなどいろいろです。実運用を行っている際にチューニングを行うかの検討材料に使うことが多いです。
0+00:30:35 ←アップタイム

Hitrate ratio:
Hitrate avg:

10
100
145
0.8663 0.8590 0.8490

↓生データ
64

64
63
6
6
6
10
1
3
3
2

←下のヒット率を計算した秒数範囲←秒数毎のヒット率↓起動してからの秒数での平均

0.03
client_conn - Client connections accepted
0.00
0.03
client_req - Client requests received
0.00
0.03
cache_hit - Cache hits
0.00
0.00
cache_miss - Cache misses
0.00
0.00
backend_conn - Backend conn. success
0.00
0.00
fetch_length - Fetch with Length.
.
n_sess_mem - N struct sess_mem.
.
n_object - N struct object.
.
n_objectcore - N struct objectcore.
.
n_objecthead - N struct objecthead.
.
n_waitinglist - N struct waitinglist↑直近一秒での値
0.00

～中略～

ヒット率は以下の場所を見ます。
Hitrate ratio:
Hitrate avg:

10
100
145
0.8663 0.8590 0.8490

直近10秒の時は86.6%、100秒は85.9%、145秒は84.9%を示します。
他に、代表的な見ておくと良い数値を解説します。
N worker threads not created
スレッドを新規につくろうとしたが、作れなかった回数。出ないのが望ましい。

N worker threads limited
スレッドプールの最大値に引っかかって新規に作れない。出ないのが非常に望ましい。

N dropped work requests
処理を諦めたリクエスト数

これらの値はスレッドに関する値で、だいたいプール数の調整を行うことで改善します。初期プール数を大きめにするのも有効です。
ヒット率高いほどよいです。

N LRU nuked objects
オブジェクトが TTL を迎える前に削除された件数。ストレージサイズが小さいと起きる。

これらの値はキャッシュポリシーを考える際に利用します。
あくまで一例ですが、例を上げます。

41

ヒット率は高く nuked は少ない

理想の状態です。もし少し nuked が出ているのであればキャッシュするオブジェク

トが増えるとバックエンドへの問い合わせが増える可能性があるので注視しましょう。
ヒット率も nuked も高い

ストレージサイズが足りない状態です。キャッシュオブジェクトが今後増える場合
ヒット率も下がりやすいのでサイズを増やすことを検討しましょう。
ヒット率も nuked も低い

そもそもキャッシュするべきオブジェクトなのかの検討が必要です。またキャッシュ出来るはずなのに起きている場合は VCL の見直しが必要です。例えば正規化が可能な余計なクエリが付いていたりする可能性があります。

他にも様々なカウンタがあるのでうまく使いチューニングを行いましょう。

ストレージサイズと TTL の決め方
ストレージサイズと TTL を決めるのはなかなか難しいです。
エイヤと128 GB のメモリを搭載しているサーバで全て割り当てて満足、というのもコスト度外視でよければ悪くはないのですが、実際はなかなか難しいです。
サイズを決める際のポイントを説明します。
良くアクセスされるオブジェクトはどの程度か？
例えば各ページに埋め込まれている JS や CSS、ロゴ画像はよくアクセスされるので最低限それ以上のサイズは指定しましょう。またポータルサイトのような形態であれ
ば、TOP や各メインコンテンツからリンクされているページを全て格納できるサイズを用意しておくとよいでしょう。
どのようなアクセスパタンか？
前項と少しかぶるのですが、例えばニュースサイトにおいては最新の記事は非常にア
クセスが多いことが想定されます。しかし一ヶ月すぎたニュースはさほどアクセスはされないでしょう。アクセス解析などでどの程度で PV が減っていくかを見てアクセスの多い期間はキャッシュできるように TTL を設定するとよいでしょう。
そのオブジェクトを作成するコストはどれだけか？
例えば秒間10回と1回、アクセスされるオブジェクトがそれぞれあるとしましょう。
単純に考えれば10回アクセスされるものをキャッシュするべきです。しかし秒間1回
アクセスを受けるオブジェクトがプログラムで作成し CPU を相当使い、秒間10回ア
クセスを受けるオブジェクトは静的コンテンツの場合、秒間1回のアクセスしかなくても意識してキャッシュするべきでしょう。

42

ヒット率の上げ方
ちょっとした工夫でヒット率は上がり、ストレージサイズも節約できますので紹介します。

何がなんでも正規化

これに尽きます。正規化を行う際の見ておきたいポイントを解説します。
ドメイン名の正規化
VCL の説明の箇所でも記述しましたが、重要なので再度説明します。
www.example.net と example.net が同じ内容を返すのであればどちらかに寄せるべきです。
if(req.http.host ~ "(?i)(www\.)?example\.net"){set req.http.host = “example.net”;}

QueryString の正規化 1
例えば URL 中に特にコンテンツの内容にかかわらないパラメータが存在する場合は消してしまうのも手です。
sub vcl_recv{
set req.url = regsub(req.url, "(\?|&)xxx=[^&]+&?(.+)?$", "\1\2");
set req.url = regsub(req.url, "(\?|&)$", "");
return(lookup);}

ここでは xxx=のパラメータが不要として削除するようにしています。

また、ここで利用した regsub ですが正規表現を利用した置換関数です。
以下のように利用します。

regsub(置換対象,正規表現,置換式)

正規表現でキャプチャしたものは\1,\2といったように指定します。また regsub は最初のマッチしたものだけの置換ですが全て置き換える regsuball もあります。

QueryString の正規化 2
Varnish では以下の場合でも異なるオブジェクトとします。
/Test?aaa=1&bbb=1/Test?bbb=1&aaa=1

aaa と bbb の順番が違うだけです。インライン C を使ってソートすることも可能で
すが、そもそも HTML やテンプレート側でリンクの際の QueryString はソートしてから渡すことで解決します。

43

クッキーの正規化
クッキーについても QueryString と同様の理由で正規化する必要があります。
もしくは必要ないのであれば削除するべきでしょう。

Vary に注意する
Vary ヘッダは同じ URL で異なる内容を返す際に、何を判断すればいいのかをプロキシに伝えるものです。
Vary: User-Agent

上記の場合 User-Agent が違う場合異なるキャッシュで保存しようとします。おそらくこれの期待は IE・FireFox・Chrome などのブラウザの種類で切り替えることですが、IE でどれだけ User-Agent があるのでしょうか？OS のバージョン

や.NET のバージョン、ツールバーが情報を付与したり同じバージョンの IE だとしても10じゃきかないでしょう。そのため注意して正規化をする必要があります。

また正規化以外の方法としては、TTL を引き上げるなどの方法、次に説明する ESIと gzip があります。

Edge Side Includes (ESI)
本誌の最初の動的コンテンツの配信のところで触れているとおり、非常に強力な機能です。ページ自体の高速化・システム全体の負荷の軽減が期待できます。
ただ、高速化にすごい期待しないでください。いれれば即100倍になった！という単純なものではないのです。どのようなものでもそうなのですが、システムは一番遅いところの速度に落ち着きます。ESI では、以下の場合苦手です。
•

ページを生成する際に絶対キャッシュできないものがある•

そのコンテンツの取得が遅い•

コンテンツの取得がページ全体の処理時間の大半を占めている

具体的には当てはまるのは何でしょうか？一例として携帯サイトでの広告です。携帯サイトの場合、基本的に JS は使えないのでどうしても広告を取得してページに埋め込む必要があります。その処理は毎回行わないといけないので、その遅さに引きづられます。もちろんその場合でもシステムの負荷の軽減は期待できるので検討するのもよいでしょうが、何がなんでも ESI で解決ではないということを意識してください。
さて、実際の使い方です。vcl_fetch 内で beresp.do_esi を true にします。
sub vcl_fetch{set beresp.do_esi = true;}44これだけで有効になります。
そしてコンテンツ側の記述ですが以下のように記述します。
<esi:include src=”path” />指定したパスを展開します。
/index.html<html><body>↓<br /><esi:include src=”/esi/1.html” />↑<br /></body></html>/esi/1.html
Hello ESI!<br />上記を実際にみると<html><body>↓<br />
Hello ESI!<br />↑<br /></body></html>と返却されます。

<esi:remove>～</esi:remove>

ESI 実行時に削除される範囲です。タグで囲まれた範囲を削除します。
つまり ESI が有効でない場合にそのまま表示されます。<esi:XXXX>といった記述は特に HTML の表示に悪影響はないので一時的に ESI を止めてる時にメッセージを出すときに利用します。
記述→<esi:remove>hoge</esi:remove>←

ESI 有効時→←

ESI 無効時→<esi:remove>hoge</esi:remove>←45

<!--esi ～ -->ESI 処理が行われた際に表示される項目です。無効時はコメントのままです。
記述→<!--esi hoge -->←ESI 有効時→ hoge ←ESI 無効時→<!--esi hoge -->←ESI の規格では他のタグも存在するのですが Varnish がサポートしているのは以上の記述のみです。

また、ESI 利用時の注意事項について説明します。
デフォルトでは HTML/XML タグ形式ではないと解釈されない

include の例できちんと<HTML>～と記述しましたが例えば内容を include のみにした場合は動作しません。どうしても動作させたい場合は起動パラメータで設定を行います-p esi_syntax=0x00000001 \このオプションを指定するとタグが存在しなくても ESI の構文を探します。
ネストするページで<html>や<body>を出力するとそのまま出力される

ESI では特に中身について変更を行わず単純に埋込みを行います。つまり include
元と先で両方共<html>や<body>タグがあると両方共出力されてしまいます。
ネスト数は制限がある

ESI した先でさらに include の記述があってもネストすることはできますがデフォルトでは最大ネスト数は5です。変更したい場合は起動パラメータで以下のように指定します。
-p max_esi_depth [最大ネスト数] \なおネスト制限に引っかかって展開されない場合でも include はそのまま残るわけではなく削除されます。

ページの ESI 化を行う際は再起動かページの ban を行うのが望ましい

詳しくは gzip で解説しますが、Varnish が ESI のタグを解釈するのは fetch した

時なので既にキャッシュされている場合はキャッシュが消えるまではそのオブジェク
トを ESI せずにそのまま返却します。

46

do_esi を外すだけでは ESI 処理を OFF に出来ない
有効化の時と同様の理由です。ESI 処理が入った場合、単純に
beresp.do_esi = false

では止めることはできません。フロー図を思い出してください、ヒットしたオブジェ
クトは fetch を通過しません。オフにする場合は vcl_recv で以下を指定してください。

set req.esi = false;gzip の利用
Varnish3 では gzip をサポートしています。これはどういう事かというと、サーバか
ら非圧縮のオブジェクトを取得して、gzip 圧縮を行いキャッシュし、そしてクライアントが Accept-Encoding で gzip をうけとれるのであれば gzip を送信し、そうでなければキャッシュ内の gzip を解凍して送信することができます。

これには3つの利点があります。
まず単純にキャッシュの効率的な利用です。Varnish2.1 までは同じ内容を gzip で要求するクライアント、非圧縮を要求するクライアントが混在で両方対応する必要がある場合、Varnish は両方キャッシュする必要がありました。しかし、Varnish3 では
レスポンス生成時の gzip 圧縮・解凍が可能になりました。これによりキャッシュされるオブジェクト数は半減する上、キャッシュも圧縮された状態で保存されるのでより多くのオブジェクトを保存できます。
次に、帯域の節約です。画像がメインの場合はそうでもありませんが、CSS や
JS、HTML を大量にキャッシュするようなサイトの場合はかなり効いてくるはずです。
最後に ESI です。2.1までは include する要素が全て非圧縮な必要がありました。解凍できなかったためです。そうすると ESI で組み立てを行ったページは自ずと非圧縮になってしまい、クライアントが gzip の受付ができるにもかかわらず非圧縮で返さざるを得ませんでした。しかし3.0では圧縮も解凍もできるため、2.1までの問題は起きません。

47

では使い方を説明します。
sub vcl_fetch{set beresp.do_gzip = true; //圧縮されていない場合圧縮する//set beresp.do_gunzip = true; //圧縮されている場合解凍する}

これで全ての非圧縮オブジェクトはキャッシュへ保存時に gzip されます。
非常に便利な gzip ですが2点注意があります。

CPU を使います
当然ですが圧縮・解凍には CPU を使います。おそらく気にならないレベルですが環境によっては注視する必要があるでしょう。
ESI を利用する際は Varnish・バックエンド間は非圧縮で必須ではありませんがバックエンドからのレスポンスは非圧縮が望ましいです。
順に考えてみましょう。
Varnish が ESI のタグを解釈するタイミングは fetch した時です。解釈を行い、234
バイトスキップしてその後234バイトはそのまま、次にファイルを include して・・・といった特殊な情報を付与します。このプロセスは当然ながら gzip 圧縮された状態では動作しないため解凍して行われます。
レスポンスが圧縮状態の場合

レスポンス→解凍→ESI 解釈→その後の処理
レスポンスが非圧縮状態の場合

レスポンス→ESI 解釈→その後の処理

そのためこのような記述を行ってください。
sub vcl_miss{if (ESI 処理を必要とするオブジェクト){unset bereq.http.accept-encoding;}}
sub vcl_fetch {if (ESI 処理を必要とするオブジェクト){set beresp.do_esi = true;
set beresp.do_gzip = true;}}

これによりバックエンドから取得する際は非圧縮で、キャッシュに保存する際はgzip されている状態になります。

48

VMOD の追加の仕方
Varnish には VMOD という機能拡張のためのモジュールが存在します。標準では stdというモジュールが存在しログ出力などが可能です。
しかし、他に配布されているモジュールを実際に使うにはどうすればいいでしょう
か？行い方を解説します。
今回は Kristian Lyngstøl(@kristianlyng)さんの、クッキーなどのヘッダ操作を行う
vmod_header で試してみます。VMOD のコンパイルには Varnish のソースが必要です。インストールしているバージョンの Varnish のソースと VMOD のソースをダ
ウンロードします。
githubhttps://github.com/KristianLyng/libvmod-header
解凍～インストール

tar zxf KristianLyng-libvmod-header-5b6fe2b.tar.gz
tar zxf varnish-3.0.0.tar.gz
cd KristianLyng-libvmod-header-5b6fe2b./configure VARNISHSRC=/root/temp/varnish-3.0.0 \VMODDIR=/usr/lib64/varnish/vmods
makemake install

オプションの VARNISHSRC は必須です、ソースを解凍した場所を指定してください。VMODDIR は必須ではありませんが指定しておくといいです。
場所は以下で調べられます。

[root@localhost ~]# varnishadm param.show vmod_dir

CLI connected to 0.0.0.0 6082
vmod_dir/usr/lib64/varnish/vmods
Default is /usr/lib64/varnish/vmods
Directory where VCL modules are to be found.

ちなみに上記のように varnishadm は引数にコマンドを入れることも可能です。

また make 時に以下のようなメッセージが出力されエラーになることがあります。
========================================You need rst2man installed to make dist========================================
make[2]: *** [vmod_header.3] Error 1

その場合は python-docutils を入れる必要があります。
yum install -y python-docutils

その後は make clean を行い再度 configure から行ってください。

49

次は実際に VCL を記述します。
//先頭付近に

import header;～中略～
sub vcl_fetch {header.append(beresp.http.Set-Cookie,"foo=bar");header.remove(beresp.http.Set-Cookie,"dontneedthiscookie");}

この後 varnish をリロードか再起動を行い試してみてください。
---response begin---

HTTP/1.1 200 OK～中略～
Set-Cookie: foo=bar～後略～

きちんと追加されていることが確認できます。

またこのモジュールですが、クッキーの操作に便利なのでぜひ man で使い方を見てみてください。

man vmod_header

なお Varnish のバージョンが上がるとリビルドが必要なことがあります。注意してください。

ストレージの高度な制御
Varnish のキャッシュストレージは複数指定することができますが、そのままだとど
このストレージに保存するかは不定です。しかし、あんまりヒットしないものは fileに凄いアクセスされるのは malloc に・・・としたいこともあるかもしれません。
ここではストレージの制御の方法を解説します。
まず最初に、起動オプションのストレージ指定においてユニークな名前をつけます。
-s st1=malloc,1G \-s st2=file,/tmp/varnish_file,1G \太字の箇所がユニークな名前です。
次に URL のパターンによって格納先を変えます。
sub vcl_fetch{
if(req.url ~”^/s1/”)else}{ set beresp.storage = “st1”;}{ set beresp.storage = “st2”;}

パスが/s1/の時は st1、それ以外は st2 に保存します。
次は残り容量をチェックして保存先を切り替えます。
50

sub vcl_fetch{if(storage.st1.free_space > 100MB)
else}{ set beresp.storage = “st1”;}{ set beresp.storage = “st2”;}

上記では、ストレージの残り容量が100 MB を越えている場合は st1、それ以外は

st2 となります。また現在 free_space が使えるのは malloc だけのようで
file,persistent で指定しても有効な値は帰ってきません。

バックエンドの高度な利用
特定のバックエンドにアクセス出来ないときにのみ別のバックエンドを使いたいときはどうすればいいでしょうか？以下解説します。
sub vcl_recv{
set req.backend = b1;
if( ! req.backend.healthy ){set req.backend = b2;}}

ヘルスチェクをしていないといけませんが req.backend.healthy を使うとバックエンドの状態がわかります。

この例では、b1 が異常の場合は b2 を利用します。

varnishtest の使い方
Varnish の VCL は非常に複雑な処理も可能な言語です。そのためテストが重要になってきます。varnishtest はテストの定義を予め作って置くことで、VCL 変更時のデグレードテストも手軽に行えます。
基本的な定義名前は s1 とする
server s1 {# リクエストを受ける
rxreq# レスポンスする
txresp -hdr "Connection: close" -body "012345\n"}# バックエンドサーバを起動
server s1 -start# バックエンドサーバを定義する# varnish の定義 名前は v1 とする
varnish v1 -arg "-b localhost:${s1_port}"51

名前は c1 とする
client c1 {# リクエストする
txreq -url "/"# レスポンスを待つ
rxresp# ステータスを評価する 200なら OK
expect resp.status == 200}# クライアントを定義する# varnish を起動
varnish v1 -start# クライアントを動かす
client c1 -run
# リクエストを待つ
server s1 -wait

実行はvarnishtest -v [filename]です。-v トレース結果を出力するオプションで必須ではありません。
流れとしては
1.

Varnish とバックエンドとクライアントの定義をする

2.

Varnish とバックエンドを起動する

3.

クライアントを Run してテスト実行

4.

後処理

です。最低限覚えておきたい記述について解説します。
${xxx_port} ポート指定（xxx はサーバ名）

基本的にサーバのポートは自動的に付けられます。
そのため複数のバックエンドサーバを定義したり Varnish を定義した場合に指定がしづらいといったことがあります。その際にこの変数を使うことで解決できます。
またアドレス版の${xxx_addr}もあります。

expect [変数] [比較演算子] [変数]様々な比較を行い一つでも失敗したら fail になります。
トレース中はこのような表記で出力されます。
成功 expect resp.status == 200**** c1 0.3 EXPECT resp.status (200) == 200 (200) match
失敗 expect resp.status == 202---- c1 0.3 EXPECT resp.status (200) == 202 (202) failed52

rxreqリクエストを受けるのを待ちます。

txresp -hdr ”[ヘッダー]” -body “[内容]”

サーバがレスポンスする際に利用します。オプションはこれだけではありませんが主に使うのは hdr と body です。

txreq -req [メソッド] -url ”url” -hdr “[ヘッダー]”

クライアントがリクエストする際に利用します。メソッドは GET や POST を指定します。

rxresp

レスポンスを待ちます。

delay [秒数]指定秒数次の処理を待ちます。
秒数指定は小数点が指定可能です

server [name] {振る舞い方} [option]

バックエンドサーバの定義でリクエストを受け取った際にどのような振る舞いをする
か定義します。オプションには以下があります。
-start サーバを起動-wait リクエストを待機client [name] {振る舞い方} [-run]

バックエンドサーバの定義で、リクエストを受け取った際にどのような振る舞いをす
るか定義します。-run を指定するとクライアントを動作させます。

varnish [name] -arg “起動オプション” {振る舞い方} [-option]
varnish を定義します。arg で起動オプションを指定します。その際にテストした
い VCL を指定すると良いでしょう。オプションには以下があります。
-start サーバを起動-stop サーバを停止-wait リクエストを待機

さらなる使い方については varnish のソース中に含まれる*.vtc ファイルを参照してください。

例えば rxresp,rxreq を上手く使うことでサーバが複数回レスポンスを返したり、
クライアントが複数回リクエストするような記述も可能です。

53

Varnish にやさしい ban の仕方
ban は実行されたタイミングで即削除を行わず、リストに ban の条件式を登録します。そして lookup、もしくは実際の削除を行っているスレッド(ban lurker thread)が定期的に見て回り、式が True になったものがあれば削除を行います。
ここで以下の ban について考えてみましょう。
ban req.http.host == "example.net" && req.url ~ "^/image/"

リクエストの host と url を評価しています。リクエストの変数(req.*)が生成されるのはリクエストを受けたときだけです。つまりこの ban が実行されるのは

lookup されるときにしか行われません。条件に合うリクエストが来るまでリストに残ります。ほんの数件であれば問題ないのですが大量にリストされていると、パフォーマンスに影響が出てきます。何とかして 削除しているスレッドに回収させたいのですが、そのためには req を使わない方法でないといけません。

そこで以下の方法でキャッシュを表す obj 変数を使うことで回避可能です。
vcl
sub vcl_fetch{set beresp.http.X-URL = req.url;
set beresp.http.X-HOST = req.http.host;}banban obj.http.X-HOST == "example.net" && obj.http.X-URL ~ "^/image/"

vcl_fetch で beresp に.X-URL/HOST を入れているのは、obj 変数が berespの情報を維持する為です。beresp には.url は存在しませんし、レスポンスには通常は Host ヘッダ含まないため、beresp.http.host もありません。しかし req 変数を使わないためにはその上方が必要なため.X-URL と.X-HOST に退避しています。
こうすることで obj で url と host を指定できます。実際に実行してみた結果です。
PID USERPR NI VIRT RES SHR COMMAND
15734 varnish 20 0 440m 18m 988 varnishd15734 varnish 20 0 504m 78m 1208 varnishd15734 varnish 20 0 504m 78m 1244 varnishd15734 varnish 20 0 444m 20m 1300 varnishd//起動状態//56M ファイルをキャッシュ//req.*で ban して数秒後//obj.*で ban して数秒後最初の56 MB のファイルをキャッシュの際しかアクセスしていませんが obj で ban
すると回収されるのがわかります。

なお、レスポンスヘッダには.X-URL と.X-HOST が含まれます。必要ない場合は

vcl_deliver で unset してください。
また、obj.*変数の詳細については Appendix を参照ください54

Tip's
X-Varnish ヘッダってなに？
Varnish が返却するヘッダに X-Varnish というものがあるがこれはなんでしょうか？
出力パタンは2つあります。
•

X-Varnish: 1393335468•

X-Varnish: 1393335498 1393335468

実は数字の部分がひとつの場合はバックエンドに取得しに行った物で、2つある場合はキャッシュから返却したものです。数値はトランザクション ID です。
•

X-Varnish: [トランザクション ID]•

X-Varnish: [今回のトランザクションの ID] [キャッシュする際に使ったトランザクション ID]

この ID はバックエンドにリクエストする際も付与されており、バックエンド側で
X-Varnish をログしている場合どのリクエストがキャッシュされたかが分かるためデバッグがしやすくなります。

リダイレクトはどうやるの？
Varnish でリダイレクトを行うのは少し厄介です。基本は error で処理を vcl_errorに飛ばしそこで Location を設定する形で行います。例えば存在しない HTML ファイ
ルへのアクセスをトップページに飛ばす場合はこのように行います。
sub vcl_fetch {if (beresp.status == 404 && req.url ~ "\.html?$") {error 750 "http://example.net/";}}sub vcl_error {if (obj.status == 750) {set obj.http.Location = obj.response;
set obj.response = "Fonund";set obj.status = 302;
return(deliver);}}

ポイントはエラーに飛ばす際にステータスを実際には使われないコードを指定する事と（この場合750）レスポンスにリダイレクト先を含めることです。
もちろん vcl_fetch 内だけではなく vcl_recv などの他のアクションでも使用できます。

SSL について
Varnish は SSL に対応していないため前段に Nginx などを置くなどする必要があります。
55

画像が404の際にデフォルトの画像を出す方法
vcl_fetch において該当ファイルが404の存在有無がわかるので、実行すると
vcl_recv に戻る事が可能な restart を行います、req.*の引継ぎが可能なので以下のように記述します。
sub vcl_fetch {if(beresp.status == 404 && req.restarts == 0){
set req.url = "/noimage.jpg";
return(restart);}}

大きなファイルの時に503になる
ストレージのサイズがオブジェクトのサイズを超える場合 Varnish は503を返します。
例えば640 MB の ISO イメージがたくさんあるサーバでストレージのサイズが200 MB しかない場合 ISO イメージをリクエストしたら503が起きます。想定される転送サイズより大きめのストレージサイズを指定しましょう。

よくわからないけどスワップする
スワップする原因は幾つかありますが、Varnish3 で起こりなかなかハマるものについて紹介します。Varnish はごく短期間の TTL の場合別の一時的なストレージ(Transient)に保存します。これは初期状態だと制限がなく（=搭載メモリ）しかも
malloc ストレージのため最悪の場合スワップしてしまいます。基本的に短期間しか保存しないので問題ないのですが、制限がないのも気持ち悪いので以下の方法で制限がかけられます。
-s Transient=malloc,100M

を起動オプションに追加します。ここでは100 MB と指定していますがそれぞれの環境に応じて調整してください。オブジェクトのサイズがストレージを超えると、やはり503になります。またストレージの指定は Transient だけではなく他のストレー
ジも必ず指定して2個以上ストレージがあるようにしてください。場合によりsegfault する場合があります。

.ttl と.grace と.keep について
ttl はオブジェクトの有効期間です。期間中はキャッシュからレスポンスします。
grace が有効になるのは TTL が切れて再キャッシュしようとした場合でバックエンドが異常に陥りキャッシュできない場合に暫定で TTL が切れていてもレスポンスする猶予期間です。
また keep ですが V3.0.0 では特に有効に動きません。将来の予約のためだそうです。
ちなみにキャッシュの実際の保持期間は ttl+grace+keep です。もちろん溢れた場合は消されます。
56

Appendix
アクションフロー図詳細
Request received

RESTART

Dissect request

vcl_recv() req.
lookupvcl_hash() req.

pipe

error

Filter req.->bereq.

ERROR

hash

obj in cache ?
create if not

vcl_pipe()

no
pass

yes

filter req.->bereq.

pipe error

obj.f.pass ?

ERROR

send bereq.
pipe until closenovcl_miss()req.
bereq.

error restart
ERROR

yes vcl_hit()
pass

RESTARTreq.
bereq.

req.
obj.

pass error

deref obj.

restartERRORRESTART

filter req.->bereq.
fetch
vcl_pass()
passcreate anon object

req.
bereq.

restart error
RESTART

ERROR

fetch hdr
from backend(find obj.ttl)

deliverreq.
vcl_fetch() bereq.
beresp.
restartRESTART

hit_for_pass

obj.f.pass=true

error
deliver

ERROR

stream ?

ERROR

nofetch bodyfrom backend

yes

vcl_error() resp.

deliver
Filter obj.->resp.

vcl_deliver()resp.
delivererror restart

Send body

ERROR

deliver

RESTART

streaming
fetch/deliver

Request completed

57

各アクションの際に指定できるリターン値
return値
error
pass
hit_for_pass
pipe
lookuprestarthash
fetch
deliver
ok

recv
x
x
x
x

pipe pass
x
x
x

hash

アクション(vcl_*)miss hit fetch
x
x
x
x
x
x

delivererror

init fini

x
x

x

x

x

x

x

x

x

x

x

x
x
x

x

vcl_init/fini の動作条件
vcl_init/fini は本文中で解説していませんが VCL がロード・アンロードの際に呼び出されます。Varnish の再起動などを行い実際に呼ばれるパタンを調べたのが以下です。
/etc/init.d/varnish start/etc/init.d/varnish restart/etc/init.d/varnish reload/etc/init.d/varnish stop
start(cli)stop(cli)
vcl.load(cli)vcl.discard(cli)vcl.use(cli)vcl_initxxx

vcl_finixxx

vcl_fini が呼び出される条件は明示的に VCL が破棄されるタイミングのみです。

VCL で利用する各型を STRING に変換する関数
型名
IP
INT
BYTES
DURATION
TIME
BOOL
BACKEND

関数名
VRT_IP_string
VRT_int_string
VRT_double_string
VRT_time_string
VRT_bool_string
VRT_backend_string

第一引数に sp 指定、第二引数に変換したい値を指定する。

58インライン C 利用時にヘッダを操作する関数
値の設定
void VRT_SetHdr(const struct sess *sp , enum gethdr_e where, const char *hdr, const char *p, …)
項番
引数名 説明
1 *sp
spを指定
操作する対象を指定（HDR_REQ, HDR_RESP, HDR_OBJ, HDR_BEREQ, HDR_BERESP）
2 where3 *hdr
操作するフィールドを指定
挿入する文字列を指定、複数指定の場合は結合する。最後にvrt_magic_string_endの指定必須
4～ *p
戻り値 なし値の取得
char * VRT_GetHdr(const struct sess *sp, enum gethdr_e where, const char *n)
項番
引数名 説明
1 *sp
spを指定
操作する対象を指定（HDR_REQ, HDR_RESP, HDR_OBJ, HDR_BEREQ, HDR_BERESP）
2 where3 *n
操作するフィールドを指定
戻り値 指定したフィールドの値*hdr 及び*n の指定方法は以下の通り
フィールド長のサイズ(1バイト) + フィールド名(末尾に:)
VRT_SetHdr(sp, HDR_RESP, "\010Expires:", “XXXXXX”, vrt_magic_string_end);
VRT_GetHdr(sp, HDR_RESP, "\010Expires:");

組み込み関数一覧
関数
ban(式)
ban_url(正規表現)
call サブルーチン名
hash_data(式)panic(式)purge
return(アクション名)
rollback
set 変数 代入演算子 式
synthetic 式
remove 変数
unset 変数error ステータスコード レスポンス
regsub(置換対象,正規表現,置換式)
regsuball(置換対象,正規表現,置換式)

説明
指定条件でbanする
指定正規表現と一致するreq.urlの場合banする
別のサブルーチンを呼び出す
オブジェクトを格納する際のハッシュに追加する
指定メッセージを出力して子プロセスを殺す
即時にハッシュを削除する
returnする
変数を初期化してvcl_recvに移動
変数に値を設定する
レスポンスボディを合成する
unsetと同じ（過去の互換性維持のため存在）変数を削除する
obj.status,obj.responseを指定してvcl_errorに行く
正規表現で最初にヒットしたものの置換を行う
正規表現で最初にヒットしたもの全ての置換を行う

利用可能なアクション

hashのみmiss,hitのみ

errorのみ

VCL 変数の説明
変数
client.*server.*req.*
bereq.*
beresp.*obj.*
resp.*
storage.*

説明
クライアントの情報（IPなど）
サーバ情報（IPなど）
クライアントからのリクエスト（URLやヘッダ）
バックエンドへのリクエストする際に利用する（URLやヘッダ）
バックエンドからのレスポンスヘッダ
キャッシュされたオブジェクトの情報（ヒット回数やヘッダ）
クライアントにレスポンスするヘッダ
ストレージ（使用サイズなど）

アクション遷移中に req.*は bereq.*にコピーされ、beresp.*はキャッシュ格納時にobj.*にレスポンス時には resp.*にコピーされます。

59

VCL 変数一覧
変数名
client.ip
client.identity
server.ip
server.hostname
server.identity
server.port
req.request
req.url
req.proto
req.http.*
req.backend
req.restarts
req.esi_level
req.ttl
req.grace
req.keep
req.xid
req.esi
req.can_gzip
req.backend.healthy
req.hash_ignore_busy
req.hash_always_missbereq.request
bereq.url
bereq.proto
bereq.http.*
bereq.connect_timeout
bereq.first_byte_timeout
bereq.between_bytes_timeout
beresp.proto
beresp.saintmodeberesp.statusberesp.response
beresp.http.*
beresp.do_esi
beresp.do_stream
beresp.do_gzip
beresp.do_gunzip
beresp.ttl
beresp.grace
beresp.keep
beresp.backend.nameberesp.backend.ip
beresp.backend.port
beresp.storage
obj.proto
obj.status
obj.response
obj.hits
obj.http.*
obj.ttl
obj.grace
obj.keep
obj.lastuse
resp.proto
resp.status
resp.response
resp.http.*
now
storage.[storagename].free_spacestorage.[storagename].used_spacestorage.[storagename].happy

60

インラインC利用時の関数
読み込み時
VRT_r_client_ip(sp)VRT_r_client_identity(sp)VRT_r_server_ip(sp)VRT_r_server_hostname(sp)VRT_r_server_identity(sp)VRT_r_server_port(sp)VRT_r_req_request(sp)VRT_r_req_url(sp)VRT_r_req_proto(sp)
VRT_GetHdr(sp, HDR_REQ,
VRT_r_req_backend(sp)VRT_r_req_restarts(sp)VRT_r_req_esi_level(sp)VRT_r_req_ttl(sp)VRT_r_req_grace(sp)VRT_r_req_keep(sp)VRT_r_req_xid(sp)VRT_r_req_esi(sp)VRT_r_req_can_gzip(sp)VRT_r_req_backend_healthy(sp)VRT_r_req_hash_ignore_busy(sp)VRT_r_req_hash_always_miss(sp)VRT_r_bereq_request(sp)VRT_r_bereq_url(sp)VRT_r_bereq_proto(sp)
VRT_GetHdr(sp, HDR_BEREQ,
VRT_r_bereq_connect_timeout(sp)VRT_r_bereq_first_byte_timeout(sp)VRT_r_bereq_between_bytes_timeout(sp)VRT_r_beresp_proto(sp)VRT_r_beresp_status(sp)VRT_r_beresp_response(sp)
VRT_GetHdr(sp, HDR_BERESP,
VRT_r_beresp_do_esi(sp)VRT_r_beresp_do_stream(sp)VRT_r_beresp_do_gzip(sp)VRT_r_beresp_do_gunzip(sp)VRT_r_beresp_ttl(sp)VRT_r_beresp_grace(sp)VRT_r_beresp_keep(sp)VRT_r_beresp_backend_name(sp)VRT_r_beresp_backend_ip(sp)VRT_r_beresp_backend_port(sp)VRT_r_beresp_storage(sp)VRT_r_obj_proto(sp)VRT_r_obj_status(sp)VRT_r_obj_response(sp)VRT_r_obj_hits(sp)
VRT_GetHdr(sp, HDR_OBJ,
VRT_r_obj_ttl(sp)VRT_r_obj_grace(sp)VRT_r_obj_keep(sp)VRT_r_obj_lastuse(sp)VRT_r_resp_proto(sp)VRT_r_resp_status(sp)VRT_r_resp_response(sp)
VRT_GetHdr(sp, HDR_RESP,
VRT_r_now(sp)
VRT_Stv_free_space([storagename])
VRT_Stv_used_space([storagename])
VRT_Stv_happy([storagename])

書き込み時
VRT_l_client_identity(sp,VRT_l_req_request(sp,VRT_l_req_url(sp,VRT_l_req_proto(sp,VRT_SetHdr(sp, HDR_REQ,
VRT_l_req_backend(sp,VRT_l_req_ttl(sp,VRT_l_req_grace(sp,VRT_l_req_keep(sp,VRT_l_req_esi(sp,VRT_l_req_hash_ignore_busy(sp,VRT_l_req_hash_always_miss(sp,VRT_l_bereq_request(sp,VRT_l_bereq_url(sp,VRT_l_bereq_proto(sp,VRT_SetHdr(sp, HDR_BEREQ,
VRT_l_bereq_connect_timeout(sp,VRT_l_bereq_first_byte_timeout(sp,VRT_l_bereq_between_bytes_timeout(sp,VRT_l_beresp_proto(sp,VRT_l_beresp_saintmode(sp,VRT_l_beresp_status(sp,VRT_l_beresp_response(sp,
VRT_SetHdr(sp, HDR_BERESP,
VRT_l_beresp_do_esi(sp,VRT_l_beresp_do_stream(sp,VRT_l_beresp_do_gzip(sp,VRT_l_beresp_do_gunzip(sp,VRT_l_beresp_ttl(sp,VRT_l_beresp_grace(sp,VRT_l_beresp_keep(sp,VRT_l_beresp_storage(sp,VRT_l_obj_proto(sp,VRT_l_obj_status(sp,VRT_l_obj_response(sp,
VRT_SetHdr(sp, HDR_OBJ,
VRT_l_obj_ttl(sp,VRT_l_obj_grace(sp,VRT_l_obj_keep(sp,VRT_l_resp_proto(sp,VRT_l_resp_status(sp,VRT_l_resp_response(sp,
VRT_SetHdr(sp, HDR_RESP,型名IP
STRINGIPSTRINGSTRINGINT
STRINGSTRINGSTRINGHEADER
BACKEND
INT
INT
DURATION
DURATION
DURATIONSTRING
BOOL
BOOL
BOOL
BOOL
BOOL
STRINGSTRINGSTRINGHEADERDURATION
DURATION
DURATIONSTRINGDURATIONINTSTRINGHEADER
BOOL
BOOL
BOOL
BOOL
DURATION
DURATION
DURATIONSTRINGIP
INT
STRINGSTRINGINT
STRINGINT
HEADERDURATION
DURATION
DURATION
DURATIONSTRINGINT
STRINGHEADER
TIME
BYTES
BYTES
BOOL

アクション
recv pipe
R
R
RW RW
R
R
R
R
R
R
R
R
RW RW
RW RW
RW RW
RW RW
RW RW
R
R
R
R
RW RW
RW RW
RW RW
R
R
RW
R
R
R
R
RW
RW
RW
RW
RW
RW
RW
RW
RW

pass
R
RW
R
R
R
R
RW
RW
RW
RW
RW
R
R
RW
RW
RW
R

hash
R
RW
R
R
R
R
RW
RW
RW
RW
RW
R
R
RW
RW
RW
R

miss
R
RW
R
R
R
R
RW
RW
RW
RW
RW
R
R
RW
RW
RW
R

hit
R
RW
R
R
R
R
RW
RW
RW
RW
RW
R
R
RW
RW
RW
R

R
R

R
R

R
R

R
R

RW
RW
RW
RW
RW

RW
RW
RW
RW
RW
RW
RW

fetch
R
RW
R
R
R
R
RW
RW
RW
RW
RW
R
R
RW
RW
RW
R
RW
R
R

deliver
R
RW
R
R
R
R
RW
RW
RW
RW
RW
R
R
RW
RW
RW
R
RW
R
R

error
R
RW
R
R
R
R
RW
RW
RW
RW
RW
R
R
RW
RW
RW
R
RW
R
R

init
R
RW
R
R
R
R
RW
RW
RW
RW
RW
R
R
RW
RW
RW
R

fini
R
RW
R
R
R
R
RW
RW
RW
RW
RW
R
R
RW
RW
RW
R

R
R

R
R

RW
R
R
R

RW
R
R
R

RW
RW
RW
RW

RW
W
RW
RW
RW
RW
RW
RW
RW
RW
RW
RW
RW
R
R
RW
RW

RW
RW
RW

R
R
RW
RW
RW
R

RW
R
R
R

RW
R
R
R

RW
R
R
R

RW
R
R
R

RW
R
R
R

RW
R
R
R

R

RW
R
R
R

R
RW
RW
RW
RW
RW
R
R
R

RW
RW
RW
RW
R

RW
R
R
R

説明
クライアントのIPアドレス
クライアントの識別子client directorで使うサーバのIPアドレス
サーバのホスト名
サーバの識別子（起動オプション-iで指定）サーバのLISTENポート
リクエストメソッド
リクエストURL
HTTPプロトコルバージョン
HTTPヘッダ
このリクエストを処理するバックエンドを指定
このリクエストを処理するときに何回restartしたか
ESI処理時の階層
有効期間を上書きする
猶予時間を上書きする
保持時間を上書きする
リクエストのユニークなID
ESI機能の有効・無効化
クライアントがgzip転送を許可しているか
現在選択されているバックエンドが正常かどうか
キャッシュ検索しているビジーなオブジェクトを無視するか
強制的にこのリクエストをキャッシュミスにするかどうか
リクエストメソッド
リクエストURL
HTTPプロトコルバージョン
HTTPヘッダ
バックエンドに接続する際のタイムアウト時間
バックエンドから最初のバイトが転送される際のタイムアウト時間
通信中に一時的に受信が待ったときのタイムアウト時間
HTTPプロトコルバージョン
セイントモードを有効にするか
HTTPステータスコード
HTTPステータスコード文字列
HTTPヘッダ
ESI処理を行うか
ストリームを有効にするか
gzip圧縮するか
gzip解凍するか
オブジェクトの有効期間
オブジェクトの追加の猶予時間
オブジェクトの追加の保持時間使用したバックエンドの名前使用したバックエンドのIPアドレス
使用したバックエンドのポート
キャッシュを格納するストレージの名前を指定
HTTPプロトコルバージョン
HTTPステータスコード
HTTPステータスコード文字列
オブジェクトをレスポンスした回数、0はキャッシュミスを表す
HTTPヘッダ
オブジェクトの有効期間
オブジェクトの追加の猶予時間
オブジェクトの追加の保持時間
オブジェクトが最後に使われてからの秒数
HTTPプロトコルバージョン
HTTPステータスコード
HTTPステータスコード文字列
HTTPヘッダ
現在時間(epoch)
指定ストレージの空き容量指定ストレージの使用容量
おそらく正常かどうかだと思うが不明

灰色部の init/fini において、各変数は定義上利用可能でしたが、確認した限り、指定すると Varnish がクラッシュしました。
必ず確認してから使って下さい。
61

起動パラメータ一覧
パラメータ名acceptor_sleep_decay
acceptor_sleep_incr
acceptor_sleep_max
auto_restart
ban_dups
ban_lurker_sleep
between_bytes_timeout
cc_command
cli_buffer
cli_timeout
clock_skew
connect_timeout
critbit_cooloff
default_grace
default_keep
default_ttl
diag_bitmap
esi_syntax
expiry_sleep
fetch_chunksize
fetch_maxchunksize
first_byte_timeout
group
gzip_levelgzip_stack_buffer
gzip_tmp_space
http_gzip_support
http_max_hdr
http_range_support
http_req_hdr_len
http_req_size
http_resp_hdr_len
http_resp_size
listen_address
listen_depth
log_hashstring
log_local_address
lru_interval
max_esi_depth
max_restarts
ping_interval
pipe_timeout
prefer_ipv6
saintmode_threshold
send_timeout
sess_timeout
sess_workspacesession_linger
session_max
shm_reclen
shm_workspace
shortlived
syslog_cli_trafficuser
vcc_err_unref
vcl_dir
vcl_trace
vmod_dirwaiter

62

型
DOUBLE
時間(小数あり)時間(小数あり)
BOOL値
BOOL値
時間(小数あり)時間(小数あり)
文字列
数値
時間(整数)
数値
時間(小数あり)時間(小数あり)時間(小数あり)時間(小数あり)時間(小数あり)
BITMAP
BITMAP
時間(小数あり)数値
数値
時間(小数あり)
グループ名
数値
数値
数値
BOOL値
数値
BOOL値
数値
数値
数値
数値
アドレス
数値
BOOL値
BOOL値
時間(整数)
数値
数値
数値
時間(整数)
BOOL値
数値
時間(整数)
時間(整数)
数値
数値
数値
数値
数値
時間(小数あり)
BOOL値
ユーザ名
BOOL値
文字列
BOOL値
文字列
WAITER

最小値
0
0
0
0
0
4096
0
0
0
60
0
0
0
0
4
64
0
0
2048
0
32
40
256
40
256
0
0
0
0
0
0
0
0
0
1024
0
1000
16
4096
0
-

最大値
1
1
10
UINT_MAXUINT_MAXUINT_MAX0
UINT_MAXUINT_MAX254
UINT_MAXUINT_MAXUINT_MAX60
UINT_MAX / 1024
UINT_MAX / 1024
UINT_MAX
9
UINT_MAX2
UINT_MAXUINT_MAXUINT_MAXUINT_MAXUINT_MAXUINT_MAX0
UINT_MAXUINT_MAXUINT_MAX0
UINT_MAX
00
UINT_MAXUINT_MAXUINT_MAX
65535
UINT_MAXUINT_MAX-

デフォルト値
0.9
0.001
0.05
on
on
0.01
60
VCC_CC
8192
10
10
0.7
180
10
0
120
0
0
1
128
26214460
MAGIC_INIT_STRING
6
32768
0
on
64
on
2048
32768
2048
32768
:80
1024
on
off
2
5
4
3
60
off
10
60
5
65536
50
100000
255
8192
10
on
MAGIC_INIT_STRINGon
VARNISH_VCL_DIR
off
VARNISH_VMOD_DIR
default

属性
実験的
実験的
実験的

開発向け

実験的
実験的

実験的
実験的
実験的
実験的

実験的

実験的

実験的

実験的

適用タイミング

要リロード

遅延適用
遅延適用

要再起動

要再起動
要再起動

要再起動

遅延適用
遅延適用

遅延適用

要再起動

要再起動

単位 説明
- アクセプターが成功するたびに受け入れを行うための待機秒数を乗数的に減らす時の乗数
秒 アクセプターがリソースを使い果たした際に再試行する際の待機秒数
秒 アクセプターがリソースを使い果たした際の最大待機秒数- 子プロセス死亡時に自動再起動を行うか- 重複しているbanを排除
秒 banリストが追加された際にban lurkerスレッドが待機する秒数
秒 通信中に一時的に受信が待ったときのタイムアウト時間- VCLをコンパイルする際に利用するコマンドライン
バイト CLIで入力時のバッファサイズ
秒 CLIで親プロセスから子プロセスにリクエストする際のタイムアウト秒
秒 バックエンドとVarnishでのクロックのずれの許容秒
秒 バックエンドに接続する際のデフォルトの接続タイムアウト秒
秒 critbitが削除されたオブジェクトのヘッダをガベージするまでにcooloffリストで保持する時間秒 デフォルトのgrace時間を適用
秒 デフォルトのkeep時間を適用
秒 デフォルトのTTLを指定 既にキャッシュされているオブジェクトには影響しない- 診断を行う際のオプション- ESIのパースを行う際のチェックオプション
秒 スレッドをスリープするまでの待機秒数
キロバイト フェッチで利用するチャンクサイズ
キロバイト ストレージから割り当てる最大チャンクサイズ
秒 バックエンドから最初のバイトを受け取るまでのタイムアウト秒数- 子プロセスのグループ名を設定- gzipの圧縮率(0=debug,1=高速～9=高圧縮)
バイト gzipに利用するスタックバッファサイズ- gzip/gunzipで利用する一時領域指定- gzipをサポート
ヘッダ行数 クライアントのリクエストとバックエンドのレスポンスの最大ヘッダ行数- Rangeヘッダを有効にする
バイト クライアントのHTTPリクエストヘッダの最大バイト数
バイト クライアントのHTTPリクエストの最大バイト数
バイト バックエンドのHTTPレスポンスヘッダの最大バイト数
バイト バックエンドのHTTPレスポンスの最大バイト数- Listenアドレス
コネクション数 Listenキュー数- ログにハッシュコンポーネントを出力する- ローカルアドレスのSessionOpenをログに記録する
秒 LRUリストを移動する際間隔
ネスト数 esi:includeの最大ネスト数
restarts 1リクエストあたりの最大リスタート数
秒 親プロセスから子プロセスへのping間隔(0は無効化)
秒 Pipeのアイドル状態のセッションタイムアウト時間- IPv4/v6両方を持っているバックエンドに接続する際にIPv6を利用
objects Saintmodeに入る際の閾値(0は無効化)
秒 クライアント接続の送信タイムアウト時間秒 永続的セッションのタイムアウト値
バイト HTTPプロトコルのワークスペースサイズ
ミリ秒 ワーカースレッドが次のリクエストを取得しに行くまでの待機時間
セッション数 セッション最大数
バイト 共有メモリのログレコードの最大バイト数
バイト ワーカースレッドに割り当てる共有メモリワークスペースサイズ
秒 指定TTL以下のオブジェクトを一時的なストレージに格納します- syslogのCLIの実行ログを記録(LOG_INFO)- 子プロセスのユーザ名を指定- VCLコンパイル時の未使用定義エラーを出力- VCLディレクトリを指定- VCLのトレースログを出力- VMODディレクトリを指定- イベント待ちのカーネルインタフェースを設定

63

あとがき
初めましてな方ははじめまして！いわなましまろのいわなちゃんです。
もともと、勉強会やブログなどで Varnish の情報を発信していたのですが、自分の頭の整理を兼ねて Varnish の本を出してみたいなぁと思い書いてみました。
のんびり書いていたら Varnish3 のリリースがあったり、仕事が忙しくなったり、コミケに落ちて油断していたら委託していただけるということで慌てたり、ソース
コードを読みながら検証していたら時間が足りなくなったり様々なことがありました。
他にもいろいろ書きたかったこと、サラッと流したけどもっと詳しく書きたかったこといろいろありますが時間の許す限り詰め込みました。あなたが Varnish を今使っている、使っていないにかかわらず参考になれば幸いです。
それでは機会があればまた！

奥付

Varnish Cache 入門
ーー発行日ーー

2011－08－13（Rev.1）, 2011－09－12（Rev.2）
2011－09－13（Rev.2.1）, 2012－06－01（Rev.3）

ーー印刷ーー
サンライズ様ーー発行ーー
いわなましまろーー発行人ーー
いわなちゃん(@xcir)ーー連絡先ーー
http://xcir.net/
ーースペシャルサンクス(敬称略)ーー
校正を手伝って下りました@ishikawa84g@saeoshi@tmae@W53SA
そして
Varnish Software6465