Immichのデータフォルダで権限のずれを防ぐ方法

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

Immichの権限のずれを防ぐには、異なるコンテナ、NASプロトコル、更新、メンテナンスジョブによって異なるIDの新しいファイルが作成される前に、ファイルの所有権とアクセスルールを予測可能な状態にしておく必要があります。

長期的に有効な解決策は、定期的に権限を再帰的にリセットすることではありません。数値のUID/GIDと各ワークフローで実際に必要なアクセス権限を記録し、マウントの所有権とACLの継承を意図的に設定して、読み取り専用パスと書き込み可能なパスを分け、変更のたびにファイル作成の流れをテストしてください。今日のライブラリがたまたま読める状態ではなく、明日作成される新しいファイルが緊急の`chown`なしで正しく作成されるようにすることで、権限のずれを防げます。

Immichの各パスを読み書きするIDを記録する

Immichにマウントされているホスト側のパスを列挙し、それぞれのパスでどのプロセスがファイルの読み取り、作成、名前変更、削除を行う想定なのかを特定します。書き込みを行う各プロセスについて、ホスト上とコンテナ内の数値UIDとGIDを記録してください。ファイルには所有権が数値で記録されるため、ユーザー名が一致しているかよりも数値IDの方が重要です。

Immich以外で書き込みを行うものも一覧に含めてください。SMBアップロード、NFSクライアント、バックアップツール、インポートスクリプト、メディア管理コンテナ、管理者のシェルは、いずれも同じディレクトリツリー内にファイルを作成する可能性があります。それぞれが異なるIDで作成すると、特定のパスでは機能しても別のパスでは失敗する所有者や権限設定が、ライブラリ内に徐々に増えていきます。

このID対応表をCompose設定と一緒に保管してください。そうすれば、今後のイメージ更新、サーバー移行、NASアカウントの復元時に、既知の正常な設定と照合でき、新しいアップロードが失敗し始めてから不一致に気づく事態を防げます。

所有者、共有グループ、最小限のアクセス権限を意図的に設定する

アプリケーションが管理するデータの所有者と、アクセスが必要な共有グループがある場合はそのグループを決めます。それぞれのワークフローには、必要な読み取り権限または書き込み権限だけを付与します。1つのコンテナがサムネイルを作成できない、またはインポートしたファイルを移動できないからといって、Immichのディレクトリ全体を書き込み可能にするのは避けてください。

UID/GIDの不一致や過度に広い権限設定は、共有ボリュームの障害によくある原因です。制限のないアクセスを許可するのではなく、コンテナとボリュームの権限を揃えるのがより安全な方法です。複数のサービスが同じストレージプールに触れるホームサーバーでは、特に重要です。

複数のサービスに書き込みアクセスが必要な場合は、アプリケーション間で再帰的な所有権の変更を繰り返すのではなく、共有グループと一貫したグループ権限またはACLを使用します。まず代表的なディレクトリで確認してください。写真ライブラリ全体にわたる広範な再帰的変更は、最新のバックアップがある場合に限り最終手段として行い、日常的なメンテナンスにはしないでください。

新しいファイルの権限を予測可能にする

既存のファイルの状態が完璧でも、作成ルールが誤っているために、新しいファイルではすぐにずれが生じることがあります。親ディレクトリのACL、デフォルトACLエントリ、umask、サービスの実行ID、そのパスに適用されるSMBまたはNFSの作成設定を確認してください。防止策の目標は、後から修復することではなく、継承を正しくすることです。

モードを再帰的に変更する前に、ホスト上の数値上の所有者と、コンテナ内で実際に実行されているUID/GIDを比較してください。このUID/GIDバインドマウントの確認を行うと、IDの不一致と、本当に権限が不足している状態とをすばやく見分けられます。許可を広げて問題を覆い隠すのではなく、所有者とグループの関係を修正してください。

通常の書き込み経路ごとに、小さなテストファイルを作成します。Immichへのアップロード、インポートの手順、利用している場合はSMB/NFS経由の転送、バックアップからの復元が対象です。各テスト後に所有者、グループ、モード、ACLを確認してください。2つの作成経路で互換性のない結果になる場合は、データをさらにインポートする前に、そのポリシーの競合を解決してください。

マウントや更新による所有者の書き換えを防ぐ

Composeの編集、イメージの更新、NASの再マウント、移行は、権限に影響する変更として扱ってください。適用前に、現在のマウント元とマウント先、パスが読み取り専用か読み書き可能か、コンテナ内で実際に使用されるユーザー、重要な各ディレクトリの数値上の所有者のサンプルを記録してください。

転送やネットワークストレージでは、異なるSMB/NFS ID、数値ID、ACLの継承、umaskの動作が持ち込まれることがあります。Immichのデータをファイルシステム間またはアクセス方法間で移動する際は、変更前のチェックリストとしてNASの権限変更時に問題が起きるポイントを確認してください。

変更後、一括処理を実行する前に、同じサンプルを比較してください。起動時に所有者が突然変わった場合は、スタックを停止し、どのエントリーポイント、メンテナンスタスク、またはIDの再マッピングが原因かを特定します。原因不明の再帰的な所有者変更を、大規模なライブラリ全体にわたって続けさせないでください。

簡単で再現可能なテストによるずれの監査

定期的に、またはアップグレード後に、簡易的な権限監査を実施します。変更のないオリジナルファイルを数点、最近のアップロード、新しく生成された派生ファイル、外部ライブラリのマウントを確認してください。予期しない所有者、グループアクセスの欠落、読み取り専用だったマウントの書き込み可能化、想定どおり継承されなくなったACLがないか調べます。

次に、エンドツーエンドの書き込みテストを実施します。通常のクライアントから使い捨てのファイルをアップロードし、Immichでの処理が終わったら開き、アプリケーションから削除します。外部ライブラリやインポート経由のパスを設定している場合は、その経路から代表的なファイルを1つ追加し、所有者が意図せず変更されることなくImmichが読み取れることを確認します。

防止策が機能していると判断できるのは、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.