不要な書き換えを許可せずにローカルメタデータファイルを設定する方法

エヴァ・ウォン

IceWhale author

エヴァ・ウォン は テクニカルライター であり ZimaSpaceの常駐ティンカーでもあります。 生涯のオタクであり、 ホームラボとオープンソースソフトウェアに情熱を持っています。彼女は複雑な技術的概念をわかりやすく、 実践的なガイドに翻訳することを専門としています。エヴァはセルフホスティングは楽しくあるべきで、怖がるものではないと信じています。彼女のチュートリアルを通じて、コミュニティが ハードウェアのセットアップを解明する手助けをしています。初めてのNAS構築からDockerコンテナの習得まで。

How to Set Up Local Metadata Files Without Allowing Unwanted Rewrites - Zima Store Online

ローカルのNFOファイルとアートワークを使えばメディアライブラリを持ち運べますが、それらを読み取る同じサーバーに、タイトル、画像、識別子を置き換える権限が与えられている場合もあります。読み取り専用のメディアマウントを使えば誤書き込みを防げますが、サーバーがダウンロードしたサイドカーを保存できる場所は変わります。

権限を変更する前に、各メタデータフィールドの正本を1つに決めてください。整理したサイドカーはバージョン管理またはバックアップし、サーバーのデータベース状態は書き込み可能なままにします。また、更新テストを行い、サーバーがソースファイルを書き換えずに読み取ることを確認してください。アップグレード後やライブラリ全体のメタデータ更新後にも、このテストを繰り返します。

どのメタデータソースを正本にするか決める

ローカルで管理するフィールドを一覧にします。タイトル、ソート用タイトル、エディション、日付、人物、プロバイダーID、ポスター、背景アートなどです。ローカルファイルを正本にする場合は、更新時にそれらのフィールドを上書きする可能性があるプロバイダー更新を無効にするか、制限してください。

ファイル命名規則を採用する前に、インストールしているサーバーファミリーのJellyfin NFOフィールドの動作を確認してください。サポート状況はライブラリの種類によって異なり、明らかに見えるファイル名でも、スキャナーが読み取るファイルとは限りません。

本番ライブラリの外に小さなサンプルディレクトリを用意します。1本の映画またはエピソード、そのNFO、選択したアートワークを含め、何千もの整理済みファイルを危険にさらすことなく、スキャンと更新の動作をテストできるようにします。

読み取り専用のメディアと書き込み可能なサーバー状態を分離する

コンテナ内ではメディアツリーを読み取り専用でマウントし、設定、キャッシュ、データベースのパスは書き込み可能なままにします。読み取り専用バインドマウントなどのコンテナフラグは、リリースによって意味が変わる可能性のあるアプリケーションのチェックボックスに頼るより強力です。

サーバーがメディアの隣に新しいアートワークをダウンロードする必要がある場合、ライブラリ全体を読み取り専用にする運用とは両立しません。代わりにダウンロードしたメタデータをアプリケーションの状態領域に保存するか、サーバープロセスの外部でサイドカーを書き込む、制御されたステージングジョブを使用してください。

マウント構成をデプロイ記録の一部として扱います。Jellyfinコンテナのアップグレードチェックリストを使うと、再作成時にメディア、メタデータ、アプリケーション状態の区別を維持できます。