プロキシやDNSの変更後、Jellyfinのセッションが切れるのはなぜですか?

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

プロキシやDNSを変更したからといって、Jellyfinのログインがすべて自動的に無効になるわけではありません。変更によってホスト名、スキーム、パス、バックエンドサーバーの識別情報、認証レイヤー、または既存のログイン状態が前提としているクライアント経路も変わると、セッションが失われることがあります。

まず、単なるDNSレコードの更新とオリジンの変更を区別します。既知のアカウントとデバイスを1つずつ固定し、LANからの直接アクセスと通常の公開ホスト名を比較して、クライアントデータを消去する前に最初の失敗リクエストを記録します。目的は、症状が消えるまでユーザーをリセットすることではなく、どの境界が変わったかを特定することです。

まず、公開オリジンが実際に変更されたかを判断する

変更前後のスキーム、ホスト名、ポート、ベースパス、プロキシルートを書き留めます。DNSのAレコードまたはAAAAレコードを変更すると、ブラウザーのオリジンを変えずに同じホスト名を別のアドレスへ向けられます。一方、ホスト名の変更やアプリケーションのベースパスの変更は、クライアントの接続境界を変えます。カスタムドメインへの移行では、アプリケーションと認証経路の両方を新しいドメインに合わせる必要があります。カスタムドメイン移行チェックリストを使うと、DNSとアプリケーションの連動関係を明確にできます。

認証状態は、それを提示する場所によって変わります。役立つセッションCookieのスコープ確認リストでは、まず各認証方式に設定されたドメインとパスを洗い出します。Jellyfinクライアントは状態をそれぞれ異なる方法で保存するため、ブラウザーの挙動がすべてのアプリを表すと思い込まず、影響を受けたクライアントでテストしてください。

古いホスト名では引き続き動作し、新しいホスト名ではログインを求められる場合は、証拠が得られるまでは想定内のオリジン移行として扱ってください。プロキシの変更後、同じホスト名で全員がログアウトされる場合は、ホスト名を維持し、上流のID、ヘッダー、プロキシ側の認証を確認してください。

DNSが引き続き同じJellyfinインスタンスに接続されていることを確認する

LANクライアントからホスト名を名前解決し、リモートアクセスが重要な場合は外部のリゾルバーからも確認します。返されたアドレスが意図したリバースプロキシに到達し、プロキシが古いコンテナ、テスト用インスタンス、復元クローン、または永続データベースが異なる別のサーバーではなく、想定したJellyfinサービスにルーティングしていることを確認してください。

DNSの切り替えによってクライアントが別のバックエンドに送られている場合、セッションの問題に見えることがあります。認証に手を加える前に、サーバーを識別できる応答、ユーザーリストの挙動、ライブラリの状態、プロキシのアップストリーム先を比較してください。新しい経路が新規または復元済みのJellyfinインスタンスに到達しているなら、既存のクライアント認証情報はそこで有効なセッションを示さなくなっている可能性があります。

The related ZimaSpace workflow for keeping proxy and session-state lifecycles separate is useful here: an ingress restart should not silently replace the application identity or the state that validates existing sessions.

Forwarded Host、Scheme、Path、Proxy Authenticationを比較する

変更後の実効プロキシ設定を記録してください。公開Host値、転送されたスキーム、クライアントアドレス、WebSocketのアップグレード経路、リダイレクト、認証ミドルウェアを、最後に正常に動作した設定と比較します。HTTPSから予期しないHTTPや別のホストのURLへのリダイレクトによって、正常なログインが消えたように見えることがあります。

Jellyfinの前段に別の認証レイヤーがある場合は、プロキシの置き換え中も、その署名キー、Cookie名、Cookieドメイン、セッションストアを安定させてください。ロードバランサーの設計では、スティッキーセッションとルーティングの状態を使ってリクエストを意図したバックエンドに振り分けます。このレイヤーを変更すると、Jellyfin自体は正常でも、ログアウトやリダイレクトループが発生することがあります。

無関係なプロキシ設定例からヘッダーをそのままコピーしないでください。失敗したリクエストやリダイレクトによって現在の値が誤っていると確認できた場合に限り、値を1つだけ変更します。最も安全なプロキシ設定は、公開オリジンを維持し、常に正しいバックエンドへ到達できる最小限の設定です。

元の証拠を消さずにクリーンなクライアントでテストする

何かを消去する前に、障害発生時刻、ブラウザーまたはアプリのバージョン、リクエストのステータス、リダイレクトの経路、プロキシのログ行、Jellyfinのログエントリーを保存してください。その後、プライベートブラウザーウィンドウまたは2台目のテスト端末を使って、新しい経路からサインインします。新しいログインに成功すれば接続可能であることは証明できますが、以前の状態が使えなくなった理由までは分かりません。

次の3つの経路を順に比較してください。LAN上のJellyfin直通アドレス、LAN上から通常のホスト名にアクセスする経路、LAN外から通常のホスト名にアクセスする経路です。直通アクセスは機能するのにホスト名では失敗する場合は、ユーザーやデータベースの状態を変更せず、DNS、TLS、プロキシ、ミドルウェアを調べてください。すべての経路で、正常と確認済みの同じアカウントが拒否される場合は、問題はJellyfinまたはその永続状態に戻っています。

リクエスト経路の証拠を記録した後で、問題のあるクライアント上の対象サイトの状態のみを消去してください。最初の手段として登録済みのデバイスをすべて削除したり、すべてのセッションを失効させたりするのは避けてください。ルーティングの移行とサーバー側の認証障害を見分けるための比較対象が失われてしまいます。

DNSの有効期限切れ、プロキシ再起動、再起動後に変更を検証する

対応する修正を適用したら、以前のDNS TTL期間が経過するまで待ち、プロキシのみを再起動してからJellyfinサービスを再起動し、最後にホストを再起動してください。各イベントの後、同じホスト名からログイン、ログアウト、再生開始、シーク、再接続をテストしてください。

安定した状態とは、ホスト名が引き続き意図したプロキシに名前解決され、プロキシが意図したJellyfinインスタンスに再接続し、通常のコンポーネント再起動後も既存セッションが維持されるべき場合は維持され、新規ログインも引き続き有効であることを意味します。スタック全体の起動時に限って障害が発生する場合は、プロキシからアップストリームへの復旧手順を使って、準備完了状態と認証を切り分けてください。

最終的なホスト名、プロキシのアップストリーム名、ベースパス、証明書の取得元、プロキシ側のセッションシークレットをデプロイメントノートに記録してください。そうすれば、今後のDNSやプロキシの変更を、ブラウザーの症状から改めて推測するのではなく、既知のID契約に照らしてテストできます。

よくある質問

DNSレコードを変更するだけでJellyfinのセッションは無効になりますか?

同じホスト名、スキーム、パス、Jellyfinインスタンスを引き続き使用する場合は、通常必要ありません。DNSの変更によってクライアントが別のバックエンドに送られる場合、公開オリジンが変わる場合、TLSやリダイレクトが変更される場合、またはJellyfinの前段にある認証レイヤーが変更される場合は、セッションに影響することがあります。

プロキシを変更した後、すべてのJellyfinセッションを失効させるべきですか?

最初の修復手段にしないでください。証拠として、問題が発生しているクライアントを1台残し、新しいルートが意図したサーバーに到達することを確認してから、新規ログインを別途テストしてください。意図的に認証情報を変更した場合、トークンの漏洩が疑われる場合、または古いクライアントの状態を信頼できなくなったことが確認された場合に限り、セッションを失効させてください。

サポートとヒント

続きを読む

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.