更新後にハードウェアトランスコードが機能しなくなるのは、再作成されたコンテナから以前と同じデバイス、権限グループ、ランタイム機能、または互換性のあるユーザー空間のスタックが見えなくなることが一般的な原因です。
ホストのGPUが引き続き動作していても、イメージの置き換え後にPlex、Jellyfin、Emby、またはカメラアプリが気づかないうちにCPU処理へフォールバックすることがあります。まず、新しいコンテナ内にデバイスが存在するか、サービスユーザーがデバイスを開けるかを確認します。そのうえで、ランタイムのマッピングと権限を、イメージ固有のコーデックやドライバーのリグレッションと切り分けます。
処理が実際にソフトウェア方式へフォールバックしたことを確認する
トランスコードが必要なファイルを強制的に再生し、メディアサーバーのダッシュボード、FFmpegまたはトランスコーダーのログ、ホストのCPU使用率、GPUエンジンの動作状況を記録します。ダイレクトプレイではハードウェア処理の経路を検証できません。
LinuxServerコミュニティの事例では、CPUの動作だけでは誤解を招くことがあるため、明示的なハードウェア使用状況の指標とGPUのテレメトリーを確認するよう推奨しています。判断のポイントは、条件を制御したトランスコード中にGPUエンジンが実際に使用されていることです。
ログでハードウェアエンコーダーが正常に開かれている場合は、非対応のフィルター、字幕、トーンマッピング、または一部のみのハードウェアアクセラレーションを調べます。デバイスを開けない場合は、ホストでの検出とコンテナからのアクセスを引き続き確認します。
ホストとコンテナ内のGPUデバイスを比較する
更新後のコンテナ内外で、想定されるデバイスノードを一覧にします。IntelまたはAMDのVA-APIでは、/dev/dri/card*と/dev/dri/renderD*を比較します。NVIDIAでは、ランタイムから認識できるか、また管理ツールが報告するデバイスを比較します。
UnraidのQuick Sync事例によると、/dev/driが存在するにはホストで適切なカーネルモジュールが必要な場合があり、コンテナにもそのデバイスを渡す必要があります。欠けていることが多いのは、メディアライブラリやアプリのデータベースではなく、/dev/driデバイスのマッピングです。
ホスト上にデバイスが存在しない場合は、まずホストのドライバー、BIOS、カーネル、またはハードウェアの状態を修復します。ホスト上には存在するもののコンテナ内にない場合は、以前と現在のCompose設定、またはUIで生成されたデバイス設定を比較します。
renderグループとvideoグループへのアクセスを確認する
ホスト上のGPUデバイスノードの数値の所有者IDとグループIDを記録し、コンテナ内のサービスユーザーに割り当てられているグループを確認します。renderなどの名前は、イメージによって異なる数値IDに対応する場合があります。
JellyfinのDockerトラブルシューティング事例では、ホストのrenderグループIDを明示的に一致させ、renderD128の権限を確認する設定が動作することが示されています。この数値によるrenderグループのマッピングは、イメージの変更によって内部のユーザーやグループが変わると、影響を受けることがあります。
デバイスを誰でも書き込み可能にするのではなく、コンテナ定義を通じて必要な補助グループを追加します。コンテナを再作成し、実際のメディアサービスユーザーとしてアクセスをテストします。
ランタイムフラグとイメージ固有の機能を確認する
以前と現在のイメージ定義を比較し、devices、group_add、GPUランタイム設定、機能変数、特権モード、およびコンテナマネージャーのテンプレート変更を確認します。
あるEmbyの報告では、アプリが利用可能な状態のままDockerでハードウェアアクセラレーションが停止しており、この問題を見落としやすくするGPU喪失後のソフトウェアフォールバックの例を示しています。
デバイスアクセスの限定的な問題を、広範な特権アクセスの付与で解決しないでください。エンコーダーの経路で必要となる最小限のデバイス権限とグループ権限を復元してください。
コンテナイメージの回帰とホストの障害を切り分ける
更新済みコンテナで簡単なGPUまたはFFmpegのテストを実行し、同じマウント、デバイスマッピング、メディアファイル、アプリ設定を使って、以前に固定したイメージと比較します。
同じランタイム状態で古いイメージがすぐに動作し、新しいイメージで失敗する場合は、ログを保存し、ユーザー空間、コーデック、FFmpeg、またはアプリケーションの回帰として扱ってください。管理されたイメージ比較でバージョンが原因と特定できているなら、権限を何度も変更しないでください。
ログから原因とわかる場合に限り、再生成可能であると文書化されたコーデックキャッシュのみを消去し、アプリのデータベースとメディアのメタデータには手を加えないでください。回帰の原因が判明するか修正されるまで、正常動作が確認されたイメージを固定してください。
修復後にパイプライン全体を検証する
ハードウェアデコード、エンコード、トーンマッピング、字幕の焼き込み、およびトランスコーディングを強制するクライアントを少なくとも1つテストします。ログに想定されたGPUデバイスが表示され、ホストでエンジンの動作が継続して確認できることを確かめます。
ZimaSpaceの手順実際のハードウェアトランスコーディングを確認するは、設定ページの切り替えよりも確実な完了テストになります。
更新済みまたは固定済みのコンテナが、再作成や再起動後もデバイスへのアクセスを維持し、想定されたコーデック経路でGPUを使用し、ひそかにフォールバックしなくなって初めて、問題が解決したと言えます。次回の更新に備え、以前のイメージダイジェストとランタイム定義をロールバックの基準として保持してください。
サポートとヒント
続きを読む

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

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

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



