Cache-Controlのno-cacheとno-storeの違いを、Nginxのアクセスログで確かめる

Nginx
スポンサーリンク

HTTPのレスポンスヘッダー Cache-Control の no-cache と no-store の違いを、実際に確かめた記事です。Nginxで3種類のヘッダー(max-age=60、no-cache、no-store)を返すページを用意し、ブラウザで同じページを開き直したときに、Nginxのアクセスログに何が届くかを比べました。curlで同じURLを呼ぶと何が分かり、何が分からないかも載せています。

結論

同じブラウザで同じページを3回開き(毎回、別のページに移ってから開き直す)、2回目と3回目の間にページのファイルを書き換えました。Nginxのアクセスログに届いたものは次のとおりです。Chromium、Firefox、WebKit(どれもPlaywrightのヘッドレスのブラウザ)で同じ結果でした。

レスポンスの Cache-Controlブラウザの動き2回目(ファイルは同じ)3回目(ファイルを書き換えた後)
max-age=60保存して、60秒の間はサーバーに聞かずに使う届かない届かない。表示は古い内容のまま
no-cache保存するが、使う前に毎回サーバーに確かめる条件付きリクエスト(If-None-Match つき)が届き、304(本文0バイト)条件付きリクエストが届き、200で新しい内容
no-store保存しないふつうのリクエストが届き、200(本文を全部送る)ふつうのリクエストが届き、200で新しい内容
  • no-cache は「キャッシュしない」ではなく、「保存してよいが、使う前に毎回サーバーに確かめる」という意味です。ブラウザは保存した内容を持っていて、変わっていなければ304を受け取って、保存した内容を表示しました。
  • ブラウザに保存させたくない(個人の情報が入ったページなど)なら no-store です。毎回、本文を全部受け取り直していました。
  • 「更新したらすぐ見えるようにしたい」だけなら、no-cache で更新は反映されました。変わっていないときは本文を送らずに済みます(304)。
  • Nginxは、no-store のURLでも、条件付きリクエストが来れば304を返しました。304を返すかはサーバーが決め、保存するかはブラウザが決めます。curlは保存しないので、curlだけでは no-cache と no-store の違いは見えません。

動作確認した環境

  • Nginx 1.30.6(Dockerイメージ nginx:1.30.6。確認した日の安定版。digestで固定)
  • ブラウザ: Dockerイメージ mcr.microsoft.com/playwright:v1.65.0-noble(digestで固定)の中の、ヘッドレスのChromium 158.0.8127.18、Firefox 159.0、WebKit 27.2。Playwright 1.65.0(npm)で操作した
  • ホスト: Windows 11、Docker 29.7.2(Docker Desktop)、Docker Compose v5.5.1、Git Bash の curl 8.14.1、PowerShell 7.6.5 と curl.exe 8.21.0、Windows PowerShell 5.1
  • 確認日: 2026年11月9日

この記事は、MacとWindowsの両方の読者を対象にしています。NginxとブラウザはDockerのコンテナで動かすので、使うのは docker compose と curl のコマンドです。OSで書き方が違うコマンドは、両方を載せています。この記事のコマンドは、Claude(AI)が実行して確認しました。本文の出力は、Windows 11 のGit Bashから上から順に実行した結果です。PowerShellで実行した結果は、後ろの章にまとめました。Macでは確認していません。

ブラウザは、Playwrightのコンテナの中のものです。普段使うChrome、Edge、Safariそのものでは確かめていません。WebKitはSafariのエンジンですが、Safariとは別のものです。

確かめ方

no-cache と no-store の違いは、「ブラウザ(キャッシュ)が保存するかどうか」です。curlはレスポンスを保存しないので、ブラウザを使います。ブラウザで同じページを開き直したとき、Nginxに次のどれが届くかを、アクセスログで見ます。

  • 何も届かない: 保存した内容を、確かめずに使った
  • 条件付きリクエスト(If-None-Match や If-Modified-Since がついたリクエスト)が届く: 保存した内容を使ってよいか、確かめた
  • ふつうのリクエストが届く: 保存した内容がないので、最初から取り直した

開き直し方は、ふつうにページを開く操作だけにしました。再読み込みのボタンと戻るボタンは使っていません(どちらも動きが変わることがあるため。最後の「確かめていないこと」を参照)。

準備

空のフォルダに、次の3つのファイルを作ります。まず compose.yaml です。nginx がページを配信し、browser はPlaywrightのイメージで、ブラウザを動かすためのコンテナです。ホストのポート19701は、後でcurlで呼ぶために開けています(使っていれば別の番号にしてください)。

