Oui. Jellyfin peut fonctionner derrière un proxy inverse sur un sous-chemin tel que https://example.com/jellyfin, mais Jellyfin et le proxy doivent utiliser le même chemin de base.
Un problème de sous-chemin se manifeste généralement par un site partiellement fonctionnel : la page de connexion peut s’afficher alors que JavaScript, les images, les WebSockets, les redirections ou les clients natifs ne fonctionnent pas. Testez le chemin par étapes : d’abord l’URL de base, ensuite la route du proxy, puis les en-têtes transmis et l’adresse du client. Vous pourrez ainsi distinguer un décalage de chemin d’un problème lié à TLS ou à l’identité du proxy.
Faites correspondre l’URL de base de Jellyfin au sous-chemin public
Définissez l’URL de base de Jellyfin sur le préfixe public exact que vous souhaitez utiliser, par exemple /jellyfin. N’ajoutez pas de préfixe interne différent sous prétexte que le proxy utilise un bloc d’emplacement nommé ; le chemin visible dans le navigateur et l’URL de base Jellyfin doivent désigner la même racine d’application.
La documentation Apache de Jellyfin pour le proxy inverse fournit explicitement un exemple de sous-chemin et indique aux administrateurs de définir l’URL de base sur /jellyfin avant de connecter les clients à cette adresse complète. exemple officiel de sous-chemin
Redémarrez Jellyfin après avoir modifié l’URL de base, puis ouvrez le sous-chemin public dans une nouvelle fenêtre de navigation privée. Si la redirection initiale supprime immédiatement /jellyfin ou le duplique, corrigez l’URL de base avant de modifier les paramètres WebSocket ou d’authentification.
Acheminez le même préfixe via le proxy inverse
Configurez le proxy inverse de sorte que les requêtes commençant par le préfixe public soient transmises à Jellyfin sans transformation de chemin supplémentaire. La solution la plus simple consiste à utiliser un seul préfixe public, une URL de base Jellyfin correspondante et un seul service en amont.
Le guide de Caddy pour Jellyfin présente le même schéma : configurez le chemin de base de Jellyfin, redirigez le préfixe sans barre oblique finale vers sa forme avec barre oblique finale et acheminez les requêtes sous ce préfixe vers le backend Jellyfin. chemin de base et route du proxy correspondants
Si le navigateur reçoit une erreur 404 du proxy avant que Jellyfin n’enregistre la requête, le routage est incorrect au niveau du proxy. Si Jellyfin reçoit la requête, mais génère des liens sans le préfixe, l’URL de base est incorrecte au niveau de l’application. Distinguez bien ces deux types de panne.
Vérifiez les ressources statiques et les WebSockets, pas seulement la page de connexion
Une réponse HTML réussie ne suffit pas à confirmer que la configuration du sous-chemin fonctionne correctement. Ouvrez les outils de développement ou consultez le journal du proxy et vérifiez que les requêtes JavaScript, CSS, les images, les API et les WebSockets restent toutes sous le même préfixe public.
Les exemples de configuration de proxy inverse de Jellyfin incluent la gestion de WebSocket, car les clients interactifs maintiennent une connexion socket en plus des requêtes HTTP ordinaires. Une règle de proxy qui ne gère que les requêtes de page peut donc sembler correcte jusqu’à ce que le statut de lecture, les mises à jour de session ou l’interface en temps réel cessent de fonctionner. exigences relatives au proxy inverse
Le critère de réussite est simple : aucune réponse 404/502 répétée pour les ressources préfixées, la mise à niveau WebSocket fonctionne et la navigation ne renvoie pas à la racine du site. Si une seule catégorie de requêtes échoue, corrigez cette règle du proxy au lieu de modifier les paramètres de bibliothèque ou d’authentification de Jellyfin.
Préservez l’identité du client à travers le proxy
Une fois le chemin fonctionnel, vérifiez les informations transférées sur le client. Jellyfin utilise la configuration de confiance du proxy pour déterminer s’il faut accepter les adresses et protocoles transférés, ce qui influe sur le comportement local ou distant et les règles d’accès externe.
Le guide réseau de Jellyfin précise que les en-têtes transférés par un proxy non approuvé sont ignorés et recommande de configurer l’adresse du proxy dans la section « Proxies connus ». Paramètre « Proxies connus » Une vérification distincte de l’adresse IP du client est utile lorsque le site fonctionne, mais que toutes les requêtes semblent provenir du proxy.
Ne résolvez pas un problème d’identification en faisant confiance à tous les sous-réseaux privés ou à tous les en-têtes transférés. Ajoutez uniquement le saut de proxy réel ou le réseau de proxy contrôlé, puis comparez dans les journaux Jellyfin une requête sur le réseau local et une requête à distance pour vérifier qu’elles sont classées comme prévu.
Testez séparément les adresses du navigateur et du client natif
Saisissez l’adresse complète du serveur, sous-chemin compris, lorsqu’un client Jellyfin vous demande l’URL du serveur. Un client configuré avec https://example.com ne peut pas deviner que Jellyfin se trouve sous /jellyfin.
Testez un navigateur et un client natif depuis le réseau local, puis recommencez avec le nom d’hôte public. Si le nom d’hôte fonctionne, mais pas l’accès direct par adresse IP locale, cela peut être normal lorsque la route du proxy et le certificat dépendent du nom d’hôte ; les tests nom d’hôte par rapport à adresse IP permettent d’isoler ce cas sans affaiblir le proxy.
Arrêtez-vous lorsque l’URL préfixée fonctionne après la connexion, lors de la navigation, de l’utilisation de WebSocket et de la lecture sur les clients que vous prenez réellement en charge. Si un seul client échoue alors que le navigateur et les autres clients fonctionnent, considérez qu’il s’agit d’un problème d’adresse ou de compatibilité du client plutôt que de réécrire une configuration de proxy qui fonctionne.
Assistance et conseils
À lire aussi

Comment cacher les vidéos pour adultes stockées sur votre NAS à votre famille
Gardez les vidéos pour adultes privées sur un NAS familial. Vérifiez les autorisations des dossiers, l’accès aux bibliothèques Plex et Jellyfin, les vignettes, l’historique...

Ce qu’il faut vérifier avant de charger un modèle communautaire dans Transformers
Utilisez la mise à jour du bac à sable Jinja de Transformers pour examiner la provenance des modèles, les modèles de conversation, le code...

Exécutez Mirage localement : OCR et détection d’objets à partir d’une seule image
Essayez le petit modèle de vision local de Cactus Compute, testez la reconnaissance optique de caractères et l’extraction d’objets à partir de données réelles,...



