コミュニティソリューション

ZimaOSでImmichのWebインターフェースがフリーズする場合:再インストールする前にアップデートしてください

Several users reported an Immich 2.2.x browser freeze while mobile access still worked; a participant later confirmed recovery after updating Immich through ZimaOS.

ImmichのWebインターフェースをサーバーやモバイルアプリから切り分ける

最初に現れた症状は、単純なコンテナのクラッシュではありませんでした。ブラウザーでImmichを開くとナビゲーションは表示されるものの、写真ライブラリの読み込みに失敗し、ImmichとZimaOSの両方のタブがフリーズすることがありました。

複数のユーザーから、Androidアプリは引き続き動作する一方、Chrome、Firefox、その他のブラウザーでは失敗するとの報告がありました。ある投稿者は、過去にImmichを利用した履歴のないFirefoxでもテストしており、すべてのケースをキャッシュの問題だけでは説明できませんでした。

ブラウザーのクリーンなセッションとモバイルアプリを比較し、写真に引き続きアクセスできるか確認します。モバイルでは成功してブラウザーでは失敗する場合、問題の範囲はWeb経路またはパッケージ化されたフロントエンドに絞られます。すべてのクライアントで失敗する場合は、サーバー、データベース、ストレージ、リソースをより広く確認する必要があります。

写真ライブラリが読み込まれず、ナビゲーションだけが表示されたImmichのWebインターフェース
ブラウザーには操作項目が表示されましたが、ライブラリの内容は読み込まれませんでした。

メディアファイルとデータベースの状態を分けて保護する

ボリュームを削除または変更する前に、Immichがアップロード済みアセットまたは外部ライブラリをどこに保存しているか確認します。重要な写真や動画を別のディスク、NAS、またはコンピューターにコピーし、コピーからサンプルを開いて確認してください。

アルバム、ユーザー、その他のメタデータはデータベースに依存するため、画像ファイルのフォルダーだけではアプリケーション全体のバックアップにはなりません。メディアと一緒に利用可能なデータベースダンプを保存し、現在のボリュームマッピングとImmichのバージョンを記録してください。

アプリを削除する際に、写真ストレージのディレクトリを削除しないでください。メディアのコピーまたはデータベース復旧用の入力のいずれかが不足している場合は、再インストールを行わず、まずバックアップ体制を整えてください。

原因と決めつけずにリソース不足を確認する

Immichの機械学習ジョブは、初回処理中に大量のCPUとメモリを使用することがあります。コミュニティの返信では、機械学習を一時的に無効にし、インターフェースが安定するか確認する方法が提案されました。

一方で、すでに機械学習タスクを完了していた参加者や、十分な性能のハードウェアを使用していた参加者、モバイルから引き続き閲覧できていた参加者もいました。そのため、この話題だけでは、機械学習が共通するブラウザー症状の原因だったとは証明できません。

システム負荷が高い場合は、1つのジョブを一時停止して、同じライブラリ表示を再テストします。改善が見られればリソース不足の可能性を支持します。変化がなければ、意図した設定を戻し、効果のないまま機能を無効にし続けずに次へ進んでください。

再インストールする前に、利用可能なZimaOSまたはImmichのアップデートを適用する

複数の報告がImmich 2.2.xの周辺に集中しており、その中には、アップグレード前は2.2.1が動作していたと述べるユーザーもいました。別の参加者は安定した2.1.0のインストール環境を報告し、ロールバックを提案しましたが、この話題ではロールバックが完了したことは記録されていません。

確認された復旧例では、あるユーザーがコンテナの更新を待った後、ZimaOSを通じてImmichを更新しました。再インストールやデータの復元を行わずに、Webインターフェースが再び動作しました。

更新後、ブラウザーで同じアルバムを開き、ライブラリをスクロールし、アセットを開き、アプリを再起動してから同じ操作を繰り返します。成功を1回のページ読み込みだけで判断しないよう、モバイルからのアクセスとアップロードも継続して確認してください。

ZimaOSでのブラウザーのフリーズ中に話題となったImmichのバージョン情報
この議論では、ハードウェア障害を証明するのではなく、バージョンによる挙動の違いが比較されました。

アップデート経路とバックアップを確認してから再インストールする

あるユーザーは外部ライブラリを使用したままアンインストールと再インストールを行いましたが、それでも問題が発生しました。そのため、再インストールは情報源で確認された修復方法ではなく、最初に行うべき手順でもありません。

アップデートで改善しない場合は、ログを確認し、正確な失敗時のバージョンを保存します。メディア、データベースのバックアップ、ボリュームマッピング、バージョン互換の復元手順が確認できている場合にのみ、再インストールしてください。

復旧とは、元のワークロードの下で、アルバム、ユーザー、アセット、モバイルバックアップ、ブラウザー上のライブラリがすべて正常に動作することです。メタデータが失われている、またはサービスが依然としてフリーズする場合は、コンテナを繰り返し削除せず、停止して以前の状態を復元してください。

よくある質問

写真を失わずにImmichを再インストールできますか?

ストレージディレクトリを保持している場合に限り可能ですが、写真だけを保護しても、すべてのアルバムやメタデータが保持されるわけではありません。復元可能なデータベースのバックアップも保存してください。

なぜImmichはモバイルでは動作するのに、ブラウザーではフリーズするのですか?

そのパターンから問題のある経路を絞り込めますが、この話題では、ブラウザー側に共通する単一の原因は証明されていません。確認されたユーザーの復旧方法は、パッケージのアップデートでした。

Immichを2.1.0にダウングレードすべきですか?

2.1.0が動作したという参加者の報告はありますが、スレッドにはロールバックの成功例は記録されていません。まず利用可能なサポート対象のアップデートを試し、復旧に必要なデータを保持してください。