S3 に置いた静的なサイトを独自ドメインと HTTPS で公開しようとすると、ほぼ必ず前段に Amazon CloudFront が出てきます。
CloudFront は設定項目が多く、キャッシュの持ち方やオリジンの守り方を決めないまま既定値で作ると、古いページが残ったり、S3 の中身が見えたりします。
キャッシュキーと TTL の関係、S3 をオリジンアクセスコントロール(OAC)でだけ読ませる仕組み、課金と落とし穴が分かると、S3 と CloudFront の構成図やテンプレートの意図が読めるようになります。
私は、検索特化サイトの dekinai.dev と個人開発の別のアプリでも CloudFront を使っているので、この 2 つについては実際のテンプレートとワークフローから書きました。
料金の金額は変わりやすいので書いていません。
CloudFrontとは
Amazon CloudFront は、HTML・CSS・JavaScript・画像のような Web のコンテンツを、エッジロケーションと呼ぶ世界中の拠点から配る CDN(コンテンツ配信ネットワーク)です。
利用者のリクエストは、遅延の一番小さいエッジロケーションへ送られます。
そこにコンテンツの写しがあればすぐに返し、無ければ、S3 のバケットや Web サーバーのように元の版を持つオリジンから取ってきて返します。
What is Amazon CloudFront?(Amazon CloudFront 開発者ガイド)
サービスの区分でいえば、サーバーを持たずに設定だけで使うマネージドなサービスで、リージョンを選ばないグローバルのサービスに入ります。
設定の単位はディストリビューションで、作ると d111111abcdef8.cloudfront.net のようなドメイン名が割り当てられ、独自ドメインを別名として足せます。
オリジンに Cache-Control などのヘッダーを付けなければ、ファイルは既定でエッジに 24 時間置かれてから期限切れになります。
リクエストがたどる順番
キャッシュに無いときの流れには、エッジロケーションとオリジンの間にもう 1 段の置き場があります。
- DNS が、利用者に一番近いエッジロケーション(POP)へリクエストを送る
- POP のキャッシュにあれば、そのまま返す
- 無ければ、近くのリージョン別エッジキャッシュを見る
- そこにも無ければ、ディストリビューションの設定に従ってオリジンへ取りに行く
- オリジンから最初のバイトが届いた時点で利用者へ返し始め、両方のキャッシュにも置く
リージョン別エッジキャッシュは POP より大きなキャッシュで、人気が落ちて POP から追い出されたファイルも長く残ります。
ただし、PUT や POST などのメソッドと動的なリクエストは、ここを通らずにオリジンへ直接行きます。
オリジンが S3 で、一番近いリージョン別エッジキャッシュがバケットと同じリージョンにあるときも、この段は飛ばされます。
How CloudFront delivers content(Amazon CloudFront 開発者ガイド)
ディストリビューションの部品
ディストリビューションの中身は、次の部品の組み合わせです。
| 部品 | 決めること |
|---|---|
| オリジン | ファイルを取りに行く先(S3 のバケット、ALB、API Gateway、Web サーバーなど) |
| キャッシュビヘイビア | パスのパターンごとに、どのオリジンへ送り、どのポリシーと関数を使うか |
| キャッシュポリシー | キャッシュキーに入れる値と、TTL の最小・既定・最大 |
| オリジンリクエストポリシー | キャッシュキーには入れずに、オリジンへ渡す値 |
| CloudFront Functions/Lambda@Edge | リクエストと応答をエッジで書き換えるコード |
キャッシュビヘイビアは並んだ順に上から照合され、最初に一致したものが使われます。
パターンが * の既定のビヘイビアは、いつも最後に処理されます。
Cache behavior settings(Amazon CloudFront 開発者ガイド)
どこで使われるか
よくある使い道は、静的なサイトの配信、動画の配信、ALB や API Gateway の前段に置いて入口を 1 つにまとめる構成です。
一番の定番は、非公開の S3 バケットにサイトのファイルを置き、CloudFront だけに読ませて、独自ドメインと HTTPS で配る形でしょう。
私のプロジェクトでの扱い
dekinai.dev は、オリジンが S3 のバケット 1 つだけのディストリビューションです。
サイトのファイルを置くバケットは公開しておらず、CloudFront の OAC 経由でだけ読ませています。
既定のビヘイビアには、AWS が用意しているマネージドのキャッシュポリシー CachingOptimized を付け、HTTP で来たリクエストは HTTPS へリダイレクトしています。
別のアプリは、1 つのディストリビューションに 3 つのオリジンをつないでいます。
サイトのファイルのバケット、API Gateway、利用者がアップロードした画像のバケットの 3 つで、パスごとにキャッシュの扱いを変えました。
# 省略
CacheBehaviors:
- PathPattern: /api/*
TargetOriginId: ApiGatewayOrigin
ViewerProtocolPolicy: redirect-to-https
CachePolicyId: 4135ea2d-6df8-44a3-9df3-4b5a84be39ad # CachingDisabled
OriginRequestPolicyId: b689b0a8-53d0-40ab-baf2-68738e2966ac # AllViewerExceptHostHeader
- PathPattern: /uploads/*
TargetOriginId: UploadsOrigin
CachePolicyId: 658327ea-f89d-4fab-a63d-7e88639e58f6 # CachingOptimized
DefaultCacheBehavior:
TargetOriginId: S3Origin
CachePolicyId: 658327ea-f89d-4fab-a63d-7e88639e58f6 # CachingOptimized
# 省略
実際に使っているテンプレートからの抜粋です。
/api/* は、マネージドのキャッシュポリシー CachingDisabled でキャッシュしないようにしました。
あわせてオリジンリクエストポリシーの AllViewerExceptHostHeader を付け、Host ヘッダー以外のヘッダー・Cookie・クエリ文字列をそのまま API Gateway へ渡しています。
Host を外すのは、API Gateway が Host にディストリビューションではなく自分のドメイン名が入っていることを前提にしていて、そのまま渡すと動かなくなることがあるからです。
Use managed origin request policies(Amazon CloudFront 開発者ガイド)
/uploads/* の画像はキーがサーバー側で作る UUID で、同じキーの中身が変わらないので、サイトと同じ CachingOptimized を付けています。
このディストリビューションにはアクセスログも付けていて、ログから訪問者を数えた話は監視の記事に書きました。
先に知っておく用語
CloudFront の設定で迷うのは、ほとんどがキャッシュの扱いとオリジンの守り方です。
キャッシュキー
キャッシュキーは、キャッシュの中のファイルを見分ける名前のようなもので、同じキーのリクエストが来て有効な写しがあればキャッシュヒットになります。
既定のキャッシュキーに入るのは、ディストリビューションのドメイン名と URL のパスだけです。
クエリ文字列・Cookie・User-Agent のようなヘッダーが違っても、既定では同じファイルとして扱われます。
Understand the cache key(Amazon CloudFront 開発者ガイド)
キャッシュキーに入れる値が増えるほど同じファイルの写しが増え、ヒットの割合は下がります。
AWS は、オリジンの応答を変える値だけをキーに入れ、分析などで使うだけの値はオリジンリクエストポリシーで渡すよう勧めています。
TTLとCache-Control
TTL は、キャッシュに置いたファイルを、オリジンへ確かめに行かずに使ってよい時間です。
キャッシュポリシーで最小・既定・最大の 3 つを決め、オリジンの Cache-Control の max-age や s-maxage と組み合わせて実際の時間が決まります。
| オリジンの応答 | 最小 TTL が 0 のとき | 最小 TTL が 0 より大きいとき |
|---|---|---|
| max-age だけがある | max-age と最大 TTL の短いほう | 最小 TTL と最大 TTL の範囲に収めた max-age |
| max-age と s-maxage がある | s-maxage と最大 TTL の短いほう(ブラウザは max-age) | 最小 TTL と最大 TTL の範囲に収めた s-maxage(ブラウザは max-age) |
| どちらも無い | 既定 TTL | 最小 TTL と既定 TTL の長いほう |
| no-cache・no-store・private がある | ヘッダーに従う | 最小 TTL の間はキャッシュする |
Manage how long content stays in the cache (expiration)(Amazon CloudFront 開発者ガイド)
マネージドの CachingOptimized は、最小 TTL が 1 秒、既定 TTL が 86,400 秒(24 時間)、最大 TTL が 31,536,000 秒(365 日)です。
キャッシュキーにはクエリ文字列も Cookie も入れず、圧縮の形式を見分ける Accept-Encoding だけを入れます。
Use managed cache policies(Amazon CloudFront 開発者ガイド)
dekinai.dev では、ビルドハッシュがファイル名に入る _next/static/ の下に public, max-age=31536000, immutable を付けて送っています。
それ以外の HTML などには、public, max-age=0, s-maxage=86400, must-revalidate を付けました。
上の表に当てはめると、ハッシュ付きのファイルはエッジでもブラウザでも 1 年持ち、HTML はエッジで 1 日持ちながら、ブラウザは毎回確かめに来る形になります。
ワークフローの注記によると、以前はどのファイルにも Cache-Control が無く、ブラウザが推測した期間だけ古い HTML を使い回していました。
その間にデプロイで古い CSS と JavaScript が消され、デプロイの直後にスタイルの無いページが表示されたことが、この設定に変えたきっかけです。
オリジンアクセスコントロール(OAC)
OAC は、CloudFront が S3 へのリクエストに署名を付け、バケットの側では CloudFront からの読み取りだけを許すための仕組みです。
古い仕組みに OAI がありますが、AWS は OAC を勧めています。
理由は、OAC が KMS の鍵による暗号化(SSE-KMS)と PUT や DELETE のリクエストに対応し、2022 年 12 月より後に始まったオプトインのリージョンのバケットにも使えるからです。
Restrict access to an Amazon S3 origin(Amazon CloudFront 開発者ガイド)
OAC を使うときは、S3 のオブジェクト所有者を新しいバケットの既定の「バケット所有者の強制」にし、ACL が要るときだけ「バケット所有者の優先」にするよう書かれています。
署名の設定を always にすると、CloudFront と S3 の間は常に HTTPS で通信します。
一方で、S3 をウェブサイトエンドポイントとしてつなぐと OAC は使えず、バケットを公開したまま配ることになります。
バケットポリシーの書き方と、ウェブサイトエンドポイントとの違いは S3 の記事に載せました。
デフォルトルートオブジェクト
デフォルトルートオブジェクトは、ディストリビューションのルート(/)が開かれたときに返すファイルです。
デフォルトルートオブジェクトに index.html を指定しても、/install/ のようなサブディレクトリを開いたときには index.html を返しません。
S3 のウェブサイトホスティングのインデックスドキュメントはサブディレクトリでも効くので、ここが S3 だけで配るときとの大きな違いです。
Specify a default root object(Amazon CloudFront 開発者ガイド)
私の 2 つのサイトはどちらも Next.js の静的エクスポートで、/foo/ のような URL をそのまま開ける必要があります。
そこで、リクエストを受けた時点で index.html を補う CloudFront Functions を付けています。
function handler(event) {
var req = event.request;
var uri = req.uri;
// 省略(移した記事の旧 URL に 301 を返す処理)
if (uri.endsWith('/')) {
req.uri = uri + 'index.html';
} else {
var lastSegment = uri.substring(uri.lastIndexOf('/') + 1);
if (lastSegment.indexOf('.') === -1 /* 省略: OG 画像は除外 */) {
req.uri = uri + '/index.html';
}
}
return req;
}
dekinai.dev で実際に使っている関数からの抜粋です。
同じ関数で、URL を変えた記事の旧 URL に 301 を返して、検索エンジンに残った古い URL を受け止めています。
CloudFront FunctionsとLambda@Edge
エッジでコードを動かす仕組みは 2 つあり、軽い書き換えは CloudFront Functions、重い処理は Lambda@Edge という分担です。
| 違い | CloudFront Functions | Lambda@Edge |
|---|---|---|
| 言語 | JavaScript | Node.js、Python |
| 動くタイミング | ビューワーリクエスト、ビューワーレスポンス | 左の 2 つに加えて、オリジンリクエスト、オリジンレスポンス |
| 処理の規模 | 毎秒数百万リクエストまで | リージョンごとに毎秒 10,000 リクエストまで |
| メモリの上限 | 2 MB | 128 MB〜10,240 MB(タイミングで違う) |
| コードとライブラリの大きさ | 10 KB | 50 MB |
| ネットワーク・ファイルシステム・リクエストの本文 | 使えない | 使える |
Differences between CloudFront Functions and Lambda@Edge(Amazon CloudFront 開発者ガイド)
URL の書き換え、リダイレクト、ヘッダーの追加、キャッシュキーの正規化は CloudFront Functions の担当です。
外部のサービスを呼ぶ処理や、AWS SDK などのライブラリに頼る処理は Lambda@Edge で書きます。
いつ使わないか
CloudFront は HTTP と HTTPS の配信を速く・安全にする仕組みなので、その外にある要件では別のサービスを選びます。
| やりたいこと | CloudFront で扱いにくい理由 | 検討するもの |
|---|---|---|
| UDP を使う通信や、HTTP 以外の TCP の通信を世界の近い入口で受ける | CloudFront は HTTP と HTTPS のリクエストを配る CDN | AWS Global Accelerator |
| 利用者ごとに中身が変わる API だけを配る | キャッシュが効かず、前段に置いても速くならない | API Gateway や ALB に直接つなぐ。入口をまとめたいなら CachingDisabled のビヘイビア |
| エッジで外部のサービスを呼んだり、リクエストの本文を読んだりする | CloudFront Functions はネットワークにも本文にも触れない | Lambda@Edge、オリジン側の Lambda |
| リポジトリにつなぐだけで、ビルドから配信までを任せる | ディストリビューション・バケット・証明書を自分で組む必要がある | AWS Amplify Hosting |
| 同じ名前のファイルを頻繁に差し替え、すぐに反映させる | 無効化は 1 か月の無料分を超えると課金され、ブラウザや途中のプロキシのキャッシュまでは消せない | ファイル名にバージョンを入れて配る |
Global Accelerator は、AWS のエッジネットワークにある固定の IP アドレスで TCP と UDP の通信を受け、AWS のネットワークを通してエンドポイントへ運びます。
How AWS Global Accelerator works(AWS Global Accelerator 開発者ガイド)
ファイル名にバージョンを入れる方法は、AWS 自身が、頻繁に更新するファイルでは無効化より優先して使うよう勧めています。
課金と落とし穴
従量課金の CloudFront の請求は、エッジから利用者へ出る転送量と、HTTP・HTTPS のリクエストの回数が中心です。
S3・ELB・API Gateway のような AWS のオリジンから CloudFront への転送(オリジンフェッチ)は無料です。
一方で、POST や PUT のように CloudFront からオリジンへ送るデータは、オリジン向けの転送として別に請求されます。
課金の軸の数え方と、配信に使うエッジの範囲を絞る価格クラスは、課金モデルの記事にまとめました。
定額のプラン
2026 年 10 月の時点で、CloudFront には従量課金のほかに、月ごとに決まった額を払う定額のプランがあります。
段階は Free・Pro・Business・Premium の 4 つで、WAF・Route 53 の DNS・TLS の証明書・エッジの計算などがまとめて入り、使用量が目安を超えても追加の請求はありません。
目安を大きく超え続けると、配信に使うエッジが減るなど、配信の質のほうが調整されることがあると書かれています。
Free のプランの目安は、1 か月に 100 万リクエストと 100 GB の転送です。
CloudFront flat-rate pricing plans(Amazon CloudFront 開発者ガイド)
ただし、プランに入れるディストリビューションには WAF の Web ACL が必須で、OAI・レガシーのキャッシュ設定・リアルタイムのログのように使えない機能もあります。
AWS Free Tier を使っているアカウントは対象外という条件も挙がっているので、申し込む前にこのページの条件を確かめる必要があります。
無効化は「パスの数」で数える
デプロイの直後に古いファイルを消したいときは、エッジのキャッシュを無効化します。
無効化は、アカウントのすべてのディストリビューションを合わせて 1 か月に 1,000 パスまで無料で、それを超えた分はパスごとに課金されます。
/images/* のように * を含むパスは、何千ファイルを消しても 1 パスとして数えます。
Pay for file invalidation(Amazon CloudFront 開発者ガイド)
私の 2 つのサイトは、GitHub Actions のデプロイの最後に、全ファイルを 1 パスで無効化しています。
aws cloudfront create-invalidation \
--distribution-id "$DISTRIBUTION_ID" \
--paths "/*"
実際に使っているワークフローからの抜粋で、ディストリビューションの ID の部分だけ変数に置き換えました。
無効化のパスは大文字と小文字を区別し、* はパスの最後に置いたときだけワイルドカードとして働きます。
HTTPからのリダイレクトも2回分
ビューワープロトコルポリシーを「HTTP を HTTPS にリダイレクト」にすると、HTTP の GET は 301 で HTTPS へ送り直されます。
このとき、HTTP のリクエストと、送り直された HTTPS のリクエストの両方が請求されます。
Require HTTPS for communication between viewers and CloudFront(Amazon CloudFront 開発者ガイド)
エラーもキャッシュされる
CloudFront は、オリジンが返したエラーの応答も、既定で 10 秒キャッシュします。
S3 のオリジンでは、エラーをキャッシュする最小 TTL を 0 にしても、オリジンを守るために 1 秒は残ります。
Control how long CloudFront caches errors(Amazon CloudFront 開発者ガイド)
OAC の構成で見落としやすいのは、存在しないファイルを開いたときのステータスです。
S3 は、リクエストした側に s3:ListBucket の権限が無いと、無いファイルにも 404 ではなく 403 を返します。
GetObject(Amazon S3 API リファレンス)
私の 2 つのサイトのバケットポリシーは s3:GetObject しか許していないので、カスタムエラーレスポンスで 403 と 404 をどちらも 404 にそろえ、/404.html を返しています。
別のアプリでは、このエラーの応答をキャッシュする時間を 60 秒にしました。
最小TTLが0より大きいとno-cacheが効かない
TTL の表のとおり、最小 TTL が 0 より大きいキャッシュポリシーでは、オリジンが no-cache や no-store を付けても、最小 TTL の間はキャッシュされます。
CachingOptimized の最小 TTL は 1 秒なので、キャッシュさせたくない応答を返すパスには、CachingDisabled のような最小 TTL が 0 のポリシーを付けます。
責任共有の自分の側
CloudFront では、エッジの設備やソフトウェアの更新は AWS が受け持ち、オリジンの守り方とキャッシュに何を置くかは利用者の受け持ちです。
既定のキャッシュキーには Cookie もヘッダーも入らないので、利用者ごとに中身が変わる応答をキャッシュするパスに置くと、別の利用者に同じ応答が返るおそれがあります。
S3 は OAC でだけ読ませ、利用者ごとに変わる応答はキャッシュしないビヘイビアに分ける、の 2 つを最初に決めておくと、中身が漏れる余地と古いページが残る余地の両方を小さくできます。
他クラウドでは
GCP の対応サービスは Cloud CDN で、グローバル外部アプリケーションロードバランサか従来のアプリケーションロードバランサと組み合わせて配信します。
Cloud Storage のファイルを配るときは、バケットをロードバランサのバックエンドバケットとしてつなぎます。
キャッシュはリクエストが通ったときにだけ置かれ、事前に入れておくことはできません。
Cloud CDN overview(Google Cloud)
Azure の対応サービスは Azure Front Door で、CDN の役割と、複数のオリジンへの負荷分散・WAF をまとめて受け持ちます。
What is Azure Front Door?(Microsoft Learn)
以前からある Azure CDN は整理が進んでいて、Azure CDN from Edgio は 2025 年 1 月 15 日に終了しました。
Azure CDN Standard from Microsoft(classic)も、2027 年 9 月 30 日に終了する予定です。
classic は 2025 年 8 月 15 日から新しいプロファイルを作れなくなっていて、Front Door の Standard か Premium への移行が案内されています。
What is a content delivery network?(Microsoft Learn)
| 区分 | AWS | GCP | Azure |
|---|---|---|---|
| CDN | Amazon CloudFront | Cloud CDN | Azure Front Door |
| 組み合わせるもの | 無し(ディストリビューション単体) | 外部アプリケーションロードバランサ | 無し(Front Door 単体) |
| オブジェクトストレージのつなぎ方 | S3 をオリジンにして OAC で読ませる | Cloud Storage をバックエンドバケットにする | Blob Storage をオリジンにする |
3 社の部品の対応表の全体版は、シリーズ最初の記事にまとめてあります。
参考
本文のリンクで紹介した公式ドキュメントと試験ガイドは、いずれも 2026-10-26 に参照しました。
定額のプランやエッジで動かせる処理のように、CloudFront の機能と料金の形は少しずつ変わっているので、設定する前にはリンク先の最新の記述を確かめてください。
最後に
CloudFront は、近いエッジのキャッシュから返し、無いときだけオリジンへ取りに行く CDN で、何をキャッシュキーに入れて何秒持つかを決めるのが設定の中心です。
S3 と組むなら、バケットを非公開のまま OAC で読ませ、サブディレクトリの index.html とエラーの 403 を CloudFront の側で扱う、という 3 点がセットになります。
資格試験では、AWS Certified Cloud Practitioner(CLF-C02)のタスク 3.2 が、エッジロケーションの利点と、リージョン・AZ との関係を挙げています。
AWS Certified Cloud Practitioner(CLF-C02)Content Domain 3
Solutions Architect – Associate(SAA-C03)では、タスク 3.4 が CloudFront と Global Accelerator を例に、エッジのネットワークサービスの使いどころを扱っています。
AWS Certified Solutions Architect – Associate(SAA-C03)Content Domain 3
GCP の Associate Cloud Engineer には Cloud CDN そのものの項目は無く、近いのはセクション 2.3 のネットワークリソースの計画に入っている負荷分散です。
AZ-900 の学習ガイドには CDN や Front Door の項目は無く、ネットワークの項目は仮想ネットワーク・DNS・VPN が中心です。
Associate Cloud Engineer 試験ガイド(Google Cloud)
Study guide for Exam AZ-900(Microsoft Learn)
ディストリビューションを作るときは、キャッシュポリシーとビヘイビアの分け方を先に決めておくと、後からキャッシュの不具合を追うときに迷わずに済みます。
以上です。
















コメントを残す