CloudFrontとキャッシュ設計 — ログインページまでキャッシュされた

CloudFrontとキャッシュ設計。クラウドと配信するコンテンツ、キャッシュの箱と鍵付きのログインカード。

※本記事はアフィリエイト広告(PR)を含みます。

ログインページまでキャッシュされると事故になります。CloudFrontで何をキャッシュするかを、条件から決めます。

前回: S3のキーとバージョニング — フォルダは存在しない

これは【深掘り】の記事です。本線の順路ではありません。 本線の キャッシュは4箇所にある — Cache-ControlとCDN で出てきた 「配信を前に置く」を、AWS の CloudFront という製品の設定として読めるようにする回です。飛ばしても本線は進めます。

このシリーズは、読者にアカウントを作らせません。 触るのは LocalStack と、aws CLI の --endpoint-url だけです。 課金が発生する操作は一切しません。 料金は具体的な金額を書きません(変わるため)。 何に対して課金されるかという構造だけを書き、数字は公式の料金ページを見てください。 コマンドは VM の中(Ubuntu Server)で打ちます。 最後に全部消します。 なお LocalStack は2026年3月23日から1つのイメージに統合され、それ以降の版(2026.03.0 以降)は起動に auth token(LocalStack のアカウントで取得。無料プランあり)が必要になりました。 この記事では、統合前に公開されて更新が止まった localstack/localstack:3.8 を固定して使い、アカウントを作らずに進めます。旧イメージの固定は練習用の短期的な手段です(公式は、更新が来ない・修正済みの脆弱性が残ると注意しています)。新しい版を使う場合は、取得した token を LOCALSTACK_AUTH_TOKEN 環境変数に設定します。

そして、この記事では CDN の仕組みそのものは説明しません。 「なぜ遠いと遅いのか」「エッジとオリジンとは何か」「キャッシュはなぜ消せないのか」は、 距離は速度で解決できない — システム設計深掘り で すでに nginx を使って手元に再現してあります。原理はそちらです。 この記事は「CloudFront という製品の設定項目を読めるようになる」ことだけに絞ります。


CloudFront の設定画面を初めて開いたとき、私は固まりました。

項目が、多すぎたのです。

Origin domain / Origin path / Origin access
Viewer protocol policy / Allowed HTTP methods
Cache policy / Origin request policy / Response headers policy
Cache key and origin requests
  - Headers / Query strings / Cookies
Minimum TTL / Default TTL / Maximum TTL
Alternate domain name (CNAME) / Custom SSL certificate
Function associations / Geographic restrictions / WAF

「どれが何に効くのか」が、1つも分かりませんでした。

それで私は、いちばんやってはいけないことをしました。とりあえず全部キャッシュする設定にしたのです。

  • Cookie: All(と言いつつ実際には「無視」の側に倒していました)
  • Headers: None
  • Minimum TTL: とりあえず大きめの数字

静的なファイルは確かに速くなりました。 ここまでは良かった。

問題は、練習用に作っていたログイン付きのページでした。

自分のブラウザでログインし、/mypage を開いて、「ようこそ、自分の名前さん」と出るのを確認しました。 そのあと、別のブラウザ(ログインしていない)で同じURLを開きました。

ようこそ、(自分の名前)さん

ログインしていないブラウザに、自分の名前が出ました。

一瞬、認証が壊れたのかと思いました。壊れていませんでした。 サーバーは正しく動いていた。

キャッシュが、私だけのページを「みんなのページ」として配っていました。

CDN は「そのURLに対する答え」を保存します。 「誰が」を保存の鍵に入れていなければ、最初の1人の答えが、全員に配られます。

練習環境だったので実害はありませんでした。 ですが、これが本番だったら事故です。 そして怖いのは、設定画面のどこにも「危険です」とは書いていないことでした。

この記事では、CloudFront の設定項目を、1つずつ「読める」状態にします。 そして、CloudFront を動かせない代わりに、同じ設定を nginx に翻訳して、手元で挙動を数字にします。


対象レベル: 中級〜上級 / 区分: 発展

目次

この記事でわかること

  • CloudFront の設定は「オリジン」「ビヘイビア」「証明書」「代替ドメイン名」の4つに分解できること。画面の項目は全部そのどれか
  • ビヘイビアは上から順にマッチする。 順番そのものが設定で、並べ替えると挙動が変わること
  • 山場:キャッシュキーに何を含めるかで、ヒット率が桁で変わること。Cookie を全部含めるとほぼ0になるのを数字で見ます
  • 他人のページが配られる事故は、直し方が2つしかないこと。そしてオリジン側で直すのが本筋であること
  • TTL は3つあり、どれが使われるかは「オリジンが Cache-Control を返すかどうか」で決まること
  • 無効化は「使うもの」ではなく「使わなくて済む設計にするもの」であること。HTMLだけが例外であること
  • CloudFront Functions と Lambda@Edge は、片方が上位互換ではないこと。まず Functions で考えるという順番
  • OAC を使うと「S3 を公開しないまま配信できる」こと。個人サイトで CloudFront を入れる価値は、ほぼここにあること
  • LocalStack のコミュニティ版では CloudFront はほぼ動かないこと。それでも設定JSONの検証まではできること

この記事でやること

  1. ~/awslab/cf を作り、LocalStack と、オリジン役・エッジ役の nginx を Compose で立てる
  2. create-distribution の設定JSONを、注釈付きで手で書く(LocalStack で動かないところは正直に書きます)
  3. 山場:proxy_cache_key を3通りに変えて、100リクエストのヒット率を実測して表にする
  4. 「他人のページが配られる」事故を、ダミーの利用者名で再現して、2通りの直し方を試す
  5. TTL の3つを、オリジンの Cache-Control の有無で場合分けした表にする
  6. 無効化のコマンドの形を書き、「無効化しない設計」に置き換える
  7. Functions / Lambda@Edge / OAC / 署名付きURL / 地理制限を、判断表にまとめる
  8. 全部消す

先に知る言葉

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

