ZimaOS 1.7.0以降、Plexが起動しなくなったり、アプリエディターに「保存する前にYAMLプレースホルダーを解決してください」と表示されたりする場合は、アプリをアンインストールする前にZimaOSを1.7.1以降へ更新してください。 1.7.1では、YAMLの保存互換性が改善され、アプリのアンインストール時に設定フォルダーが削除される問題も修正されています。
元のユーザーはPlexを再インストールして復旧しましたが、IceWhaleは、1.7.0でPlexをアンインストールするとAppDataがデフォルトで削除されると直ちに警告しました。そのため、Plexの設定をすでにバックアップしていない限り、再インストールを最初に行うのは適切ではありません。
YAMLを手動で編集する前にZimaOSを更新する
公式のZimaOS 1.7.1リリースノートには、YAML保存の互換性向上と、アプリのアンインストール時に設定フォルダーが削除される問題の修正が記載されています。
プレースホルダー警告の原因
IceWhaleのサポートは、古いPlex YAMLのtipsテキストから<br>を削除するようユーザーに案内しました。これはPlexのデータベース障害ではなく、パッケージングとパーサーの互換性に関する問題でした。
Plexが実際に実行中か確認する
docker ps | grep -i plex
docker logs --tail 200 plex正常なLinuxServer Plexコンテナは、ポート32400の内部Webサービスに到達するはずです。
再インストール前にPlexのAppDataをバックアップする
Plexのメタデータには、ライブラリデータベース、視聴履歴、ポスター、サーバーIDが含まれます。コンテナを削除または再作成する前に、Plexの設定ディレクトリが正しくマッピングされていることを確認し、バックアップしてください。
最新のアプリストアパッケージを使用する
現在のZimaOS Plexアプリストアページには、保守されている1.43.2のリリース系列が掲載されています。
メディアボリュームのマッピングを確認する
Plexは起動するもののライブラリが空の場合は、アプリ設定を開き、ホスト側のメディアパスがPlexで使用するコンテナ内パスに引き続きマッピングされていることを確認してください。現在のPlexセットアップガイドで、対応しているストレージの設定方法を確認できます。
GPUデバイスを別途確認する
元のログでは、/dev/dri/renderD128と/dev/dri/card0の権限に問題がありませんでした。再生はできるもののトランスコードに失敗する場合は、YAMLエラーとは別にGPUのマッピングを診断してください。
Plexハードウェアガイドが、この場合の確認に役立ちます。
Plexの認証状態を確認する
元のログでは、ある実行時は認証済み、別の実行時は未認証でした。Plexは開くものの、サーバーやアカウントの状態が正しくない場合は、永続設定ボリュームが保持されていることを確認し、クレームトークンを再生成する前に、意図したPlexアカウントへログインしていることを確認してください。
ZimaOSの更新後にコンテナイメージを確認する
docker inspect plex --format '{{.Config.Image}}'実行中のイメージを現在のアプリストアパッケージと比較してください。ZimaOSを正常に更新しても、手動で固定した古いPlexイメージが自動的に変更されるとは限りません。
ライブラリを再構築する前にAppDataを復元する
アンインストール前にAppDataをバックアップしていた場合は、ライブラリのメタデータが失われたと判断する前に設定ディレクトリを復元してください。元のデータベースが無事なら避けられる、長時間の再スキャンやメタデータのダウンロードを、新しいPlexデータベースにテラバイト単位のメディアを再登録することで発生させずに済みます。
よくある質問
1.7.0のエラーを直すためにPlexをアンインストールすべきですか？
AppDataをバックアップするまでは、アンインストールしないでください。1.7.0では、アンインストールによって設定フォルダーが削除される可能性があるとIceWhaleが警告しています。
brプレースホルダーエラーは何を意味しますか？
アプリエディターがYAMLのヒントフィールド内のテキストを誤って解釈したという意味です。サポートは<br>エントリを削除するよう案内しました。
1.7.1でこの種の問題は解決しますか？
はい。変更履歴には、YAML保存の互換性向上とアプリ設定削除の修正が含まれています。
Plexは実行中なのにメディアが表示されないのはなぜですか？
ホストとコンテナ間のメディアボリュームのマッピングを確認し、Plexライブラリを再スキャンしてください。
