CI/CD

Next.js 16 Server Actionsのクロスオリジンリクエスト拒否?リバースプロキシの調査方法(2026)

Originはスキーム、ホスト、ポートからなる3要素で表されます。 MDNのOriginヘッダー解説に沿って送信元を確認し、プロキシ転送後のHostまたはX-Forwarded-Hostと照合してください。正当なクロスオリジン呼び出しが確認できた場合に限り、実際の経路に必要な送信元をserverActions.allowedOriginsへ追加します。これは汎用CORSスイッチではなく、プロキシ設定の誤りを覆い隠す用途にも使いません。

この記事は、リバースプロキシ、ゲートウェイ、複数ドメインのいずれかを介してNext.js 16 App Routerを運用するフロントエンド担当者向けです。
プロキシのヘッダー転送を管理するプラットフォーム担当者と、送信元の信頼範囲を決めるセキュリティ担当者にも、確認手順と検証基準を示します。

最初に失敗地点を特定する

「送信元が許可されない」という表示だけでは、Next.jsが拒否したのか、プロキシが遮断したのか、Action内の処理が失敗したのかは判断できません。ブラウザーの開発者ツールで該当リクエストの送信先、Origin、応答状態を記録し、同じ時刻のアプリケーションログと照合します。

  • アプリ側にリクエストの記録がない場合は、プロキシやゲートウェイのアクセスログ、ルーティング規則、遮断ログを先に調べます。
  • アプリに到達している場合は、受信したOriginとHost、またはX-Forwarded-Host、および拒否時のログを確認します。
  • リクエストが処理されて応答が返っている場合は、Action内部の認証・認可や処理エラーも調査対象です。

Next.jsの公式資料では、Server ActionsのリクエストでOriginとHost(またはX-Forwarded-Host)を比較し、追加の送信元をallowedOriginsで指定できると説明されています。Server Actionsの設定項目を参照しつつ、表示されたエラーだけをCORSの問題と決めつけないことが重要です。

ブラウザー側の呼び出し元を照合する

ページのアドレスとActionの送信先を見比べ、プロトコル、ホスト名、ポートがどう異なるかを記録します。ブラウザーが送るOriginは送信元を示すヘッダーであり、プロキシが上流へ渡すHostとは別の値として扱われることがあります。

  • ローカル、プレビュー、本番の各入口で、ページのURLとActionの送信先を記録します。
  • 失敗したリクエストのOrigin、送信先、応答状態を控えます。
  • Cookieや認証トークンなどの機密情報を除いたうえで、比較に必要なヘッダーだけを記録します。

本番だけで発生するなら、ローカルと本番のホスト名、TLS終端後のプロトコル、プレビュー用ドメインの違いを優先して比べます。Actionの呼び出しとサーバー側の更新処理はNext.jsのデータ変更ガイドで確認でき、ログイン中かどうかだけでなく、認証・認可の境界も公式の認証ガイドに従って別途検証します。

プロキシとプラットフォームの転送経路を追う

プロキシが受け取ったHostと、Next.jsへ転送したHost、X-Forwarded-Hostを各段階で比較します。中間のゲートウェイが公開ホスト名を内部名に置き換えている場合や、転送ヘッダーを落としている場合は、許可リストを広げる前に転送設定を直す必要があります。

X-Forwarded-Hostは、プロキシなどを経由したリクエストで元のホスト情報を伝えるために使われるヘッダーです。MDNのヘッダー解説と、Next.jsのセルフホスティングに関する説明を参照し、アプリが信頼する値がどの段階で設定されるかを確認します。複数のプロキシを通る構成では、最初の入口だけでなく、各段階の受信値と転送値を対応づけてください。

直結とプロキシ経由の比較では、同じAction、同じユーザー権限、同じ入力を用い、経路だけを変えます。直結では成功し、プロキシ経由でのみ失敗するなら、キャッシュやReactのクライアント状態より先に、ホスト情報の書き換えと転送を調べるのが妥当です。ゲートウェイの役割はHTTPの仕様でも定義されており、ゲートウェイ層の遮断とアプリケーションの送信元検証は別の処理として記録します。

アプリケーションの許可範囲を絞る

serverActions.allowedOriginsは、プロキシ設定の代わりではありません。公式のServer Actionsセキュリティガイドと、デプロイ中のNext.jsバージョンに対応する設定リファレンスを確認し、追加の許可が必要な構成かどうかを判断します。

設定例は、app.example.jpからの正当な呼び出しを確認でき、実環境の送信元と一致する場合に限って検討する形です。

const nextConfig = {
  experimental: {
    serverActions: {
      allowedOrigins: ['app.example.jp'],
    },
  },
};

export default nextConfig;

