キャッシュは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 は個人サイトに必須ではないこと。無料枠はあるが、要るかどうかは別だということ
この記事でやること
- キャッシュが効いていない状態を先に見る。
dist/を nginx で配って、開発者ツールの Network で確認する Cache-Controlを nginx で自分で付けて、from disk cacheが出るところまで持っていく(ここが山場)curlでETagを使って、304 Not Modifiedが返る様子を見るproxy_cacheを効かせて、アプリのログにリクエストが届かなくなるのを確認する- わざと事故を起こす。 HTML に1年のキャッシュを付けて、更新が反映されなくなるところまでやって、戻す
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
Cache-Control | HTTPの応答ヘッダ。「このファイルを何秒、どこに置いていいか」をサーバーが指示するもの。この記事の主役 |
max-age | Cache-Control の中身。何秒間そのまま使っていいか。 max-age=3600 なら1時間 |
no-store | 絶対に保存するな。 ディスクにもメモリにも残さない |
no-cache | 保存はしていい。ただし使う前に毎回サーバーに確認しろ。 「キャッシュするな」ではありません |
| 条件付きリクエスト | 「前に取ったやつから変わってたら下さい」という聞き方。 変わっていなければ中身は送られてこない |
ETag | そのファイルの中身に対して付く目印(指紋のようなもの)。中身が変われば変わる |
Last-Modified | そのファイルが最後に更新された日時。 ETag より雑だが軽い |
304 Not Modified | 「変わってないよ」という返事。中身は入っていない(ヘッダだけ)。だから速い |
immutable | 「このURLの中身は絶対に変わらない」という宣言。 確認すら要らなくなる |
| オリジン | 本物のファイルが置いてある、自分のサーバー。 キャッシュの元 |
| エッジ | 読者の近くに置かれた、コピーを持つサーバー。 CDN の実体 |
| CDN | Content 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の中で、フロントをビルドします。
出力はこうなります。
index-C2u9Kx1p.js
index-a83Bf0Qd.css
ファイル名の後ろに付いている
C2u9Kx1pが、この記事の後半の主役です。ビルドツールの回で「キャッシュ対策という明確な仕事をしている」と書いたものです。何の仕事なのかを、今回はっきりさせます。
nginx の回でやったとおり、/var/www/html/ に置きます。先に元のファイルを退避します。
戻したくなったら、これで戻ります。
何が返ってきているかをヘッダで見る
ブラウザを開く前に、curl で応答ヘッダだけ見ます。 -I はヘッダだけ取るオプションです。
ファイル名は、自分の 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行足す
設定を触る前に、必ずバックアップを取ります。
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 の回でやった型です。
nginx -t が syntax is ok と test is successful の2行を返してから reload してください。 逆にすると、設定が壊れたまま反映されます。
効いているか、まずヘッダで確かめる
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, immutable | 1年 |
index.html | no-cache | 毎回確認 |
| ロゴなど、名前が変わらない画像 | public, max-age=3600 | 1時間程度 |
| ログイン後の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-Match | ETag | 「この目印と違ってたら下さい」 |
If-Modified-Since | Last-Modified | 「この時刻より新しかったら下さい」 |
手で再現できます。 まず ETag を取ります。
HTTP/1.1 200 OK
Content-Length: 461
Last-Modified: Tue, 09 Sep 2026 02:09:12 GMT
ETag: "68bf1a48-1cd"
その ETag を、そのまま付けてもう一度聞きます。
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 });
});
ログインが要らない場所に置いてください。 理由は後で書きます。
アプリを再起動して、素の状態を確認します。
別のターミナルから、2回叩きます。
{"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 に別ファイルとして置くのが一番安全です。
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:10m | appcache という名前を付ける。 10m はキーの索引に使うメモリ(中身ではない) |
max_size=100m | ディスクを最大100MBまで使う。 超えたら古いものから捨てる |
inactive=10m | 10分間1度も使われなかったら捨てる |
max_sizeを書かないと、上限なしでディスクを食い続けます。 Redis の回の「TTL を付け忘れるとメモリを食い潰す」と、まったく同じ話です。キャッシュには必ず上限を書きます。
使う側を書く
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 30s | 200 が返ってきたら30秒間保存する |
add_header X-Cache-Status ... | 効いたかどうかを見るための、自分用の目印 |
アプリに届かなくなるのを見る
アプリのターミナルを見えるようにしたまま、3回叩きます。
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箇所を、「消せるか」だけで並べ直します。
| 場所 | 消し方 | 難易度 |
|---|---|---|
| ④ Redis | DEL キー名 | 簡単 |
| ③ nginx | sudo rm -rf /var/cache/nginx/appcache/* して reload | 簡単 |
| ② CDN | 管理画面かAPIでパージを頼む。 反映に時間差がある | 面倒 |
| ① ブラウザ | ❌ 手段が無い | 不可能 |
③ は本当に消せる
やってみてください。
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年を付けてしまう
さっき「やってはいけない」と書いたことを、わざとやります。
location /assets/ を、わざと全体に広げます。
# ⚠️ わざと間違えています。あとで必ず戻します
location / {
add_header Cache-Control "public, max-age=31536000, immutable";
try_files $uri $uri/ =404;
}
ホストのブラウザで一度開いてください。 そのあと、中身を書き換えます。
index.html の <title> でも、画面に出る文字でも構いません。目で分かる変更を1つ入れて、ビルドして置き直します。
サーバーの上のファイルは、確実に新しくなっています。
ブラウザに戻って、新しいタブを開き、開発者ツールの Network タブを開いてから、アドレスバーに URL を打ち直して開いてください。 F5 は使いません。 再読み込み(F5)のときは、ブラウザがページ本体(index.html)だけはサーバーに確かめに行くので、新しい版が返ってきて、この事故は再現しないからです。古いまま固定されるのは、URL を打って開く・リンクから来る、という普通の開き方のときです。
何も変わりません。
しかも、Network タブの index.html の行は、Size 列が (disk cache) になっています。 ブラウザは「1年変わらないと言われたので聞きません」と判断し、サーバーに問い合わせすらしていません。サーバーには、こちらの声が届く先すらありません。
この状態を、こう言い換えられます。
サイトは1ミリ秒も遅くなっていません。むしろ最速です。 そして、読者が見ているのは古い情報です。
これが「間違ったキャッシュは、遅いより悪い」の意味です。
| 読者から見て | |
|---|---|
| 遅い | 待てば正しい情報が出る |
| 間違ってキャッシュされている | 待っても正しい情報は出ない。しかも本人は気づかない |
価格が古い、在庫が古い、お知らせが古い。「速いけど嘘」より「遅いけど本当」のほうが、ほぼ常にマシです。
開発者ツールで
Disable cacheを入れると直って見えます。それは自分だけです。 読者の環境では直っていません。 ここが本当に怖いところです。
戻す
バックアップから戻します。
自分のブラウザに残ったものは、開発者ツールを開いた状態で、再読み込みボタンを右クリック →「キャッシュの消去とハード再読み込み」で消せます。
ただし、これができるのは自分だけです。読者にはできません。
やりすぎないための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 here | server { } の中に書いている。 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 …… 学習用なので、外して構いません。
③ /api/now …… 消して構いません。 ~/server/app.js から消して再起動します。
④ /var/www/html を元に戻すとき。
⑤ バックアップファイルの掃除。
.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から始めて、確信が持てたものだけ伸ばす
参考リンク
- roadmap.sh — System Design
- MDN — HTTP キャッシュ
- MDN — Cache-Control
- MDN — ETag
- MDN — 304 Not Modified
- MDN — 条件付きリクエスト
- RFC 9111 — HTTP Caching
- nginx — ngx_http_headers_module
- nginx — ngx_http_proxy_module
- nginx — A Guide to Caching with NGINX
- web.dev — HTTP キャッシュを使う
- Vite 公式ガイド
- Cloudflare — 料金プラン
次に読む
この記事は 【第8段階】深掘り の 5 / 30 本目です。
| 記事 | |
|---|---|
| ← 前の記事 | 自分のページをCSPで壊す — Webの防御ヘッダ |
| → 次の記事 | まだマイクロサービスにしない — モノリスと12 Factor |
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。

コメント