Ir para o conteúdo
Gerir links

Porque o seu link localhost falha quando o partilha

Distinga localhost, endereços privados e um site publicado. Prepare um destino público e verifique-o com o WikiURL antes de partilhar.

WikiURL · Redirecionamentos · Publicado

Um site isolado num portátil contrasta com um servidor ligado a outros dispositivos.

Se só abre no seu computador, reveja o endereço enviado

Prepara o programa de uma jornada no portátil. A pré-visualização funciona e copia o endereço para enviar a outra pessoa ou criar um QR. No seu navegador aparece o programa, mas o telemóvel mostra um erro. Antes de mudar o desenho ou gerar imagens novamente, veja o nome do servidor no endereço: uma pré-visualização local não é necessariamente uma página publicada na Internet.

As dúvidas reais sobre abrir localhost a partir de um telefone e de outra rede têm um ponto comum: partilhar texto não torna acessível o servidor que o recebe. Este guia distingue três situações e propõe um processo para distribuir um programa público. Não transforma um ambiente de desenvolvimento em alojamento nem presume que a falha seja um problema de permissões de uma conta. Reveja primeiro o local para onde o endereço aponta.

Localhost aponta para o dispositivo que faz o pedido

O nome localhost tem um uso especial: a RFC 6761 explica que deve resolver para um endereço de retorno local, ou loopback. Habitualmente, o navegador procura o serviço no próprio dispositivo. Por isso, o localhost do portátil não identifica esse portátil para o telefone. Abrir o mesmo endereço no telemóvel tenta aceder ao ambiente local do telemóvel, onde provavelmente não está o programa que preparou.

Os dois exemplos mostram destinos locais, não convites públicos. 127.0.0.1 é um endereço IPv4 de loopback; a porta 3000 distingue um serviço sem alterar o alcance do endereço. Copiar o link, acrescentar UTM, encurtá-lo ou desenhá-lo num QR não muda esse significado. Conserve estes endereços para trabalho local, mas não os use como destino do programa para qualquer participante. Não é necessário testá-los em ferramentas externas para reconhecer o problema.

http://localhost:3000/programa
http://127.0.0.1:3000/programa

Um endereço privado também não é uma publicação na Internet

Substituir localhost por um endereço da rede local pode fazer parte de um teste autorizado entre dispositivos, mas não equivale a publicar. A RFC 1918 reserva intervalos privados, incluindo 192.168.0.0/16. O exemplo 192.168.1.25 pode identificar um computador dentro de uma rede concreta; não é um destino universal para pessoas noutras redes. Mesmo na mesma rede wifi, o serviço e as regras de acesso devem permitir a ligação.

Se precisar de um teste interno, combine o endereço e as condições de acesso com quem administra o ambiente. Uma rede empresarial ou acesso remoto autorizado é outro cenário, não uma razão para publicar informação interna. Para um programa destinado ao público, peça um endereço publicado adequado. Não desative a firewall nem abra portas no router como solução improvisada ao preparar um cartaz. A verificação de um URL não substitui a configuração e proteção do servidor.

http://192.168.1.25:3000/programa

Obtenha um endereço publicado para o conteúdo realmente público

Publicar exige colocar o conteúdo num serviço web acessível à audiência prevista. A MDN distingue ficheiros de trabalho de publicação e explica o papel do alojamento e do endereço web. Se outra pessoa gere o site, entregue-lhe a versão aprovada do programa e solicite o URL definitivo. Se publicar pessoalmente, siga o procedimento do alojamento e verifique que conteúdo e configuração coloca à disposição dos visitantes.

Não basta substituir o texto localhost por um domínio: esse domínio deve conduzir a um serviço que realmente disponibilize a página. O endereço fictício usa example.invalid e não funciona como site de testes. Substitua-o pelo URL real apenas quando existir a publicação. Conserve o caminho correto e reveja imagens, estilos e links. Uma página publicada que ainda chama recursos de localhost pode parecer completa no seu computador e falhar para outras pessoas.

https://example.invalid/programa

Verifique o destino público com o WikiURL e noutro contexto

Quando tiver um URL público sem segredos, introduza-o em Verificar URL do WikiURL. Reveja a resposta HTTP e o endereço final detetado se houver redirecionamentos. A ferramenta informa que não admite endereços de redes privadas: não a use para explorar a rede nem testar serviços locais. Se aparecer uma limitação ou bloqueio, interprete o resultado dentro do alcance dessa verificação, sem concluir automaticamente que o site está indisponível para qualquer visitante.

Depois abra o link publicado no telemóvel e, quando possível, numa ligação diferente da do computador de desenvolvimento. Confirme o conteúdo do programa, as imagens e a navegação. Uma resposta 200 não demonstra por si só a página esperada: pode ser uma página inicial ou de autenticação. A verificação técnica e a revisão visual respondem a perguntas diferentes. Confirme também que nenhum link da própria página o devolve a um endereço local.

Crie os materiais a partir da versão aprovada

Só depois use o endereço público confirmado na mensagem, link curto ou gerador QR do WikiURL. Reveja o destino da versão final e teste o QR no material que vai distribuir. Não reutilize por engano o ficheiro criado com a pré-visualização. Se o endereço de publicação mudou, atualize as cópias que ainda controla e registe qual é a versão aprovada, em vez de assumir que um QR anterior mudou automaticamente.

Guarde no registo de publicação o endereço público e os resultados das verificações, separados dos endereços de desenvolvimento. Se o conteúdo deve continuar interno, mantenha o acesso combinado e não o publique apenas para passar num verificador externo. O objetivo é fazer coincidir destino e audiência: trabalho local para o seu dispositivo, acesso interno para as pessoas previstas e uma web publicada quando o programa deve abrir a partir do exterior.

Abrir a ferramenta →

Fontes e documentação

← Todos os guias