Home Assistantはリバースプロキシのサブパス経由で動作しますか?

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

Home Assistantはリバースプロキシの背後で実行できますが、書き換えられたサブパスから安定して配信することは、一般にサポート対象のデプロイ構成ではありません。

example.com/homeassistantのページがHTMLを返しても、後続のリクエストでルート相対アセット、認証ルート、WebSocket、インテグレーションのコールバックが対象になる場合があります。最初の画面だけでなく、より広くテストしてください。新しいブラウザーでサインインし、ライブダッシュボードを開いて、ネストされたルートを再読み込みし、コールバックを1つ完了させてください。どこかの層でプレフィックスが失われる場合は、書き換えを増やすのではなく、Home Assistantを専用ホスト名に移してください。

リバースプロキシのサポートとサブパスのサポートを区別する

リバースプロキシはTLSを終端し、ホスト名のルート宛てのリクエストをHome Assistantに転送できます。サブパスには別の要件が加わります。生成されるすべてのURL、アセット、API呼び出し、WebSocket、リダイレクト、コールバックで、アプリケーションが認識するプレフィックスを一貫して維持する必要があります。プロキシ層で成功しても、そのアプリケーション側の契約が満たされたことにはなりません。

Home Assistantコミュニティの検証では、このアプリケーションはURLプレフィックス配下へのデプロイをサポートしていないという直接的な結論に至っています。Home Assistantをサブパスに配置することへの最終的な回答では、プロキシの選択にかかわらずサブドメインを推奨しています。

リバースプロキシのサポートが合格とは、正しい転送設定のもとで、専用ホスト名のルートからHome Assistantが動作することです。提案されたサブパスが不合格とは、1つ以上のアプリケーションルートでプレフィックスが失われることです。この2つの判定を、リバースプロキシ自体に互換性がないという主張にまとめないでください。

最初の低リスクテストとしてフロントエンドのアセットを使う

Home Assistantを変更する前に、プライベートブラウザープロファイルで提案されたサブパスを開き、ネットワークリクエストを確認してください。ベースドキュメントは読み込まれる一方で、JavaScript、アイコン、マニフェスト、翻訳がホスト名のルートを起点とするパスを要求するなら、その構成はすでに最初の後戻り可能な判定で不合格です。

ドキュメント化されたパス書き換えを試したところ、メインページは返されましたが、フロントエンドのリソースはHome Assistantのプレフィックスなしでスラッシュから始まるURLを要求しました。このルート相対アセットの読み込み失敗は、アプリケーションのパス不一致であり、プロキシ上のファイル欠落ではありません。

合格とは、想定したルートでフロントエンドのすべてのリソースが正常に返されることです。不合格とは、404応答やルートパスへのリクエストが発生することです。その時点で中止し、専用ホスト名を使ってテストしてください。レスポンス本文の置換は脆弱で、将来のフロントエンドビルドで書き換え対象外の新しいパスが追加される可能性があります。

WebSocket、認証、ネストされたルートをテストする

静的なダッシュボードの外枠だけでは、セッション全体を検証したことにはなりません。まっさらなプロファイルからサインインし、数分間エンティティの更新を確認して、ネストされたダッシュボードのURLを再読み込みし、サインアウトしてから再度サインインしてください。その後、HTTPアップグレード、トークン、リダイレクト、ルートの再読み込みで、同じ公開オリジンとパスが維持されるか確認します。

Home Assistantはライブなフロントエンド通信にWebSocketを多用するため、プロキシはアップグレード処理とヘッダーを維持する必要があります。運用者によるリバースプロキシでのWebSocket処理の説明から、HTMLが読み込めるだけでは互換性テストとして不十分な理由がわかります。

PASSは、パス変換エラーなしで認証、ライブ更新、ナビゲーション、直接再読み込みがすべて機能することを意味します。ソケットまたはリダイレクトに限ってFAILとなる場合も、サブパス設計は不合格です。プロキシディレクティブを1つ修正しても、コールバックや今後のルートがプレフィックスに対応することの証明にはなりません。

安定した境界として専用ホスト名を選ぶ

Home Assistantをha.example.comのような専用ホスト名のルートで公開し、そのホスト名からリバースプロキシを経由して内部サービスにルーティングしてください。これにより、アプリケーションがパスプレフィックスに対応していなくても、公開オリジンを1つに保てます。プライベートVPNまたはトンネルを使えば、インターネットに公開せずに同様の明確なルート境界を実現できます。

ネットワーク変更後に既存のリモート接続経路が使えなくなった場合は、DNS、パブリックアドレス、NAT、トンネル、プロキシのルーティングをそれぞれ個別に確認してください。ZimaSpaceのルーター変更後のリモートアクセスに関する診断では、この関連経路を確認できます。

クリーンなブラウザーでアセットを読み込み、WebSocketを確立し、認証を行い、ネストされたルートを再読み込みし、プロキシの再起動後もHome Assistantにアクセスできる場合に、代替案は合格です。DNSまたはプロキシの変更をロールバックできるよう、以前のルートは必要な期間だけ利用可能にしてください。曖昧な公開URLを2つ、いつまでも運用しないでください。

完全なセッションが再起動後も維持されることを確認する

プロキシとHome Assistantを一度再起動してから、LANと予定しているリモートネットワークの両方で一連のテストを最初から最後まで繰り返してください。証明書名、転送されたクライアントアドレス、信頼するプロキシの範囲、ログイン、ライブ状態、ログアウト、1つのインテグレーションコールバックを確認します。これは元の負荷テストであり、静的ページだけの簡易確認ではありません。

すべての手順に合格したルートホスト名の設計のみを成功と判定してください。カスタムのレスポンス書き換えを行った場合に限り機能するサブパスは、アップデートでアセットやコールバックの動作が変わる可能性があるため、未対応の技術的負債として扱います。動作確認済みのホスト名、上流アドレス、ロールバック設定を記録してください。

ルートホスト名の設計でもまだ失敗する場合は、ベースパス対応ではなく、プロキシの信頼設定、WebSocket転送、DNS、証明書、またはルーティングに原因が残っている可能性が高いため、さらに調査してください。希望するURL形式を維持するためだけに、保護されていないポートでHome Assistantを直接公開しないでください。

サポートとヒント

続きを読む

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.