ストレージパスの変更後、Immichに古いデータが表示される

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

ストレージパスの変更後にImmichのデータが古いまま表示される原因は3つあり、混同してはいけません。管理対象メディアルートの移動、外部ライブラリのインポートパスの変更、またはキャッシュされた状態を表示し続けているクライアントです。現行のImmichリリースでは、設定されたメディア場所とボリュームマウントに一貫性があれば、移動した管理対象メディアの場所を調整できる場合があります。一方、外部ライブラリの移動は、依然として新しいアセットIDとして扱われることがあります。

再スキャンの前に、以前のパスとデータベースを保持してください。まず、実行中のコンテナから見えるパスを確認し、Immichサーバー側の記録が誤っているのか、それとも1つのクライアントだけが古い状態なのかを特定します。この違いによって、マウントの修復、コンテナから見えるパスの維持、テスト用サブセットの再スキャン、クライアントキャッシュのみの消去のどれを行うべきかが決まります。

管理対象メディアルートの移動と外部ライブラリの移動を区別する

Immichが管理するアップロードのホスト上の場所を変更した場合は、実効メディア場所の設定とホストからコンテナへのマウントが一緒に変更されたことを確認してください。現行バージョンの管理対象メディアの移動を、外部ライブラリのインポートパスの名前変更と同じように診断してはいけません。

ここではZimaSpaceのImmich永続状態マップが役立ちます。データベースとファイルシステムのパスが一体となって、復旧の境界を形成するからです。ホスト上のファイルが正しくても、コンテナが別の場所にマウントされていれば不十分です。

管理対象メディアのルートが一致していない場合は、ライブラリのジョブを実行する前に環境とボリュームのマッピングを修正し、サービスを再起動してください。変更されたパスが外部ライブラリのものである場合は、データベースをそのまま保持し、そのケースを別途テストしてください。

可能な限り外部ライブラリのコンテナパスを一定に保つ

外部ライブラリの場合、コンテナから見えるインポートパスを変えずに済むホスト側のストレージ移動が最も安全です。Immichに提示されるパスが変わる場合は、スキャンの前にアセットID、アルバム、人物、以前のパスを少数記録しておき、既存のアセットが再リンクされたのか、それとも再作成されたのかを確認できるようにしてください。

Immichの外部ライブラリのパス変更レポートでは、移動したファイルが新しいアセットとして扱われ、再処理によってImmich内だけの関連付けが失われた事例が説明されています。これは特定のバージョンに限った事例ですが、外部ライブラリのパス変更は自動的に透過的な名前変更として扱われるわけではない、という慎重なルールを裏付けています。

テスト対象の一部が新しいアセットとして表示される一方、古い記録が欠落またはゴミ箱入りになった場合は、全体の再スキャンを中止してください。可能であれば古いコンテナ内パスに戻すか、バージョンに適した移行方法を使用してください。検証済みのバックアップなしに、本番データベースのパスを手動で書き換えないでください。

この問題を、Immich管理ファイルのStorage Template移行と混同しないでください。タイムライン上の症状は似ているように見えるかもしれませんが、ファイルの所有者と対応する移行方法は異なります。

サーバーに保存されたパスとクライアントのキャッシュを切り分ける

既知の同じアセットをWebクライアントと、認証済みの別のクライアントで確認し、サーバーログまたはサーバーから見えるパスと比較します。サーバー側のジョブが古いパスを示し続けている場合、ブラウザーのキャッシュを消去しても根本の記録は修復できません。

後に発生したImmichの古いパスのメタデータ問題では、名前を変更した後も処理が以前の外部ライブラリのパスを参照し続けていました。これは、モバイル版やWeb UIを原因とみなす前に、ジョブ側のパスを確認すべき強い根拠です。

サーバーのパスが正しく、1つのWebビューだけが古い状態の場合は、そのクライアントのキャッシュを更新または消去し、元ファイルを再確認してください。キャッシュされたサムネイルや古いクライアント状態により、修復済みのサーバーが壊れているように見えることがあります。一方で、キャッシュされたプレビューにより、壊れたサーバーパスが正常に見えることもあります。

パス境界の最小範囲を修正し、制御された再スキャンを検証する

元に戻せる修正を1つだけ行います。管理対象メディアの設定とマウントを同期する、外部ライブラリのコンテナ内パスを以前の状態に戻す、インポートパスを修正する、または1つのクライアントのキャッシュを消去します。ライブラリが大規模に再検出される可能性のある操作を行う前に、データベースをバックアップしてください。

実用上最小限の再スキャンを実行し、既存の記録との関連付けが維持されるか、古いパスのエラーが止まるか、古いアセットと新しいアセットの重複が発生しないかを確認します。次に、サンプルの元ファイルを開き、アルバムと人物の関連付けを確認し、検索を実行してから、スタックを再起動します。

古いパスと新しいパスの記録が同時に有効なままになる、大きな外部ライブラリが予期せず再処理される、または元ファイルは読み取れるのに関連付けが消える場合は、エスカレーションしてください。変更前後のマウントマップ、Immichのバージョン、影響を受けたアセットID、ファイルシステムの大文字・小文字の扱い、データベースのバックアップ日時を正確に記録してください。

サポートとヒント

続きを読む

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.