新しいネットワークに移行した後、Jellyfinの環境を再構築する方法

ネットワーク移行後にJellyfinを再構築する際は、まずローカルサービスへの経路を復旧し、その後、ストレージのマウント、ID、DNS、リモートアクセスを個別の確認項目として検証してください。

新しいルーター、サブネット、VLAN、またはDNSドメインによって、クライアント、マウント、リバースプロキシが同じパスを共有できなくなり、正常なJellyfinデータベースが壊れているように見えることがあります。古いネットワークのメモとアプリケーションデータのコピーを保管してください。目標は、クライアントからサービス、メディアまでのパスが明確に把握でき、障害の層がJellyfinではなくネットワーク自体の場合に、そこで作業を止められる状態にすることです。

変更を加える前に旧パスを記録する

サーバーアドレス、ホスト名、サブネット、ゲートウェイ、DNS名、マウント済みメディアパス、リバースプロキシの接続先、証明書名、ファイアウォールルールやポート転送ルールを記録します。ローカルストリーミングとリモートストリーミングは分けて考えてください。旧ホストがまだ使用できる場合は、新しいアドレスを割り当てる前にJellyfinの設定をエクスポートし、ユーザーとライブラリを一覧にしてください。

これにより、再構築の基盤が整います。ユーザーがサービスにアクセスでき、サービスがデータベースとメディアにアクセスでき、バックアップが保存先に届く状態です。パブリックポートや新しいプロキシルールから始めないでください。

安定したアドレスでローカルサービスを復旧する

サーバーにDHCP予約または静的アドレスを設定し、同じLANからJellyfinのウェブインターフェースを開けることを確認します。サービスのバインドアドレスとホストのファイアウォールを確認し、DNSを変更する前にローカルクライアントでテストしてください。アプリが起動してもライブラリが空の場合は、データベースを再構築せず、いったん停止してストレージパスを確認してください。

Jellyfinの移行ガイダンスでは、内部データはパスに依存し、コンテナのパスは記録済みのメディアの場所と一致している必要があると強調されています（パスに依存する移行ガイダンス）。パスの不一致は、メタデータの問題ではなく、トポロジーの障害として扱ってください。

DNSの設定より先にマウントとアクセス権を復元する

メディアとバックアップのボリュームを安定したパスに再接続し、Jellyfinのサービスアカウントで読み取り権限をテストします。各ライブラリからファイルを1つずつ確認し、アプリケーションデータのディレクトリへの書き込みも1回テストしてください。キャッシュとダウンロード済みのアートワークは再構築可能なストレージに置き、ユーザーメディア、データベース、バックアップは保護された役割のストレージに保持します。

Jellyfinの起動前に再起動によってマウントが復元され、ライブラリのスキャンでファイル欠落の警告が出なければ合格です。マウントに対話的なログインが必要な場合は、続行する前に起動順序を修正してください。

Featured

ZimaBoard 2 - 大きなアイデアを実現するミニホームサーバー

Single board computer zimaboard2

$339.00 - $529.00

Buy Now

ID、DNS、リモートアクセスの順に再構築する

ローカル再生が機能したら、ホスト名と内部DNSレコードを復元します。IPアドレスではなく名前を使ってクライアントをテストし、その後、自宅の外からリバースプロキシまたはVPNを検証してください。認証と認可はルーティングとは分けて考えます。ログインに失敗しても、新しいポートフォワーディングが間違っている証拠にはなりません。

実際に使うクライアントの組み合わせで、ダイレクト再生とトランスコードをそれぞれ1回実行します。確認できたエンドポイント、再生モード、失敗箇所を記録してください。コミュニティの移行事例は、経路やネットワークに関する前提を比較するのに役立ちますが、そこで使われたハードウェアやルーターの設定を一般化しないでください（移行事例）。

ロールバックと拡張を明確にする

ローカル再生、ユーザーアクセス、リモートルーティング、復元がすべて成功するまで、古いDNSレコード、設定のバックアップ、以前のネットワークに関するメモを保持してください。共有経路の性能が低下した場合に限り、管理用の独立したVLANや2つ目のネットワークインターフェースなど、専用の経路を追加して拡張します。サーバーが安定したアドレス、再起動後も維持されるマウント、またはテスト済みの復旧経路を確保できない場合は、再構築を中止してください。クライアントをどれだけ再設定しても、こうした基盤の不足は解消できません。