HLS carte de dépannage
| Problem | Cause probable | Meilleure page suivante |
|---|---|---|
| Le lien M3U8 ne sera pas lu | Échec de lecture généralisé sur le manifeste, CORS, segments, codec ou DRM. | Le lien M3U8 ne fonctionne pas |
| Erreur CORS dans le navigateur | L'origine ne permet pas au navigateur d'accéder au manifeste, à la clé ou aux segments. | Erreur HLS CORS |
| 403 Interdit | Un URL signé a expiré ou le serveur rejette la forme de la demande. | M3U8 403 Interdit |
| Nécessite Referer ou en-têtes personnalisés | La protection Hotlink attend la page d'origine ou un client de navigateur normal. | Lecteur RefererM3U8 personnalisé |
| La clé AES-128 échoue | L'URI de la clé est bloquée, a expiré, manque le CORS ou nécessite le Referer. | La clé M3U8 ne se charge pas |
| La lecture démarre puis s'arrête | Un ou plusieurs segments multimédias sont morts, surchargés ou protégés différemment. | HLS testeur de flux |
| La playlist IPTV échoue | Le fichier M3U est mal formé, vide après analyse ou plein de URL de canaux morts. | La playlist IPTV ne fonctionne pas |
| Flux protégé par DRM | Widevine, FairPlay ou PlayReady nécessitent un chemin de lecture sous licence. | Lecteur M3U8 crypté |
Comment dépanner un flux HLS ou M3U8
- 1Confirmez que le URL est un véritable manifeste HLSOuvrez le URL ou collez-le dans le lecteur. Un manifeste HLS valide commence généralement par #EXTM3U et contient des balises telles que #EXT-X-STREAM-INF, #EXTINF, #EXT-X-KEY ou #EXT-X-ENDLIST.
- 2Identifier la requête défaillanteDéterminez si le premier échec est le manifeste principal, une liste de lecture multimédia, une clé AES-128 ou un segment multimédia .ts/.m4s. Le correctif dépend de cet emplacement.
- 3Comparez la lecture directe avec la lecture proxyTestez directement le URL en premier. Si le flux fonctionne au VLC ou via le proxy mais pas dans le navigateur, le problème est généralement le CORS ou les en-têtes de requête plutôt qu'un flux mort.
- 4Ajouter Referer ou User-Agent seulement si nécessairePour les flux protégés par hotlink auxquels vous êtes autorisé à accéder, définissez la page d'origine sur Referer et utilisez un navigateur normal User-Agent. N'ajoutez pas d'en-têtes personnalisés à moins que l'origine ne l'exige.
- 5Exécuter le rapport de santéUtilisez le validateur pour répertorier les variantes, le débit binaire, le cryptage, l'état en direct/VOD et les échecs de segments échantillonnés. Cela sépare un véritable problème de CDN ou de playlist d'un problème d'accès au navigateur.
- 6Arrêtez-vous aux limites du codec et du DRMSi les requêtes sont accessibles mais que la lecture échoue toujours, vérifiez les codecs et la protection. Les lecteurs de navigateur ne peuvent pas décoder tous les codecs et cet outil ne contourne pas Widevine, FairPlay, PlayReady, les paywalls ou les serveurs de licences.
Utilisez la chaîne de requêtes, pas seulement le premier URL
Une session HLS est une chaîne de requêtes. Le premier fichier M3U8 peut se charger alors qu'une liste de lecture enfant, une clé AES-128 ou un segment ultérieur échoue. Un bon dépannage suit la chaîne dans l'ordre, car un échec CORS sur une clé, un 403 sur un segment et un manifeste principal expiré nécessitent des correctifs différents.
Comment ce hub évite le chevauchement de mots clés
Cette page cible les requêtes générales telles que le dépannage HLS, le dépannage M3U8 et la correction de l'erreur de lecture HLS. Les pages rayons liées ciblent les causes exactes : CORS, 403 interdit, Referer, chargement de clé, segments morts, analyse de playlist IPTV, sous-titres, HLS crypté et conversion sans téléchargement.
Quand utiliser le lecteur, le validateur ou le convertisseur
Utilisez le lecteur pour confirmer la lecture de base, les contrôles proxy et Referer pour tester les problèmes d'accès au navigateur, le validateur pour inspecter les variantes et les segments échantillonnés, et le convertisseur uniquement une fois que le flux est accessible. La conversion ne peut pas réparer un flux expiré, inaccessible ou protégé par DRM.
Dépannage des rayons
- Le lien M3U8 ne fonctionne pas est le premier arrêt lorsque vous ne savez pas si l'échec est du CORS, du Referer, des segments morts, des codecs ou du DRM.
- Erreur HLS CORS explique pourquoi un flux peut être lu dans VLC mais échouer dans Chrome, Edge, Safari ou Firefox.
- M3U8 403 Interdit couvre les signatures expirées, la protection des hotlinks, les filtres User-Agent et les 403 au niveau du segment.
- Lecteur RefererM3U8 personnalisé montre comment tester les flux qui s'attendent à ce que les requêtes proviennent de la page d'origine.
- La clé M3U8 ne se charge pas se concentre sur les échecs d'URI de clé AES-128, les clés bloquées et le débogage chiffré HLS.
- HLS testeur de flux utilise le rapport de santé pour inspecter les variantes, le débit binaire, le statut live/VOD et les segments morts échantillonnés.
- La playlist IPTV ne fonctionne pas diagnostique les fichiers M3U mal formés, les listes de chaînes vides, les IPTV URL morts et les problèmes de balises.
- Lecteur M3U8 crypté fixe la frontière entre les AES-128 HLS qui peuvent être testés et les DRM qui ne peuvent pas être contournés.
Questions fréquemment posées
Quel est le moyen le plus rapide de déboguer un flux M3U8 ?
Commencez par rechercher quelle requête HLS échoue : le manifeste principal, la liste de lecture multimédia, la clé AES-128 ou le segment. Comparez ensuite la lecture directe avec la lecture proxy et exécutez le rapport de santé pour séparer les problèmes CORS, 403, Referer, de segment mort, de codec et de DRM.
Pourquoi HLS est-il lu dans VLC mais pas dans un navigateur ?
Le VLC n'est pas limité par les règles CORS du navigateur et prend en charge plus de codecs que la plupart des navigateurs. Si le VLC fonctionne mais que le navigateur échoue, testez d'abord avec le proxy CORS, puis ajoutez Referer ou User-Agent uniquement si l'origine nécessite ces en-têtes.
Comment savoir si un lien M3U8 est mort ?
Un lien M3U8 mort échoue généralement dans les lecteurs de navigateur et de bureau, ou il charge un manifeste mais les segments ultérieurs renvoient des réponses 404, 403, un délai d'attente ou des réponses vides. Le rapport de santé aide en échantillonnant les segments multimédias URL au lieu de vérifier uniquement le premier manifeste.
Un proxy peut-il corriger chaque erreur de lecture HLS ?
Non. Un proxy peut aider avec les tests CORS du navigateur et certains tests autorisés Referer/User-Agent, mais il ne peut pas corriger les jetons expirés, les restrictions IP, les segments indisponibles, les codecs non pris en charge, les paywalls, les DRM ou les exigences du serveur de licences.
Cela résout-il les flux protégés par DRM ?
Il peut identifier les limites des DRM, mais il ne contourne pas Widevine, FairPlay, PlayReady, les paywalls ou les systèmes de licence. Pour les flux protégés par DRM, utilisez l’application, le lecteur ou le flux de licence autorisé.