キャッシュは4箇所にある — Cache-ControlとCDN

Cache-ControlとCDN。ブラウザと中継サーバー、データを保存した箱と配信の矢印。

キャッシュは1か所ではなく4か所にあります。どこで効かせるのかを決めてから、Cache-ControlとCDNを設定します。

前回: 自分のページをCSPで壊す — Webの防御ヘッダ 作業場所はVMの中(Ubuntu)です。ここまでで作った ~/server(API)と ~/react-demo(フロント)、そして nginx をそのまま使います。確認はホストの Windows のブラウザです。

パフォーマンスの回を、こう締めました。

キャッシュは最後の手段。 回数を減らす → 1回を速くする → 返す量を減らす → それでも駄目なら。

今回が、その「それでも駄目なら」です。

ただし、いきなり道具の話に入ると、また同じところで転びます。Redis の回で一度転んでいます。更新したのに古い値が返る、という事故です。

今回は、その事故がもっと嫌な形で出ます。Redis なら DEL で消せました。でもブラウザに入ったキャッシュは、こちらから消せません。

だからこの記事は「キャッシュの入れ方」ではなく、「どこに何秒置いていいか」を決める記事です。

対象レベル: 中級 / 区分: 必修

目次

この記事でわかること

  • キャッシュは4箇所にあること。Redis で作ったのは、そのうち一番奥の1つだけだったこと
  • 手前にあるキャッシュほど速く、手前にあるキャッシュほど消せないこと。これが全部の理由になっていること
  • ハッシュ付きのファイルは1年、HTMLはキャッシュしないという定石が、なぜその組み合わせでないと成立しないのか
  • ETag は「速くするため」ではなく「変わっていないことを確かめるため」の仕組みで、304 は中身が空だということ
  • 間違ったキャッシュは、遅いより悪いこと。遅いは待てば直るが、古い情報は待っても直らないこと
  • CDN は個人サイトに必須ではないこと。無料枠はあるが、要るかどうかは別だということ

この記事でやること

  1. キャッシュが効いていない状態を先に見る。 dist/ を nginx で配って、開発者ツールの Network で確認する
  2. Cache-Control を nginx で自分で付けて、from disk cache が出るところまで持っていく(ここが山場)
  3. curl で ETag を使って、304 Not Modified が返る様子を見る
  4. proxy_cache を効かせて、アプリのログにリクエストが届かなくなるのを確認する
  5. わざと事故を起こす。 HTML に1年のキャッシュを付けて、更新が反映されなくなるところまでやって、戻す

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
Cache-ControlHTTPの応答ヘッダ。「このファイルを何秒、どこに置いていいか」をサーバーが指示するもの。この記事の主役
max-ageCache-Control の中身。何秒間そのまま使っていいか。 max-age=3600 なら1時間
no-store絶対に保存するな。 ディスクにもメモリにも残さない
no-cache保存はしていい。ただし使う前に毎回サーバーに確認しろ。 「キャッシュするな」ではありません
条件付きリクエスト「前に取ったやつから変わってたら下さい」という聞き方。 変わっていなければ中身は送られてこない
ETagそのファイルの中身に対して付く目印(指紋のようなもの)。中身が変われば変わる
Last-Modifiedそのファイルが最後に更新された日時。 ETag より雑だが軽い
304 Not Modified「変わってないよ」という返事。中身は入っていない(ヘッダだけ)。だから速い
immutable「このURLの中身は絶対に変わらない」という宣言。 確認すら要らなくなる
オリジン本物のファイルが置いてある、自分のサーバー。 キャッシュの元
エッジ読者の近くに置かれた、コピーを持つサーバー。 CDN の実体
CDNContent Delivery Network。世界中のエッジにコピーを配って、近い場所から返す仕組み
パージCDN に置かれたコピーを、こちらから消させること

no-cache は「キャッシュするな」ではありません。 ここは本当によく間違えます。 保存するなは no-store、保存はするけど毎回確認しろが no-cache です。名前が完全に逆です。


キャッシュは4箇所ある — 先に地図を描く

Redis を入れたとき、「キャッシュを入れた」と言いました。あれは正確ではありませんでした。

正しくは、4箇所あるうちの一番奥に、1つ入れたです。リクエストが流れる順に並べると、こうなります。

[ブラウザ] → [CDN] → [nginx(リバースプロキシ)] → [アプリ] → [Redis] → [MySQL]
     ①          ②              ③                          ④
#場所誰の持ち物かこちらから消せるかどこでやったか
①ブラウザ読者のPCの中❌ 消せないこの記事(Cache-Control)
②CDN事業者のエッジ△ パージを頼めば消える(時間差あり)この記事(説明だけ)
③リバースプロキシ(nginx)自分のサーバー⭕ ファイルを消すだけこの記事(proxy_cache)
④アプリ(Redis)自分のサーバー⭕ DEL 一発Redis の回

