リバースプロキシがあるアプリを別のアプリのドメインにリダイレクトするのはなぜですか?

Eva Wong は テクニカルライター であり、 生粋の技術好き としてZimaSpaceで活動しています。ホームラボやオープンソースソフトウェア をこよなく愛する生粋のギークで、複雑な技術概念をわかりやすく、実践的なガイド にまとめることを得意としています。Evaは、セルフホスティングは難しいものではなく、楽しむものだと考えています。チュートリアルを通じて、初めてのNAS構築からDockerコンテナの使いこなしまで、コミュニティがハードウェアのセットアップをわかりやすく理解できるよう 支援しています。、初めてのNAS構築からDockerコンテナの習得まで。

バックエンドまたはミドルウェアが誤った公開ホスト名を使ってリダイレクトを生成すると、リバースプロキシによって、あるアプリから別のアプリのドメインに転送されることがあります。

ZimaSpaceのセルフホスト環境では、複数のアプリが同じプロキシを共有しながら、それぞれ独自の公開ベースURLを必要とする場合があります。Host、X-Forwarded-Host、スキーム、ミドルウェア、またはアプリ側の正規URLが別のサービスを指していると、最初のページは正しく表示されても、次の301、302、またはログインコールバックで別のドメインに移動することがあります。

バックエンドに送られるHostとスキームを確認する

リダイレクトを再現しながら、プロキシとバックエンドでリクエストヘッダーを記録してください。

転送されたホスト名とスキームがバックエンドに届くことに焦点を当てたリバースプロキシの実装ガイドは、根底にあるプロトコルの説明だけでなく、同じ小さな問題を扱っているため、この分岐の原因を特定するのに役立ちます。

アプリのURLを変更する前に、プロキシヘッダーを修正してください。リクエストが別のホストを経由したと認識しているバックエンドは、正しい絶対リダイレクトを生成できません。

X-Forwarded-Hostを重点的に確認する

絶対URLの生成時に、生のHostヘッダーではなくX-Forwarded-Hostを使うフレームワークもあります。

X-Forwarded-Hostが公開ホスト名を保持することに焦点を当てたHTTPヘッダーの解説は、根底にあるプロトコルの説明だけでなく、同じ小さな問題を扱っているため、この分岐の原因を特定するのに役立ちます。

このヘッダーを、正常に動作するアプリと誤った宛先に転送されるアプリで比較してください。すべてのバックエンドを1つのドメインに固定するグローバルな上書き設定は削除してください。

アプリが絶対URLを生成するか確認する

プロキシヘッダーを信頼し、正規リンクやリダイレクトを生成するフレームワーク設定を探してください。

プロキシ背後で絶対URLが誤って生成される問題に焦点を当てた実践的なプロキシデバッグブログは、根底にあるプロトコルの説明だけでなく、同じ小さな問題を扱っているため、この分岐の原因を特定するのに役立ちます。

すべてのリダイレクトをエッジ側で書き換えるのではなく、フレームワークのプロキシ信頼設定または公開URL設定を修正してください。

アプリのベースURLまたは正規ドメインを確認する

多くのセルフホスト型アプリは、サイトURLをプロキシルールとは別に保存しています。

アプリケーションのベースURLがプロキシのホスト名を上書きする事例に焦点を当てた実践的なアプリ背後プロキシのケーススタディは、根底にあるプロトコルの説明だけでなく、同じ小さな問題を扱っているため、この分岐の原因を特定するのに役立ちます。

移行や復元の後に、保存されているアプリケーションURLの値を比較してください。コピーしたデータベースに、別のアプリ環境の正規ホスト名が残っていることがあります。

バックエンドの手前にあるリダイレクトミドルウェアを監査する

プロキシルールによって、アプリケーションにリクエストが届く前にスキームやホストが意図的に書き換えられることがあります。

リダイレクトミドルウェアでホストを置き換える方法を扱う、焦点を絞ったホームラボ向けTraefikガイドは、基礎となるプロトコルの説明だけでなく、同じ小さな問題を扱っているため、この分岐の切り分けに役立ちます。

テスト用のルーター1つで、疑わしいリダイレクトミドルウェアだけを無効にしてください。HTTPSの強制とドメイン間のリダイレクトは分けて考えます。

OAuthとOIDCのコールバックURLを確認する

認証フローでは、プロバイダーが正確なリダイレクトURIを検証するため、誤った公開ホスト名が明らかになることがよくあります。

OIDCコールバックは公開プロキシURLに依存するを扱う、焦点を絞ったOIDCのトラブルシューティング記事は、基礎となるプロトコルの説明だけでなく、同じ小さな問題を扱っているため、この分岐の切り分けに役立ちます。

発行者、コールバック、転送ヘッダー、アプリのベースURLをまとめて比較してください。通常のページが読み込まれても、ログインのコールバック経路が正しいとは限りません。

ホームサーバーの同じ経路を再テストする

変数を1つ変更したら、別の経路を使う可能性のある別のテストに切り替えず、同じクライアントから同じNASまたはセルフホストのワークフローを再実行してください。

関連するZimaSpaceガイド隣接するホームサーバーのネットワーク経路を参考にすると、最終確認を同じセルフホスト環境に沿って行えます。

再接続、サービスの再起動、2回目の制御された転送またはリクエストの後も元の症状が解消したままであることを確認して、初めて修正が完了したと言えます。

よくある質問

DNSがHTTP 301や302の原因になることはありますか?

DNSが返すのはアドレスだけです。リダイレクトはプロキシ、認証レイヤー、またはアプリケーションが生成します。

ブラウザーでドメインが切り替わる前に、正しいアプリが読み込まれるのはなぜですか?

最初のプロキシルートが正しくても、バックエンドが誤ったベースURLや転送されたホストを使って、後続の絶対リダイレクトを生成することがあります。

プロキシですべてのLocationヘッダーを書き換えるべきですか?

いいえ。まず誤ったホスト名の発生源を修正してください。広範なレスポンス書き換えでは、アプリケーションの設定ミスが隠れてしまうことがあります。

サポートとヒント

続きを読む

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.