これは構成例であり、すべてのNext.js 16環境にそのまま適用できることを意味しません。設定の配置やサポート状況は導入中のバージョンの公式リファレンスで確認し、実測した送信元と異なるドメインを慣例で追加しないでください。ワイルドカードを含む広い範囲の指定も、信頼境界を不必要に広げるため避けます。

判断材料 優先する対応 避ける対応
アプリにリクエストが届いていない プロキシやゲートウェイの遮断・ルーティングを調査 allowedOriginsだけを変更する
アプリでOriginとHost系ヘッダーが不一致 転送ルールとアプリが参照するヘッダーを照合 不一致の理由を調べず許可範囲を広げる
正当なクロスオリジン呼び出しが確認できた 必要な送信元だけを設定し、拒否テストも行う すべての送信元を許可する
Action内の処理で失敗している 認証・認可、入力、アプリケーションログを調べる CORSやキャッシュの問題と決めつける

公開前の回帰確認を行う

修正の成否は、成功したリクエストが一度返ったかだけでは評価できません。想定する入口からActionを送って成功することと、許可していない入口からのリクエストが拒否されることの両方を確認し、修正によって信頼範囲が広がっていないか検証します。

  • 本番とプレビューそれぞれのページURL、Origin、アプリ到達後のホスト情報を記録します。
  • 許可対象からActionを実行し、処理結果とアプリのログを照合します。
  • 許可対象外の送信元からも試し、拒否されることを確かめます。
  • 修正前後のヘッダーと結果を、Cookieやトークンを除いて回帰記録に残します。

検証記録の整理には、KuzCloudのヘルプも参照できます。各チェック項目は、ブラウザー側の送信元、プロキシによる変換、アプリ側の判定を分けて残してください。

確認対象 残す証拠 合格条件
ブラウザーの送信元 秘匿情報を除いたOriginとActionの送信先 想定した公開入口と一致する
プロキシ転送 各段階のHost、X-Forwarded-Host、応答状態 意図しない書き換えや欠落がない
アプリの判定 到達ログ、Actionの結果、拒否時のログ 許可対象は成功し、対象外は拒否される
症状 優先して見る場所 次の判断
本番だけ拒否される 公開ドメインと転送後のヘッダー 環境ごとの入口・転送差を修正する
プロキシ経由だけ拒否される プロキシ前後のホスト情報 アプリが参照する値と転送規則を合わせる
アプリ到達後に処理が失敗する Actionログ、認証・認可、入力 送信元検証以外のアプリ処理を調査する
設定判断 採用条件 見直し条件
追加設定をしない OriginとHost系ヘッダーが想定どおり照合される 入口変更後に不一致が再発する
allowedOriginsを限定して追加する 正当な送信元と実際の経路を確認済み 許可理由を記録できない、または範囲が広すぎる
プロキシ設定を先に直す ヘッダー欠落や内部ホストへの置換が見つかった 修正後もアプリ側で不一致が残る

よくある疑問

本番だけで拒否される場合

まず本番の公開URLと、アプリが受け取るホスト情報をプレビュー環境と比較します。プロトコル終端やドメインの切り替えによって差が出ている場合は、キャッシュやクライアント状態を原因とみなす前に、入口ごとの転送ヘッダーとアプリログを揃えて確認してください。

allowedOriginsに書く値の決め方

ブラウザーの公開ドメインかプロキシの内部名かを、名前だけから決めないでください。実際のOriginとアプリ側のHost系ヘッダーを採取し、公式設定の意味と導入バージョンを確認したうえで、追加許可が必要な送信元だけを選びます。

CORSやキャッシュの問題との見分け方

ブラウザーのエラー表示だけでは、プロキシによる遮断、Server Actionsの送信元検証、Action内の処理失敗を区別できません。アプリ到達の有無、応答状態、OriginとHost系ヘッダー、サーバーログを突き合わせます。これらを確認する前にキャッシュ失効やクライアント状態の修正へ進むと、原因を取り違えるおそれがあります。

本番の入口やプロキシの挙動を再現する目的では、ローカル環境だけでは公開経路との差を確認しにくく、共用開発環境では別の設定変更が検証に影響し、自社でMacを購入すれば機器の調達や保守も必要になります。Mac上のブラウザーや開発環境を使った一時的な確認が必要なら、KuzCloudの利用環境案内で利用条件を確認し、Macレンタルを補助環境として検討できます。ただし、これは本番サーバーや本番プロキシの代替ではありません。リクエスト経路そのものの検証は、実際の運用構成で行ってください。

専用Macで、プロキシ設定の検証環境を整えませんか

KuzCloudなら、Apple Silicon搭載の物理Macを専有でき、実際の運用に近い環境で設定変更を検証できます。

フルroot権限と独立したIPv4アドレスを備え、必要なツールや検証環境を自由に構築できます。