Jellyfinが想定どおりの設定ファイルを使用しているか確認する方法

はい、ホスト上でたまたまファイルが存在する場所から推測しなくても、Jellyfinが想定どおりの設定ディレクトリを使用しているか確認できます。信頼できる方法は、Jellyfinのパス優先順位を確認し、実行中のプロセスまたはコンテナ設定を調べ、設定ファイルを変更する前に起動ログで有効なパスを確認することです。

これは、パッケージインストールからDockerへ移行した場合、composeファイルをコピーした場合、または以前のサーバーを復元した場合に重要です。network.xml、system.xml、logging.jsonのコピーが複数存在していても、実際に有効なのは1つのディレクトリだけだからです。症状が消えるまで各コピーを編集してはいけません。まず有効な設定ディレクトリを特定し、元に戻せる変更を1つだけ行い、再起動後にJellyfinが同じパスを報告することを確認してください。

まず設定パスの優先順位を確認する

Jellyfinの起動方法から確認します。コマンドラインの--configdirは、環境変数JELLYFIN_CONFIG_DIRより優先されます。より優先度の高い設定がない場合にのみ、プラットフォームのデフォルト値が使用されます。

公式の設定パスの優先順位には、データ、設定、キャッシュ、Webディレクトリのパス優先順位が記載されています。使い慣れたホスト上のフォルダーが有効だと思い込む前に、その順序をサービスユニット、コンテナ環境変数、または起動コマンドと照らし合わせてください。

より優先度の高い設定が予期しない場所を指している場合は、そこで確認を止めてください。ディスク上で見つけた別のファイルが、Jellyfinによって読み込まれている証拠にはなりません。起動設定を修正するか、有効なパスを意図的に維持して記録してください。

実行中のコンテナまたはサービス定義を調べる

Dockerでは、ディスク上に保存されているcomposeファイルだけでなく、実行中のコンテナを調べてください。実行中のコンテナからは、そのコンテナの作成時に実際に適用された環境変数とマウントを確認できます。

Dockerの実行中コンテナの定義は、実行中のコンテナに関する低レベルの情報を返します。これは、環境変数の値やマウント先を、想定しているJellyfinのパスと比較するのに役立ちます。コンテナ作成後に編集したcomposeファイルは、現在の実行環境と一致しない可能性があります。

ネイティブサービスの場合は、systemdユニットと、それが読み込む環境ファイルを調べてください。実行時の定義と記録が一致しない場合は、実行時の設定を信頼したうえで、意図したパスを使うようサービスを再作成するか判断してください。

Jellyfinの起動時の情報でパスを確認する

想定するパスを記録したら、一度再起動して、Jellyfinの起動直後の行を確認します。設定済みのデータ、キャッシュ、ストレージのパスを探し、先ほど確認したプロセスまたはコンテナの定義と比較してください。

Webログインに成功したことだけを、正しい設定ディレクトリが有効である証拠にしてはいけません。Jellyfinは新しい設定パスや古い設定パスでも正常に起動し、有効なインターフェースを表示できます。その一方で、ユーザー設定、ネットワーク、プラグイン、スケジュールタスクが誤った状態から読み込まれる可能性があります。

メディアサーバーを別の導入方法へ移行する場合も、スタック全体に同じパス管理の原則が適用されます。実践的な出発点として、Jellyfinの自宅メディア環境では、アプリのパス、メディアのパス、アクセス用のパスをセットアップの別々の要素として扱っています。

Featured

ZimaCube 2 パーソナルクラウドホームNAS

ZimaCube2

$799.00 - $2,499.00

Buy Now

影響のない設定変更を1つだけ行って判別する

候補となるディレクトリが2つとも有効に見える場合は、サーバーのXML設定ファイルを編集する前にJellyfinを停止してください。明確な効果があり、元に戻せる設定を1つ選び、疑わしい有効ディレクトリだけで変更します。ファイルの選択を確認するためだけに、ユーザーデータやライブラリパスなど、大規模な再スキャンを引き起こす可能性があるものは変更しないでください。

Jellyfinを起動し、選択した設定が反映されるか確認します。反映された場合は、サービスをもう一度停止して変更を元に戻し、再度起動して永続化を確認してください。反映されない場合、そのファイルは有効ではないか、より優先度の高い設定ソースによって上書きされています。

この制御されたオフラインのA/Bテストは、タイムスタンプの比較より確実です。バックアップツール、パッケージのアップグレード、エディターは、いずれも無効なファイルに触れる可能性があるためです。Jellyfinでは、これらの設定オプションは基本的に静的で、サーバー起動前に設定するものと説明されています。そのため、特定の設定で別の動作が明記されていない限り、稼働中の編集は避けてください。

再起動後も有効なパスが維持されたら確認を終える

実行時の定義、起動時の情報、元に戻せる設定変更の3つが、再起動後も同じディレクトリを示していれば判定は確定です。そのパスを導入環境の記録とバックアップ対象に記載してください。

コンテナを再作成した後に有効なパスが変わる場合は、Jellyfinのファイルを繰り返し編集するのではなく、ボリュームと環境変数がどのように生成されているかを調べてください。その場合、問題はJellyfinの設定パーサーではなく、導入環境の状態にあります。

実行時のパスが明確であるにもかかわらず、Jellyfinが有効なファイル内の正しい設定を一貫して無視する場合にのみ、サポートへ相談してください。重複ファイルの問題と切り分けられるよう、問い合わせる前に起動ログと正確なバージョンを保存しておきましょう。