services:
  nginx:
    image: nginx:1.30.6@sha256:42c68eab6f7e22611786a9fe1d1c019e275c50185bd54b8f75dc2b9184322703
    ports:
      - "19701:80"
    volumes:
      - ./default.conf:/etc/nginx/conf.d/default.conf:ro
      - ./html:/usr/share/nginx/html:ro

  browser:
    image: mcr.microsoft.com/playwright:v1.65.0-noble@sha256:6e3fb709361521eb27161606e6da6d2674e5e89fa16516cb37d6fdd91372273d
    command: ["sleep", "infinity"]
    init: true
    ipc: host
    working_dir: /work
    volumes:
      - .:/work

Playwrightのイメージには、ブラウザは入っていますが、npmのパッケージ playwright は入っていないので、後で入れます。init: true と ipc: host は、PlaywrightのDockerのドキュメントで勧められている --init と --ipc=host(Chromiumを使うとき)にあたる設定です。

次に、Nginxの設定 default.conf です。3つのページに、それぞれ違う Cache-Control をつけます。

log_format cache escape=none '$status "$request" bytes=$body_bytes_sent '
                 'If-None-Match=[$http_if_none_match] '
                 'If-Modified-Since=[$http_if_modified_since] '
                 'Cache-Control=[$http_cache_control]';

server {
    listen 80;
    root /usr/share/nginx/html;
    access_log /var/log/nginx/access.log cache;

    location = /max-age.html  { add_header Cache-Control "max-age=60"; }
    location = /no-cache.html { add_header Cache-Control "no-cache"; }
    location = /no-store.html { add_header Cache-Control "no-store"; }
}

