Testar link M3U8: como saber se o seu HLS está funcionando (e por que não abre)
Resposta rápida: Para testar link M3U8, cole o endereço num player de teste online, como o do Wowza, e dê Play. Se tocar, o link está no ar; se falhar, o registro de eventos (Event Log) mostra onde.
- Abra o player de teste do Wowza (ou o demo do hls.js).
- Cole o link
.m3u8no campo e clique em Start. - Dê Play e leia o registro de eventos (Event Log): erro de rede, 403 ou 404 apontam o link.
- No terminal,
curl -I "SEU-LINK"deve responder 200. - Toca aqui e não no seu site, ou no iPhone? Vá às camadas 2 e 3.
Neste tutorial (8 seções)
Atualizado em 21/10/2026. Os sites de teste citados estavam no ar nessa data.
Você colou um link .m3u8 e a tela ficou preta. Antes de culpar o vídeo, descubra em qual de três camadas está o problema: o link, o site onde ele deveria tocar ou o aparelho.
A base é o tutorial da JMV Technology, com o Guilherme, de novembro de 2025. A tela do Wowza conferida em 21/10/2026 mantém o campo de URL, o botão Start e o registro de eventos.
Testar link M3U8 em 1 minuto, no player do Wowza
No player de teste do Wowza o processo é este, o mesmo do vídeo:
- Copie o link
.m3u8. - Cole no campo de URL do player.
- Clique em Start e dê Play no vídeo.
- Se o link for compatível, a reprodução começa.
O Wowza mostra também o registro de eventos (Flowplayer Event Log). Ele registra cada comportamento do link: o Play, o Pause e os erros, quando ocorrem.
Tocou? O link está no ar. Não tocou, ou tocou aqui e não onde você precisa? Siga as três camadas.
Camada 1: o link e a origem
Para testar link M3U8 além do player, comece pelo endereço: ele responde e a playlist aponta para arquivos que existem?
Peça só os cabeçalhos:
curl -I "https://SEU-DOMINIO/video/playlist.m3u8"O esperado é 200 e um content-type de playlist: application/vnd.apple.mpegurl ou audio/mpegurl. Um 403 indica bloqueio ou token. Um 404, endereço errado ou arquivo removido.
curl -I no link de teste: status 200 e content-type de playlist HLS.Abra a playlist (curl sem o -I). Ela lista as variantes de qualidade e os segmentos. Teste uma variante e um segmento: se um deles dá 404, o player trava no meio do vídeo, mesmo com a playlist principal respondendo.
Para ver o que há dentro do stream, o ffprobe resolve numa linha:
ffprobe -hide_banner "https://SEU-DOMINIO/video/playlist.m3u8"Ele lista as faixas de vídeo e de áudio com codec e resolução.
Prefere uma tela? O VLC abre o link em Mídia → Abrir transmissão de rede e mostra codec e bitrate. Veja o passo a passo do teste no VLC.
Camada 2: toca no teste e não no seu site
Link bom e site mudo: o defeito costuma estar entre a página e o servidor. Aperte F12 e abra Console e Rede. Filtre por m3u8 e leia o status de cada pedido.
As causas mais comuns:
- CORS. O navegador só deixa a página ler o
.m3u8se o servidor responder comAccess-Control-Allow-Originpara o domínio dela. Se o servidor libera só alguns domínios, o teste online passa e o seu site não. Veja o guia de CORS da MDN. - Conteúdo misto. Página em HTTPS com link
http://é bloqueada. Use HTTPS no link. A MDN explica o conteúdo misto. - Player sem suporte a HLS. O Safari toca HLS nativo. O Chrome de desktop toca HLS nativo, ligado por padrão, desde a versão 142, segundo o incidente público da Mux (status.mux.com, 2025), que também registra um defeito de reprodução nessa versão. Em outros navegadores e em versões mais antigas, o site precisa de um player com hls.js.
- Link expirado ou com token. Link de acesso protegido vale por tempo limitado. Gere outro e teste de novo.
A barra de endereço não é teste confiável: o resultado muda com o navegador e a versão. Teste num player e, no site, use player nativo com fallback hls.js.
Camada 3: não toca no iPhone
O iPhone é o mais exigente: o formato que toca em todo iPhone é vídeo H.264 com áudio AAC; além disso, o link precisa estar em HTTPS e o <video> precisa do atributo playsinline para tocar na página. Os codecs aceitos estão na especificação de HLS da Apple.
No player da JMV, o vídeo sob demanda chega ao iPhone por HLS nativo, com playsinline, e troca de qualidade conforme a conexão (verificado em 20/10/2026).
O link toca no computador e não no iPhone? Veja o diagnóstico em três camadas.
Qual ferramenta usar para testar HLS
| Ferramenta | O que mostra | Cadastro |
|---|---|---|
| Wowza | Reprodução e registro de eventos (Play, Pause, erros) | Não pede no teste |
| hls.js demo | Reprodução com hls.js e dados técnicos do stream | Não pede no teste |
| Livepush | Reprodução do link | Sem cadastro, segundo a página |
| Castr | Reprodução do link | Sem cadastro, segundo a página |
| VLC | Reprodução, codec e bitrate | Instalar o programa; sem cadastro |
Para testar link M3U8 com segurança, use dois. O que o hls.js toca é o que o seu site também deve tocar, se usar hls.js.
Perguntas frequentes
Como testar se um link m3u8 está funcionando, online e grátis?
Cole o link no player de teste do Wowza, clique em Start e dê Play. Se tocar, o link está no ar; se não, o registro de eventos (Event Log) do Wowza mostra o erro.
Por que o link m3u8 abre no Safari e não no meu navegador?
O Safari toca HLS nativo. Outros navegadores dependem da versão ou de um player com hls.js. Teste num player online, não na barra de endereço.
O link funciona no player de teste, mas não no meu site: o que pode ser?
Quase sempre CORS, conteúdo misto (link http numa página https), player sem suporte a HLS ou link com token expirado. Veja F12 → Rede.
Qual player m3u8 online usar: Wowza, HLS.js demo, Livepush, Castr ou VLC?
Qualquer um mostra se toca. O Wowza exibe o registro de eventos (Event Log); o VLC mostra codec e bitrate. Use dois para confirmar.
Como saber se o problema é o link ou o player do site?
Se toca no Wowza e no VLC, o link está bom e o problema é o player ou a página. Se falha nos dois, o erro está no link ou na origem.
Preciso baixar app ou extensão para abrir m3u8?
Não. Um player online ou o VLC bastam, sem instalar APK nem extensão de terceiros.
Próximos passos
Link funcionando e sem origem própria? Veja como a hospedagem de vídeo com link HLS (M3U8) direto entrega o endereço. Na JMV Stream, o link .m3u8 aparece no painel do vídeo ou no retorno da API (campo source).
Vai usar o link no OBS? Veja como inserir o link HLS no OBS pela fonte do VLC e como configurar o OBS para retransmitir pelo bitrate da origem.
Para guardar e entregar os vídeos, conheça a hospedagem de vídeo da JMV Stream: banda 100% ilimitada com preço fixo em reais, sem cobrança por tráfego e sem taxa de excedente.
Testar a hospedagem com link HLS pelo WhatsApp
Teste grátis de 30 dias para empresas com CNPJ, liberado pelo WhatsApp.
Vídeo da JMV, de novembro de 2025: testar link HLS online
Como testar o link HLS do seu vídeo (2 min 43 s), com Guilherme, da JMV Technology. Vídeo publicado em 18/11/2025.
Capítulos do vídeo:
Transcrição do vídeo (2 min 43 s)
Transcrição a partir da legenda automática, com acentos e pontuação revisados. Um trecho com chamada para curso e planos foi omitido entre colchetes. O vídeo diz que o link HLS não abre diretamente no navegador; hoje isso depende do navegador e da versão (veja a camada 2).
00:00 — O que é o link HLS (M3U8)
Como testar o link HLS do seu vídeo.
Olá, pessoal, eu sou o Guilherme da JMV Technology e hoje venho mostrar para vocês uma ferramenta ou site em que poderá testar o seu link HLS, conhecido também como M3U8. Este é um tipo de link de vídeos, como um link de transmissões ao vivo e vídeos gravados. Ele é muito utilizado na inserção em aplicativos e também quando a pessoa deseja utilizar um player customizado, e também para outras opções. Quando você contrata um plano de vídeo conosco, disponibilizamos esse tipo de link como opção.
00:47 — Por que ele não abre direto
Diferente do link direto do player, que também é uma opção que disponibilizamos em nossos serviços, o link HLS não abre diretamente no navegador. Desta forma, você vai necessitar de algum recurso para ver se esse link estará funcionando.
Em nosso canal do YouTube, temos uma opção que também é interessante, que é o teste desse tipo de link pelo VLC. Deixarei essa opção aqui no nosso card e também na descrição. [trecho omitido: chamada para a plataforma de curso gratuito e para os planos de vídeo]
01:41 — Testar no player do Wowza
Para realizarmos o teste de um link HLS, vamos acessar o site wowza.com/testplayers. Deixaremos o link aqui na descrição. Este é um procedimento bem simples. Vamos pegar o nosso link e inserir neste campo. Assim que realizarmos a inserção, é somente clicar no botão Start e dar o play no vídeo. O link sendo compatível iniciará a execução. Assim conseguirá validar se ele está em um bom funcionamento.
02:16 — Ler o status da execução
Ao lado temos o status da execução, onde ele mostra cada comportamento do seu link, como o momento em que é dado play, pause e momentos em que podem ocorrer algum erro.
Então é isso. Se gostou, deixe o seu like, se inscreva em nosso canal e nos siga em nossas redes sociais.