この表から、この記事で一番大事な一文が出ます。

手前にあるキャッシュほど速く、手前にあるキャッシュほど消せません。

理由は単純です。①のブラウザキャッシュは、そもそも通信が起きません。 サーバーの出番が無いので最速です。そして、サーバーの出番が無いということは、こちらから何を言っても届かないということでもあります。

この記事の後半で「消すのが一番難しい」に戻ってくるのは、この構造のためです。

なぜ4つに分けて考える必要があるのか

「遅い」の原因が、どの層にあるかで打ち手が全然違うからです。

症状どの層の話か
2回目の表示も、画像を全部取り直している① ブラウザに「置いていい」と言っていない
海外からのアクセスだけ遅い② 物理的な距離。CDN の出番
同じページなのに毎回アプリが動いている③ リバースプロキシで止められる
同じ集計SQLが何度も飛んでいる④ Redis の回でやったところ

この記事で新しくやるのは ① と ③ です。 ② は説明だけ、④ は済んでいます。


① まず、キャッシュが効いていない状態を見る

パフォーマンスの回と同じ型です。入れる前を先に見ます。

dist/ を nginx で配る

VMの中で、フロントをビルドします。

bash
$ cd ~/react-demo
$ npm run build
$ ls -la dist/assets/

出力はこうなります。

index-C2u9Kx1p.js
index-a83Bf0Qd.css

ファイル名の後ろに付いている C2u9Kx1p が、この記事の後半の主役です。ビルドツールの回で「キャッシュ対策という明確な仕事をしている」と書いたものです。何の仕事なのかを、今回はっきりさせます。

nginx の回でやったとおり、/var/www/html/ に置きます。先に元のファイルを退避します。

