このページは英語のページを機械翻訳したものです。内容は英語のページが正です。 英語のページを読む
メディアの配信の前に CDN を置く
サーバーの前に置いた CDN(Cloudflare、Google Cloud CDN、CloudFront など)で、メディア(/media/ と /media/proxy/)を配信できます。
CDN のキャッシュから応答したリクエストは、サーバーの CPU も転送量も使いません。
このガイドでは、サーバーを CDN のオリジンにする構成(オリジンプル)を説明します。これはどの blob ストアにも当てはまります。blob = s3 や blob = gcs のときも、サーバーは非公開のバケットからファイルを読み、blob = fs のときと同じように /media/ の下で配信するので、バケットが CDN のオリジンになることはありません。
サーバー全体が CDN の後ろにあるときは、CDN を経由しなかったリクエストを拒否することもできます。
media_origin(MY_MEDIA_ORIGIN)に CDN のホスト名(たとえば media.example.org)を設定します。
MY_MEDIA_ORIGIN=https://media.example.org- 値はオリジンだけ(
scheme://host[:port])で、パス、クエリー、末尾のスラッシュは付けません。httpsが必須で、httpはlocalhostのようなループバックのホストにだけ使えます。不正な値だと起動に失敗します。 - 設定しないと、メディアはサーバー自身のオリジン(
https://{host})から配信されます。 - 次の URL がこのオリジンを使います。ローカルのメディアには
{media_origin}/media/...、リモートのメディアのプロキシには{media_origin}/media/proxy/...です。 クライアント API、ActivityPub(attachment、icon、image、カスタム絵文字のicon)、リンクプレビュー(OGP)が出力するすべての URL が対象です。 - Web クライアントの Content-Security-Policy は、
img-srcとmedia-srcにこのオリジンを加えます。 - ActivityPub のオブジェクトの
idのような連合の URI は、media_originが何であってもhttps://{host}/の下のままです。変わるのはファイルを配信する場所だけで、識別子は変わりません。 - URL は読み出すたびに組み立てられ、データベースには保存されません。そのため
media_originを変えると、既存のメディアの URL も変わります。 リモートのサーバーが保存した古い URL は、古いオリジンの/media/が配信を続ける限り使えます。
CDN の向き先をサーバーにする
Section titled “CDN の向き先をサーバーにする”- オリジン(バックエンド)は、サーバーの公開ホスト名(
https://{host})にします。CDN がサーバーから取得する必要があるのは、/media/の下のパスだけです。 - サーバーは
/media/と/media/proxy/をホスト名で制限しません。CDN が送ってきたHostが何であっても配信します。 /media/には認証が不要で、Authorized Fetch も適用されません。サーバーは CDN からの署名のないリクエストにそのまま応答します。- リモートのメディア(
/media/proxy/{id}/{variant}?sig=...)では、sigが URL の一部です。キャッシュキーにクエリー文字列を含めてください。 そうしないと、署名の異なる URL が 1 つのエントリーを共有してしまいます。 - キャッシュする期間は、オリジンの
Cache-Controlに任せてください(CDN で上書きしないでください)。
| パス | Cache-Control |
|---|---|
/media/{...}(ローカルのメディア) |
public, max-age=31536000, immutable(1 年) |
/media/proxy/{...}(リモートのメディア) |
public, max-age= にインスタンスの設定 remote_media_cache_ttl_seconds の秒数 |
どちらも Cross-Origin-Resource-Policy: cross-origin 付きで返されるので、ほかのオリジンのページからも読み込めます。
Cloud Run では、ingress-cloudflare-media が OpenTofu でこれを設定します。Cloud Run へのデプロイを参照してください。
メディアの URL を開ける人
Section titled “メディアの URL を開ける人”メディアの URL にはアクセス制御がありません。ファイルの URL を持っている人なら誰でも、サインインせずに開けます。そのファイルを添付した投稿の公開範囲は関係ありません。 これは CDN の有無にかかわらず当てはまり、フォロワー限定の投稿やダイレクトメッセージの添付、リモートのメディアのプロキシの URL も含みます。
- URL は推測しにくくなっています。ローカルのファイルの URL にはランダムな部分を持つ識別子が含まれ、プロキシの URL には署名が付いています。1 つの URL を知っても、ほかの URL は分かりません。
- 投稿を見た人は誰でも、そのメディアの URL をほかの人に渡せ、その URL はほかの人にも使えます。
- 応答には
publicが付いているので、CDN や、サーバーと読む人の間にある共有キャッシュがコピーを持つことがあります(期間は上の表を参照してください)。 CDN がサーバーに問い合わせずにメディアを配信できるのは、このためです。
公開でない投稿は、その投稿を見られる人を制限しますが、添付ファイルのリンクを持っている人がそのファイルを開くことは防げない、とユーザーに伝えてください。
削除とキャッシュ
Section titled “削除とキャッシュ”メディアを削除したあとも、CDN のキャッシュは max-age の間それを保持します。削除したファイルは、ローカルのメディアでは最大 1 年、プロキシでは最大 remote_media_cache_ttl_seconds の間、見えたままになることがあります。
サーバーは CDN のキャッシュをパージしません。削除やモデレーションの操作のあとすぐに消えなければならないものがあるときは、CDN のコンソールか API で手動でパージしてください。
Service Worker
Section titled “Service Worker”Web クライアントの Service Worker は、ほかのオリジンのメディアをキャッシュせず、ブラウザーのネットワーク処理に任せます。そのため、適用されるのは CDN のキャッシュだけです。
CDN を経由しなかったリクエストを拒否する
Section titled “CDN を経由しなかったリクエストを拒否する”CDN がサーバーを守れるのは、CDN を通るリクエストからだけです。インターネットからのトラフィックを受ける Cloud Run の *.run.app のように、オリジンにそれ自身のアドレスでも到達できるときは、誰でも WAF やキャッシュを通らずにオリジンを直接呼び出せます。
CDN のアドレスが trusted_proxies にあると、CDN 自身のサーバーレスプラットフォーム上の呼び出し元(たとえばその人自身の Cloudflare Worker)も信頼されたアドレスから接続することになり、レート制限が見るクライアントの IP を自分で選べてしまいます。
次の 3 つの設定で、これを塞ぎます。CDN は転送するすべてのリクエストに秘密のヘッダーを加え、サーバーはそのヘッダーのないリクエストに、ほかの処理をする前に 403 を返します。
- ブラウザーとアプリ(ページ、クライアント API、OAuth、メディアの URL)とほかのサーバー(ActivityPub の配送と取得)は、
hostとmedia_originのホストで CDN に到達します。CDN はキャッシュした/media/のファイルには自分で応答し、 サーバーに転送するすべてのリクエストに、origin_secret_headerをorigin_secretの値で設定します。 - プラットフォーム(ヘルスプローブ、死活監視、Cloud Tasks、Cloud Scheduler)と、それ以外の誰か(自分のスクリプトや Webhook など)は、ヘッダーなしでサーバー自身のアドレスに直接到達します。
- オリジンの確認は、サーバーの中で最初に行われます。
origin_secretまたはorigin_secret_previousの値でヘッダーを 1 つだけ持つリクエストを通し、 ヘッダーがない場合は、ヘルスチェックへのGETとHEAD、/_internal/へのPOSTだけを通します。 すべてのリクエストからヘッダーを取り除き、残りを403で拒否します。 - 通ったリクエストは、Web クライアント、クライアント API、OAuth、ActivityPub、ヘルスチェック、
/_internal/、 または/media/と/media/proxy/に届きます。後の 2 つはメディアのストレージ(blob = fs、s3、gcs)を読むか、 ほかのサーバーのファイルを中継します。拒否されたリクエストにはCache-Control: no-store付きの403が返り、my.http.origin_refusedに加算されます。
サーバーが公開のアドレスを持ち、プラットフォームでそのアドレスを CDN 以外のすべてに閉じられないときに使ってください。ファイアウォールやプラットフォームがすでに接続できる相手を制限しているとき、たとえばロードバランサーの後ろのプライベートネットワークでだけ待ち受けるサーバーには必要ありません。
そのロードバランサー自身が CDN のヘッダーを確認し、CDN のアドレスだけを受け入れるときも同じです。CloudFront の後ろの AWS Application Load Balancer は、リスナールールとマネージドプレフィックスリスト com.amazonaws.global.cloudfront.origin-facing でこれができます。その場合は、ロードバランサーと CDN のどちらも X-Forwarded-For に追記するので、両方のアドレスを trusted_proxies に並べてください。
Cloud Run のドメインマッピングのように、プラットフォーム自身の機能がトラフィックを転送し、自分で制御できるヘッダーを加えないときは役に立ちません。役に立つのは、リクエストヘッダーを加えられる CDN かロードバランサーだけです。
| 設定 | 持つもの |
|---|---|
origin_secret(MY_ORIGIN_SECRET) |
値。表示可能な ASCII で 32 バイト以上。秘密情報で、環境変数か MY_ORIGIN_SECRET_FILE から読みます |
origin_secret_header(MY_ORIGIN_SECRET_HEADER) |
ヘッダーの名前。自分で決めます。origin_secret と一緒に必須です。CDN が設定を拒む名前や、cf- や x-cf- で始まる名前のようにサーバーやプロキシが読む名前は不正です |
origin_secret_previous(MY_ORIGIN_SECRET_PREVIOUS) |
受け入れる 2 つ目の値。値を入れ替える間だけ使います |
どれも設定しなければ何も確認されず、サーバーはこの節がないものとして動きます。
ヘッダーなしで通るもの
Section titled “ヘッダーなしで通るもの”| リクエスト | 理由 |
|---|---|
/healthz、/readyz、/health/live、/health/ready、/api/v1/instance/health への GET または HEAD |
プラットフォームのプローブや死活監視が直接呼び出すため |
/_internal/ のパスへの POST |
Cloud Tasks と Cloud Scheduler がサーバー自身の URL で呼び出すため。これらは独自の署名付きトークンを持ちます |
それ以外はすべて、メンテナンスモードの間も含めてヘッダーが必要です。Web クライアントとそのアセット、/media/、クライアント API、OAuth、ほかのサーバーからの配送を含む ActivityPub が該当します。
そのため、CDN を通さずにサーバー自身のアドレスで直接呼び出すものは、自分の Webhook、音声のメディアサーバー、スクリプトなど、何でも拒否されます。それらの向き先は CDN のホスト名にしてください。
メトリクスのポート(metrics_listen)は公開されていない別のリスナーで、確認の対象になりません。
秘密の値を持たないリクエストは、通ったとしても、その後の処理に影響を与えられません。クライアントの IP は X-Forwarded-For が何であっても接続の相手になり、traceparent と X-Request-Id は無視されます。
CDN がサーバーに転送するすべてのホスト名にヘッダーが必要です。host、media_origin のホスト、CDN が配信するなら別の account_domain もです。同じ CDN の後ろにあるメディアのホストにも設定します。/media/ もほかと同じように拒否されるためです。
-
値を生成し、ほかで使われていない名前を選びます。
ターミナルウィンドウ openssl rand -hex 32 -
先に CDN でヘッダーを設定します。 サーバーは知らないヘッダーを無視するので、この段階ではまだ何も変わりません。
- Cloudflare: リクエストヘッダーの変換ルール(Rules、Transform Rules、Modify Request Header の順)で、すべてのプランで使えます。ゾーンへのすべてのリクエストに一致させ、Set static を選んで名前と値を指定します。クライアントが送った値は置き換えられます。一部のホスト名だけのルールにすると、残りのホスト名は締め出されます。
- Amazon CloudFront: 各ディストリビューションのオリジンに、オリジンのカスタムヘッダーを設定します。これもビューアーの値を置き換えます。
- Google Cloud のロードバランサー: バックエンドサービスにカスタムリクエストヘッダーを設定します。
- ほかの CDN やプロキシ: サーバーへのすべてのリクエストで、ヘッダーを追記ではなく設定する必要があります。
-
MY_ORIGIN_SECRETとMY_ORIGIN_SECRET_HEADERを設定してデプロイします。my config checkはこれらを検証し、何が確認されるかを示しますが、CDN の状態は見えません。 -
外から、オリジン自身のアドレスで確認します。
ターミナルウィンドウ curl -s -o /dev/null -w '%{http_code}\n' https://<host>/ # 200: through the CDNcurl -s -o /dev/null -w '%{http_code}\n' https://<origin address>/ # 403: directlycurl -s -o /dev/null -w '%{http_code}\n' https://<origin address>/health/live # 200: a health check
CDN のアドレスも trusted_proxies に並べてください。そうしないと、サーバーからはクライアントが 1 つに見え、すべてのリクエストが CDN のレート制限を共有します。my config check はこれを警告します。
拒否されたリクエストには、ヘッダーがどのように間違っていても、ほかの禁止されたリクエストと同じ 403 の problem document が Cache-Control: no-store 付きで返ります。応答にヘッダーの名前は一切含まれません。
全員が締め出されたとき
Section titled “全員が締め出されたとき”設定を誤ると、ヘルスチェックは 200 のまま、すべてのリクエストが拒否されます。そのため、プラットフォームからは正常なサーバーに見え、/health/live の死活監視も何も検出しません。兆候は次のとおりです。
- CDN を通したすべてのページが
403になる。 - メトリクス
my.http.origin_refusedが増え、http.server.request.durationのリクエストが止まる。 - ログに、ステータス
403でhttp.routeのないhttp requestの行が出る。ログとトレースには、ヘッダーもその名前も値も残りません。拒否されたリクエストはトレースのスパンを作りません。
復旧するには、確認なしでデプロイします。MY_ORIGIN_SECRET と MY_ORIGIN_SECRET_HEADER の設定を外してください。ほかのサーバーは配送を再試行しますが、その間、人はサーバーにアクセスできませんでした。
そのうえで、CDN の名前と値を設定と比べ、ルールがすべてのホスト名を対象にしていることを確認してから、もう一度設定してください。
値を入れ替える
Section titled “値を入れ替える”CDN とサーバーを同時に変えることはできず、サーバーのレプリカもそれぞれのペースで再起動します。そのため、受け入れる値が 1 つだけだと、変更している間、両者の値が食い違う間ずっとトラフィックが拒否されます。そこでサーバーは、入れ替えの間は 2 つの値を受け入れます。
MY_ORIGIN_SECRETに新しい値を、MY_ORIGIN_SECRET_PREVIOUSに古い値を設定してデプロイします。どちらの値も通ります。- CDN の値を変え、その変更がすべての拠点に行き渡るのを待ちます。
MY_ORIGIN_SECRET_PREVIOUSの設定を外してデプロイします。設定されている間、my config checkは警告します。
ヘッダーの名前は、この方法では入れ替えられません。名前を変えるには、サーバーの確認を一時的にオフにして設定をやり直すか、デプロイする前に、CDN で古い名前と並べて新しい名前を設定してください。
LLM とコーディングエージェント向け:llms.txt,llms-full.txt, llms-small.txt