プロキシまたはDNSの変更後にHome Assistantのセッションが失われるのはなぜですか?

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

プロキシやDNSの変更後にセッションが失われる場合、その原因は通常、クライアントが使用するURLのオリジンとHome Assistantが認識する経路の不一致であり、ユーザーアカウントの破損ではありません。

ブラウザーに旧ホスト名のCookieやフロントエンドの状態が残っている一方で、スマートフォンでは新しいアドレスが解決されている場合があります。また、プロキシがログインページを配信できても、認証後のWebSocketに失敗することがあります。まずプライベートブラウザーウィンドウ1つとLANへの直接接続テスト1つで確認し、それぞれの結果について正確なスキームとホスト名を記録してください。障害のある層を特定するまでは、すべてのセッションを削除しないでください。

1つのクライアントの状態と経路全体の障害を切り分ける

想定している最終URLを使ってプライベートウィンドウでHome Assistantを開き、問題が起きているブラウザーやモバイルアプリと比較してください。ログインが完了するか、ダッシュボードが5分間接続状態を維持するか、ページを更新してもセッションが維持されるかを記録してください。この元に戻せる比較により、サーバーを変更せずにクライアントの古い状態を確認できます。

プロキシがログインページを返しても、認証後のフロントエンドで接続できないと表示されることがあります。このログイン成功後の接続失敗は、HTMLが表示されるだけではセッション全体の経路が機能している証拠にならないことを示しています。

古いブラウザーだけで失敗し、プライベートウィンドウでは安定する場合は、そのクライアントで新旧両方のHome Assistantオリジンのサイトデータを削除してから、再度サインインしてください。プロキシ経由のURLではすべてのクライアントで失敗する一方、LANへの直接アクセスは機能する場合は、クライアントの状態をそのままにしてプロキシ経路を調べてください。

WebSocketとForwarded-Originの処理を確認する

ログイン中にブラウザーのネットワーク表示またはプロキシログを確認し、WebSocketのアップグレード、ステータス、切断までの時間、転送されたスキーム、転送されたホスト、クライアントアドレスを確認してください。重要なのは、HTTPページが読み込まれることと、認証済みの接続がアップグレードされて開いたまま維持されることの違いです。

Home Assistantのリバースプロキシのトラブルシューティングでは、通常のHTTPプロキシとは別にWebSocketの転送が必要であることが繰り返し指摘されています。この仕組みはアップグレード経路の解釈にのみ使い、すべてのプロキシに同じNginx設定が適用できる証拠として扱わないでください。

アップグレードに失敗する場合は、ログから誤りが確認できたプロキシルート、アップグレードヘッダー、転送されるスキーム、または信頼するプロキシの範囲だけを修正してください。成功して接続が維持される場合は、プロキシを変更せず、DNSとクライアントのオリジン状態を調査してください。

DNS応答と最終URLを比較する

問題が発生しているクライアント、動作するクライアント、プロキシホストからHome Assistantのホスト名を名前解決してください。IPv4、IPv6、スプリットDNSの応答、証明書名、リダイレクト先、コンパニオンアプリに保存されているURLを比較してください。DNSの変更が完了したとみなせるのは、クライアントが同じ正規ホスト名を使って意図したエンドポイントに到達したときだけです。

ディスカバリー、名前解決、ルーティングのより広い関係については、Home Assistantの到達性モデルで説明しています。これを使って、古いDNS応答とセッションレイヤーの障害を切り分けてください。

クライアントごとに異なるエンドポイントが解決される場合は、記載されたTTLの時間だけ待つか、影響を受けているクライアントとローカルリゾルバーだけのキャッシュをクリアしてください。ホスト名ごとに別のCookie境界とリダイレクト境界が生じるため、一時的なホスト名を追加で作成しないでください。

元のセッション経路を再テストし、対象を絞ってエスカレーションする

最後に使用するパブリックURLまたはプライベートURLからサインインし、ダッシュボードを開いたまま、ネストされたビューを再読み込みしてください。リモートアクセスが設計の一部であれば、ネットワークを一度切り替え、クライアントを一度再起動した後にもう一度試してください。合格とみなすには、元の問題を引き起こした操作の後も、正規URLが同じで、WebSocket接続が安定し、セッションが維持されている必要があります。

クリーンなクライアントでは動作するものの、既存のクライアントの1つで依然として失敗する場合は、そのクライアントのプロファイルまたはアプリの接続だけを修復してください。すべてのプロキシ経由のクライアントで、同じアップグレードまたはリダイレクトの兆候が見られる場合は、次の変更を試す前に、直前のプロキシまたはDNSの変更を元に戻し、ログを保存してください。

失敗しているURLの種類、DNS応答、プロキシのステータスコード、WebSocketの結果、タイムスタンプ、クライアント間の比較を正確に添えてエスカレーションしてください。異なる2つのクライアントで、更新と再接続後もセッションが維持されることを確認できたら、そこで止めてください。それ以上のCookieやプロキシの変更は、診断上の価値がなく、リスクを高めるだけです。

サポートとヒント

続きを読む

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.