log_format で、アクセスログに次のものを残します。ステータス、リクエストの行、送った本文のバイト数と、ブラウザが送ってきたリクエストヘッダーの If-None-Match、If-Modified-Since、Cache-Control です。[] の中が空なら、そのヘッダーは送られていません。escape=none は、値の中の文字(" など)をエスケープせずに、そのまま残す指定です(Nginxのドキュメント)。ETag(ファイルごとの識別子)と Last-Modified は、Nginxが静的なファイルに自動でつけます。

最後に、ブラウザを動かすスクリプト visit.js です。1つのブラウザで同じページを3回開きます。毎回、別のページ(about:blank)に移ってから開き直します。2回目と3回目の間に、ページのファイルを書き換えます。ページのファイル(html/ の中)は、このスクリプトが作ります。

// 使い方: node visit.js <max-age|no-cache|no-store> [chromium|firefox|webkit]
// 1つのブラウザで同じページを3回開く。毎回、別のページ(about:blank)に移ってから開き直す。
// 2回目と3回目の間に、ページのファイル(Nginx が配信している html/ の中)を書き換える。
const fs = require('fs');
const playwright = require('playwright');

const name = process.argv[2];
const type = process.argv[3] || 'chromium';
const write = (text) =>
  fs.writeFileSync(`html/${name}.html`,
    `<!doctype html><meta charset="utf-8"><link rel="icon" href="data:,"><p>${text}</p>\n`);

(async () => {
  fs.mkdirSync('html', { recursive: true });
  write(`${name}: 最初の内容`);
  const browser = await playwright[type].launch();
  console.log(`${type} ${browser.version()}`);
  const page = await browser.newPage();
  for (let i = 1; i <= 3; i++) {
    if (i === 3) {
      write(`${name}: 書き換えた後の内容です`);
      console.log('(ファイルを書き換えた)');
    }
    await page.goto(`http://nginx/${name}.html`);
    console.log(`${i}回目の表示: ${await page.textContent('p')}`);
    await page.goto('about:blank');
  }
  await browser.close();
})();

起動して、browser のコンテナに playwright を入れます。版はイメージと同じ1.65.0にします。browser のコンテナは今のフォルダを /work にマウントしているので、node_modules は今のフォルダにできます。

$ docker compose up -d
$ docker compose exec browser npm install playwright@1.65.0

added 2 packages in 4s

docker compose up -d の出力と、npmの新しい版の案内は省きました。Nginxのアクセスログは docker compose logs nginx で見られます。以下の「[nginx のログに増えた行]」は、そのコマンドの出力のうち、visit.js を1回実行する間に増えた行です(行の頭のサービス名は除いています。docker compose logs --no-log-prefix nginx で同じ形になります)。

max-age=60: 保存して、期限の間はサーバーに聞かない

まず、比べるための max-age=60 です。Chromiumで開きます。

$ docker compose exec browser node visit.js max-age
chromium 158.0.8127.18
1回目の表示: max-age: 最初の内容
2回目の表示: max-age: 最初の内容
(ファイルを書き換えた)
3回目の表示: max-age: 最初の内容
[nginx のログに増えた行]
200 "GET /max-age.html HTTP/1.1" bytes=100 If-None-Match=[] If-Modified-Since=[] Cache-Control=[]

Nginxに届いたのは1回目だけです。2回目と3回目は、ブラウザが保存した内容を、サーバーに聞かずに使いました。そのため、ファイルを書き換えた後の3回目も、古い内容のままでした。max-age=60 は、レスポンスが作られてから60秒の間は新しい(fresh)ものとして扱ってよい、という意味です(RFC 9111 5.2.2.1、MDN)。「サーバーのファイルを直したのに、ブラウザで変わらない」は、この状態です。

no-cache: 保存して、使う前に毎回確かめる

$ docker compose exec browser node visit.js no-cache
chromium 158.0.8127.18
1回目の表示: no-cache: 最初の内容
2回目の表示: no-cache: 最初の内容
(ファイルを書き換えた)
3回目の表示: no-cache: 書き換えた後の内容です
[nginx のログに増えた行]
200 "GET /no-cache.html HTTP/1.1" bytes=101 If-None-Match=[] If-Modified-Since=[] Cache-Control=[]
304 "GET /no-cache.html HTTP/1.1" bytes=0 If-None-Match=["6af11c9c-65"] If-Modified-Since=[Mon, 09 Nov 2026 01:06:36 GMT] Cache-Control=[]
200 "GET /no-cache.html HTTP/1.1" bytes=119 If-None-Match=["6af11c9c-65"] If-Modified-Since=[Mon, 09 Nov 2026 01:06:36 GMT] Cache-Control=[]

3回とも、Nginxにリクエストが届きました。2回目と3回目には、1回目のレスポンスの ETag と Last-Modified の値が、If-None-Match と If-Modified-Since として入っています。ブラウザが1回目のレスポンスを保存していて、「これはまだ使えるか」を確かめた、ということです。

  • 2回目: ファイルが同じなので、Nginxは304(Not Modified)を返し、本文は送っていません(bytes=0)。ブラウザは保存していた内容を表示しました。
  • 3回目: ファイルを書き換えたので、ブラウザが送った値が今のファイルと合わなくなり、Nginxは200で新しい内容を返しました。

RFC 9111(5.2.2.4)では、no-cache のレスポンスは、オリジンのサーバーで確かめて成功しない限り、ほかのリクエストに使ってはいけない、とされています。保存すること自体は禁止していません。MDNにも「no-cache は『キャッシュしない』という意味ではない」と書かれています。

ログの Cache-Control=[] は、ブラウザがリクエストに Cache-Control をつけていないことを表します。今回は再読み込みではなく、ふつうに開き直しています。

no-store: 保存しない

$ docker compose exec browser node visit.js no-store
chromium 158.0.8127.18
1回目の表示: no-store: 最初の内容
2回目の表示: no-store: 最初の内容
(ファイルを書き換えた)
3回目の表示: no-store: 書き換えた後の内容です
[nginx のログに増えた行]
200 "GET /no-store.html HTTP/1.1" bytes=101 If-None-Match=[] If-Modified-Since=[] Cache-Control=[]
200 "GET /no-store.html HTTP/1.1" bytes=101 If-None-Match=[] If-Modified-Since=[] Cache-Control=[]
200 "GET /no-store.html HTTP/1.1" bytes=119 If-None-Match=[] If-Modified-Since=[] Cache-Control=[]

3回とも、条件のつかないふつうのリクエストで、Nginxは毎回200で本文を全部送りました。If-None-Match がないのは、ブラウザが1回目のレスポンスを保存していないためです。RFC 9111(5.2.2.5)では、no-store はキャッシュがリクエストとレスポンスのどの部分も保存してはいけない、という意味です。

表示だけを見ると、no-cache と no-store は3回とも同じでした。違いは、ブラウザが保存しているかと、変わっていないときに本文を送り直すかです。

FirefoxとWebKitでも同じだった

visit.js の2つ目の引数でブラウザを変えられます。

$ docker compose exec browser node visit.js no-cache firefox
firefox 159.0
1回目の表示: no-cache: 最初の内容
2回目の表示: no-cache: 最初の内容
(ファイルを書き換えた)
3回目の表示: no-cache: 書き換えた後の内容です
[nginx のログに増えた行]
200 "GET /no-cache.html HTTP/1.1" bytes=101 If-None-Match=[] If-Modified-Since=[] Cache-Control=[]
304 "GET /no-cache.html HTTP/1.1" bytes=0 If-None-Match=["6af11ca9-65"] If-Modified-Since=[Mon, 09 Nov 2026 01:06:49 GMT] Cache-Control=[]
200 "GET /no-cache.html HTTP/1.1" bytes=119 If-None-Match=["6af11ca9-65"] If-Modified-Since=[Mon, 09 Nov 2026 01:06:49 GMT] Cache-Control=[]

3つのヘッダーを、Firefox 159.0 と WebKit 27.2 でも開きました(max-age、no-cache、no-store と、firefox、webkit の組み合わせ)。表示と、ログに届いたステータスの並びは、どれもChromiumと同じでした。

ブラウザmax-age=60no-cacheno-store
Chromium 158.0.8127.18200 だけ200、304、200(2回目と3回目は条件付き)200、200、200(条件なし)
Firefox 159.0200 だけ200、304、200(2回目と3回目は条件付き)200、200、200(条件なし)
WebKit 27.2200 だけ200、304、200(2回目と3回目は条件付き)200、200、200(条件なし)

curlで確かめる(Nginxはno-storeでも304を返す)

ホストからcurlでヘッダーを見ます。MacのターミナルとGit Bashでは curl、Windows の PowerShell では .exe までつけて curl.exe と打ちます。下はGit Bashで実行した結果です。

$ curl -s -i http://localhost:19701/no-cache.html
HTTP/1.1 200 OK
Server: nginx/1.30.6
Date: Mon, 09 Nov 2026 01:07:11 GMT
Content-Type: text/html
Content-Length: 119
Last-Modified: Mon, 09 Nov 2026 01:07:03 GMT
Connection: keep-alive
ETag: "6af11cb7-77"
Cache-Control: no-cache
Accept-Ranges: bytes

<!doctype html><meta charset="utf-8"><link rel="icon" href="data:,"><p>no-cache: 書き換えた後の内容です</p>

$ curl -s -i http://localhost:19701/no-store.html
HTTP/1.1 200 OK
Server: nginx/1.30.6
Date: Mon, 09 Nov 2026 01:07:11 GMT
Content-Type: text/html
Content-Length: 119
Last-Modified: Mon, 09 Nov 2026 01:07:07 GMT
Connection: keep-alive
ETag: "6af11cbb-77"
Cache-Control: no-store
Accept-Ranges: bytes

<!doctype html><meta charset="utf-8"><link rel="icon" href="data:,"><p>no-store: 書き換えた後の内容です</p>

設定どおりの Cache-Control と、ETag、Last-Modified がついています(max-age.html では Cache-Control: max-age=60 でした)。ヘッダーが正しく出ているかは、これで確かめられます。ただし、curlを何回実行しても、Nginxのログは毎回 If-None-Match=[] の200になります。curlはレスポンスを保存せず、条件付きリクエストを自分では送らないからです。

上の出力の ETag を、自分で If-None-Match につけて送ってみます。

$ curl -s -i -H 'If-None-Match: "6af11cb7-77"' http://localhost:19701/no-cache.html
HTTP/1.1 304 Not Modified
Server: nginx/1.30.6
Date: Mon, 09 Nov 2026 01:07:14 GMT
Last-Modified: Mon, 09 Nov 2026 01:07:03 GMT
Connection: keep-alive
ETag: "6af11cb7-77"
Cache-Control: no-cache

$ curl -s -i -H 'If-None-Match: "6af11cbb-77"' http://localhost:19701/no-store.html
HTTP/1.1 304 Not Modified
Server: nginx/1.30.6
Date: Mon, 09 Nov 2026 01:07:14 GMT
Last-Modified: Mon, 09 Nov 2026 01:07:07 GMT
Connection: keep-alive
ETag: "6af11cbb-77"
Cache-Control: no-store

[nginx のログに増えた行]
304 "GET /no-cache.html HTTP/1.1" bytes=0 If-None-Match=["6af11cb7-77"] If-Modified-Since=[] Cache-Control=[]
304 "GET /no-store.html HTTP/1.1" bytes=0 If-None-Match=["6af11cbb-77"] If-Modified-Since=[] Cache-Control=[]

no-store のURLでも304が返りました。今回の設定では、Nginxは Cache-Control の値によらず、送られてきた If-None-Match がファイルの ETag と合えば304を返しました。no-store の効き目は、ブラウザが保存しないので、そもそも条件付きリクエストを送らないことにあります。手で条件付きリクエストを送って304が返っても、no-cache と no-store の違いは分かりません。違いを見るには、上のようにブラウザ(キャッシュするクライアント)で開き直します。

304のレスポンスにも Cache-Control がついています。Nginxの add_header は、200、201、204、206、301、302、303、304、307、308 のステータスのときにヘッダーを足します(ほかのステータスでも足すには always をつける。Nginxのドキュメント)。

WindowsのPowerShellでの引用符

ETag の値は " で囲まれていて、この " も含めて送る必要があります。PowerShell 7.6 では、MacやGit Bashと同じ書き方で304になりました(ここからの curl.exe の出力は1行目だけを載せます)。

PS> curl.exe -s -i -H 'If-None-Match: "6af11e39-77"' http://localhost:19701/no-store.html
HTTP/1.1 304 Not Modified

Windows PowerShell 5.1 では、同じ書き方だと200になりました。Nginxのログには If-None-Match=[6af11e39-77] と、" が消えた値が届いていました。5.1 では \" と書くと304になりました。

PS> curl.exe -s -i -H 'If-None-Match: "6af11e39-77"' http://localhost:19701/no-store.html
HTTP/1.1 200 OK
PS> curl.exe -s -i -H 'If-None-Match: \"6af11e39-77\"' http://localhost:19701/no-store.html
HTTP/1.1 304 Not Modified

上の2つは Windows PowerShell 5.1 での結果です。逆に、PowerShell 7.6 で \" と書くと、ログには If-None-Match=[\"6af11e39-77\"] と \ ごと届き、200になりました。使っているPowerShellの版に合わせて書き分けます(版は $PSVersionTable.PSVersion で分かります)。

どれを使うか

  • ブラウザに残したくないページ(ログインした後の、個人の情報が入ったページなど): no-store。毎回、本文を全部送ります。
  • 保存はされてよいが、更新はすぐ見せたいページ(HTMLなど): no-cache。毎回サーバーに確かめますが、変わっていなければ304で本文を送らずに済みます。
  • max-age=60 では、今回の開き直しで、60秒以内はブラウザが保存した内容をそのまま使い、サーバーにリクエストが来ませんでした(max-age は新しさの期限の指定で、通信を禁止するものではありません)。その間にファイルを更新しても、すでに開いたブラウザには古い内容が表示されます。

Nginxの add_header には、引き継ぎの決まりがあります。ドキュメントによると、ある階層(location など)に1つでも add_header があると、上の階層(server など)の add_header は引き継がれません(1.29.3 からは add_header_inherit で変えられる)。server に書いたヘッダーが、location に Cache-Control を足したとたん消える、ということが起きます。この記事では、この動きは確かめていません。

片付け

$ docker compose down

今のフォルダに、html/、node_modules/、package.json、package-lock.json が残るので、いらなければ消します。

PowerShellで実行した結果

Windows の PowerShell 7.6 で、同じ内容のファイルを改行CRLFで作り、docker compose up -d、npm install、Chromiumでの no-cache と no-store、curl.exe、docker compose down を実行しました。docker compose のコマンドはGit Bashと同じ書き方で、visit.js の表示とNginxのログに届いたステータスの並びも、Git Bashのときと同じでした。curl.exe の引用符は、上の「WindowsのPowerShellでの引用符」のとおりです。

確かめていないこと

  • 普段のブラウザ(Chrome、Edge、Firefox、Safari)での動き。確かめたのは、Playwrightのコンテナの中のヘッドレスのChromium、Firefox、WebKitだけです。
  • 再読み込みのボタンと、戻る・進むのボタンで開いたとき。MDNによると、戻るボタンなどの履歴の移動では、no-cache でも確かめずに表示されることがあります。
  • ブラウザを閉じて開き直したとき。今回は、1つのブラウザを開いたまま、3回開き直しました。
  • Cache-Control をつけないとき。MDNによると、つけないとブラウザが独自の判断(ヒューリスティック)でキャッシュすることがあります。
  • CDNやプロキシなど、ブラウザ以外のキャッシュでの動き
  • Macでの実行(Docker Desktop for Mac、ターミナルのcurl)

参考

スポンサーリンク
NginxWEB
スポンサーリンク
シェアする
hayoをフォローする

コメント

タイトルとURLをコピーしました