bash
$ sudo cp -r /var/www/html /var/www/html.bak
$ sudo rm -rf /var/www/html/*
$ sudo cp -r ~/react-demo/dist/* /var/www/html/
$ ls -la /var/www/html/

戻したくなったら、これで戻ります。

bash
$ sudo rm -rf /var/www/html
$ sudo mv /var/www/html.bak /var/www/html

何が返ってきているかをヘッダで見る

ブラウザを開く前に、curl で応答ヘッダだけ見ます。 -I はヘッダだけ取るオプションです。

bash
$ curl -I http://localhost/assets/index-C2u9Kx1p.js

ファイル名は、自分の ls で出た名前に読み替えてください。 返ってくるのはこうです。

HTTP/1.1 200 OK
Server: nginx/1.24.0
Date: Tue, 09 Sep 2026 02:11:30 GMT
Content-Type: application/javascript
Content-Length: 143829
Last-Modified: Tue, 09 Sep 2026 02:09:12 GMT
ETag: "68bf1a48-231d5"
Accept-Ranges: bytes

ここで確認することが1つあります。

Cache-Control がありません。

nginx は、何も設定しなければ Cache-Control を付けません。 一方で、Last-Modified と ETag は勝手に付けてくれています。 これは後で効いてきます。

ブラウザで見る

ホストの Windows のブラウザで http://VMのIP/ を開きます(IPは VM の中で ip a で確認できます)。

F12 で開発者ツールを開き、Network タブを出します。開発者ツールの回でやったところです。

この記事の間だけ、Disable cache のチェックは外してください。 パフォーマンスの回では「必ず入れる」と書きましたが、今回はキャッシュそのものを観察するので、入れると何も起きません。

F5 で再読み込みして、Size 列を見ます。

[スクリーンショット: 01_キャッシュなし.png] 開発者ツールの Network タブで、Disable cache のチェックを外した状態で再読み込みし、Size 列に 143 kB のようなバイト数が並んでいるところを撮ってください。

Size 列の表示意味
143 kB のような数字本当に通信して取ってきた
(disk cache)通信していない。 ブラウザの中から出した
304 + 小さい数字サーバーに聞いたが「変わってない」と言われた

今は数字が並んでいるはずです。 つまり、2回目も律儀に全部取り直しています。


② Cache-Control を自分で付ける()

ここがこの記事の山場です。 ヘッダを1つ足すだけで、Size 列の表示が変わります。

nginx に1行足す

設定を触る前に、必ずバックアップを取ります。

bash
$ sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/default.bak
$ sudo nano /etc/nginx/sites-available/default

server { ... } の中に、location ブロックを1つ足します。

server {
    listen 80 default_server;
    listen [::]:80 default_server;

    root /var/www/html;
    index index.html;
    server_name _;

    # ハッシュ付きのファイルだけ、1年キャッシュしていいと伝える
    location /assets/ {
        add_header Cache-Control "public, max-age=31536000, immutable";
    }

    location / {
        try_files $uri $uri/ =404;
    }
}

31536000 は秒数です。 60 × 60 × 24 × 365 で1年です。

保存したら、必ずこの順番で確認します。 nginx の回でやった型です。

bash
$ sudo nginx -t
$ sudo systemctl reload nginx

nginx -t が syntax is ok と test is successful の2行を返してから reload してください。 逆にすると、設定が壊れたまま反映されます。

効いているか、まずヘッダで確かめる

bash
$ curl -I http://localhost/assets/index-C2u9Kx1p.js
HTTP/1.1 200 OK
Content-Type: application/javascript
Content-Length: 143829
Last-Modified: Tue, 09 Sep 2026 02:09:12 GMT
ETag: "68bf1a48-231d5"
Cache-Control: public, max-age=31536000, immutable

Cache-Control の行が増えました。 ここまでは「サーバーがそう言っている」だけです。

ブラウザが本当に言うことを聞いたか

ホストのブラウザに戻って、F5 で再読み込みします。

Size 列が (disk cache) に変わります。

[スクリーンショット: 02_disk-cache.png] Cache-Control を付けたあと再読み込みし、/assets/ のファイルの Size 列が (disk cache) または (memory cache) になっているところを撮ってください。

(memory cache) と出ることもあります。どちらでも成功です。 メモリ=そのタブを閉じるまで、ディスク=ブラウザを閉じても残る、という違いです。どちらも通信していない点は同じです。

そして、ここが一番見てほしいところです。

Time 列が 0 ms になります。 サーバーは何もしていません。ネットワークが1ミリ秒も動いていないからです。

これが①のブラウザキャッシュです。 4箇所のうち、一番速いのは間違いなくここです。

add_header の落とし穴を先に潰す

nginx の add_header には、初見で必ず踏む罠があります。

location の中に add_header を1つでも書くと、その location は上の階層の add_header を全部引き継がなくなります。

足し算ではなく上書きです。たとえばこう書くと、

server {
    add_header X-Frame-Options "SAMEORIGIN";   # サイト全体に付けたつもり

    location /assets/ {
        add_header Cache-Control "public, max-age=31536000, immutable";
    }
}

/assets/ のファイルにだけ X-Frame-Options が付きません。 気づきにくいうえ、消えるのがセキュリティ関係のヘッダだったりします。

確認方法は curl -I です。 付けたつもりのヘッダが本当に出ているか、パスごとに見てください。

expires 1y; という短い書き方もあります。 こちらは Cache-Control: max-age=31536000 と Expires を両方付けてくれます。 ただし immutable は付けられません。この記事では add_header に一本化して、ヘッダが二重に出ないようにしています。


③ 何を長くして、何をキャッシュしないか

ここが判断の話です。道具より、こちらのほうが大事です。

結論を先に書きます。これが定石です。

対象設定秒数
/assets/index-C2u9Kx1p.js のような、名前にハッシュが入ったファイルpublic, max-age=31536000, immutable1年
index.htmlno-cache毎回確認
ロゴなど、名前が変わらない画像public, max-age=36001時間程度
ログイン後のAPI応答no-store保存させない

そして、この組み合わせでないと成立しません。 順に理由を書きます。

なぜハッシュ付きファイルは1年でいいのか

ビルドツールの回の回収です。

ビルドすると index-C2u9Kx1p.js という名前になります。このハッシュは、中身から計算されています。

中身が1文字でも変われば、ファイル名が変わります。

つまり、index-C2u9Kx1p.js という URL の中身は、未来永劫変わりません。 変わったものは index-9fA2Tk4m.js という別のURLになるからです。

中身が変わらないと確定しているものは、いくら長くキャッシュしても事故りません。 だから1年です。immutable は「変わらないので確認すら不要」という、さらに強い宣言です。

「ハッシュ付きファイル名」と「1年キャッシュ」は、セットで初めて意味を持ちます。 片方だけやると壊れます。 ハッシュを付けずに1年キャッシュしたら、更新が1年届きません。

なぜ index.html はキャッシュしてはいけないのか

index.html の中に、そのハッシュ付きファイル名が書いてあるからです。

<script type="module" src="/assets/index-C2u9Kx1p.js"></script>

新しいファイル名を読者に伝える役目を持っているのが index.html だけです。ここがキャッシュされると、

読者は古い index.html を見続け、そこに書いてある古いJSを、1年キャッシュから出して使い続けます。

新しいファイルは、置いてあるのに誰も取りに来ません。 デプロイしたのに何も変わらない、という一番嫌な形で出ます。

index.html に no-cache を付けます。

    location = / {
        add_header Cache-Control "no-cache";
    }

    location = /index.html {
        add_header Cache-Control "no-cache";
    }

no-cache は「保存するな」ではなく「使う前に毎回確認しろ」でした。 index.html は数KBしかありません。 毎回確認しても、変わっていなければ 304 が返るだけなので、ほとんど費用はかかりません。次の節の話です。

なぜログイン後のAPIは no-store なのか

キャッシュは、誰のものか区別しません。

/api/tasks が「自分のタスク一覧」を返すとして、これがどこかにキャッシュされると、次に来た別の人に、自分のタスクが出ます。

  • ブラウザのキャッシュなら、共用PCで次に使った人に見えます
  • CDN やリバースプロキシなら、まったく無関係な他人に見えます

セキュリティの回で扱った「被害を小さくする」の、一番わかりやすい適用先です。

Cache-Control: no-store

判断の基準は1つです。

「これが、別の人に返っても平気か」 平気ならキャッシュしていい。まずければ no-store。


④ ETag と Last-Modified — 変わっていないことを確かめる

no-cache にしたものは「毎回確認」でした。その確認のやり方です。

nginx は、静的ファイルに ETag と Last-Modified を勝手に付けています。

Last-Modified: Tue, 09 Sep 2026 02:09:12 GMT
ETag: "68bf1a48-231d5"

ブラウザは、2回目のリクエストでこれを送り返します。

ブラウザが送るヘッダ対になるもの意味
If-None-MatchETag「この目印と違ってたら下さい」
If-Modified-SinceLast-Modified「この時刻より新しかったら下さい」

手で再現できます。 まず ETag を取ります。

bash
$ curl -I http://localhost/index.html
HTTP/1.1 200 OK
Content-Length: 461
Last-Modified: Tue, 09 Sep 2026 02:09:12 GMT
ETag: "68bf1a48-1cd"

その ETag を、そのまま付けてもう一度聞きます。

bash
$ curl -I -H 'If-None-Match: "68bf1a48-1cd"' http://localhost/index.html
HTTP/1.1 304 Not Modified
Last-Modified: Tue, 09 Sep 2026 02:09:12 GMT
ETag: "68bf1a48-1cd"

304 Not Modified が返りました。そして、ここが本題です。

Content-Length がありません。中身が1バイトも入っていません。

461バイトのファイルなら大した差ではありませんが、これが 500KB のファイルなら、往復のヘッダだけで済みます。

304 は「速い」ではなく「軽い」

ここを勘違いすると、キャッシュ設計を間違えます。

通信転送量
(disk cache)(max-age が生きている)起きないゼロ
304(no-cache で確認した)起きるほぼゼロ

304 でも、往復1回はかかります。 遠くのサーバーなら、それだけで100ミリ秒かかることもあります。

一番速いのは 304 ではなく、そもそも聞かないこと(max-age)です。 だからハッシュ付きファイルは immutable を付けて、304 すら起こさせません。

ブラウザで 304 を見る

ホストのブラウザで F5 を押して、index.html の行の Status 列を見てください。

[スクリーンショット: 03_304.png] Network タブで、index.html(または /)の Status 列が 304 になっていて、Size 列が (disk cache) ではなく小さい数字になっているところを撮ってください。

ETag と Last-Modified はどちらか片方で足ります。 両方あれば ETag が優先されます。 Last-Modified は「1秒未満の更新を見分けられない」という弱点があります。中身から作る ETag のほうが正確です。


⑤ nginx のリバースプロキシキャッシュ(③の層)

ここまでは静的ファイルの話でした。次はアプリの手前です。

リバースプロキシの回で、app.local → 127.0.0.1:3000 に渡す設定を作りました。あそこに、キャッシュを1枚挟みます。

確かめられるエンドポイントを用意する

キャッシュが効いたことを目で見るために、「呼ばれるたびに違う値を返して、ログを出す」ものを足します。 ~/server/app.js に足してください。

app.get("/api/now", (req, res) => {
  const now = new Date().toISOString();
  console.log("★ APIに届いた:", now);
  res.json({ now });
});

ログインが要らない場所に置いてください。 理由は後で書きます。

アプリを再起動して、素の状態を確認します。

bash
$ cd ~/server
$ node app.js

別のターミナルから、2回叩きます。

bash
$ curl -s -H "Host: app.local" http://localhost/api/now
$ curl -s -H "Host: app.local" http://localhost/api/now
{"now":"2026-09-09T03:12:44.108Z"}
{"now":"2026-09-09T03:12:45.512Z"}

値が違います。 そしてアプリ側のターミナルに ★ APIに届いた が2回出ます。 これが今の状態です。

-H "Host: app.local" を付けているのは、hosts ファイルを触らずに済ませるためです。 nginx は Host: ヘッダを見てどの server ブロックを使うか決めます(リバースプロキシの回でやったところ)。手で名乗れば、それで通ります。

proxy_cache_path は server の中に書けない

ここが一番よく詰まるところです。

キャッシュの置き場所を宣言する proxy_cache_path は、http ブロックに書く決まりです。server { } の中に書くと、nginx -t がこう言って止まります。

nginx: [emerg] "proxy_cache_path" directive is not allowed here

conf.d に別ファイルとして置くのが一番安全です。

bash
$ sudo nano /etc/nginx/conf.d/proxy-cache.conf
proxy_cache_path /var/cache/nginx/appcache
                 levels=1:2
                 keys_zone=appcache:10m
                 max_size=100m
                 inactive=10m;
書いたもの意味
/var/cache/nginx/appcacheキャッシュを実際に置くディレクトリ
levels=1:2中でフォルダを分ける深さ。1つの階層に何万ファイルも置かないため
keys_zone=appcache:10mappcache という名前を付ける。 10m はキーの索引に使うメモリ(中身ではない)
max_size=100mディスクを最大100MBまで使う。 超えたら古いものから捨てる
inactive=10m10分間1度も使われなかったら捨てる

max_size を書かないと、上限なしでディスクを食い続けます。 Redis の回の「TTL を付け忘れるとメモリを食い潰す」と、まったく同じ話です。キャッシュには必ず上限を書きます。

使う側を書く

bash
$ sudo cp /etc/nginx/sites-available/app /etc/nginx/sites-available/app.bak
$ sudo nano /etc/nginx/sites-available/app
server {
    listen 80;
    server_name app.local;

    location / {
        proxy_cache appcache;
        proxy_cache_valid 200 30s;
        add_header X-Cache-Status $upstream_cache_status;

        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
行意味
proxy_cache appcacheさっき名前を付けた置き場を使う
proxy_cache_valid 200 30s200 が返ってきたら30秒間保存する
add_header X-Cache-Status ...効いたかどうかを見るための、自分用の目印
bash
$ sudo nginx -t
$ sudo systemctl reload nginx

アプリに届かなくなるのを見る

アプリのターミナルを見えるようにしたまま、3回叩きます。

bash
$ curl -si -H "Host: app.local" http://localhost/api/now | grep -E "X-Cache-Status|now"
$ curl -si -H "Host: app.local" http://localhost/api/now | grep -E "X-Cache-Status|now"
$ curl -si -H "Host: app.local" http://localhost/api/now | grep -E "X-Cache-Status|now"
X-Cache-Status: MISS
{"now":"2026-09-09T03:20:01.774Z"}
X-Cache-Status: HIT
{"now":"2026-09-09T03:20:01.774Z"}
X-Cache-Status: HIT
{"now":"2026-09-09T03:20:01.774Z"}

2回目以降、now の値が同じになりました。 そして、

アプリのターミナルに ★ APIに届いた は、1回しか出ていません。

[スクリーンショット: 04_proxy-cache.png] 左に node app.js のターミナル、右に curl を3回打ったターミナルを並べて、★ APIに届いた が1回しか出ていないのに、curl は3回とも応答をもらっているところを撮ってください。

これが③の層です。 アプリはもちろん、その奥の Redis も MySQL も、一切動いていません。

30秒待つと EXPIRED を経て MISS に戻ります。 proxy_cache_valid 200 30s; と書いたからです。

効かないときに見るところ

X-Cache-Status が MISS のままなら、次の順に疑います。

X-Cache-Status意味
MISS無かったので取りに行った(1回目は正常)
HITキャッシュから返した(成功)
EXPIRED期限切れだったので取り直した
BYPASSキャッシュを使わない設定に当たった
(ヘッダ自体が出ない)proxy_cache を書いた location を通っていない

そして、初見で必ず踏むのがこれです。

nginx は、Set-Cookie が付いた応答をキャッシュしません。

安全側に倒した、正しい既定です。 ログイン後のページをキャッシュして他人に返したら大事故だからです。さっき「ログインが要らない場所に置いてください」と書いたのは、これが理由です。

同じく、アプリが Cache-Control: no-store や private を返していると、nginx はキャッシュしません。 proxy_ignore_headers で無視させることもできますが、アプリが「するな」と言っているものを無視する設定なので、意味が分かるまで使わないでください。


⑥ 一番難しいのは、やっぱり消すこと

Redis の回と同じ結論に、別の道から戻ってきます。

4箇所を、「消せるか」だけで並べ直します。

場所消し方難易度
④ RedisDEL キー名簡単
③ nginxsudo rm -rf /var/cache/nginx/appcache/* して reload簡単
② CDN管理画面かAPIでパージを頼む。 反映に時間差がある面倒
① ブラウザ❌ 手段が無い不可能

③ は本当に消せる

やってみてください。

bash
$ sudo rm -rf /var/cache/nginx/appcache/*
$ sudo systemctl reload nginx
$ curl -si -H "Host: app.local" http://localhost/api/now | grep X-Cache-Status
X-Cache-Status: MISS

MISS に戻りました。ただのファイルなので、消せば消えます。

proxy_cache_purge(特定のURLだけ消す機能)は、無償版の nginx には入っていません。 商用版か、別のモジュールが要ります。 個人で使う分には「全部消して reload」で十分です。

① は、どうやっても消せない

読者のPCの中にあるものを、こちらから消す手段はありません。

  • 「キャッシュを消してください」とお願いする → 読者はやりません
  • 期限が切れるのを待つ → max-age=31536000 と言った以上、1年待ちます

打てる手は、1つだけです。

消せないなら、そのURLをもう使わない。 別のURLを新しく作って、そっちを見に行かせる。

これが、ハッシュ付きファイル名の正体です。

index-C2u9Kx1p.js   ← 古いほう。読者のブラウザに1年残っていて構わない
index-9fA2Tk4m.js   ← 新しいほう。名前が違うので、キャッシュに存在しない = 必ず取りに来る

古いキャッシュを「消して」いません。「置き去りにして」います。

ビルドツールの回で「ハッシュはキャッシュ対策」と書いた仕事の中身が、これです。 消せない場所に対する、唯一の現実的な答えが「URLを変えること」でした。

この考え方は、ファイル名以外にも出てきます。 CDN の世界では キャッシュバスティング と呼ばれ、?v=2 のようなクエリを付ける形でも使われます。やっていることは同じで、URLを別物にしているだけです。


⑦ CDN とは何か(契約はしません)

②の層です。ここは説明だけにします。手を動かしません。

理由を正直に書きます。

  • 本番のドメインのDNSを預ける操作になります。この学習用VMでは再現できません
  • 無料枠はありますが、設定を間違えたときに直る先が「本番サイト」になります
  • 今の段階で、要りません(これも後で書きます)

仕組みは、③をもっと遠くに置いただけ

やっていることは、さっきの proxy_cache とほぼ同じです。

【CDN なし】
 東京の読者 ──────────────────► 東京のサーバー(オリジン)
 ロンドンの読者 ───────────────────────────────► 東京のサーバー
              地球半周ぶん、毎回

【CDN あり】
 東京の読者 ──► 東京のエッジ ──┐
 ロンドンの読者 ──► ロンドンのエッジ ──┼──► 東京のサーバー(オリジン)
                                  初回だけ

CDN は「読者の近くに置かれた、コピーを持つリバースプロキシ」です。 それ以上でも以下でもありません。

そして、ここが大事です。

CDN が何を何秒キャッシュするかを決めているのは、Cache-Control です。 ②の設定を、この記事でやった②のヘッダで動かしています。

②を使う準備は、実は①の作業でもう済んでいます。 これが、キャッシュを4箇所の地図で捉える一番のご利益です。同じヘッダが、複数の層に効きます。

逆に、CDN でしか解けない問題

問題proxy_cache で解けるか
アプリの処理が重い⭕ 解ける
物理的な距離(海外から遅い)❌ 解けない。光の速さは変えられない
アクセスが集中して回線が埋まる❌ 解けない。自分の回線が1本しかない
大量アクセスによる攻撃❌ 解けない。手前で吸ってもらう必要がある

「距離」と「量」は、自分のサーバーの中では解けません。 そこが CDN の本当の出番です。

無料枠と、個人サイトに要るかどうか

主要な CDN には無料枠があります。

サービス個人利用
Cloudflare無料プランあり。 個人サイトで最もよく使われる
AWS CloudFront無料利用枠あり(期間・量に制限)。クラウド料金の回の話が直撃するので、先に上限を作ること

では、要るのか。正直に書きます。

月に数千アクセスの個人サイトには、要りません。

理由です。

  • 距離の問題が起きていない。 読者がほぼ国内なら、CDN が縮められる時間はごくわずかです
  • 量の問題も起きていない。 1台のサーバーで余裕でさばけます
  • 層が1つ増えます。 「反映されない」の原因が、自分のサーバーか CDN かエッジか読者のブラウザかに増えます

パフォーマンスの回の型が、そのまま当てはまります。

測って、距離か量が本当にボトルネックになってから入れる。

逆に「入れたほうがいい」とはっきり言えるのは、こういうときです。

  • 読者に海外が明確に含まれている
  • 画像や動画が主で、転送量が回線を圧迫している
  • 攻撃や急なアクセス集中を、自分のサーバーの手前で受け止めたい

⑧ わざと事故を起こす — 間違ったキャッシュは、遅いより悪い

最後に、一番大事な体験をします。 Redis の回と同じで、事故は自分で起こしたほうが早く覚えます。

index.html に1年を付けてしまう

さっき「やってはいけない」と書いたことを、わざとやります。

bash
$ sudo nano /etc/nginx/sites-available/default

location /assets/ を、わざと全体に広げます。

    # ⚠️ わざと間違えています。あとで必ず戻します
    location / {
        add_header Cache-Control "public, max-age=31536000, immutable";
        try_files $uri $uri/ =404;
    }
bash
$ sudo nginx -t
$ sudo systemctl reload nginx

ホストのブラウザで一度開いてください。 そのあと、中身を書き換えます。

bash
$ cd ~/react-demo

index.html の <title> でも、画面に出る文字でも構いません。目で分かる変更を1つ入れて、ビルドして置き直します。

bash
$ npm run build
$ sudo rm -rf /var/www/html/*
$ sudo cp -r ~/react-demo/dist/* /var/www/html/

サーバーの上のファイルは、確実に新しくなっています。

bash
$ grep -o "index-[A-Za-z0-9_-]*\.js" /var/www/html/index.html

ブラウザに戻って、新しいタブを開き、開発者ツールの Network タブを開いてから、アドレスバーに URL を打ち直して開いてください。 F5 は使いません。 再読み込み(F5)のときは、ブラウザがページ本体(index.html)だけはサーバーに確かめに行くので、新しい版が返ってきて、この事故は再現しないからです。古いまま固定されるのは、URL を打って開く・リンクから来る、という普通の開き方のときです。

何も変わりません。

しかも、Network タブの index.html の行は、Size 列が (disk cache) になっています。 ブラウザは「1年変わらないと言われたので聞きません」と判断し、サーバーに問い合わせすらしていません。サーバーには、こちらの声が届く先すらありません。

この状態を、こう言い換えられます。

サイトは1ミリ秒も遅くなっていません。むしろ最速です。 そして、読者が見ているのは古い情報です。

これが「間違ったキャッシュは、遅いより悪い」の意味です。

読者から見て
遅い待てば正しい情報が出る
間違ってキャッシュされている待っても正しい情報は出ない。しかも本人は気づかない

価格が古い、在庫が古い、お知らせが古い。「速いけど嘘」より「遅いけど本当」のほうが、ほぼ常にマシです。

開発者ツールで Disable cache を入れると直って見えます。それは自分だけです。 読者の環境では直っていません。 ここが本当に怖いところです。

戻す

バックアップから戻します。

bash
$ sudo cp /etc/nginx/sites-available/default.bak /etc/nginx/sites-available/default
$ sudo nginx -t
$ sudo systemctl reload nginx

自分のブラウザに残ったものは、開発者ツールを開いた状態で、再読み込みボタンを右クリック →「キャッシュの消去とハード再読み込み」で消せます。

ただし、これができるのは自分だけです。読者にはできません。

やりすぎないための3つの目安

目安中身
迷ったら短くするmax-age=60 から始める。 短すぎて困ることは、たいてい起きません
入口だけは絶対にキャッシュしないindex.html は no-cache。 ここが古いと、他の全部が古いまま固定されます
長くするのは、URLが変わるものだけハッシュ付きファイルだけが1年の資格を持ちます

キャッシュを入れないことで起きるのは「少し遅い」だけです。 キャッシュを間違えることで起きるのは「古い情報が出続ける」です。 天秤は、最初から傾いています。


つまずいたところ

症状原因
Cache-Control を付けたのに Size が数字のままDisable cache にチェックが入っている。 この記事の間だけ外す
curl -I に Cache-Control が出ないlocation が当たっていない。 /assets/ と /assets(末尾のスラッシュ)は別物
付けたはずの別のヘッダが消えたlocation に add_header を書くと、上の階層の add_header を引き継がない。 そこに全部書き直す
Cache-Control が2行出るexpires と add_header を両方書いている。 どちらか片方にする
nginx: [emerg] "proxy_cache_path" directive is not allowed hereserver { } の中に書いている。 conf.d に別ファイルで置く
X-Cache-Status ヘッダ自体が出ないその location を通っていない。 proxy_pass と同じブロックに書く
X-Cache-Status がずっと MISS応答に Set-Cookie が付いている。 nginx は既定でキャッシュしない(正しい動き)
同じく MISS のままアプリが Cache-Control: no-store / private を返している
curl で 404 や別のサイトが返る-H "Host: app.local" を付け忘れている。 nginx は Host: でブロックを選ぶ
502 Bad Gateway になったnode app.js が動いていない。 キャッシュ以前の問題
/var/cache/nginx が作られないnginx が起動時に作る。 reload ではなく restart が要ることがある
304 ではなく毎回 200 が返るIf-None-Match の値がずれている。 " を含めて丸ごとコピーする
ファイルを更新したのに ETag が同じ中身が本当に同じ。 cp しただけで内容が変わっていない
gzip を有効にしたら ETag の形が変わった正常。 nginx は圧縮すると ETag を弱いもの(W/"...")に変える
ビルドしたら画面が真っ白になった古い index.html が、消えた古いJSを読んでいる。 ハード再読み込みで確認
設定を直したのに反映されないreload を忘れている。 nginx -t → reload は必ずセット

後片づけ

残すもの、消すものを分けます。

① /assets/ の1年キャッシュ設定 …… 残してください。 正しい設定です。

② proxy_cache …… 学習用なので、外して構いません。

bash
$ sudo cp /etc/nginx/sites-available/app.bak /etc/nginx/sites-available/app
$ sudo rm /etc/nginx/conf.d/proxy-cache.conf
$ sudo rm -rf /var/cache/nginx/appcache
$ sudo nginx -t
$ sudo systemctl reload nginx

③ /api/now …… 消して構いません。 ~/server/app.js から消して再起動します。

④ /var/www/html を元に戻すとき。

bash
$ sudo rm -rf /var/www/html
$ sudo mv /var/www/html.bak /var/www/html
$ ls -la /var/www/html/

⑤ バックアップファイルの掃除。

bash
$ ls /etc/nginx/sites-available/

.bak が溜まっているはずです。 どれが今の正なのか分からなくなる前に、要らないものを消してください。

⑥ 開発者ツールの Disable cache に、チェックを入れ直してください。

普段の開発中は入れっぱなしが正解です。 外すのは、今日のようにキャッシュそのものを観察するときだけです。


まとめ

  • キャッシュは4箇所ある。 ブラウザ / CDN / リバースプロキシ / アプリ。Redis で作ったのは一番奥だけだった
  • 手前ほど速く、手前ほど消せない。 この1行が、この記事の全部の理由になっている
  • Cache-Control は、サーバーからの指示。 付けなければ nginx は何も言わない
  • no-cache は「キャッシュするな」ではない。 保存するなは no-store、毎回確認しろが no-cache
  • ハッシュ付きファイルは max-age=31536000, immutable。 中身が変われば名前が変わるから、1年でも事故らない
  • index.html は no-cache。 ここに新しいファイル名が書いてあるので、ここが古いと全部が古いまま固定される
  • 「ハッシュ付きファイル名」と「1年キャッシュ」はセット。 片方だけやると壊れる
  • キャッシュしていいかの判断は1つ。「これが別の人に返っても平気か」。まずければ no-store
  • ETag / Last-Modified は「変わっていないこと」を確かめる仕組み。 304 は中身が空
  • 304 は「速い」ではなく「軽い」。 往復は起きる。一番速いのは、そもそも聞かないこと
  • add_header は location に1つ書くと、上の階層のものを引き継がない。 足し算ではなく上書き
  • proxy_cache_path は server の中に書けない。 conf.d に別ファイルで置く
  • proxy_cache を効かせると、アプリにも Redis にも MySQL にもリクエストが届かなくなる
  • Set-Cookie が付いた応答を nginx はキャッシュしない。 事故を防ぐための、正しい既定
  • キャッシュには必ず上限を書く。 max_size を忘れるのは、Redis で TTL を忘れるのと同じ
  • ブラウザのキャッシュは消せない。 だから消すのではなく、URLを変えて置き去りにする
  • CDN は「読者の近くに置いたリバースプロキシ」。 動かしているのは、この記事で書いた Cache-Control
  • proxy_cache では距離と量は解けない。 そこだけが CDN の本当の出番
  • 月に数千アクセスの個人サイトに CDN は要らない。 層が1つ増えるほうが高くつく
  • 間違ったキャッシュは、遅いより悪い。 遅いは待てば直る。古い情報は待っても直らない
  • 迷ったら短くする。 max-age=60 から始めて、確信が持てたものだけ伸ばす

参考リンク


次に読む

この記事は 【第8段階】深掘り の 5 / 30 本目です。

記事
← 前の記事自分のページをCSPで壊す — Webの防御ヘッダ
→ 次の記事まだマイクロサービスにしない — モノリスと12 Factor

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

Frontend/Backend›Caching / Content Delivery Network
  • Client Side(ブラウザキャッシュ)
  • Server Side(リバースプロキシキャッシュ)
  • CDN
  • Caching Strategies

この記事は、上の項目を実際に手を動かして確かめる回です。

キャッシュは4箇所あるという地図で、Redis の回との位置関係を整理する回です。CDNは仕組みの説明だけで、契約はしません。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次