Lorsque Jellyfin échoue pour un seul utilisateur ou sur un seul appareil, ne commencez pas par modifier l’ensemble du serveur. Testez le compte concerné sur un appareil dont le bon fonctionnement est confirmé, puis un compte fonctionnel sur l’appareil concerné.
Ces deux tests créent une matrice de diagnostic simple. Si le problème suit le compte, examinez les autorisations de l’utilisateur et l’état de la session. S’il suit l’appareil, examinez l’adresse du serveur enregistrée, l’état de l’application, le chemin des codecs, le DNS et l’itinéraire réseau. S’il concerne un seul élément multimédia, quel que soit le compte, orientez-vous vers la compatibilité de lecture au lieu d’en attribuer la cause à l’utilisateur ou à l’appareil.
Effectuer le test deux par deux des comptes et des appareils
Utilisez le même serveur et, si possible, le même élément multimédia. Testez l’utilisateur concerné sur un appareil fonctionnel, puis un utilisateur fonctionnel sur l’appareil concerné. Évitez de modifier les mots de passe, de réinstaller les applications ou de vider les caches avant de savoir de quel côté le symptôme apparaît.
Si les deux utilisateurs échouent sur un appareil, l’appareil ou son itinéraire réseau devient la piste principale. Si un utilisateur échoue sur plusieurs appareils, le compte devient la piste principale. Si un seul ensemble utilisateur-appareil échoue, l’état de session mis en cache ou une configuration propre au client est plus probable qu’une panne générale du serveur.
Notez l’échec exact : connexion refusée, bibliothèque absente, lecture refusée, mise en mémoire tampon du flux ou serveur inaccessible. « Jellyfin échoue » est trop vague pour permettre une réparation ; chaque résultat observable correspond à une vérification suivante différente.
Si le problème suit l’utilisateur, vérifier les autorisations et l’accès à distance
Ouvrez l’utilisateur Jellyfin concerné et comparez son accès aux bibliothèques, ses autorisations de lecture multimédia, ses autorisations de transcodage et son autorisation de connexion à distance avec celles d’un compte fonctionnel. Modifiez une seule différence avérée à la fois.
Jellyfin documente les contrôles de lecture au niveau de l’utilisateur, notamment l’autorisation de lire des contenus et celle de lire des contenus nécessitant un transcodage. autorisations de lecture des utilisateurs Jellyfin
Si l’utilisateur fonctionne sur le réseau local, mais pas à distance, vérifiez son autorisation d’accès à distance ainsi que la classification réseau du serveur avant de réinitialiser les identifiants. Un refus limité à l’accès distant peut être une règle correcte, et non un échec d’authentification.
Si le problème suit l’appareil, réinitialiser uniquement l’état du client
Vérifiez d’abord l’adresse du serveur enregistrée, notamment le protocole, le nom d’hôte, le port et tout sous-chemin de proxy inverse. Comparez-la caractère par caractère avec celle d’un client fonctionnel. Une ancienne adresse IP directe ou un sous-chemin manquant peut faire échouer un seul appareil alors que le serveur fonctionne correctement.
Si l’adresse est correcte, déconnectez-vous puis reconnectez-vous avant de supprimer toutes les données de l’application. Mettez ensuite à jour le client s’il est particulièrement ancien. Ne réinstallez l’application qu’après l’échec de ces étapes ciblées, car tout effacer supprime les indices permettant de déterminer si un jeton de session ou une entrée de serveur enregistrée était à l’origine du problème.
Pour les appareils distants, un chemin d’accès distant à Jellyfin peut aider à comparer le nom d’hôte ou l’itinéraire du tunnel prévus avec l’adresse enregistrée sur le client défaillant.
Si la connexion fonctionne, mais que la lecture échoue, comparer le chemin de lecture
Lisez le même fichier depuis un appareil fonctionnel et un appareil défaillant, puis observez le tableau de bord Jellyfin. Notez si chaque client effectue une lecture directe, un remultiplexage, une diffusion directe ou un transcodage, et si les sous-titres sont activés.
La documentation des codecs de Jellyfin explique que les conteneurs, pistes audio, vidéos ou sous-titres non pris en charge peuvent imposer des chemins de conversion différents selon les clients. compatibilité des codecs du client C’est pourquoi un téléviseur peut échouer sur un titre qui se lit parfaitement dans un client de bureau.
Si seul l’appareil défaillant déclenche un transcodage, examinez le journal FFmpeg et l’autorisation de transcodage de l’utilisateur avant de modifier le fichier multimédia. Si les deux clients utilisent le même mode de lecture, mais qu’un seul échoue, poursuivez avec le réseau de l’appareil et l’état de l’application.
Vérifier le DNS et l’itinéraire réseau uniquement pour l’appareil défaillant
Lorsque le serveur est inaccessible plutôt qu’en présence d’une erreur de lecture, comparez la résolution DNS et l’itinéraire depuis l’appareil défaillant avec ceux d’un appareil fonctionnel sur le même réseau. Testez d’abord le nom d’hôte prévu ; ne supposez pas qu’une adresse IP directe est équivalente lorsque le routage TLS ou celui du proxy inverse dépend du nom d’hôte.
Le guide de dépannage de Jellyfin indique qu’une absence totale de journaux de trafic web correspondants signifie généralement que la requête n’a pas atteint le serveur. indicateur de dépannage réseau
Si l’appareil défaillant ne produit aucune entrée dans le journal du serveur, corrigez le DNS, l’accessibilité Wi-Fi/VLAN, l’état du VPN, la confiance accordée au certificat ou l’adresse enregistrée au niveau du client. Si Jellyfin consigne la requête et renvoie une erreur d’application, revenez dans la matrice vers le comportement du compte ou de la lecture.
Valider la correction avec l’utilisateur, l’appareil et le contenu d’origine
Après avoir modifié la couche identifiée, revenez à la combinaison exacte d’origine et reproduisez l’action qui a échoué. Le bon fonctionnement d’un compte administrateur sur un autre ordinateur portable ne prouve pas que l’utilisateur concerné sur le téléviseur est dépanné.
Redémarrez ou reconnectez ensuite le client une fois afin de vérifier que l’état fonctionnel est conservé après une nouvelle session. Si la réparation concernait l’accès à distance, répétez le test depuis un réseau externe au lieu de tester uniquement lorsque l’appareil est encore connecté au réseau local.
Arrêtez-vous lorsque la combinaison compte/appareil d’origine fonctionne et que la combinaison de contrôle se comporte toujours normalement. Si le même échec isolé persiste, transmettez les résultats de la matrice, la version du client, la version du serveur, l’URL du serveur, le mode de lecture et l’extrait de journal pertinent.
Assistance et conseils
Plus à lire

Jellyfin doit-il utiliser un compte partagé unique ou des comptes distincts pour chaque membre du foyer ?
Choisissez les comptes familiaux Jellyfin selon les limites d’identité, d’accès, de contrôle parental et de récupération dont vous avez besoin.

Pourquoi l’utilisation de la mémoire de Jellyfin reste-t-elle élevée une fois la tâche terminée ?
Distinguez la croissance du processus Jellyfin du cache Linux, et n’intervenez que lorsque la mémoire continue d’augmenter ou crée une réelle pression.

Signes indiquant qu’une configuration de stockage Jellyfin devient un risque pour la récupération des données
Auditez les rôles de stockage de Jellyfin, séparez l’état actif des sauvegardes et des données reconstructibles, puis validez la disposition par une restauration.

