Immichの外部ライブラリを読み取り専用ソースとして設定する方法

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

Immichの外部ライブラリは、管理対象のアップロード領域の外にすでに保存されている写真をインデックス化します。ソースを読み取り専用でマウントすれば、アプリケーションやオペレーターのミスからオリジナルを保護できますが、サムネイル、エンコード済み動画、プロフィールデータ、データベースの状態を保存する書き込み可能なストレージは引き続き必要です。

したがって、このセットアップでは、変更しないソースフォルダーと書き込み可能な生成データという2つの信頼領域を使用します。大規模なアーカイブを追加する前に、小規模なパイロットライブラリで検出、メタデータ、サムネイル、再スキャン、削除の各テストを実施する必要があります。同じパイロットで、コンテナ内のパス、所有権、復旧計画が整合していることも確認できます。

ソースと管理対象のストレージを分けてマッピングする

既存のアーカイブ用にホスト側のパスと、/external/family-photosのような別のコンテナ側のパスを選びます。外部アセットと管理対象アセットではライフサイクルのルールが異なるため、Immichのアップロード保存先の下には配置しないでください。

Immichの外部ライブラリのワークフローでは、ユーザーに割り当てるパスをサーバーから参照できる必要があります。管理者がホスト専用のパスをアプリケーションに入力しないよう、マウント元とマウント先の両方を記録してください。

アップロード、サムネイル、エンコード済み動画、データベースデータ用のImmichの書き込み可能な保存先について、通常のバックアップと空き容量の監視が設定されていることを確認します。オリジナルを読み取り専用にしても、生成データや、ライブラリを使える状態に保つアセット情報は保護されません。

コンテナマウントを読み取り専用にする

Composeまたはコンテナ管理ツールで、読み取り専用フラグを付けてアーカイブをバインドマウントとして追加します。一般的な設定では、ホスト上の/srv/photos/archiveをコンテナ内の/external/archiveに:roを付けてマッピングします。

コンテナのプロセスに、すべての親ディレクトリを通過して読み取る権限を付与します。読み取り専用でも権限が不要になるわけではありません。ディレクトリに実行権限がないと、個々のファイルが読み取り可能でも検出できません。

ソースがネットワーク共有の場合は、コンテナの起動前にホスト側のマウントを安定させます。Immichのネットワーク共有の信頼性ガイドでは、パスが利用可能な状態であることと、アプリケーションの依存先として信頼できることの違いを解説しています。

パイロット用の外部ライブラリを追加してスキャンする

所有者となるImmichユーザーを作成または選択し、外部ライブラリを追加して、コンテナから見えるインポートパスを入力します。アーカイブ全体を指定するのではなく、コピーまたは重要ではないオリジナルを含むディレクトリから始めてください。

スキャンを実行し、想定どおりの写真と動画の件数が表示されることを確認します。ネストされたフォルダー内のアセットを開き、日付と場所を確認して、サムネイルやエンコード済みプレビューがオリジナルの隣ではなく、管理対象ストレージに書き込まれることを確かめてください。

ホスト側で、スキャンの前後にテスト用ソースの更新日時またはハッシュ値を比較します。また、コンテナ内からマウント先のパスにファイルを作成してみてください。読み取りは成功し、書き込みは失敗するはずです。

再スキャン、ファイルの欠落、復旧をテストする

ホスト側のソースにファイルを1つ追加し、再スキャンして表示されることを確認します。次に、テスト用のファイルをソースから一時的に移動して再スキャンし、実際のデータで試す前に、インストール済みのImmichのバージョンでアセットレコードがどのようにマークまたは削除されるかを確認してください。

通常の復旧計画に従って、データベースとImmichの書き込み可能なデータをバックアップしてください。アプリケーション側の読み取り専用マウントでは、ディスク障害、ホスト側での削除、破損を防げないため、外部オリジナルには別途独立したバックアップが必要です。

合格条件は、Immichがアーカイブをインデックス化して表示できること、アーカイブに書き込めないこと、そして外部ソースを管理対象のアップロードとして扱わずに再構築できることです。生成ファイルがオリジナルと同じ場所に作成された場合や、マウントが見つからないことをライブラリが空であると誤認した場合は、中止してください。

よくある質問

読み取り専用マウントにすると、Immichがオリジナルを削除できなくなりますか? コンテナのそのマウント経由での書き込みは防げます。ただし、ホスト側での削除、別の書き込み可能な共有、ファイルシステム障害、管理者によるマウントモードの変更までは防げません。

外部ライブラリのサムネイルはどこに保存されますか? 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.