Immichのキャッシュと一時ストレージの設定方法

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

Immichのキャッシュと一時ストレージを設定するには、まず永続的なライブラリの状態を、生成された派生データ、再利用可能なモデルキャッシュ、本当に破棄してよいコンテナの一時データから分けてください。

Immichが再生成できるため、サムネイルやエンコード済み動画はキャッシュのように思えるかもしれません。しかし、これらは永続的な作業用データであり、大量になって再構築に大きなコストがかかることがあります。モデルのダウンロードはライフサイクルが異なります。一方、ログや書き込み可能レイヤーの一時データが、気付かないうちに起動ディスクを消費してはなりません。役割に応じてストレージを割り当て、クリーンアップと再起動時の動作をテストしてください。

移動する前にストレージの役割を分類する

少なくとも次の4種類に分類してインベントリを作成してください。オリジナルと必須のアプリケーション状態、生成されたサムネイルとプレビュー、生成されたエンコード済み動画、モデル・ログ・一時的なランタイムデータです。それぞれについて、現在のパス、サイズ、増加率、バックアップ方針、再構築コスト、書き込みを行うサービスを記録してください。

ユーザーによる生成されたサムネイルと動画の増加についての報告は、サムネイルとエンコード済み動画を別々に測定する必要がある理由を示しています。メディアの構成や処理設定によって生成量が変わるため、個々の比率に普遍性はありません。

削除すると空き容量が増えるというだけで、ディレクトリを「キャッシュ」と呼ばないでください。失われると再生成に何日もかかったり、再生中のコンテンツに支障が出たり、復旧計画で保持する想定の状態が消えたりするなら、アプリが技術的には再作成できるとしても、明確な永続化の役割を割り当てるべきです。

頻繁に更新される生成データは、必要なレイテンシと耐久性に合った場所に置く

サムネイルやプレビューは操作時の閲覧に使われ、小さな読み込みが多数発生することがよくあります。一方、エンコード済み動画は、より大きな連続領域を消費することがあります。高速なSSDは派生データを多用する処理を改善できますが、移動によって実測された待ち時間が解消される場合に限られます。移動先に、またすぐいっぱいになる小容量ボリュームを作らないようにしてください。

ZimaSpaceのサムネイルストレージの増加に関する説明から応用できるストレージ上の教訓は、オリジナルデータを別の場所に置いていても、アプリが現在使用しているストレージがいっぱいになることがある、という点です。Immich固有のパスは異なりますが、実際に書き込み可能な役割を監視する必要があることは同じです。

メディアの大容量データをHDDやNASストレージに置き、派生データをSSDに移す場合は、両方の空き容量の下限を監視し、再起動後にすべてのマウントを確認してください。高速な派生データ用ストレージが役立つのは、通常の増加に対応できる十分な容量があり、その障害を正本のオリジナルデータの消失と取り違えない場合に限られます。

モデルキャッシュは意図的に永続化しつつ、再構築可能なものとして扱う

機械学習モデルは繰り返し推論に使うためにダウンロードまたは準備され、相当なストレージ容量を消費することがあります。モデルキャッシュを永続化すれば、不要なダウンロードや起動時の処理を避けられます。特に低速な接続では有効ですが、復旧階層におけるデータベースや家族のオリジナル写真と混同しないでください。

Immichのストレージアーキテクチャに関するコミュニティの議論は、運用者が高速なキャッシュ的データと大量の写真ストレージを分ける理由を示しています。こうした構成はあくまで例として参考にし、何かを移動する前に、自分のCompose定義で現在のパスとマウントを確認してください。

モデルキャッシュが失われた場合、必要な取得元にサービスがアクセスでき、十分なディスク容量があれば、通常はキャッシュを再作成または再ダウンロードして復旧できます。この動作を文書化し、再生成可能な大容量キャッシュをバックアップツールが誤って貴重なオフサイト容量を使って保護しないようにします。

書き込み可能レイヤー、ログ、スクラッチ領域の使用量に上限を設ける

コンテナの書き込み可能レイヤーを、永続化された派生データ、一時的なトランスコード、大容量のログの置き場として、文書化せずに使わないでください。Dockerのディスク使用量とコンテナのマウントを確認し、増加する大容量パスがすべて意図的に永続化されているか、意図的に破棄可能になっているかを確かめます。書き込み可能レイヤーの原因不明な急増は設定上の兆候であり、通常はクリーンアップの対象ではありません。

2026年版Docker HQの安全なDockerディスククリーンアップのワークフローでは、削除前の監査と、データベースが含まれている可能性のあるボリュームの保護が重視されています。ここでも同じ注意を適用してください。各ボリュームとレイヤーの所有関係が分かるまでは、本番のImmichホストで一括クリーンアップコマンドを実行しないでください。

ログローテーションを設定し、ピーク時に十分な余裕があるストレージにスクラッチパスを配置します。多数の小さなファイルが作成される場合は、バイト数だけでなくinodeの使用量も監視します。一時パスがいっぱいになった場合の正しい対処は、その役割の上限を設けるか別の場所に移すことであり、アプリケーションがたまたま起動するまで見慣れないディレクトリを削除することではありません。

再起動、再構築、空き容量のテストでストレージ変更を検証する

パスを変更したら、古いアセットと最近のアセットを開き、複数のアルバムを閲覧し、動画を再生して、サムネイル生成または機械学習のジョブを1つ実行し、管理された新しいファイルを1つアップロードします。書き込み先が意図したデバイスであり、データベースが引き続き読み取り可能なメディアを参照していることを確認します。

コンテナを再起動し、その後ホストを再起動します。設定が正しければ、各役割が自動的に再マウントされ、想定される派生データとモデルキャッシュが保持され、スクラッチ領域は破棄可能なままになり、使用中の各ストレージ階層に十分な空き容量が表示されます。通常のワークロード期間中、ストレージを監視して、想定どおりの場所で使用量が増えることを確認します。

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.