本文へ移動
技術を、自社の仕事に。
判断と実行を助けるメディア

記事を検索

Astro 7.4.11で転送ヘッダーの判定が変更 SSRの確認点

目次 · 6項目

CDNやロードバランサーの背後でAstroのサイトをSSR(リクエストのたびにページを描画する方式)で動かしていると、Astroの内部では、利用者が見ているURLではなく中継の機器から届いたリクエストを受け取ります。本来のホスト名やhttpsであることは、中継の機器が付ける X-Forwarded-Host・X-Forwarded-Proto などのヘッダーから復元します。この復元がずれると、Astro.url を使って組み立てた正規URL(canonical)やリダイレクト先、OGPのURLが http://localhost:4321 のような内部の値になります。

Astro 7.4.11(npmへの公開は2026年11月11日。日付はUTC、以下同じ)で、このヘッダーを信頼するかどうかの判定が変わりました。セキュリティを強める修正ですが、中継の機器の設定によっては、更新後にこれまで使われていたホスト名が使われなくなります。本記事では、変更点の原文と、7.4.10と7.4.12に同じ入力を渡して比べた結果をもとに、更新前に確認する点を整理します。

7.4.11で変わった判定

Astroは、astro.config.mjs の security.allowedDomains に許可するホスト名を並べたときだけ、転送のヘッダーを信頼します。設定していなければ X-Forwarded-Host は無視されます。型定義の説明は「If the header doesn’t match any allowed pattern, the header is ignored and the request’s original host is used instead.」と書いており、許可されなかったヘッダーの代わりに、サーバーが受けたリクエストのホストが使われます。

7.4.11のCHANGELOGは、この判定について次の変更を挙げています。

  • プロトコル・ホスト・ポートを1つずつではなく、許可リストの項目ごとにまとめて照合する(「together against each security.allowedDomains entry, instead of one at a time」)
  • 転送されたプロトコルは、使うホストに対してその項目が許している場合だけ適用する
  • 転送されたポートは、そのホストの項目に書かれている場合だけ適用する
  • X-Forwarded-Proto がない転送のホストは、サーバー側のプロトコルで判定する(「validated with the protocol of the server」)
  • port: '443'(httpなら '80')の項目が、ポートを含まないホストに一致するようになった
  • Host・X-Forwarded-Host は「ホスト名と任意のポート」の形だけを受け付ける

あわせて、protocol付きの項目と付かない項目が混在するリストで、ftp や ws のようなhttp(s)以外の X-Forwarded-Proto が通っていた問題も直りました。7.4.12(11月13日)にはこの判定の変更はなく、メモリ使用量の改善などが中心です。

