一時的なトランスコードファイルでシステムドライブがいっぱいになる:防止する方法

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

アクティブなトランスコード処理を停止し、一時セグメントの書き込み先を確認してから、クリーンアップを徹底し、パスをシステムドライブ以外に移してください。

メディアサーバーは、ソースライブラリが大容量のストレージプールにあっても、デフォルトのキャッシュやアプリケーションディレクトリにHLSセグメント、多重化し直したストリーム、字幕焼き付け用の出力、不完全なセッションファイルを保存する場合があります。これらのファイルが十分な速さで削除されない場合、トランスコードディレクトリのマッピングが誤っている場合、または再生終了後も中断されたセッションが残っている場合、システムドライブの空き容量がなくなります。ファイルを削除したりキャッシュを移動したりする前に、実際のディレクトリとセッションを診断してください。

アクティブなトランスコードディレクトリと容量の大きいセッションを特定する

制御されたトランスコードを1つ開始し、どのディレクトリが増加するかを監視してください。アプリケーションの設定、コンテナ内のパス、ホストのバインドマウント、ファイルシステム、空き容量、ファイル数、容量の大きいセッションサブディレクトリを記録してください。

Jellyfinでは、トランスコードの一時ファイル用に別の書き込み可能な場所を指定できます。これは、トランスコード先のパスが永続メディアライブラリやメタデータのパスとは別であることを示しています。該当する設定は一時トランスコード先のパスです。

アプリケーションに表示されるパスと、実際に容量が不足しているホストドライブが異なる場合は、Dockerの実効マウントと書き込み可能レイヤーを確認してください。バインドマウントが設定されていないと、コンテナは意図したキャッシュボリュームではなく、システム側のコンテナファイルシステムに一時ファイルを書き込む可能性があります。

緊急クリーンアップの前にプロデューサーを停止する

再生中のセッションを特定し、急速に増加しているファイルに関連するトランスコードだけを停止してください。空き容量を確保する前に、最新のFFmpegログ、ソースのタイトル、クライアント、出力ビットレート、字幕、開始時刻を保存してください。

以前、再生終了後も古いトランスコードファイルが残り、ディスクがいっぱいになってサーバーが起動できなくなったことがあります。Jellyfinのある課題では、ユーザーが視聴を停止してから数時間後も、映画がトランスコード用一時フォルダーを占有していたことが報告されています。

FFmpegが書き込み中のアクティブなセッションのファイルは削除しないでください。セッションまたはサーバーを正常に停止し、ファイルが開かれていないことを確認してから、キャッシュ全体やアプリケーションのデータベースではなく、一時出力であると確認できたものだけを削除します。

長時間のストリーミングセッションでセグメント削除を有効にする

再生中にサーバーがダウンロード済みのHLSセグメントを削除するか確認します。セグメント削除が無効だと、長編映画やライブストリームでは、生成された出力全体を保持できるだけのディスク容量が必要になる場合があります。

Jellyfinによると、セグメント削除機能は、クライアントがダウンロードした古いセグメントを削除し、トランスコード済みファイル全体をサーバーに保存せずに済むようにするものです。このオプションは、ストリーム全体の保存を防ぐために用意されています。

テスト用クライアントで有効にし、再生、シーク、再開の動作を監視します。セグメントを保持する必要がある、再現性のあるクライアントの問題がある場合に限って無効のままにし、その場合は専用トランスコードボリュームの容量を増やし、セッションのクリーンアップを強化します。

トランスコード先を専用の高速ボリュームに移す

OSのルートとは別の、専用SSD、NVMeキャッシュ、または十分な容量の一時ファイルシステムを選びます。保存先には複数の書き込みを同時に処理できる性能があり、想定される最大数のトランスコードセッションに十分な容量が必要です。

小容量のRAMディスクにトランスコードデータを置いているユーザーから、一時デバイスの容量が尽きるまでディレクトリが増え続ける可能性があるため、キャッシュ上限を設けてほしいという要望が寄せられています。障害につながるのは、保存先がRAMかSSDかにかかわらず、上限のないトランスコードキャッシュです。

サーバーを停止し、適切なサービス所有者を設定して新しいディレクトリを作成します。そのディレクトリをコンテナ内に明示的にマウントし、アプリケーション設定をコンテナから参照できるパスに更新します。トランスコードを1回実行し、ホストのシステムドライブの使用量が増えなくなったことを確認します。

古いセッションとクリーンアップの失敗を見つける

一時セッションディレクトリと、再生中のセッションIDおよびFFmpegプロセスを照合します。一致するセッションがなく、ファイルを開いているプロセスもなく、最終更新日時が古いファイルは、サポートされているクリーンアップの対象候補です。

一般的なキャッシュクリーンアップタスクですべてのトランスコード関連ファイルが削除されると思い込まないでください。先のJellyfinのクリーンアップ報告では、通常のキャッシュタスクで古いトランスコードファイルが削除されませんでした。そのため、本当に確認すべきなのはセッションごとのクリーンアップが完了したかどうかです。

クライアント切断、コンテナの再起動、クラッシュ、ネットワーク障害、プロセスの強制終了の前後にサーバーログを確認します。唯一の対策として毎日の削除スクリプトに頼るのではなく、サーバーが正常な停止イベントを受信できない原因を修正してください。

同時トランスコード時の最悪ケースの容量を測定する

代表的なリモートトランスコードを1回実行し、一時データの1分あたりのバイト数を測定します。字幕の焼き付け、HDRトーンマッピング、サポートされている最高の出力ビットレートでも繰り返し、想定する同時セッション数と保持時間を掛け合わせます。

システムドライブが満杯になると、再生以外にもメディアサーバーに影響することがあります。あるJellyfinのサポート事例では、トランスコードファイルによるドライブの容量不足がウェブインターフェースに接続できなくなった原因の可能性として指摘されており、システムボリュームの容量不足がアプリケーションの可用性に影響することを示しています。

オペレーティングシステム、ログ、データベース、パッケージ更新、Dockerのメタデータ用に空き容量を確保します。トランスコードボリュームが単独で障害を起こしても、サーバーの起動やメディアアプリケーションの起動が妨げられないようにしてください。

クリーンアップと容量アラートを確認する

再生開始、シーク、一時停止、クライアントの切断、サーバーの再起動、同時セッションをテストします。アクティブなファイルが専用のトランスコードパス内でのみ増加し、セッション終了後に縮小することを確認してください。

ZimaSpaceのホームメディアサーバーの構築ガイドでは、ソースストレージをアプリケーション用および一時データ用のワークロードから分離するための、より幅広い検証手順を紹介しています。

古いセッションが残らず、対応クライアントでセグメントを削除でき、システムドライブに安全な空き容量が確保され、専用トランスコードボリュームまたはルートファイルシステムの容量がしきい値に達する前にアラートが発報されれば、修復は完了です。

サポートとヒント

続きを読む

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.