リバースプロキシの再起動後にImmichへログインできない

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

リバースプロキシの再起動後にだけImmichへのログインに失敗する場合は、まずImmichアプリケーションとアカウントへの直接アクセスが機能する状態で、プロキシ経由の経路が壊れたのかどうかを確認してください。

再起動により、古いアップストリームアドレス、共有ネットワークへの参加漏れ、ヘッダーの変更、Cookieの動作、または依存先に接続可能になる前に起動したプロキシプロセスが明らかになることがあります。同じアカウントをローカルのImmichエンドポイントと通常のパブリックホスト名の両方で試し、2つの経路が最初に分岐する箇所を調べてください。

直接アクセスで認証とプロキシ障害を切り分ける

信頼できるローカル経路を使い、リバースプロキシを経由せずにImmichサーバーで既知のアカウントを試してください。直接ログインには成功する一方で、パブリックホスト名では読み込みが終わらない、リダイレクトが繰り返される、またはアップストリームエラーが返る場合は、ユーザー情報と認証の主要経路はおそらく正常です。調査対象をプロキシ、TLS、ルーティング、ブラウザーの状態に絞ってください。

直接アクセスでは機能する一方、プロキシ経由ではログインに失敗したというコミュニティの事例は、この切り分け方法の参考になります。この報告は特定バージョンに関するものなので、同じ根本原因だと思い込まず、接続経路を比較する根拠として利用してください。

直接アクセスとプロキシ経由のどちらでもログインに失敗する場合は、プロキシ設定の変更をやめてください。代わりにImmichのサービス状態、データベース接続、アカウントの状態、サーバーログを確認してください。障害の直前にプロキシを再起動したのは偶然かもしれません。バイパステストを行えば、そのタイミングだけを根拠のない診断に結び付けずに済みます。

プロキシから現在のImmichアップストリームに接続できるか確認する

プロキシの再起動後、プロキシ自身のネットワーク名前空間からImmichのアップストリームを名前解決し、接続できることを確認してください。Dockerでは、ユーザー定義の共有ネットワーク上でサービス名を指定するアップストリームのほうが、コンテナの再作成時に変わるコンテナIPを手動でコピーして使う方法よりも一般的に安定しています。

プロキシからImmichへの接続に関するリバースプロキシの障害についての議論から、アカウントの復旧を試す前にアップストリームへの到達性とWebSocket対応のプロキシ設定を確認すべき理由がわかります。個別の設定は逸話的な事例として扱い、すべてのプロキシに使えるテンプレートだと考えないでください。

プロキシだけを2回再起動し、その都度、同じサービスをアップストリームとして名前解決できるか確認してください。アドレスを編集せずにすぐ接続できれば合格です。再作成後に名前解決、ネットワークへの所属、または接続先ポートが変わる場合は、スタックを繰り返し再起動するのではなく、Composeのネットワーク定義を修正してください。

転送ヘッダー、TLS、Cookieの動作を調べる

プロキシがImmichのページを返していても、HTTPの経路全体に依存する認証が原因でログインに失敗することがあります。再起動の前後でプロキシの設定を比較し、ホストとスキームの転送、HTTPSの終端処理、リダイレクト、Cookieの書き換えの有無、さらに2つ目のプロキシやトンネルがレスポンスも変更していないか確認してください。

Immichコミュニティのある議論では、プロキシによるCookie処理がログインの停止を引き起こした重複Cookieによるログイン事例が紹介されています。これは限定的な事例ですが、認証情報が正しければプロキシ経由のセッションも必ず成功すると決めつけず、ブラウザーの応答とCookieを確認することが大切です。

ブラウザーのセッションが止まったように見えるからといって、すべてのアカウントを削除したり、データベースをリセットしたりしないでください。元のCookieと応答を記録してから、プライベートウィンドウまたは別のブラウザーを使ってください。クリーンなクライアントで動作する場合は、影響を受けたサイトの状態のみを消去し、不正なCookieまたはリダイレクトを発生させたプロキシルールを修正してください。

失敗したリクエストのタイムスタンプでプロキシのアクセスログとエラーログを確認する

ログインを1回試し、正確な時刻、パブリックホスト名、クライアント、返されたステータスを記録します。その後、そのリクエスト前後のプロキシのアクセスログとエラーログを確認してください。プロキシに到達しなかったリクエスト、プロキシが生成した4xxまたは5xx、アップストリームへの接続障害、Immichに到達してアプリケーションの応答を受け取ったリクエストを区別してください。

NGINXログのトラブルシューティング手順では、ステータス、アップストリームのエラー、リクエストの所要時間、対象を絞ったログ記録から、ログインページを何度も再読み込みするよりはるかに有力な手がかりが得られることを説明しています。同じ方法をCaddy、Traefikなどのプロキシにも適用してください。

プロキシログにアップストリームの成功応答が記録されているのに、ブラウザーでログインが完了しない場合は、リダイレクト、Cookie、TLS、クライアントの状態を調べてください。プロキシがアップストリームに接続できない場合は、ルーティングまたはサービスの起動準備を修正してください。Immich自体がエラーを返している場合は、プロキシが原因と決めつけず、該当するサーバーログを確認してください。

最初に問題を引き起こした再起動後も修正が有効であることを確認する

原因を特定して修正したら、問題が起きたときとまったく同じ操作を繰り返します。リバースプロキシのみを再起動し、ヘルスチェックが完了するまで待ってから、パブリックホスト名でログインします。次に、既存のアセットを開き、小さなファイルをアップロードして、通常のAPI通信を確認できるだけの時間、セッションを維持します。

ZimaSpaceの制御されたリモートアクセス経路のガイドでは、より広い境界を説明しています。リモートアクセスではプロキシは1つのレイヤーにすぎないため、DNS、TLS、認証、プライベートなアップストリームを意図的に構成し、状況を把握できる状態に保つ必要があります。

ログインがプロキシの再起動後も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.