言葉意味
ディストリビューションCloudFront の設定のかたまり1つ。「1つのサイト」に対して1つ作るのが基本
オリジン元のデータがある場所。S3 や、自分の EC2 や、社外のサーバー
ビヘイビアパスの形(/images/* など)ごとの規則。上から順にマッチする
キャッシュキー保存したものを取り出すための鍵。これが違えば別物として保存される
TTLTime To Live。保存したものを何秒間そのまま使ってよいか
無効化(Invalidation)保存済みのものを「もう使うな」と各拠点に伝えること
OACOrigin Access Control。CloudFront からだけ S3 を読ませる仕組み
署名付きURL期限や条件が埋め込まれた、一時的にだけ有効なURL
代替ドメイン名(CNAME)d111....cloudfront.net の代わりに使う自分のドメイン
Lambda@Edge / CloudFront Functions配信の途中で、自分の書いたコードを動かす仕組み

⓪ 作業場所を作る

VM の中(Ubuntu Server)で打ちます。

bash
$ mkdir -p ~/awslab/cf
$ cd ~/awslab/cf

Docker と Compose は入っている前提です。 入っていなければ、先に入れてください。

bash
$ docker --version
$ docker compose version
Docker version 27.3.1, build ce12230
Docker Compose version v2.29.7

この記事では、3つのコンテナを立てます。

コンテナ役割外から見えるか
localstackAWS の API を真似する。CloudFront の設定JSONを投げる相手ポート4566
originオリジン役の nginx。元データを持っている見えない(意図的)
edgeエッジ役の nginx。CloudFront の代わりポート8080〜8083

origin にポートを開けないのは、うっかりではありません。 ⑦でやる OAC(S3 を公開せず、CloudFront からだけ読ませる)と同じ形を、最初から作っておくためです。


① ディストリビューションの構造を、JSONで読む

CloudFront の設定画面は項目が多いですが、分解すると4つしかありません。

かたまり何を決めるかJSONのどこ
オリジン元データがどこにあるか。 何本でも登録できるOrigins
ビヘイビアパスの形ごとの規則。 上から順にマッチするCacheBehaviors と DefaultCacheBehavior
証明書HTTPS を張るための鍵。 バージニア北部で取る必要があるViewerCertificate
代替ドメイン名自分のドメインで見せるかAliases

残りの項目(地理制限・WAF・ログ)は、この4つにぶら下がるオプションです。

まず、空の型紙を出してみる

これは AWS に接続しません。 aws CLI が手元に持っている定義から、JSONの形だけを出す機能です。

bash
$ sudo apt update
$ # Ubuntu 24.04 の apt には awscli が無い(22.04 でも v1)ので、AWS 公式の zip で v2 を入れる
$ sudo apt install -y unzip curl jq
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o awscliv2.zip
$ unzip -q awscliv2.zip
$ sudo ./aws/install
$ aws --version
aws-cli/2.17.42 Python/3.11.9 Linux/6.8.0-45-generic
bash
$ aws cloudfront create-distribution --generate-cli-skeleton > skeleton.json
$ wc -l skeleton.json
211 skeleton.json

211行ありました。 これが「設定画面の項目が多い」の正体です。

bash
$ jq 'keys' skeleton.json
$ jq '.DistributionConfig | keys' skeleton.json
[
  "DistributionConfig"
]
[
  "Aliases",
  "CacheBehaviors",
  "Comment",
  "CustomErrorResponses",
  "DefaultCacheBehavior",
  "DefaultRootObject",
  "Enabled",
  "Logging",
  "Origins",
  "PriceClass",
  "Restrictions",
  "ViewerCertificate",
  "WebACLId"
]

さきほどの表の4つが、そのまま並んでいます。 見えていなかっただけでした。

自分で書いてみる

型紙は項目が全部入っているので読みにくいです。 必要な項目だけを手で書きます。

bash
$ nano dist.json
{
  "DistributionConfig": {
    "CallerReference": "obmes-lab-2026-10-06",
    "Comment": "学習用。実際には作成しません",
    "Enabled": true,

    "Aliases": {
      "Quantity": 0,
      "Items": []
    },

    "Origins": {
      "Quantity": 2,
      "Items": [
        {
          "Id": "static-s3",
          "DomainName": "obmes-lab-static.s3.ap-northeast-1.amazonaws.com",
          "S3OriginConfig": { "OriginAccessIdentity": "" }
        },
        {
          "Id": "app-server",
          "DomainName": "app.example.com",
          "CustomOriginConfig": {
            "HTTPPort": 80,
            "HTTPSPort": 443,
            "OriginProtocolPolicy": "https-only"
          }
        }
      ]
    },

    "DefaultCacheBehavior": {
      "TargetOriginId": "app-server",
      "ViewerProtocolPolicy": "redirect-to-https",
      "AllowedMethods": {
        "Quantity": 7,
        "Items": ["GET","HEAD","OPTIONS","PUT","POST","PATCH","DELETE"],
        "CachedMethods": { "Quantity": 2, "Items": ["GET","HEAD"] }
      },
      "MinTTL": 0,
      "DefaultTTL": 0,
      "MaxTTL": 0,
      "Compress": true,
      "ForwardedValues": {
        "QueryString": true,
        "Cookies": { "Forward": "all" },
        "Headers": { "Quantity": 1, "Items": ["Authorization"] }
      }
    },

    "CacheBehaviors": {
      "Quantity": 2,
      "Items": [
        {
          "PathPattern": "/assets/*",
          "TargetOriginId": "static-s3",
          "ViewerProtocolPolicy": "redirect-to-https",
          "AllowedMethods": {
            "Quantity": 2,
            "Items": ["GET","HEAD"],
            "CachedMethods": { "Quantity": 2, "Items": ["GET","HEAD"] }
          },
          "MinTTL": 86400,
          "DefaultTTL": 31536000,
          "MaxTTL": 31536000,
          "Compress": true,
          "ForwardedValues": {
            "QueryString": false,
            "Cookies": { "Forward": "none" },
            "Headers": { "Quantity": 0, "Items": [] }
          }
        },
        {
          "PathPattern": "/api/*",
          "TargetOriginId": "app-server",
          "ViewerProtocolPolicy": "https-only",
          "AllowedMethods": {
            "Quantity": 7,
            "Items": ["GET","HEAD","OPTIONS","PUT","POST","PATCH","DELETE"],
            "CachedMethods": { "Quantity": 2, "Items": ["GET","HEAD"] }
          },
          "MinTTL": 0,
          "DefaultTTL": 0,
          "MaxTTL": 0,
          "Compress": true,
          "ForwardedValues": {
            "QueryString": true,
            "Cookies": { "Forward": "all" },
            "Headers": { "Quantity": 2, "Items": ["Authorization","Origin"] }
          }
        }
      ]
    },

    "ViewerCertificate": {
      "CloudFrontDefaultCertificate": true
    },

    "Restrictions": {
      "GeoRestriction": { "RestrictionType": "none", "Quantity": 0 }
    },

    "PriceClass": "PriceClass_200",

    "Logging": {
      "Enabled": false,
      "IncludeCookies": false,
      "Bucket": "",
      "Prefix": ""
    },

    "WebACLId": ""
  }
}

上から読みます。

場所読み方
CallerReference同じ値で2回投げても、2個作られないための札。 一意ならなんでもよい
Origins.Items[]元データの場所を、複数登録できる。 Id は後でビヘイビアから指す名前
S3OriginConfigS3 をオリジンにするとき
CustomOriginConfigS3 以外はすべてこっち。 EC2 でも、他社のサーバーでもよい
OriginProtocolPolicyCloudFront からオリジンへの通信をどうするか。利用者との通信とは別
ViewerProtocolPolicy利用者から CloudFront への通信をどうするか
MinTTL / DefaultTTL / MaxTTL④でやります
ForwardedValuesこれがキャッシュキーの中身。 ②の山場
AllowedMethods / CachedMethods通してよいメソッドと、保存してよいメソッド。保存されるのは GET / HEAD だけ
PathPatternこのビヘイビアが担当するパスの形
ViewerCertificate③の証明書。既定の証明書のままなら d111....cloudfront.net でしか見られない
PriceClass世界のどの範囲の拠点を使うか。 範囲を狭めると安くなる代わりに、遠い国から遅くなる

ビヘイビアは上から順にマッチする

ここが、いちばん事故りやすい場所です。

リクエストが来ると、CloudFront はこう判断します。

リクエスト: /assets/logo.png

  1. CacheBehaviors[0] の PathPattern "/assets/*" と比べる → 一致 → ここで決定、終わり
  2. CacheBehaviors[1] の PathPattern "/api/*"    → 見ない
  3. DefaultCacheBehavior                          → 見ない
リクエスト: /mypage

  1. "/assets/*" → 一致しない
  2. "/api/*"    → 一致しない
  3. DefaultCacheBehavior → ここに落ちる

DefaultCacheBehavior は「既定値」ではなく「最後のビヘイビア」です。 どれにも当たらなかったものが、全部ここに来ます。

そして、順番を入れ替えると挙動が変わります。

【危険な並び】
  1. "/*"          ← ここで全部拾ってしまう
  2. "/api/*"      ← 永久に到達しない

「広いパターンを上に置くと、下は死にます。」 私がやった事故はこれではありませんでしたが、設定を直すときに一度これを踏みました。

並べ替えの鉄則: 上から「狭い → 広い」の順にする。 DefaultCacheBehavior は必ずいちばん下(というより、外側)にある。

LocalStack に投げてみる

まず LocalStack を立てます。

bash
$ nano compose.yml
services:
  localstack:
    image: localstack/localstack:3.8
    ports:
      - "4566:4566"
    environment:
      - SERVICES=cloudfront,s3
      - DEBUG=1

  origin:
    image: nginx:1.27-alpine
    volumes:
      - ./origin.conf:/etc/nginx/conf.d/default.conf:ro

  edge:
    image: nginx:1.27-alpine
    depends_on:
      - origin
    ports:
      - "8080:8080"
      - "8081:8081"
      - "8082:8082"
      - "8083:8083"
    volumes:
      - ./edge.conf:/etc/nginx/conf.d/default.conf:ro

origin に ports: がありません。 これは書き忘れではありません。 edge からは Docker のネットワーク内で http://origin として届きますが、VM の外からは触れません。 ⑦の OAC の話と、同じ形です。

まずは LocalStack だけ動かします。

bash
$ docker compose up -d localstack
$ docker compose logs -f localstack | head -20
localstack-1  | LocalStack version: 3.8.1
localstack-1  | Ready.

毎回 --endpoint-url を書くのは面倒なので、別名を作ります。

bash
$ alias awsl='aws --endpoint-url=http://localhost:4566 --region ap-northeast-1'
$ export AWS_ACCESS_KEY_ID=test
$ export AWS_SECRET_ACCESS_KEY=test

test / test は LocalStack が受け付けるダミーです。 本物のアクセスキーは絶対に使いません。

では、投げます。

bash
$ awsl cloudfront create-distribution --cli-input-json file://dist.json
An error occurred (InternalFailure) when calling the CreateDistribution operation:
API for service 'cloudfront' not yet implemented or pro feature - please check
https://docs.localstack.cloud/references/coverage/ for further information.

動きません。

LocalStack のコミュニティ版に CloudFront は入っていません。 有償版(Pro)の機能です。この記事では、ここから先を LocalStack で確かめることはできません。

それでも収穫はあります。

このエラーは「JSONを読み終えて、サーバーに送った後」に出ています。 つまり、JSONの形が壊れていたら、その前に別のエラーで止まります。

わざと壊して確かめます。

bash
$ jq '.DistributionConfig.Origins.Quantity = 5' dist.json > broken.json
$ awsl cloudfront create-distribution --cli-input-json file://broken.json
An error occurred (InconsistentQuantities) when calling the CreateDistribution operation: ...

別のこわし方もします。

bash
$ sed 's/"Enabled": true/"Enabled": "yes"/' dist.json > broken2.json
$ awsl cloudfront create-distribution --cli-input-json file://broken2.json
Parameter validation failed:
Invalid type for parameter DistributionConfig.Enabled, value: yes,
type: <class 'str'>, valid types: <class 'bool'>

こちらは「Parameter validation failed」で、通信する前に止まっています。

CloudFront が動かなくても、「設定JSONが正しい形かどうか」は手元で検証できます。 この記事の前半の目的は、それで達成できます。

なお、Quantity と Items の長さが合っていないと InconsistentQuantities になります。 CloudFront の JSON は、配列の要素数を自分で書く形式です。 手で書くとき、ここを必ず間違えます。

スクリーンショットを撮ってください: 01_cloudfront_not_implemented.png create-distribution が Pro 機能だと言って断ってくる画面。「動かないものは動かない」と分かる記録として残します。


② キャッシュキーに何を含めるか

ここが、この記事の中心です。

キャッシュは「URL → 答え」の対応表ではありません。 「キャッシュキー → 答え」の対応表です。

キャッシュキーに何を入れるかは、自分で決めます。 そして、入れるものを増やすほど、キーの種類が増えます。

候補は4つ

含める候補含めるとどうなるか
パス(/api/items)必ず含まれる。 外せない
クエリ文字列(?q=book&page=2)含めないと、?page=2 を開いても1ページ目が返る。含めると、値の組み合わせの数だけ別物になる
ヘッダ(Accept-Language など)含めると、言語ごとに別々に保存できる。User-Agent を含めると、端末の種類だけキーが増えて壊滅する
Cookie(session=...)含めると、利用者ごとに別のキーになる。ヒット率はほぼ0になる

「安全にしたい」と思って全部含めると、キャッシュが効かなくなります。 「速くしたい」と思って何も含めないと、②の事故(他人のページ)が起きます。

この2つの間のどこに置くかが、CloudFront の設定の本体です。

CloudFront ではどう書くか

古い書き方(ForwardedValues)と、新しい書き方(キャッシュポリシー)があります。

"ForwardedValues": {
  "QueryString": true,
  "Cookies": { "Forward": "all" },
  "Headers": { "Quantity": 1, "Items": ["Authorization"] }
}

これが「クエリ文字列は全部・Cookie は全部・Authorization ヘッダも」キーに含める、という意味です。

Cookies.Forward: "all" は、いちばん重い設定です。 利用者ごとにキーが分かれるので、キャッシュはほとんど当たりません。

新しい書き方では、これを「キャッシュポリシー」という名前付きの部品に切り出します。

"DefaultCacheBehavior": {
  "TargetOriginId": "app-server",
  "ViewerProtocolPolicy": "redirect-to-https",
  "CachePolicyId": "4135ea2d-6df8-44a3-9df3-4b5a84be39ad",
  "OriginRequestPolicyId": "216adef6-5c7f-47e4-b989-5492eafa07d3"
}

ここで大事なのは、「キャッシュキーに含める」と「オリジンへ転送する」が分かれたことです。

ポリシー何を決めるか
キャッシュポリシーキャッシュキーに何を含めるか(=別物として保存するかどうか)
オリジンリクエストポリシーオリジンへ何を渡すか(キーには含めない)

この分離が、実務ではとても効きます。

例: Cookie はオリジンに渡したいが、キャッシュキーには入れたくない。 古い書き方ではできませんでした。新しい書き方ならできます。

ただし「Cookie を渡すのにキーに入れない」は、③の事故そのものです。 やるなら、オリジンが Cache-Control: private を返すことが前提になります。

nginx に翻訳して、実測する

CloudFront は動かせないので、同じ設定を nginx でやります。

CloudFrontnginx
キャッシュキーの構成proxy_cache_key
DefaultTTLproxy_cache_valid
オリジンのヘッダを無視するproxy_ignore_headers
ヒットしたかどうか$upstream_cache_status
ビヘイビアのパスパターンlocation

まず、オリジン役を書きます。

bash
$ nano origin.conf
server {
    listen 80;
    default_type text/plain;

    # 何度呼ばれたかを見るための番号
    add_header X-Origin-Hit $msec always;

    # 検索結果のようなもの。クエリ文字列で内容が変わる
    location /api/items {
        add_header Cache-Control "public, max-age=60" always;
        return 200 "items q=$arg_q\n";
    }

    # 誰にでも同じもの
    location /assets/ {
        add_header Cache-Control "public, max-age=31536000, immutable" always;
        return 200 "asset $uri\n";
    }

    # ⚠️ 個人向けのページ。Cookie の中身で内容が変わる
    location /mypage {
        add_header Cache-Control "private, no-store" always;
        return 200 "ようこそ $cookie_session さん\n";
    }

    # Cache-Control を「返さない」ページ(④で使う)
    location /nocachecontrol {
        return 200 "no cache-control header\n";
    }
}

$cookie_session は、Cookie: session=... の値をそのまま出す nginx の変数です。 ログイン機構は作りません。「Cookie で内容が変わるページ」を1行で作るための代用です。

次にエッジ役です。ここでキャッシュキーを3通り作ります。

bash
$ nano edge.conf
proxy_cache_path /tmp/c_path  levels=1:2 keys_zone=k_path:10m  max_size=64m inactive=10m;
proxy_cache_path /tmp/c_query levels=1:2 keys_zone=k_query:10m max_size=64m inactive=10m;
proxy_cache_path /tmp/c_cook  levels=1:2 keys_zone=k_cook:10m  max_size=64m inactive=10m;

# 8080: キー = パスだけ
server {
    listen 8080;
    location / {
        proxy_pass       http://origin;
        proxy_cache      k_path;
        proxy_cache_key  "$scheme$request_method$host$uri";
        proxy_cache_valid 200 60s;
        add_header X-Cache-Status $upstream_cache_status always;
    }
}

# 8081: キー = パス + クエリ文字列
server {
    listen 8081;
    location / {
        proxy_pass       http://origin;
        proxy_cache      k_query;
        proxy_cache_key  "$scheme$request_method$host$request_uri";
        proxy_cache_valid 200 60s;
        add_header X-Cache-Status $upstream_cache_status always;
    }
}

# 8082: キー = パス + クエリ文字列 + Cookie
server {
    listen 8082;
    location / {
        proxy_pass       http://origin;
        proxy_cache      k_cook;
        proxy_cache_key  "$scheme$request_method$host$request_uri$http_cookie";
        proxy_cache_valid 200 60s;
        add_header X-Cache-Status $upstream_cache_status always;
    }
}

$uri はクエリ文字列を含みません。$request_uri は含みます。 この1文字違いが、8080 と 8081 の差です。

立てます。

bash
$ docker compose up -d
$ docker compose ps
NAME              IMAGE                    STATUS         PORTS
cf-edge-1         nginx:1.27-alpine        Up 3 seconds   0.0.0.0:8080-8083->8080-8083/tcp
cf-localstack-1   localstack/localstack:3.8 Up 2 minutes  0.0.0.0:4566->4566/tcp
cf-origin-1       nginx:1.27-alpine        Up 3 seconds

origin に PORTS が無いことを確認してください。 外からは触れません。

bash
$ curl -s -m 3 http://localhost:80/api/items || echo "オリジンには直接届かない"
オリジンには直接届かない

動きを1回だけ見る

bash
$ curl -s -D - -o /dev/null http://localhost:8080/api/items | grep -i x-cache
$ curl -s -D - -o /dev/null http://localhost:8080/api/items | grep -i x-cache
X-Cache-Status: MISS
X-Cache-Status: HIT

1回目は MISS、2回目は HIT。 CloudFront のアクセスログにある x-edge-result-type と、同じ意味の値です。

100回投げて、ヒット率を数える

測定用のスクリプトを書きます。

bash
$ nano bench.sh
bash
#!/bin/sh
  # 使い方: ./bench.sh <ポート> <モード>
  PORT=$1
  MODE=$2
  HIT=0
  MISS=0

  i=1
  while [ $i -le 100 ]; do
    case "$MODE" in
      plain)  URL="http://localhost:$PORT/api/items"; COOKIE="" ;;
      query)  URL="http://localhost:$PORT/api/items?q=$((i % 5))"; COOKIE="" ;;
      cookie) URL="http://localhost:$PORT/api/items?q=1"; COOKIE="session=user$((i % 97))" ;;
    esac

    if [ -n "$COOKIE" ]; then
      S=$(curl -s -D - -o /dev/null -b "$COOKIE" "$URL" | grep -i '^x-cache-status' | tr -d '\r' | awk '{print $2}')
    else
      S=$(curl -s -D - -o /dev/null "$URL" | grep -i '^x-cache-status' | tr -d '\r' | awk '{print $2}')
    fi

    if [ "$S" = "HIT" ]; then HIT=$((HIT+1)); else MISS=$((MISS+1)); fi
    i=$((i+1))
  done

  echo "port=$PORT mode=$MODE  HIT=$HIT  MISS=$MISS  ヒット率=$HIT%"
bash
$ chmod +x bench.sh

cookie モードの i % 97 は、100回のうち3回だけ同じ利用者が再訪する、という意味です。 実際のサイトでも「同じ人が短時間に何度も同じURLを開く」ことは、そう多くありません。

キャッシュを空にしてから測ります。

bash
$ docker compose restart edge
$ sleep 2
$ ./bench.sh 8080 plain
port=8080 mode=plain  HIT=99  MISS=1  ヒット率=99%
bash
$ docker compose restart edge
$ sleep 2
$ ./bench.sh 8081 query
port=8081 mode=query  HIT=95  MISS=5  ヒット率=95%
bash
$ docker compose restart edge
$ sleep 2
$ ./bench.sh 8082 cookie
port=8082 mode=cookie  HIT=3  MISS=97  ヒット率=3%

結果

キャッシュキーの構成CloudFront での設定100回中のHITヒット率
パスだけQueryString: false / Cookies: none9999%
パス + クエリ文字列QueryString: true / Cookies: none9595%
パス + クエリ + CookieQueryString: true / Cookies: all33%

同じサイト、同じリクエスト数、同じオリジン。違うのはキーの作り方だけです。

「Cookie を全部キーに含める」は、キャッシュを事実上OFFにするのと同じです。 設定画面では、チェックボックス1つの違いにしか見えません。

もう1つ、大事なことがあります。

bash
$ docker compose restart edge
$ sleep 2
$ ./bench.sh 8081 plain
port=8081 mode=plain  HIT=99  MISS=1  ヒット率=99%

クエリ文字列をキーに含める設定でも、クエリが付かないリクエストは普通に当たります。 問題は「含めること」自体ではなく、「値の種類がいくつあるか」です。

含めるもの値の種類危険度
?page=1..1010通り低い。 10倍になるだけ
Accept-Language数十通り中。 言語を絞れば実用的
?utm_source=...無限高い。広告の流入で無限にキーが増える
User-Agentほぼ無限極めて高い
Cookie(セッション)利用者の数だけ極めて高い

utm_source のような広告用のパラメータは、キャッシュキーから外すのが定石です。 内容が1文字も変わらないのに、別物として保存されるからです。

スクリーンショットを撮ってください: 02_cache_key_hit_rate.png 3回の bench.sh の結果が縦に並んだ画面。99% → 95% → 3% が1画面に入っている状態が理想です。


③ 事故の形:個人向けのページがキャッシュされる

冒頭の事故を、再現します。

危険な設定を書く

8083番に、「オリジンのキャッシュ指示を無視して、Cookie もキーに入れない」エッジを立てます。

bash
$ nano edge.conf

ファイルの末尾に、次を足します。

proxy_cache_path /tmp/c_bad levels=1:2 keys_zone=k_bad:10m max_size=64m inactive=10m;

# 8083: ⚠️ わざと危険にした設定
server {
    listen 8083;
    location / {
        proxy_pass       http://origin;
        proxy_cache      k_bad;
        proxy_cache_key  "$scheme$request_method$host$request_uri";

        # ⚠️ オリジンの Cache-Control を無視する
        proxy_ignore_headers Cache-Control Set-Cookie Expires;
        proxy_cache_valid 200 300s;

        add_header X-Cache-Status $upstream_cache_status always;
    }
}

proxy_cache_path は http ブロックの直下に書く必要があります。 server の中に書くと起動しません。 上の3行のうち proxy_cache_path の行は、ファイル先頭の他の proxy_cache_path と同じ場所に置いてください。

proxy_ignore_headers Cache-Control は、CloudFront の 「オリジンのキャッシュヘッダを見ずに、最小TTLを効かせる」設定に相当します。

bash
$ docker compose restart edge
$ sleep 2

事故を起こす

まず、alice がログイン後のページを開きます。

bash
$ curl -s -D - -b "session=alice" http://localhost:8083/mypage | grep -Ei 'x-cache|ようこそ'
X-Cache-Status: MISS
ようこそ alice さん

正しく alice のページが返りました。 次に、bob が同じURLを開きます。

bash
$ curl -s -D - -b "session=bob" http://localhost:8083/mypage | grep -Ei 'x-cache|ようこそ'
X-Cache-Status: HIT
ようこそ alice さん

bob の画面に alice の名前が出ました。

さらに、Cookie を持っていない人でも見えます。

bash
$ curl -s http://localhost:8083/mypage
ようこそ alice さん

これが、冒頭で私が起こした事故です。 ダミーの名前なので実害はありませんが、本番なら情報の漏えいです。

スクリーンショットを撮ってください: 03_other_users_page.png session=bob で叩いたのに ようこそ alice さん が返っている行。この1行が事故の全部です。

直し方は2つしかない

この事故は、突き詰めると2通りの直し方しかありません。

直し方nginxCloudFront副作用
A: キャッシュしないproxy_no_cache / TTL を 0 にビヘイビアの TTL を全部0(キャッシュ無効ポリシー)速くならない
B: Cookie をキーに含めるproxy_cache_key に $http_cookieCookie をキャッシュキーに含めるヒット率が②の3%になる

Aを試します。

# 8083 の location の中に、次の2行を足す
proxy_no_cache     $cookie_session;
proxy_cache_bypass $cookie_session;
bash
$ docker compose restart edge
$ sleep 2
$ curl -s -D - -b "session=alice" http://localhost:8083/mypage | grep -Ei 'x-cache|ようこそ'
$ curl -s -D - -b "session=bob"   http://localhost:8083/mypage | grep -Ei 'x-cache|ようこそ'
X-Cache-Status: BYPASS
ようこそ alice さん
X-Cache-Status: BYPASS
ようこそ bob さん

直りました。 ただし、このページは二度と速くなりません。

Bも試します(8082番が、まさにその設定です)。

bash
$ curl -s -D - -b "session=alice" http://localhost:8082/mypage | grep -Ei 'x-cache|ようこそ'
$ curl -s -D - -b "session=bob"   http://localhost:8082/mypage | grep -Ei 'x-cache|ようこそ'
$ curl -s -D - -b "session=alice" http://localhost:8082/mypage | grep -Ei 'x-cache|ようこそ'
X-Cache-Status: MISS
ようこそ alice さん
X-Cache-Status: MISS
ようこそ bob さん
X-Cache-Status: HIT
ようこそ alice さん

これも正しい。 alice が2回目に開いたときだけ HIT します。

Bは「alice のための保存」が alice にしか使われないので、キャッシュとしての価値はほとんどありません。

本筋は、オリジンが Cache-Control: private を返すこと

AもBも、エッジ側の設定です。 エッジの設定は、忘れます。増やします。ずれます。

本当に守るべき形は、これです。

location /mypage {
    add_header Cache-Control "private, no-store" always;
    ...
}

そして、エッジ側では proxy_ignore_headers Cache-Control を書かない。

8080番(普通の設定)で確かめます。

bash
$ curl -s -D - -b "session=alice" http://localhost:8080/mypage | grep -Ei 'x-cache|ようこそ'
$ curl -s -D - -b "session=bob"   http://localhost:8080/mypage | grep -Ei 'x-cache|ようこそ'
X-Cache-Status: MISS
ようこそ alice さん
X-Cache-Status: MISS
ようこそ bob さん

キーは「パスだけ」なのに、事故は起きません。 オリジンが private, no-store を返していて、エッジがそれに従っているからです。

「誰に見せてよいか」を知っているのは、オリジンだけです。 エッジは知りません。だから、エッジ側の設定で守ろうとすると、いつか間違えます。

どこで守るか強さ
オリジンが Cache-Control: private を返すいちばん強い。 CDN を替えても効く
エッジの TTL を0にする設定を変えると壊れる
エッジのキャッシュキーに Cookie を含める設定を変えると壊れる

この考え方は 更新したのに古い値が返る — システム設計深掘り と同じです。 「キャッシュの正しさは、データを持っている側が決める」。


④ TTL は3つある

設定JSONにあった、この3つです。

"MinTTL": 0,
"DefaultTTL": 86400,
"MaxTTL": 31536000

名前から想像すると「最小・標準・最大」ですが、どれが使われるかは条件で変わります。

オリジンが返す Cache-Control実際に使われる保存時間
何も返さないDefaultTTL
max-age=30(MinTTL=60 より小さい)MinTTL(60秒)。オリジンの指示より長く持たれる
max-age=3600(MinTTL と MaxTTL の間)3600秒。オリジンの指示どおり
max-age=99999999(MaxTTL より大きい)MaxTTL
no-cache / no-store / private かつ MinTTL=0保存しない(正しい挙動)
no-cache / no-store / private かつ MinTTL>0保存される。③の事故

最後の行が、いちばん危険です。

MinTTL は「最低これだけは持て」という命令です。 オリジンが「持つな」と言っていても、MinTTL が0でなければ持ちます。

私が事故を起こしたのは、まさにここでした。 「速くしたいから、最小TTLを大きめにしておこう」と思っただけでした。

nginx で確かめる

「オリジンが Cache-Control を返さない場合」を見ます。

bash
$ curl -s -D - -o /dev/null http://localhost:8080/nocachecontrol | grep -i x-cache
$ curl -s -D - -o /dev/null http://localhost:8080/nocachecontrol | grep -i x-cache
X-Cache-Status: MISS
X-Cache-Status: HIT

オリジンは何も言っていないのに、60秒保存されました。 proxy_cache_valid 200 60s; が効いています。これが DefaultTTL です。

次に、「オリジンが短い時間を指定した場合」。

bash
$ curl -s -D - -o /dev/null http://localhost:8080/api/items | grep -iE 'x-cache|age'
X-Cache-Status: HIT
Age: 12

Age は「保存されてから何秒経ったか」です。 CloudFront のレスポンスにも Age が付きます。 これで「いま何秒目のキャッシュを見せられているか」が分かります。

max-age=60 が過ぎるとどうなるか、待って確かめます。

bash
$ curl -s -D - -o /dev/null http://localhost:8080/api/items | grep -i x-cache

61秒待ってから、もう一度。

X-Cache-Status: EXPIRED

EXPIRED は「持っていたが古くなったので取り直した」という意味です。 CloudFront のログでいう RefreshHit に近い状態です。

実務での決め方

対象MinTTLDefaultTTLMaxTTL理由
/assets/*(ハッシュ付きファイル)長い長い長い中身が変わったらファイル名が変わるので、永久でよい
HTML0短い(数分)短い名前を変えられないので、短く持つしかない
/api/*000オリジンの指示に完全に従わせる
画像(名前が固定)0中くらい中くらい差し替えたら無効化する

MinTTL: 0 は「キャッシュしない」ではありません。 「オリジンの指示を無条件に尊重する」という意味です。 ここを長く誤解していました。


⑤ 無効化(Invalidation)は、使わずに済ませる

保存されたものを消したいときは、無効化を投げます。

bash
$ awsl cloudfront create-invalidation \
    --distribution-id E1EXAMPLE12345 \
    --paths "/index.html" "/assets/style.css"
An error occurred (InternalFailure) when calling the CreateInvalidation operation:
API for service 'cloudfront' not yet implemented or pro feature ...

これも LocalStack では動きません。 形だけ読みます。

JSONで書くと、こうです。

{
  "DistributionId": "E1EXAMPLE12345",
  "InvalidationBatch": {
    "CallerReference": "invalidate-2026-10-06-1",
    "Paths": {
      "Quantity": 2,
      "Items": ["/index.html", "/assets/style.css"]
    }
  }
}

そして、無効化には3つの性質があります。

性質内容
すぐには反映しない世界中の拠点に伝わるまで待つ。 数分かかることがある
回数に上限がある月に一定の本数を超えると課金される。 数字は公式の料金ページを見てください
/* は1本と数えるただし全部消えるので、その後しばらくオリジンに負荷が集中する

無効化は「デプロイのたびに叩くもの」ではありません。 叩かなくて済むように設計するのが本筋です。

無効化しない設計=ファイル名にハッシュを付ける

やることは1つです。 中身が変わったら、ファイル名も変える。

【悪い】
  /assets/style.css        ← 中身を変えても名前が同じ → 無効化が必要

【良い】
  /assets/style.8f3a2c91.css   ← 中身を変えると名前が変わる → 無効化が不要

これはビルドツールが自動でやってくれます。 dist/ の中身は何なのか — ビルドツールとVite で出てきた dist/ の中の、あの謎の文字列がこれです。

手元でも確かめられます。

bash
$ echo "body { color: red }" > style.css
$ sha256sum style.css | cut -c1-8
$ echo "body { color: blue }" > style.css
$ sha256sum style.css | cut -c1-8
d92e15bd
35f08b45

1文字変えるだけで、名前が変わります。 だから古い名前のファイルは、誰も取りに来ません。

すると、こう設定できます。

{
  "PathPattern": "/assets/*",
  "MinTTL": 86400,
  "DefaultTTL": 31536000,
  "MaxTTL": 31536000
}

1年キャッシュしてよくなります。 無効化は、一度も要りません。

HTML だけは、名前を変えられない

問題があります。

https://example.com/ を開いたときに返る HTML の名前は、変えられません。 変えたら、URLが変わってしまうからです。

そして HTML の中には、ハッシュ付きのファイル名が書いてあります。

<link rel="stylesheet" href="/assets/style.35f08b45.css">

HTML が古いままだと、新しい CSS は永久に読まれません。

ファイル名前を変えられるかTTL
CSS / JS / 画像(ハッシュ付き)変えられる長くてよい(1年)
HTML変えられない短くする(数分)か、キャッシュしない

「ハッシュ付きは永久、HTMLは短命」。 これが、無効化を使わずに済ませるための、ほぼ唯一の型です。

nginx でも同じことをやってみます。

bash
$ curl -s -D - -o /dev/null http://localhost:8080/assets/style.35f08b45.css | grep -i cache-control
Cache-Control: public, max-age=31536000, immutable

immutable は「有効期限内は、更新チェックすらするな」という指示です。 ハッシュ付きファイルにだけ付けられます。

どうしても消したいときの、nginx 側の逃げ道も見ておきます。

bash
$ docker compose exec edge sh -c 'ls /tmp/c_path | head'
$ docker compose exec edge sh -c 'rm -rf /tmp/c_path/*'
$ curl -s -D - -o /dev/null http://localhost:8080/api/items | grep -i x-cache
X-Cache-Status: MISS

無料版の nginx には「1つだけ消す」機能がありません。 フォルダごと消すしかありません。 「消すのが難しい」という点は、CloudFront も nginx も同じです。


⑥ Lambda@Edge と CloudFront Functions

「配信の途中で自分のコードを動かす」仕組みが、2つあります。 名前が似ていますが、別物です。片方がもう片方の上位互換でもありません。

CloudFront FunctionsLambda@Edge
動く場所エッジ拠点そのもの(利用者にいちばん近い)リージョン別のエッジ(少し奥)
使える言語JavaScript のみ(専用の実行環境)Node.js / Python
実行時間の上限1ミリ秒規模秒規模
使えるメモリとても小さい大きい
ネットワークアクセスできないできる(DBやAPIを呼べる)
フックできる場所利用者側の2箇所だけ4箇所すべて
本文(body)を触れるか触れない触れる
デプロイ速い世界に配るのに時間がかかる
書く場所の制約なしバージニア北部で作る必要がある
値段非常に安いFunctions より高い(料金ページ)

フックできる4箇所

利用者 ──①──> CloudFront ──②──> オリジン
                            <──③──
       <──④──

  ① viewer request   : 利用者から来た瞬間          (Functions ○ / Lambda@Edge ○)
  ② origin request   : キャッシュに無くて取りに行く前(Functions × / Lambda@Edge ○)
  ③ origin response  : オリジンから返ってきた直後   (Functions × / Lambda@Edge ○)
  ④ viewer response  : 利用者に返す直前            (Functions ○ / Lambda@Edge ○)

①④は「毎リクエスト」、②③は「キャッシュが外れたときだけ」動きます。 呼ばれる回数がまったく違うので、値段も違います。

Functions で書けるもの

軽い書き換えだけです。 たとえば、末尾に index.html を足す処理。

function handler(event) {
    var request = event.request;
    var uri = request.uri;

    // /about/ → /about/index.html
    if (uri.endsWith('/')) {
        request.uri = uri + 'index.html';
    }
    // /about → /about/index.html
    else if (!uri.includes('.')) {
        request.uri = uri + '/index.html';
    }

    return request;
}

これは S3 を CloudFront で配るときに、ほぼ必ず要ります。 S3 は「フォルダを開いたら index.html を返す」という動きを、CloudFront 経由ではしてくれないからです。

もう1つ、よくあるのがヘッダの追加です。

function handler(event) {
    var response = event.response;
    var headers = response.headers;

    headers['strict-transport-security'] = { value: 'max-age=31536000' };
    headers['x-content-type-options']    = { value: 'nosniff' };
    headers['referrer-policy']           = { value: 'strict-origin-when-cross-origin' };

    return response;
}

このヘッダの意味は 自分のページをCSPで壊す — Webの防御ヘッダ にあります。

ただし、これは「レスポンスヘッダポリシー」という設定でもできます。 コードを書かずに済むなら、書かないほうがよいです。

nginx で同じことをやってみる

①のURL書き換えは、nginx なら1行です。

location / {
    rewrite ^(/[^.]*[^/])$ $1/index.html last;
    ...
}

CloudFront Functions がやっているのは、これと同じ次元の処理です。 「軽い書き換え専用」というのは、そういう意味です。

判断の順番

1. 設定(レスポンスヘッダポリシー・リダイレクト)で済むか → 済むならコードを書かない 2. 済まないなら CloudFront Functions で書けるか → 書けるなら Functions 3. どうしても足りない(DBを見る・本文を書き換える)→ Lambda@Edge

最初から Lambda@Edge を選ぶと、デプロイの遅さで確実に後悔します。 Lambda そのものの考え方は 待っている時間に課金されない — サーバーレスとLambda にあります。


⑦ 守る側の設定

CloudFront は「速くする道具」だと思っていましたが、実際には「守る道具」としてのほうが効きます。

OAC:S3 を公開しないまま配信する

静的サイトを S3 で公開する方法は、2つあります。

方法S3 の状態問題
S3 の静的ウェブサイトホスティングバケットを公開するHTTPS が張れない。バケットのURLが直接叩ける
CloudFront + OACバケットは非公開のままこれが正しい形

OAC は、こう作ります。

bash
$ awsl cloudfront create-origin-access-control \
    --origin-access-control-config '{
      "Name": "obmes-lab-oac",
      "SigningProtocol": "sigv4",
      "SigningBehavior": "always",
      "OriginAccessControlOriginType": "s3"
    }'
An error occurred (InternalFailure) when calling the CreateOriginAccessControl operation:
API for service 'cloudfront' not yet implemented or pro feature ...

これも動きません。 形だけ読みます。

そして、S3 側にはこういうポリシーを付けます。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowCloudFrontOnly",
      "Effect": "Allow",
      "Principal": { "Service": "cloudfront.amazonaws.com" },
      "Action": "s3:GetObject",
      "Resource": "arn:aws:s3:::obmes-lab-static/*",
      "Condition": {
        "StringEquals": {
          "AWS:SourceArn": "arn:aws:cloudfront::123456789012:distribution/E1EXAMPLE12345"
        }
      }
    }
  ]
}

読み方は、こうです。

行意味
Principal: cloudfront.amazonaws.comCloudFront というサービスに許す
Condition: AWS:SourceArnしかも「このディストリビューション」からだけ。これが無いと、他人の CloudFront からも読めてしまう
Action: s3:GetObject読むだけ。書き込みは許していない

ポリシーの読み方そのものは AccessDeniedに全権限で答えない — AWS深掘り にあります。

S3 のバケットは「ブロックパブリックアクセス」を全部ONのままで構いません。 これが OAC のいちばんの価値です。

⓪で立てた origin コンテナが、まさにこの形でした。

bash
$ docker compose port origin 80 2>/dev/null || echo "origin は外に開いていない"
$ curl -s -m 3 http://localhost:8080/assets/logo.png
origin は外に開いていない
asset /assets/logo.png

元データには直接届かない。エッジ経由でだけ届く。 これが OAC の形です。

署名付きURL / 署名付き Cookie

「誰にでも配る」のではなく、「特定の人にだけ、期限付きで配る」仕組みです。

署名付きURL署名付き Cookie
単位1ファイルごと複数ファイルまとめて
向いている用途ダウンロード用のリンク1本会員向けページ一式・動画配信
URLの見た目長い文字列が付くURLは普通のまま

どちらも「期限」と「条件」が署名の中に埋め込まれています。 署名は改ざんできないので、期限を書き換えて延ばすことはできません。

注意点があります。

署名付きURLをキャッシュキーに含めると、1人1URLになるのでヒット率が0になります。 署名部分(Signature= など)は、キャッシュキーから外す必要があります。

②でやった「utm パラメータを外す」のと、まったく同じ話です。

地理制限

"Restrictions": {
  "GeoRestriction": {
    "RestrictionType": "whitelist",
    "Quantity": 1,
    "Items": ["JP"]
  }
}
値意味
none制限しない
whitelist書いた国だけ許す
blacklist書いた国だけ拒む

これは「日本国内向けサービス」で、素朴に効きます。 ただし、判定はIPアドレスの国情報なので、完全ではありません。

WAF を前に置ける

CloudFront には、WebACLId という項目があります。

"WebACLId": "arn:aws:wafv2:us-east-1:123456789012:global/webacl/my-acl/xxxxxxxx"

AWS WAF という別のサービスを、CloudFront の前に差し込める、という設定です。 この記事では、その設定項目が存在することだけを紹介します。

「どんな攻撃をどう防ぐか」は、この記事の範囲外です。 知っておくべきなのは、「CloudFront を前に置くと、後からWAFを足せる」という構造だけです。

個人サイトに CloudFront を入れる価値はあるか

判断表です。

状況CloudFront理由
S3 に静的サイトを置き、非公開のまま配りたい入れるOAC が唯一の手段
S3 の静的サイトに、独自ドメインで HTTPS を張りたい入れるS3 単体では張れない
読者が世界中にいる入れる距離の問題はCDNとエッジキャッシュの回で測りました
読者がほぼ国内で、レンタルサーバーで動いている入れない距離が近いので効果が薄く、設定が増えるだけ
GitHub Pages / Netlify などを使っている入れないCDN が最初から入っている(静的サイトは本当に無料で出せる)
動的なサイトを速くしたい要検討キャッシュできる部分がどれだけあるかによる
「なんとなく速くなりそう」入れない③の事故を踏む

私の結論は、「S3 を非公開のまま配りたいとき」と「独自ドメインで HTTPS を張りたいとき」の2つです。 速さは、そのついでに付いてくるものでした。


会社のサイトで、CDNの設定とWAFの運用を自分で抱えきれない場合は、代理店に任せる選択肢もあります。Cloudflareは株式会社ドーモがアカウント開設・DNS切り替えまでの導入作業と日本語の運用サポート(平日10:00-18:30)を行うサービスで、Proは初期アカウント開設費用5万円・初期設定代行費用15万円のほか、月額は想定PV数で決まり1万PV以下で1万円です(2026-11時点、税抜)。最低契約期間は12ヵ月の年間契約で、個人の開発サイトというより社内に専任担当がいない企業向けです。

つまずいたところ

「CloudFront は速くする道具」だと思い込んでいた。 設定画面の項目の半分は、速さと関係がありません。 OAC・証明書・署名付きURL・地理制限・WAF は、全部「守る側」です。この記事を書くまで、速さの設定だけを見て、守る側を全部素通りしていました。

「とりあえず全部キャッシュ」で③の事故を起こした。 原因は最小TTLでした。 「速くしたいから最小TTLを大きめに」と思っただけで、それが「オリジンが持つなと言っても持て」という命令だとは思っていませんでした。設定画面のどこにも警告はありません。

DefaultCacheBehavior を「既定値」だと読んでいた。 違います。「どのパターンにも当たらなかったものが来る、最後のビヘイビア」です。 これを「全体の既定」だと思っていたので、/api/* のビヘイビアを追加したのに設定が効かない理由が分かりませんでした。上のビヘイビアで拾われていました。

キャッシュキーに Cookie を入れて「安全になった」と満足した。 ②で測ったら、ヒット率が3%でした。 キャッシュを入れた意味がゼロです。安全にしたつもりで、CDNの料金だけ払う構成になっていました。

$uri と $request_uri を間違えて、1時間悩んだ。 $uri はクエリ文字列を含みません。 8081番のヒット率が8080番と同じになってしまい、設定が反映されていないと思って docker compose restart を何度も打ちました。変数名を1文字読み違えただけでした。

proxy_cache_path を server の中に書いて、nginx が起動しなかった。 http ブロックの直下にしか書けません。 docker compose logs edge を見るまで、コンテナが黙って終了している理由が分かりませんでした。docker compose ps に出てこないときは、必ずログを見る。

LocalStack で CloudFront が動かないと分かって、記事を諦めかけた。 コミュニティ版には入っていません。 ですが、--generate-cli-skeleton と、CLIの送信前のパラメータ検証は AWS に繋がなくても動きます。「動かす」を諦めて「読めるようにする」に目的を変えたら、むしろ設定JSONを1行ずつ読むことになって、理解が深くなりました。

無効化を「デプロイのたびに叩くもの」だと思っていた。 回数に上限があり、超えると課金されます。 そして反映も即時ではありません。ビルドツールが dist/ に出していたハッシュ付きのファイル名が、この問題を解くために存在していたのだと、ここで初めて繋がりました。


後片づけ

立てたものを全部消します。

まず、何が動いているか確認します。

bash
$ cd ~/awslab/cf
$ docker compose ps
NAME              IMAGE                     STATUS         PORTS
cf-edge-1         nginx:1.27-alpine         Up 41 minutes  0.0.0.0:8080-8083->8080-8083/tcp
cf-localstack-1   localstack/localstack:3.8 Up 45 minutes  0.0.0.0:4566->4566/tcp
cf-origin-1       nginx:1.27-alpine         Up 41 minutes

-v を付けて落とします。 ボリュームも一緒に消えます。

bash
$ docker compose down -v
[+] Running 5/5
 ✔ Container cf-edge-1        Removed
 ✔ Container cf-origin-1      Removed
 ✔ Container cf-localstack-1  Removed
 ✔ Volume    cf_default       Removed
 ✔ Network   cf_default       Removed

残っていないか確認します。

bash
$ docker ps -a
$ docker volume ls
CONTAINER ID   IMAGE   COMMAND   CREATED   STATUS   PORTS   NAMES
DRIVER    VOLUME NAME

イメージも消したければ、こうします。

bash
$ docker image rm localstack/localstack:3.8 nginx:1.27-alpine

作業フォルダも消します。

bash
$ cd ~
$ rm -rf ~/awslab/cf

別名も解除しておきます。

bash
$ unalias awsl
$ unset AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY

本物のAWSには、一度も接続していません。 課金される操作は1つもしていないので、コンソールで消すものもありません。


まとめ — 理解できたこと

  • CloudFront の設定は「オリジン」「ビヘイビア」「証明書」「代替ドメイン名」の4つに分解できる。 画面の項目は、全部そのどれかにぶら下がっている
  • ビヘイビアは上から順にマッチし、最初に当たったところで決まる。 広いパターンを上に置くと、下のビヘイビアは永久に到達しない
  • DefaultCacheBehavior は「既定値」ではなく「最後のビヘイビア」。 どれにも当たらなかったものが、ここに落ちてくる
  • キャッシュは「URL → 答え」ではなく「キャッシュキー → 答え」の対応表。 キーに何を入れるかを決めるのは自分
  • キーの作り方だけで、ヒット率は 99% / 95% / 3% まで変わった。 設定画面ではチェックボックス1つの違いにしか見えない
  • Cookie を全部キーに含めるのは、キャッシュをOFFにするのとほぼ同じ。 「安全にしたつもり」で料金だけ払う構成になる
  • 危険なのは「含めること」ではなく「値の種類が多いこと」。 utm_source や User-Agent は無限に増える
  • 他人のページが配られる事故の直し方は「キャッシュしない」か「Cookie をキーに含める」の二択しかない。 そして本筋は、オリジンが Cache-Control: private を返すこと
  • 「誰に見せてよいか」を知っているのはオリジンだけ。 エッジ側の設定で守ろうとすると、いつか間違える
  • TTL は3つあり、どれが使われるかは「オリジンが Cache-Control を返すかどうか」で変わる。 MinTTL: 0 は「キャッシュしない」ではなく「オリジンの指示を尊重する」
  • MinTTL > 0 は、オリジンの no-store を踏み潰す。 私の事故の原因はここだった
  • 無効化は使うものではなく、使わずに済ませるもの。 ファイル名にハッシュを付ければ、一度も要らない
  • HTML だけは名前を変えられないので、短いTTLかキャッシュしないの二択になる
  • CloudFront Functions と Lambda@Edge は上下関係ではない。 まず設定で済むか、次に Functions、最後に Lambda@Edge の順で考える
  • 個人サイトで CloudFront を入れる価値は、「S3 を非公開のまま配りたい」と「独自ドメインで HTTPS を張りたい」の2つ。 速さはついでだった
  • LocalStack のコミュニティ版に CloudFront は無い。 それでも --generate-cli-skeleton と送信前の検証で、設定JSONは手元で読めるようになる

参考リンク


次に読む

この記事は 【深掘り】AWS の 8 / 16 本目です。

記事
← 前の記事S3のキーとバージョニング — フォルダは存在しない
→ 次の記事Route 53とDNSのTTL — 切り替えたのに古いサーバーへ行く

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

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

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

AWS›AWS — CloudFront
  • キャッシュキーに何を含めるか
  • OAC で S3 を公開せずに配信する

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

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

コメント

コメントする

目次