スタックの再作成後、Plexはなぜ永続データにアクセスできなくなるのか?

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

スタック再作成後にPlexが新規インスタンスとして表示された場合は、旧永続データが実際に失われたと確認できるまで、マウントまたは権限の問題として扱ってください。

DockerまたはComposeスタックを再作成するとコンテナが置き換えられ、`/config`の保存先となるホストパス、名前付きボリューム、ユーザーID、ストレージプールも変わることがあります。その結果、Plexは空のディレクトリや読み取れないディレクトリを開き、元のデータベースが残っているのに新規インストールのように見えます。新しいインスタンスを停止し、旧appdataを見つけて、実際のマウント設定と数値の所有者情報を比較してください。そのデータが本当に失われている場合に限り、バックアップから復元します。

Plexが新規サーバーのように見えたら停止する

スタックの再作成後に初回セットアップウィザードが表示されても、これは永続化に問題がある兆候であり、ライブラリを再構築する合図ではありません。コンテナを停止し、Plexがさらにデータを書き込む前にマッピングを確認してください。最もよくある原因は、新しいコンテナが以前のアプリケーションデータディレクトリではなく、空のホストパスを読み込んでいることです。

スタックの再作成後、想定される永続設定のマッピングが元のappdataを指さなくなると、コンテナに初回セットアップ画面が表示されることがあります。最初に確認すべきなのは、旧データがホスト上に残っているかどうかです。

以前のPlexデータディレクトリを見つけ、更新日時、データベースファイル、メタデータフォルダーを確認します。それらが存在する場合は、削除したり新しいサーバーを初期化したりしないでください。復旧の対象はメディアライブラリではなく、マウントパスとアクセス権限です。

旧環境と新環境の/configマッピングを正確に比較する

スタックを再作成すると、コンテナ内で見えるパスを変えずに、相対バインドマウント、名前付きボリューム、環境変数の置換、ストレージプール、Composeの作業ディレクトリが変わることがあります。Plexからは引き続き`/config`が見えていても、そのパスが別のホスト上の場所を指している可能性があります。

Plexコンテナのセットアップでは、設定をコンテナの外に保存するのが最も安全です。見た目が似たComposeファイルを信頼するのではなく、以前のデプロイ記録またはバックアップにある実際のマウント設定と、再作成したスタックの設定を比較してください。

既知の旧appdataを一時的な診断用コンテナに読み取り専用でマウントするか、ホスト上で直接確認します。想定されるデータベースと設定ファイルがあれば、本番環境のマッピングを修正してPlexを一度再起動します。ディレクトリが実際に存在しない場合は、バックアップからの復元に進みます。

データベースを疑う前に所有権を確認する

正しいホストパスを指定していても、再作成したコンテナが別のUID、GID、ユーザーネームスペース、またはセキュリティコンテキストで実行されていると、使用できないことがあります。データが正しい場所にマウントされていても、Plexは設定を保存できない、データベースファイルを開けない、ディレクトリを作成できないように見えることがあります。

Plexがアプリデータを作成または更新できない場合は、`777`を無差別に再帰適用して「修正」するのではなく、設定ディレクトリの権限を数値で確認してください。

コンテナ内でユーザー識別情報を確認し、ホスト上の数値の所有者とモードを比較します。意図したサービスアカウントにアクセス権を与えるため、必要最小限の所有権またはACLの修正を適用してください。その後Plexを起動し、新規セットアップではなく既存のサーバーが開くことを確認します。

数値上の所有者が一致していてもアクセスに失敗する場合は、データベースを変更する前にACL、コンテナのセキュリティラベル、ユーザー名前空間の動作を確認してください。UID/GIDが正しくても、別のアクセス制御レイヤーを回避することはできません。

アプリケーションの状態が戻ってからメディアのマウントを確認する

以前のサーバー識別情報とライブラリが再び表示されても、メディアのマウントが`/config`とは別に変更されていると、ライブラリが利用不可に見えることがあります。これは別の永続化領域の問題です。ライブラリを再作成したり、メディアをアプリケーションデータのディレクトリにコピーしたりせずに、メディアのパスを修正してください。

アプリケーションの状態とメディアのマウントは、別々の永続化領域として維持してください。こう分けておけば、まずPlexの識別情報を復元し、元のライブラリが再び表示されてから、見つからないメディアパスをトラブルシューティングできます。

Plexコンテナ内から既知のメディアパスをいくつか開きます。古いデータベースが`/media/movies`を参照しているのに、再作成したスタックが`/movies`を公開している場合は、想定される内部パスを復元するか、管理された手順でライブラリのパスを移行してください。マウントが安定するまで再スキャンしないでください。

元の状態が本当に失われた場合にのみバックアップから復元する

古いホストディレクトリが空、削除済み、または使用できないほど破損している場合は、最新の正常確認済みPlexアプリデータのバックアップを、適切にマッピングした空のパスに復元します。何が起きたのか後から調べられるよう、唯一の証拠を上書きせず、失敗した状態は別に保管してください。

信頼できるコンテナ復旧手順では、永続化された`/config`を保護し、使い捨てのアプリケーション層だけを置き換え、Plexへの再書き込みを許可する前にマウントを検証します。

復元後、サーバーの識別情報、ライブラリ数、視聴状態、ローカル再生、トランスコードを使用している場合はその動作、さらに1回の再起動を確認します。その後、実際に適用されているスタック構成とバックアップの保存場所を記録します。同じ永続データを手作業で推測することなく再作成できたときにのみ、インシデントは解決です。

サポートとヒント

続きを読む

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.