Poucas coisas em IPTV são tão exasperantes como colar um nome de utilizador e password que você sabe estarem corretos e ver o player devolver "Authentication Failed" (Falha na Autenticação). Dois factos tornam isto pior do que deveria ser:
- O erro é exatamente o mesmo para pelo menos oito causas subjacentes diferentes, várias das quais não têm nada a ver com as suas credenciais.
- Os players quase nunca lhe dizem qual delas é.
Este guia acompanha-o pelas diferentes causas pela ordem em que vale a pena verificá-las. Se puder colar as credenciais no verificador de credenciais Xtream antes de começar, os primeiros três passos resolvem-se automaticamente — a ferramenta diz-lhe se a autenticação falhou realmente, expirou ou atingiu um limite de ligações.
Uma mesma mensagem de erro, oito causas subjacentes — o player não consegue distingui-las, portanto o diagnóstico fica a seu cargo.
1. A subscrição já passou a data de validade
Esta é a causa mais comum, e não parece diferente de uma password errada na maioria dos players. O Xtream devolve a mesma resposta auth: 0 em ambos os casos.
A solução é pedir ao seu provedor a nova validade — ou, se já renovou, esperar uma hora e tentar novamente. Os painéis de controlo de alguns provedores atualizam a base de dados num horário programado, não em tempo real, e uma conta recém-renovada pode continuar a aparecer como expirada durante meia hora após o pagamento ter sido processado.
O verificador de credenciais devolverá auth: expired neste caso, permitindo-lhe descartar esta hipótese com um só clique.
2. O limite de ligações foi atingido
A maioria das subscrições Xtream é vendida com um limite de ligações — tipicamente 1, 2, 3 ou 5 ligações simultâneas. Se todas estiverem em uso, uma nova tentativa de login é rejeitada com o mesmo erro de autenticação de uma password errada.
A armadilha: uma ligação nem sempre está ativamente a transmitir stream. Os players que fecham sem se desligarem corretamente (a maioria fá-lo) podem deixar uma ligação "fantasma" que o provedor só limpa após um timeout. Se mudou de dispositivo recentemente, reiniciou uma TV, ou teve a sua rede Wi-Fi a cair e a religar-se, é plausível que todos os slots estejam ocupados por fantasmas que não estão a transmitir nada na realidade.
A solução: espere 5 a 10 minutos para o timeout do lado do servidor disparar e tente novamente. Ou contacte o seu provedor e peça-lhe para limpar as ligações ativas da sua conta.
3. O nome de utilizador tem um carácter de espaço oculto
Colar credenciais de um e-mail, de um fórum ou de uma captura de ecrã inclui frequentemente caracteres invisíveis: um espaço no início, uma nova linha (enter) no final, ou um espaço não separável (U+00A0) onde o utilizador pensa que digitou um espaço normal. A maioria dos players não apara (trim) estes caracteres, e um nome de utilizador com uma nova linha no final é um nome de utilizador diferente da perspetiva do provedor.
Para verificar, cole o nome de utilizador e a password num editor de texto simples. Mova o cursor para o final de cada um. Se conseguir fazer backspace e apagar um carácter invisível antes do cursor ficar encostado ao final do texto visível, esse é o seu problema.
O verificador de credenciais apara explicitamente os espaços do servidor e do nome de utilizador antes de os enviar para o servidor; portanto, se ele for bem sucedido onde o seu player falha, esta é quase de certeza a causa.
4. O URL do servidor tem um caminho extra ou uma query string extra
O Xtream Codes chama um único endpoint em /player_api.php. O seu player constrói o URL completo ao anexar esse caminho àquilo que você colocar no campo "servidor". Se colou o URL M3U completo (http://servidor.exemplo/get.php?username=…&password=…&type=m3u_plus) no campo do servidor em vez de apenas http://servidor.exemplo, o player acabará por chamar /get.php?username=…&password=…&type=m3u_plus/player_api.php?…, ao qual qualquer servidor devolverá 404 ou um HTML. O player reporta então "auth failed" (falha na autenticação) porque não recebeu JSON de volta.
A solução é reduzir o URL a apenas http(s)://host:porta. O nome de utilizador e a password vão para os seus próprios campos. Muitos utilizadores já colaram o URL M3U no campo do servidor pelo menos uma vez.
5. O servidor é HTTPS mas a cadeia de certificados está quebrada
Alguns provedores correm a sua API Xtream num certificado autoassinado ou expirado. A maioria dos players modernos recusa-se a falar via HTTPS com um servidor com um certificado inválido, mas alguns mais antigos baixam silenciosamente para HTTP e depois falham porque o provedor deixou de servir HTTP no último trimestre.
O diagnóstico: abra o URL do servidor num browser de computador. Se vir um aviso de certificado, o player também o está a encontrar. A solução é mudar o URL do servidor de https://… para http://…, com a óbvia desvantagem de que a sua password passa a viajar não encriptada. Questione o provedor acerca da renovação do certificado; este é um problema deles, não seu.
6. O seu IP está a ser bloqueado
Os provedores bloqueiam regularmente geograficamente (geo-block) o tráfego de países com os quais não têm acordos, ou limitam a taxa (rate-limit) ao nível do IP quando uma conta atinge demasiadas ligações numa janela de tempo curta. Ambos parecem idênticos para o player: uma resposta de falha na autenticação.
Para verificar, tente as mesmas credenciais a partir de uma rede diferente — tethering no telefone, um Wi-Fi diferente ou uma VPN para um país diferente. Se as credenciais funcionarem noutro local mas não na sua ligação de casa, o seu IP é o problema.
O verificador de credenciais chama a API a partir do lado do servidor através de um IP fixo, por isso um cenário "o verificador diz que sim, o meu player diz que não" confirma que o problema é o IP do seu cliente, não as suas credenciais.
7. A base de dados do provedor está em manutenção / migração
As migrações periódicas dos provedores quebram o login no Xtream durante horas a fio. Sintomas: todas as contas Xtream no mesmo provedor devolvem "auth failed" simultaneamente. Não há forma de distinguir isto das suas próprias credenciais terem sido revogadas a não ser aguardando e tentando novamente, ou perguntando num fórum onde outros clientes do mesmo provedor o tenham notado.
Se tiver um URL M3U para além das credenciais Xtream (a maioria dos provedores fornece ambos), o M3U geralmente continua a funcionar durante a migração porque é servido a partir de um caminho de código diferente. Mudar para o URL M3U é uma solução alternativa rápida até a API voltar a funcionar.
8. As credenciais estão realmente erradas
Este é o caso mais aborrecido mas é real. O provedor invalidou-as. O provedor rodou-as após um incidente com pagamentos. Está a usar as credenciais do mês passado e recebeu um novo conjunto quando renovou.
Como ter a certeza: inicie sessão no portal de cliente do seu provedor (quase todos os provedores Xtream têm um) e copie as credenciais aí apresentadas para o formulário. Se essas funcionarem e as credenciais que tem estado a usar não funcionarem, tem a sua resposta.
Como se enquadra o verificador de credenciais
O verificador de credenciais Xtream neste site distingue automaticamente entre os casos 1, 2 e 8 (os mais comuns):
auth: ok+ números no painel principal → as credenciais estão boas. O problema é o seu player ou a sua rede — tente os casos 4–7.auth: expired→ caso 1. Renove ou contacte o seu provedor.auth: failed→ caso 8. As credenciais estão realmente erradas.- Aviso de limite de ligações → caso 2. Espere ou peça ao provedor para limpar as ligações.
upstream_timeout/upstream_unreachable→ caso 6 ou 7. O próprio servidor está inacessível a partir de um IP público, portanto o problema não é a autenticação.
Executar o verificador uma vez antes de depurar o seu player poupa em média cerca de vinte minutos de investigação. Também exclui totalmente a hipótese de "o provedor está em baixo" — se o nosso servidor consegue falar com o deles, o deles está online.
O que fazer quando souber a causa
Para credenciais que genuinamente funcionam (casos 1–7 onde identificou a mitigação), o Klipa suporta tanto o login Xtream como o URL M3U lado a lado na mesma biblioteca. Se a API Xtream do seu provedor for instável mas a exportação M3U for saudável, adicione ambos — um mantém a lista de canais viva quando o outro falha. Consulte a comparação Xtream-vs-M3U para saber com que interface deve iniciar.
Se já passou por todos os oito casos e as credenciais genuinamente não funcionam em lado nenhum — incluindo o verificador, o portal do cliente e uma rede diferente — o problema está no lado do provedor e não há mais nada a depurar do seu lado.