Next.js Server ActionsをCloudflare Workersにデプロイする前に何を確認する?2026
結論として、Next.js Server ActionsのCloudflare Workersデプロイは、「対応している」という表示だけで承認せず、選んだ適応経路、リクエストの信頼境界、アクション単位の認可、実行環境、ロールバックを本番相当の構成で確認してから判断してください。必要な機能や安全確認を検証できない場合は、独自の未検証ミドルウェアで補うのではなく、リリースを保留します。
対象は、Next.jsアプリを新たにWorkersへ配置するチーム、既存アプリを移行するエンジニア、そして公開可否と証跡に責任を持つ担当者です。特に、React 19.2を含む構成でServer Actionsを利用し、プロキシやカスタムドメインを経由する場合に役立ちます。
配置経路とアプリの状態を確認する
新規アプリと既存アプリでは、最初に確認する内容が異なります。新規の場合は、Cloudflareの現行Next.jsデプロイガイドが示す構成、アダプター、ビルド手順を採用し、必要な機能がその経路で動くかを確認します。既存アプリの場合は、現在のNext.js機能や依存パッケージを洗い出し、移行先の構成で置き換えが必要な処理を特定します。
Cloudflare Workers向けNext.js公式ガイドには配置経路と機能上の留意点が示されています。ただし、ガイドに機能対応が記載されていることは、すべてのアプリが同じ条件で移行できることや、安全性が自動的に満たされることを意味しません。採用時点の公式ガイドとアダプターの説明を読み、対象アプリのビルド・実行結果と照合してください。
| 判断項目 | 新規アプリ | 既存アプリ |
|---|---|---|
| まず確認するもの | 公式ガイドが示す適応経路とビルド手順 | 利用中の機能、依存関係、現在のビルド手順 |
| 主な検証 | Server Actions、フォーム、データ処理が選定構成で実行できるか | Node.js API依存、ファイル処理、外部サービス接続が移行先で成立するか |
| 承認の条件 | 採用する構成と必要機能の動作を記録できる | 差分と代替策を整理し、移行後の回帰結果を残せる |
送信元の信頼境界を追跡する
ブラウザーからアプリまでにプロキシや独自ドメインが入る場合、OriginとHostの値がどこで生成・変更され、アプリにどう届くかを経路ごとに調べます。Next.jsの設定資料では、Server ActionsのリクエストについてOriginとHostまたはX-Forwarded-Hostを比較する仕組みと、信頼する追加の送信元を指定するserverActions.allowedOriginsが説明されています。Server Actionsの公式設定資料を確認し、許可対象は実際に必要なドメインに限定してください。
テストでは、同一オリジンだけでなく、許可していないOrigin、Originがない場合、値が不正な場合も扱います。各ケースで、入口のプロキシがHostやX-Forwarded-Hostをどう設定し、アプリ側がどの値を根拠に判定したかを記録します。クライアントから送られた転送ヘッダーをそのまま信頼すると、アプリが想定していない送信元を許可してしまうおそれがあります。
注意:Next.jsのセキュリティ公告にはOriginが
nullとなるケースに関するCSRFの問題が記録されています。これは特定の条件に関する情報であり、Workersが一律にリクエストヘッダーを失うことや、すべてのエッジ配置で回避が起きることを示すものではありません。公告の影響範囲と修正情報を、対象バージョンと構成に照らして確認してください。
アクションごとの認証と権限を確かめる
Server Actionsは、画面上のボタンからしか呼ばれない内部処理として扱わないでください。ReactのServer Functions資料が説明するように、関数はネットワークリクエストを介して呼び出されます。したがって、各アクションをサーバー側で保護すべき入口として台帳化し、実行時に認証と認可を検証します。React Server Functionsの仕様も参照し、クライアントの表示制御だけをアクセス制御とみなさないでください。
資金、アカウント、権限、テナント情報を変更する処理では、次の拒否確認を行います。
- 未ログインの利用者が実行した場合、変更や外部送信が発生しない。
- 認証済みでも権限が不足する場合、操作が拒否される。
- 別テナントや別利用者の資源を指定した場合、対象の存在を含め不必要な情報を返さず拒否される。
- 失敗した要求について、データベース更新や通知などの副作用が残らない。
認証は「誰が呼んだか」、認可は「その利用者が対象資源に対して何をできるか」を確認する別の処理です。Next.jsの認証・認可ガイドに沿って実装を点検し、拒否結果と副作用がなかった証拠をテスト記録に残します。失敗したときだけログが出る構成では、どの権限条件を検証したか追えないため、確認対象と結果を関連付けてください。
フォーム、アップロード、実行環境を照合する
フォーム送信が小さな値だけを扱うのか、ファイルや大きなリクエスト本文を受けるのかで、必要な確認は変わります。Next.jsの設定資料には、Server ActionsのbodySizeLimitを設定する項目と、既定値として1MBが記載されています。この値はNext.js側の設定であり、Workersの全配置経路に共通する上限と読み替えてはいけません。実際の制約はWorkersのプラットフォーム制限と照らし、採用経路と契約条件に応じて確認してください。
Node.js APIを使う依存ライブラリーがある場合も、動作すると決めつけず、対象機能と設定を確認します。CloudflareのNode.js互換性資料にある対応状況を参照し、実際のビルドと実行で依存処理を検証してください。アップロードを含むときは、本文のサイズ、保存先、タイムアウト時の扱い、途中失敗後のデータ状態まで確認対象に含めます。
公開前の確認を実施し、証跡を残す
本番と同じドメイン・プロキシ・アダプター設定を反映した管理環境で、次の項目を順に確認します。保護機能の実装そのものを試すだけでなく、意図した拒否と副作用の有無を記録することが重要です。
- [ ] 採用するアダプター、Next.jsのバージョン、ビルド設定を記録し、現行の公式ガイドと照合した。
- [ ] Origin、Host、X-Forwarded-Hostの入口からアプリまでの受け渡しと上書き規則を確認した。
- [ ] 同一オリジン、許可外、欠落、不正な送信元情報を使ったテスト結果を保存した。
- [ ] 各Server Actionで未ログイン、権限不足、別テナントの要求を拒否し、更新などの副作用がないことを確認した。
- [ ] フォーム、アップロード、Node.js依存処理を、Workers側の制約と対象アダプターに照らして確認した。
- [ ] ビルド識別子、アプリログ、エッジ側の観測結果、テスト結論を同じリリース記録にひも付けた。
- [ ] デプロイ失敗や安全確認の異常を想定し、直前に承認した版へ戻す手順を実行または検証した。
OWASPのCSRF防止ガイドも確認し、フレームワークの送信元検証だけでなく、アプリの認証・認可や必要なCSRF対策がどう組み合わさるかを評価します。独自のHMAC署名やトークン検査を加える場合は、その実装とプロキシ経由の挙動も検証対象です。確認できない仕組みを、本番の安全性を保証する代替策として扱わないでください。
判断基準とリリース可否を記録する
FAQ:Workersで動くことは、そのまま本番公開の承認になりますか?
なりません。動作確認は選択した経路で機能が実行できる証拠ですが、送信元の検証、アクションごとの権限、実行環境の制約、復旧手順まで確認できたことを意味しません。未検証の項目が残る場合は、担当者と必要な証跡を指定して公開を止めます。
FAQ:エッジ配置でOriginとHostを検証するには何を記録しますか?
プロキシを含むリクエスト経路と、各段階のOrigin、Host、X-Forwarded-Hostの扱いを記録します。許可外や欠落などの入力に対する判定も残し、アプリがどの値を信頼したかを説明できる状態にします。転送ヘッダーをクライアント入力のまま信頼していないことも確認します。
FAQ:利用者の権限はフォーム側で制御すれば十分ですか?
十分ではありません。Server Actionの実行時にサーバー側で利用者と対象資源を照合し、権限不足やテナント境界を拒否する必要があります。拒否テストでは、応答だけでなくデータ更新や通知などの副作用が発生していないことも記録します。
| リリース判定 | 条件 | 判断 |
|---|---|---|
| 放行 | 適応経路と必要機能を確認し、送信元検証、動作単位の認可、実行環境、復旧証跡が揃っている | 承認者が証跡を確認したうえで公開 |
| 条件付き保留 | 影響範囲が限定され、未確認項目と担当者、再確認方法が明確 | 解消するまで公開しない |
| 阻止 | 信頼境界が不明、権限拒否を検証できない、必須機能が動かない、またはロールバックできない | 構成を修正し、再検証 |
Cloudflareの対応状況やアダプターの推奨経路は更新されるため、公開時点の資料と実際の構成を突き合わせてください。コミュニティで語られるヘッダー処理やCSRF回避の未確認情報だけを、全Workers環境に当てはまる阻止理由にしてはいけません。一方で、自分たちの構成で必要な挙動を再現・確認できないなら、その不確実性自体を未解決のリリース項目として扱います。
Workersの公開確認は、ブラウザーやAppleプラットフォーム固有の実機動作を代替しません。手元の端末や現在のテスト環境では確かめにくいmacOS・Safariの動作まで検証する必要がある場合に限り、KuzCloudのMacレンタルを選択肢として比較できます。Apple環境が不要で、同じWorkers構成での検証だけが目的なら、既存の管理環境とロールバック手順を整える方が適切です。詳しい利用手順はサポートガイドで確認でき、必要な環境を一時的に使う場合はKuzCloudのコンソールから利用条件を確認してください。
本番前の検証環境に、専用のリモートMacを
KuzCloudなら、Apple M4搭載の専用Mac miniをSSHやVNCで利用でき、開発環境に近い条件で動作を確認できます。
CPUやメモリをほかの利用者と共有しない実機環境で、ビルドやテストを安定して実行できます。