2026年11月20日時点の最新は7.4.13(11月18日)です。7.4.13では、port: '443' のような既定のポートを書いた項目で許可したオリジンからのクロスオリジンのリクエストを、開発サーバーが止めてしまう問題が直りました(#18711)。CHANGELOGは「BaseApp.validateForwardedHost() now applies the same allowedDomains rules as the rest of Astro.」と書いています。下で比べた判定の関数のファイル(validate-headers)は、7.4.12と7.4.13で変わっていません。

7.4.10と7.4.12に同じ入力を渡した結果

2026年11月15日に、npmから astro 7.4.10 と 7.4.12 を取得し、判定を行う関数(validateForwardedHeaders)に同じヘッダーと許可リストを渡して戻り値を比べました。サーバー側の値は、内部で http://localhost:4321 を受けている想定です。戻り値に含まれない値は使われず、サーバー側の値に戻ります。

入力(許可リストと届いたヘッダー)7.4.107.4.12
https 限定の example.com。Hostだけ届き、Protoはないホストを採用ホストも不採用
上と同じで、X-Forwarded-Proto: https も届くhttps・ホストを採用https・ホストを採用
example.com の項目にポートなし。別のホストの項目にだけある 8443 を転送ポート8443も採用ポートは不採用
port: '443' 付きの項目。ポートなしのホストが届くホストは不採用ホストを採用
**.example.com。evil.test@www.example.com が届くそのまま採用不採用
protocolの有無が混在。X-Forwarded-Proto: ftp が届くftpを採用ftpは不採用

Astro 7.4.10と7.4.12で結果が変わった4つの入力。Protoなしで届いたホストは7.4.12では採用されない。別のホストの項目にだけあるポート8443は7.4.12では採用されない。port 443の項目はポートなしのホストに7.4.12で一致する。@を含むホストは7.4.12では採用されない

最初の行が、更新で表示が変わりうるケースです。中継の機器が X-Forwarded-Host だけを付け、X-Forwarded-Proto を付けない設定で、許可リストを protocol: 'https' に限っていると、7.4.10では採用されていたホストが、7.4.12では内部の値に戻ります。7.4.10は、Protoがない場合に https とみなして照合していたためです。

逆に、4行目の port: '443' を書いた項目は、7.4.10ではポートを含まないホストに一致していませんでした。型定義の例にもこの書き方があるため、例のとおり設定していたサイトでは、7.4.11以降で初めてホストが採用されるようになります。ただし開発サーバー(astro dev)でのクロスオリジンの確認は、7.4.12まではこの書き方の項目に一致しませんでした(上の7.4.13の修正)。手元の開発サーバーで確かめるときは7.4.13以降を使ってください。

なお、この比較は判定の関数を直接呼んだものです。@astrojs/node などのアダプターを通した実際のリクエストや、特定のCDNの背後での動作は確かめていません。

影響を受けるサイト、受けないサイト

ヘッダーを読むのは、リクエストのたびに描画するページです。すべてのページをビルド時に生成する静的なサイト(このGH Mediaのような構成)は、配信時にAstroがリクエストを受けないため、この判定は使われません。

影響を確かめたいのは、次の条件が重なるサイトです。

  • output: 'server'、またはページ単位で prerender = false にしたページがある
  • security.allowedDomains を設定している
  • ページやミドルウェアで Astro.url(または context.url)からURLを組み立てている

フォームの送信元の確認(security.checkOrigin)も、型定義の説明では、ブラウザーが送るヘッダーを「the Request URL」と比べる仕組みです。リクエストのURLの組み立てが変わると、この確認の結果にも関わる可能性があるため、フォームのあるサイトは更新後に実際の送信でも確かめてください(関係は編集部の整理で、送信の動作は未確認です)。

更新前の確認手順(編集部の提案)

  1. 許可リストを書き出す。 astro.config.mjs の security.allowedDomains の各項目に、protocol・port が書かれているかを控えます。protocol: 'https' だけの項目と、ポートを別の項目に分けて書いた構成は、上の比較で結果が変わったものです。
  2. 中継の機器が付けるヘッダーを確かめる。 CDN・ロードバランサー・リバースプロキシ(nginxなど)の設定で、X-Forwarded-Proto を付けているかを見ます。nginxなら proxy_set_header X-Forwarded-Proto $scheme; のような行があるかどうかです。付けていなければ、7.4.11以降では X-Forwarded-Host だけでは採用されない場合があります。
  3. 検証環境で同じヘッダーを送る。 更新したサーバー(2026年11月20日時点の最新は7.4.13)に、たとえば curl -H 'X-Forwarded-Host: www.example.com' -H 'X-Forwarded-Proto: https' http://localhost:4321/ のように送り、canonicalやリダイレクト先のURLを確かめます。Protoを外した場合も試すと、中継の機器の設定漏れに気づけます。このコマンドは本記事の作成では実際のサーバーで実行していません。
  4. 直し方を選ぶ。 中継の機器で X-Forwarded-Proto を付けるのが本来の直し方です。許可リスト側を protocol なしにして通す方法もありますが、httpでの転送も受け入れることになるため、編集部としては勧めません。

Astroの更新で手元のスクリプトや表示が変わった過去の例は、Astro 7.4.5の環境変数の記事でも扱いました。Nodeのアダプターで認証の保護が外れた件はbaseの設定の記事にまとめています。

確認した範囲

2026年11月15日に、withastro/astro のCHANGELOG(7.4.11・7.4.12)、変更のコミット(08e2cee、#18641)、型定義のドキュメント、npmの公開日時を確認しました(資料調査)。あわせて、npmから取得したastro 7.4.10と7.4.12の判定の関数に6通りの入力を渡して比べました(Node.js 22.23.4)。アダプターを通した実リクエスト、CDN・ロードバランサーの背後での動作、上のcurlのコマンドの実行は行っていません。2026年11月20日に、7.4.13(11月18日)のCHANGELOGと変更(#18711)、7.4.12との差分で判定の関数のファイルが変わっていないことを確認しました。

AstroでのWebサイトの制作や、公開後の更新の確認は、グリームハブのWebサイト制作のご相談で承っています。構成によって確かめる場所が変わるため、お問い合わせからご相談ください。

参考資料

この記事を共有XFacebook
鈴木 翔

技術の可能性に魅了され、学生時代からプログラミングとデジタルアートの分野に深い関心を持つ

この記事のテーマを、自社の次の一歩へ

Webサイトで、実現したいことから。

使う人の目的、必要な機能、更新の体制を整理し、制作・改善で最初に取り組むことを考えます。

  • サイトの目的
  • 機能と使いやすさ
  • 公開後の運用
Web制作・改善を相談する

構想段階からご相談いただけます。この記事の情報を相談フォームに引き継ぎます。

最新記事をメールで受け取る・Web制作ガイドを読む
無料ダウンロード

Web制作 費用・発注・集客 完全ガイド【2026年版】

費用相場・制作会社の選び方・集客戦略をPDFにまとめました。

The PDF and newsletter emails are currently in Japanese.

メルマガにも登録されます。いつでも解除可能です。