Jellyfinのストレージは、永続的な状態、再構築可能なキャッシュ、負荷変動の大きいトランスコード用一時ファイルを分離して構成します。データベースと設定には、最も信頼性の高いローカルパスを割り当ててください。
ホームサーバーでは、高速なSSDに設定、データベース、キャッシュ、トランスコード用の一時領域を配置し、大容量メディアはより大きなストレージに保存できます。各ディレクトリを明示的に割り当て、コンテナのユーザーと空き容量の下限を確認してから再起動し、代表的なトランスコードを実行して、構成が完了したと判断してください。
永続パス、再構築可能なパス、一時パスを割り当てる
Jellyfinのパスがデフォルトのまま、または未文書化のマウントになっています。まずは影響の少ない確認から始めます。実際に使用されているデータ、設定、キャッシュ、ログ、Web、トランスコードの各パスを表示し、それぞれを永続、再構築可能、一時のいずれかに分類します。
確認すべき具体的な状態は、永続パスがローカルSSD上にあり、一時領域がルートファイルシステムを圧迫し、キャッシュがネットワーク共有上にある、といったものです。別の変数を変更する前に結果を記録してください。Jellyfinの実効パス
推測で進めず、分岐結果を解釈します。永続パスがローカルで信頼できるならそのまま使用し、一時領域が不足しているなら一時領域だけを移動し、データベースまたは設定がリモートにあるなら、再生の調整前にローカルへ移します。
パスとコンテナの権限を構成する
ストレージの役割が決まりました。まずは影響の少ない確認から始めます。パスを一度に1つだけ変更し、マウントテーブルを確認して、Jellyfinユーザーとしてテストファイルまたは一時ファイルを作成します。
確認すべき具体的な状態は、書き込みテストに成功する、権限が拒否される、パスが空のディレクトリとして解決される、といったものです。別の変数を変更する前に結果を記録してください。ローカルにマウントされたファイルシステム
推測で進めず、分岐結果を解釈します。書き込みに成功したら続行し、権限エラーが発生したらデータを削除せずに所有権を修正し、パスが空なら再スキャンする前にマウント先を修正します。
キャッシュとトランスコード用の空き容量下限を設定する
パスの構成と書き込み権限の確認が完了しました。まずは影響の少ない確認から始めます。通常利用で最も負荷の高い再生の組み合わせを実行し、一時領域の増加量と書き込みレイテンシを記録して、障害発生前にアラートを設定します。
確認すべき具体的な状態は、一時領域が一定範囲に収まる、負荷の集中時にボリュームが満杯になる、キャッシュが削除されず増え続ける、といったものです。別の変数を変更する前に結果を記録してください。トランスコード用空き容量の下限
推測で進めず、分岐結果を解釈します。一定範囲に収まるなら下限を維持して監視し、満杯になるならストリームを追加する前に一時領域を移動または拡張し、キャッシュが削除されないなら、そのパスとメンテナンスタスクを確認します。
再起動して代表的なトランスコードを再実行する
ストレージパスと空き容量の下限が構成されました。まずは影響の少ない確認から始めます。Jellyfinを一度再起動し、実効パスを確認してから、字幕またはスケーリングを使ったダイレクト再生とトランスコードを1つずつ実行し、一時ファイルがクリーンアップされることを確認します。
確認すべき具体的な状態は、パスが保持されて再生にも成功する、トランスコードがCPU処理にフォールバックする、一時領域への書き込みに失敗する、といったものです。別の変数を変更する前に結果を記録してください。
推測で進めず、分岐結果を解釈します。パスと再生に問題がなければ完了し、アクセラレーターのフォールバックが発生するならマッピングを個別に診断し、一時領域への書き込みに失敗するなら最後に動作していたパスへ戻して所有権を修正します。
サポートとヒント
もっと読む

Jellyfinは別のコンテナとGPUやアクセラレーターを安全に共有できますか?
GPUの共有には条件があります。デバイスが認識され、ドライバーが対応していることを確認してから、両方のワークロードを実行し、ソフトウェアフォールバックが発生していないか監視してください。

Jellyfinのエラーがクライアントとサーバーのどちらに起因するかを見分ける方法
Jellyfinのエラーが特定の1台のデバイスにだけ発生する場合はクライアント側に原因があり、同じ経路で複数のクライアントが失敗し、ログも一致する場合はサーバー側に原因があります。

Jellyfinのバックアップで不整合な状態が取得されるのを防ぐ方法
完全なファイルコピーだけでは自動的に整合性が確保されるわけではありません。書き込みを停止するかアトミックにスナップショットを取得し、すべての状態パスを記録したうえで、復元を検証してください。

