Por que um link M3U8 falha
| Causa | Como é | O que tentar |
|---|---|---|
| CORS bloco | O manifesto ou os segmentos .ts são carregados em VLC, mas falham no navegador. | Habilite o proxy CORS inteligente e execute o relatório de integridade novamente. |
| URL expirado | O manifesto retorna 403, 404 ou uma resposta vazia em todos os lugares. | Capture um novo .m3u8 URL da página de origem ou CDN. |
| Proteção de link direto | O stream funciona apenas quando as solicitações vêm do site original. | Defina o mesmo Referer e, se necessário, User-Agent nas opções de proxy. |
| Segmento morto | O manifesto é carregado, mas a reprodução é interrompida ou ignorada após alguns segundos. | Execute o validador M3U8 e inspecione as falhas dos segmentos amostrados. |
| Codec não suportado | VLC reproduz o stream, mas o navegador mostra apenas áudio ou vídeo preto. | Verifique os codecs no relatório de integridade e tente outro navegador ou VLC. |
| Conteúdo misto | Uma página HTTPS tenta carregar um fluxo HTTP. | Use um stream HTTPS URL ou roteie o stream por meio de um endpoint de proxy. |
| DRM | O manifesto aponta para reprodução protegida com Widevine, FairPlay ou PlayReady. | Use o aplicativo ou player licenciado. Esta ferramenta não ignora o DRM. |
Como consertar um link M3U8 que não funciona
- 1
Confirme se o manifesto é real
Abra o M3U8 URL diretamente ou cole-o no player. Um manifesto HLS válido geralmente começa com #EXTM3U e contém tags como #EXT-X-STREAM-INF, #EXTINF ou #EXT-X-ENDLIST.
- 2
Experimente primeiro a reprodução sem proxy
Cole o URL e pressione Play. Se carregar, o stream estará acessível e você poderá continuar testando a taxa de bits, legendas, conversão ou edição da lista de reprodução.
- 3
Habilite o proxy CORS
Se o navegador relatar um erro CORS ou o fluxo funcionar em VLC, mas não on-line, ative o proxy CORS inteligente para que manifestos, chaves e segmentos sejam solicitados por meio do proxy.
- 4
Defina Referer e User-Agent quando necessário
Para streams protegidos por hotlink, copie a página URL onde o stream normalmente é reproduzido e defina-a como Referer. Adicione um navegador de desktop User-Agent se a origem filtrar por cliente.
- 5
Execute o relatório de saúde
Use o validador M3U8 para listar faixas, taxa de bits, criptografia, status ativo/VOD e segmentos .ts mortos amostrados. Isso separa um link morto real de um problema de acesso ao navegador.
- 6
Verifique os limites de codec e DRM
Se o manifesto e os segmentos estiverem acessíveis, mas a reprodução ainda falhar, inspecione os codecs e a criptografia. Os reprodutores de navegador não podem decodificar todos os codecs e esta ferramenta não ignora o DRM.
Como saber se é CORS ou um link morto
CORS é uma regra do navegador, então a mesma transmissão pode falhar online e ainda assim ser reproduzida em VLC. Um link morto falha em todos os lugares. Se VLC abrir o URL mas o navegador não, comece com o proxy. Se ambos falharem, inspecione o status HTTP e capture um URL novo porque os links HLS assinados geralmente expiram rapidamente.
Quando um Referer personalizado corrige a reprodução
Algumas origens só veiculam manifestos e segmentos quando a solicitação parece ter vindo da página original. Isso é proteção de hotlink. Neste player, habilite o proxy, abra as opções avançadas, defina a página original como Referer e tente novamente. Se a origem também verificar o tipo de cliente, adicione um navegador User-Agent.
Por que a reprodução começa e depois para
Um manifesto pode ser válido enquanto um ou mais segmentos de mídia estiverem ausentes, bloqueados ou sobrecarregados. O player pode iniciar, armazenar em buffer e parar quando atingir o segmento quebrado. O relatório de integridade mostra amostras do segmento .ts URLs por meio do proxy e relata contagens de aprovação/reprovação para que você saiba se o caminho CDN está realmente íntegro.
Por que VLC e um navegador discordam
VLC não está sujeito às regras do navegador CORS e suporta mais codecs, portanto pode reproduzir streams que um navegador rejeita. Uma ferramenta de navegador é melhor para depuração da web porque revela os mesmos CORS, conteúdo misto e problemas de cabeçalho que os visitantes do site encontrarão e, em seguida, fornece controles de proxy e Referer para testar as correções.
Ferramentas que ajudam a isolar o problema
- M3U8 Validador verifica trilhas, taxa de bits, criptografia, status ativo/VOD e segmentos mortos.
- M3U8 a MP4 confirma se os segmentos acessíveis podem ser remixados em um arquivo.
- VLC vs On-line M3U8 Player explica por que a reprodução no navegador e na área de trabalho nem sempre coincide.
Perguntas frequentes
Por que meu link M3U8 não é reproduzido no navegador?
As causas mais comuns são restrições CORS, URL assinado expirado, proteção de hotlink que requer um Referer específico, segmentos .ts mortos, codecs não suportados, conteúdo HTTP/HTTPS misto ou DRM. Experimente primeiro o relatório de proxy e integridade para separar os problemas de acesso do navegador de um fluxo interrompido.
Por que o mesmo M3U8 URL funciona em VLC, mas não online?
VLC não é limitado pelas regras CORS do navegador, portanto pode buscar streams que um jogador online não pode acessar diretamente. Habilite o proxy CORS no player do navegador e tente novamente com um Referer personalizado se a origem usar proteção de hotlink.
Como faço para corrigir um erro HLS CORS?
Use uma origem que envie os cabeçalhos Access-Control-Allow-Origin corretos ou roteie o manifesto, as chaves e os segmentos por meio de um proxy CORS. Para testar, habilite o proxy inteligente neste player e execute o relatório de integridade por meio dele.
Qual Referer devo usar para um fluxo M3U8 protegido?
Use o URL da página onde o stream normalmente é reproduzido, não o próprio .m3u8 URL. Muitas origens verificam essa página como Referer antes de veicular o manifesto ou segmentos de mídia.
Isso pode corrigir streams protegidos por DRM?
Não. Esta ferramenta pode ajudar com CORS, Referer e depuração de segmento morto, mas não ignora sistemas DRM como Widevine, FairPlay ou PlayReady.