スキャン、メタデータ処理、再生セッションの後もJellyfinのメモリ使用量が高いままになることがあります。「使用中メモリ」には、アプリケーションのヒープ、ネイティブメモリ割り当て、共有ライブラリ、トランスコード用tmpfs、ファイルシステムのページキャッシュ、コンテナに計上されるカーネルメモリなど、ライフサイクルの異なる複数の要素が含まれるためです。
一度高い値が出ただけでメモリリークと判断しないでください。まず、メモリがJellyfinプロセス、cgroup、ホストのキャッシュのどれに属するかを特定します。次に、同じワークロードを繰り返し実行し、回収不能な部分が安定した水準に達するか、それとも増え続けるかを確認してください。
ホストの空きメモリではなく、使用可能なメモリを確認する
Linuxは、使用されていないRAMを最近読み込んだファイルのキャッシュに利用します。そのため、Jellyfinがライブラリをスキャンしたり、大量のメタデータを読み込んだりすると、「free」の値が小さくなることがありますが、アプリケーションで使えるメモリは十分に残っている場合があります。
代表的なLinuxのページキャッシュに関する解説では、空きRAMが少ないことだけで問題と判断せず、使用可能なメモリとスワップの動作を確認することを推奨しています。回収可能なキャッシュは、別のワークロードがそのページを必要とするまでは有効に使われています。
使用可能なメモリがゼロに近づく、スワップの使用が継続的に増える、メモリ回収中にレイテンシが上がる、またはカーネルがOOMキルを記録するといった場合は、早めに注意してください。こうした兆候はメモリプレッシャーを示します。メモリプレッシャーがなければ、キャッシュが多くてもサーバーがウォームアップしているだけかもしれません。
コンテナ内で匿名メモリとファイルキャッシュを区別する
コンテナ内で動作するJellyfinでは、Dockerの使用率だけに頼らず、cgroupのメモリ内訳を確認してください。匿名メモリはヒープ、スタック、匿名マッピングを表し、ファイルバックメモリはページキャッシュを表します。ページキャッシュは通常、より解放されやすいものです。
最新のコンテナのメモリ計上ガイドでは、anon、file、slabを分けて説明しており、キャッシュを多用するコンテナを、プロセスのプライベートメモリが際限なく増加している状態と取り違えずに済みます。
ワークロードの実行前、ピーク時、完了から5分または10分後、そして同じ処理をもう一度実行した後の両方の値を記録してください。ファイルキャッシュが多くても安定しているなら、データがキャッシュされていると考えられます。同じ処理を繰り返すたびに匿名メモリが同程度ずつ増える場合は、プロセスやプラグインをさらに詳しく調べる必要があります。
一時ストレージもメモリになることを忘れずに
トランスコード用ディレクトリや別の作業パスがtmpfsを使用している場合、そのファイルはRAMを消費し、コンテナまたはホストのメモリ使用量に計上されることがあります。再生セッションを停止すると、解放可能な一時セグメントは最終的に解放されるはずですが、ジョブの中断やクリーンアップの失敗によって、tmpfsの使用量が大きいまま残ることがあります。
すべての追加ギガバイトが管理ヒープだと決めつけず、一時ファイルシステムを直接測定してください。また、画面上のJellyfinタスクが終了した後も、FFmpegなどの別プロセスが動作していないか確認してください。子プロセスがファイルやマッピングを保持していると、ダッシュボード上ではユーザージョブが完了していても、メモリが確保されたままになることがあります。
tmpfsの上限を設定してください。RAM上でのトランスコードが有効なのは、ピーク時のワーキングセットに加え、Jellyfin、オペレーティングシステム、ほかのコンテナを考慮しても、安全なメモリ余裕が残る場合だけです。通常のトランスコード中にメモリ上限に達する場合は、ホスト全体の必要容量を見積もったうえで、パスをSSDに移すか、上限を引き上げてください。
再現性のある頭打ちテストで、メモリ保持とリークを見分ける
ライブラリの閲覧、小規模なテスト対象セットのメタデータ更新、または代表的なトランスコードなど、管理されたワークロードを1つ選びます。プロセスのRSS、cgroupのanonとfile、ホストの使用可能RAM、スワップ、処理時間を記録します。クールダウン時間を同じにして、3回実行してください。
メモリ使用量の多いコンテナのワークフローでは、匿名メモリの継続的な増加やOOMによるメモリ圧迫は、キャッシュ主体で使用量が安定している状態とは区別して扱います。数値が元のアイドル時の値に戻ったかどうかを問うより、この違いに注目するほうが有用です。
ランタイムのアロケーターは、すべてのページをすぐにオペレーティングシステムへ返さず、再利用のためにメモリを保持する場合があります。重要なのは、同等の処理を繰り返すことでコミット済みメモリの使用量が増え続けるか、ホストに負荷がかかるかどうかです。処理後すぐにRSSが開始前のアイドル時の水準まで下がるかどうかではありません。
メモリ使用量が頭打ちにならない場合は、プラグイン、繰り返し実行されるジョブ、上限を調査する
同じワークロードを繰り返すたびに匿名メモリが段階的に増える場合は、必須ではないプラグインまたはバックグラウンド機能を一度に1つずつ無効にし、同じテストを繰り返してください。FFmpegの子プロセスが動いておらず、スキャンも進行していない、負荷の低いJellyfinプロセスと比較します。
コンテナのメモリ上限と、ホスト上で動作するほかのワークロードも確認してください。上限が低すぎると、通常のキャッシュやランタイムの動作が異常に見えることがあります。一方、混み合ったホストで上限を設けていないと、1つのサービスが大量のメモリを消費し、システム全体にメモリ回収の負荷をかけることがあります。
ZimaSpaceの最初に継続的な余裕がなくなるリソースについての議論が、適切な停止基準です。メモリの割り当てを変更するのは、ダッシュボードでアイドル状態のRAMがほとんど使われているように見えるからではなく、メモリ不足が一貫してJellyfinの障害に先行している場合に限ってください。
FAQ
JellyfinのRSSが高いだけで、自動的にメモリリークだと判断できますか?
いいえ。RSSには、ランタイムが再利用のために保持しているメモリや、処理が終わっても常駐し続けるページが含まれる場合があります。より明確なメモリリークの兆候は、同等の負荷を繰り返しても安定した水準に達せず、回収不能メモリまたは匿名メモリが増え続けることです。特に、使用可能なRAMが減ったり、スワップやOOMイベントが発生したりする場合は要注意です。
メモリを解放するために、毎晩Jellyfinを再起動すべきですか?
定期的な対処としてはおすすめしません。再起動は診断のための比較には使えますが、定期的に再起動すると増加パターンが見えなくなり、実際の原因を特定しにくくなります。まずプロセス、cgroup、キャッシュ、tmpfsのメモリを分類し、証拠によって特定された場合に限り、メモリリーク、クリーンアップの失敗、プラグイン、または上限不足を修正してください。
サポートとヒント
続きを読む

家族に見られないように、NAS上のアダルト動画を隠す方法
家族で使うNASでは、アダルト動画を非公開に保ちましょう。フォルダーのアクセス権、PlexとJellyfinのライブラリーへのアクセス、サムネイル、視聴履歴、共有テレビのログイン情報、DLNAを確認してください。

Transformersでコミュニティモデルを読み込む前に確認すべきこと
TransformersのJinjaサンドボックスアップデートを使って、モデルの来歴、チャットテンプレート、リモートコード、シリアライズされた重み、隔離された初回実行を確認しましょう。

Mirageをローカルで実行:1枚の画像から文字認識と物体検出
Cactus Computeの小型ローカルビジョンモデルを試し、実際の入力でOCRとオブジェクト抽出を検証して、メモリ、言語、プライバシーの制限を把握しましょう。



