Jellyfinはリバースプロキシのサブパス配下で動作しますか?

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

はい。Jellyfinはhttps://example.com/jellyfinのようなサブパスでリバースプロキシの背後に置いて動作させられますが、Jellyfinとプロキシで同じベースパスを設定する必要があります。

サブパスの障害は、サイトが一部だけ動作する形で現れることがよくあります。ログインページは読み込めても、JavaScript、画像、WebSocket、リダイレクト、ネイティブクライアントが失敗する場合があります。パスの不一致とTLSやプロキシの識別情報の問題を見分けられるよう、ベースURL、プロキシルート、転送ヘッダーとクライアントアドレスの順に各層をテストしてください。

JellyfinのベースURLを公開サブパスに合わせる

使用する公開プレフィックスと完全に一致するよう、JellyfinのベースURLを設定してください。たとえば/jellyfinです。プロキシで名前付きロケーションブロックを使っているからといって、異なる内部プレフィックスを追加しないでください。ブラウザーに表示されるパスとJellyfinのベースURLは、同じアプリケーションルートを示す必要があります。

JellyfinのApacheリバースプロキシに関するドキュメントには、サブパスの例が明記されており、クライアントを完全なアドレスに接続する前にベースURLを/jellyfinに設定するよう案内されています。公式のサブパス設定例

ベースURLを変更したらJellyfinを再起動し、新しいプライベートブラウザーウィンドウで公開サブパスを開いてください。最初のリダイレクトでただちに/jellyfinが消えたり、二重になったりする場合は、WebSocketや認証の設定に手を加える前にベースURLを修正してください。

リバースプロキシ経由で同じプレフィックスにルーティングする

公開プレフィックスで始まるリクエストが、余計なパス変換を加えずにJellyfinへ転送されるよう、リバースプロキシを設定してください。最もシンプルな構成は、公開プレフィックスを1つ、対応するJellyfinのベースURLを1つ、アップストリームサービスを1つにすることです。

CaddyのJellyfinガイドでも同じパターンが示されています。Jellyfinのベースパスを設定し、末尾にスラッシュを付けた形式へプレフィックスのみのURLをリダイレクトし、そのプレフィックス配下のリクエストをJellyfinバックエンドにプロキシします。一致するベースパスとプロキシルート

Jellyfinがリクエストをログに記録する前にブラウザーがプロキシから404を受け取る場合、プロキシ層のルートが誤っています。Jellyfinがリクエストを受け取っているのに、プレフィックスなしのリンクを生成する場合は、アプリケーション層のベースURLが誤っています。この2種類の障害の兆候を混同しないでください。

ログインページだけでなく、静的アセットとWebSocketも確認する

HTMLレスポンスが正常でも、サブパスの設定が正しいとは限りません。開発者ツールまたはプロキシのログを開き、JavaScript、CSS、画像、API、WebSocketへのリクエストがすべて同じ公開プレフィックス内に収まっていることを確認してください。

Jellyfinのリバースプロキシ設定例にWebSocketの処理が含まれているのは、インタラクティブなクライアントが通常のHTTPリクエストに加えてソケット接続を維持するためです。そのため、ページリクエストだけを処理するプロキシルールは、一見正しく機能しているように見えても、再生状況、セッションの更新、またはライブUIの動作に問題が生じることがあります。リバースプロキシの要件

合格条件はシンプルです。プレフィックス付きのアセットで404/502エラーが繰り返し発生せず、WebSocketが正常にアップグレードされ、ページ移動でサイトのルートに戻らないこと。特定の種類のリクエストだけが失敗する場合は、Jellyfinのライブラリや認証設定を変更するのではなく、そのプロキシルールを修正してください。

プロキシ経由でもクライアントの識別情報を維持する

パスが機能したら、転送されたクライアント情報を確認してください。Jellyfinは、転送されたアドレスやプロトコルを受け入れるかどうかをプロキシの信頼設定に基づいて判断します。これは、ローカルとリモートの動作や外部アクセスのルールに影響します。

Jellyfinのネットワークガイドでは、信頼されていないプロキシからの転送ヘッダーは破棄されると説明し、「既知のプロキシ」にプロキシアドレスを設定することを推奨しています。「既知のプロキシ」の設定サイトは機能するのに、すべてのリクエストがプロキシから発信されたように表示される場合は、別途クライアントIPの確認を行うと便利です。

すべてのプライベートサブネットや転送されたヘッダーを信頼することで、アクセス元の識別に関する問題を解決しようとしないでください。実際のプロキシホップまたは管理下にあるプロキシネットワークだけを追加し、JellyfinのログでLANからのリクエストとリモートからのリクエストを1つずつ比較して、想定どおりに分類されていることを確認してください。

ブラウザーとネイティブクライアントのアドレスを個別にテストする

JellyfinクライアントでサーバーURLを求められたら、サブパスを含む完全なサーバーアドレスを入力してください。https://example.comを保存したクライアントは、Jellyfinが/jellyfinの下で動作していることを推測できません。

LANからブラウザーとネイティブクライアントを1つずつテストし、次にパブリックホスト名経由でもテストしてください。ホスト名経由では機能するのに、ローカルIPへ直接アクセスすると機能しない場合、プロキシのルートや証明書がホスト名に依存しているため、想定どおりの可能性があります。このケースの切り分けには、プロキシのセキュリティを弱めずにホスト名とIPアドレスの比較テストを行うと便利です。

ログイン、ページ移動、WebSocketの使用、再生が、実際にサポートしているクライアントでプレフィックス付きURLのまま機能することを確認してください。ブラウザーやほかのクライアントでは問題なく、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.