Immichは、失われたファイルをなぜ誤った所有者で再作成するのか?

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

Immichが汎用的な復旧機能として、欠落した元ファイルをひそかに再作成することはありません。削除したオブジェクトが再び現れた場合は、まずそれが生成サムネイル、エンコード済み動画、プロフィール用ファイル、XMPサイドカー、その他の書き込み可能なファイルのいずれなのかを特定してください。これらは異なるプロセスで再作成または書き換えられ、別の所有者が設定される場合があります。

破棄可能なオブジェクトを1つ再生成し、その親ディレクトリと比較します。ホスト上の数値UID/GIDとACLを、コンテナ内の実効書き込みユーザーと照合し、Immich、サイドカー書き込み機能、NASプロトコル、その他のホストプロセスのどれが実際に作成したのかを特定してください。書き込み元が判明するまでは、再帰的なchownやchmod 777は避けてください。

再作成されたファイルを親ディレクトリおよび正常な近隣ファイルと比較する

再作成されたファイル、その親ディレクトリ、正常に動作する古いファイルについて、所有者、グループ、モード、ACL、必要に応じて拡張属性、数値のUID/GIDを記録してください。NASとコンテナでは名前が誤解を招くことがあります。数値IDを確認すれば、一方のシステムの「immich」がもう一方のシステムでも同じIDに対応しているかがわかります。

NASに移動したファイルに対するZimaSpaceのアクセス権の仕組みは、そのまま当てはまります。新しいオブジェクトのアクセス権は、保存先のACL、コンテナのID、プロトコルのマッピング、作成ルールによって決まります。そのため、置き換えファイルは読み取り可能でも、別のツールのワークフローに支障をきたす所有者が設定されることがあります。再作成されたファイルが親ディレクトリの継承設定と一致し、表示名だけが見慣れない場合は、何かを変更する前に数値IDを確認してください。親ディレクトリや正常なファイルのどちらとも異なる場合は、引き続き書き込み元のIDを調べてください。問題はファイルシステムのACLではなく、コンテナの設定にある可能性があります。

置き換えファイルを書き込むプロセスと実効UID/GIDを特定する

安全な再生成を1回実行し、関連するログとファイルシステムを監視します。書き込みを行うコンテナ内の実効ユーザーとグループを確認してください。代わりにサイドカー、メタデータツール、バックアッププロセス、ホストスクリプトがファイルを作成している場合は、Immichの実行時のIDを変更するのではなく、そのサービスを調べてください。

コンテナ内の所有権は、名前ではなく数値で決まります。Dockerのファイル所有権についての解説では、UID/GIDのマッピングが一致しない場合、同じバインドマウントされたファイルでもホストとコンテナでユーザー名が異なって表示される理由を説明しています。共通の基準として数値IDを使用してください。

あるImmichの外部ライブラリの所有権に関する議論では、ある環境でXMPサイドカーがrootとして書き込まれる事例が報告されました。これは実効的な書き込みユーザーと、サポートされている実行時のユーザーIDを確認する根拠となる事例であり、現在のImmichのすべてのインストール環境で、再生成されるすべてのファイルがrootとして書き込まれるという意味ではありません。

コンテナを意図的にroot以外のユーザーで実行している場合は、そのUID/GIDがホストまたはNAS上に実際に存在し、マウント先への必要なアクセス権を持っていることを確認してください。コンテナ内のユーザー名は、同じ名前のホストアカウントと自動的に一致するわけではありません。

既存ファイルを何度も修正するのではなく、作成時のルールを修正する

原因が確認できた最小限の範囲を修正します。対応している場合はサービスのUID/GIDを合わせ、親ディレクトリのグループやACL継承を修正し、適切なumaskを設定するか、誤ったユーザーIDを割り当てているNAS共有のマッピングを変更してください。Immichと、正当にアクセスする必要のある他のユーザーの両方が、オリジナルファイルと生成ファイルにアクセスできる状態を維持してください。

安易な修復方法として、誰でも書き込めるパーミッションを使わないでください。ユーザーIDの不一致を隠し、必要以上に書き込み権限を広げてしまいます。同様に、PostgreSQLの所有権、モデルキャッシュ、アップロード、外部ライブラリを一つのコマンドで再帰的に変更しないでください。これらのパスは、意図的に異なるサービスユーザーを使用している場合があります。

外部ライブラリを不変に保つ必要がある場合は、読み取り専用でマウントし、アプリが所有する書き込み可能なデータは別の場所に置くことを検討してください。ただし、使用する機能がその場所へのサイドカー書き込みを必要としない場合に限ります。重要なのは望ましい所有権と書き込み動作を決めることであり、写真アーカイブ内のすべてのファイルを同じアカウントに所有させることではありません。

同じファイルを再作成し、再起動後に検証する

安全に再作成できる、破棄してもよい生成ファイルまたはテスト用サイドカーだけを削除してから、同じImmich操作を再度実行します。新しいファイルの所有者、グループ、ACLを確認し、Immichと、以前アクセスに失敗したもう一方のプログラムの両方から読み取れることを検証します。このテスト中はオリジナルのメディアに手を加えないでください。

コンテナを再起動してからホストを一度再起動し、修正したユーザーIDとマウント設定が再起動後も維持されることを確認します。修復が成功していれば、次のテストファイルは期待どおりの所有権で自動的に作成されます。Immichの書き込みと競合する、起動後に実行するchownスクリプトに依存してはいけません。

所有権の変更が予期せずデータベースやオリジナルファイルにまで及んだ場合、または再起動後にサービスが読み書きできなくなった場合は、作業を中止して保存済みの設定に戻してください。数値ID、ACLの出力、マウントオプション、コンテナの実効ユーザー、Composeの該当部分、Immichが再作成した正確なファイル種別を添えてエスカレーションしてください。

サポートとヒント

続きを読む

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.