Guia de porta

localhost:3000

A porta 3000 é muito usada em apps JavaScript, servidores Node, projetos React e ambientes de desenvolvimento Next.js.

Abrir URL local Usar construtor de URL

Checklist rápido

  1. 1 Inicie o servidor local com o comando do framework.
  2. 2 Copie a URL exata que aparece no terminal em vez de adivinhar.
  3. 3 Abra a URL no mesmo computador onde o processo está rodando.
  4. 4 Se falhar, confirme se a porta mudou ou se outro processo a ocupou.
  5. 5 Leia logs e erros do terminal antes de alterar firewall ou código.

Verificações rápidas

Confirmar que algo escuta na porta lsof -i :3000

Se nenhum processo aparecer, o navegador não tem com quem conectar. Inicie o app novamente e use a URL impressa no terminal.

Comparar localhost com loopback http://127.0.0.1:3000/

Se 127.0.0.1 funcionar e localhost não, revise hosts file, IPv6, bind address ou certificado local.

Usar o comando do framework npm run dev

Next.js, React e scripts Node podem mudar para outra porta quando 3000 está ocupada.

Verificação de request em vivo

O que esta página vê

Detectando o que o servidor enxerga...
IP pública Verificando...
Linha da request Verificando...
Headers HTTP da request
Carregando headers...

Headers sensíveis, como cookies e tokens de autorização, são filtrados antes de aparecer.

Quando usar localhost:3000

localhost:3000 deve ser usado quando o terminal ou a documentação do projeto indica essa porta. A porta é apenas a entrada do serviço local; o conteúdo depende do servidor que está rodando.

Em uma máquina de desenvolvimento, localhost aponta para o próprio computador. Outras pessoas não conseguem abrir essa URL sem túnel, deploy ou configuração de rede.

Por que pode não abrir

Os motivos mais comuns são servidor parado, porta diferente da esperada, protocolo errado, rota ausente ou um processo antigo ocupando a mesma porta.

  • Copie a URL do terminal.
  • Teste o IP 127.0.0.1 com a mesma porta.
  • Use lsof para descobrir quem está usando a porta.

Rota, API e página em branco

Nem todo serviço em localhost:3000 mostra uma homepage bonita em /. Talvez você precise de /api ou /dashboard, /api, /docs, /admin ou outra rota definida pelo framework.

Guias relacionadas de localhost

Guia de porta

localhost:5173

Use localhost:5173 para servidores Vite e resolva quando o navegador não consegue abrir o app local.

Guia de porta

localhost:8080

Abra localhost:8080 e entenda por que Java, Tomcat, Spring Boot, proxies e painéis locais usam esta porta.

Solução de problemas

Localhost recusou a conexão

Resolva localhost recusou a conexão revisando processo, URL, porta, protocolo, firewall e logs locais.

Ferramenta para desenvolvedores

Consulta de portas localhost

Busque portas localhost comuns, entenda para que costumam ser usadas e copie comandos para verificar portas ocupadas.

FAQ

localhost:3000 é um site público?

Não. É um endereço local do seu próprio computador. Ele só fica acessível para outras pessoas se você configurar rede, túnel ou deploy.

Devo usar http ou https em localhost:3000?

Use o protocolo que o servidor imprime. A maioria dos dev servers usa http, salvo quando certificados locais foram configurados.

Por que o Chrome diz que não é possível acessar localhost:3000?

Normalmente o app não está escutando na porta, a porta mudou ou o processo terminou. Confira primeiro o terminal.

O que revisar primeiro quando esta porta localhost não abre?

Veja se o servidor de desenvolvimento continua rodando e copie a URL exata do terminal. Se o terminal mostrar outra porta, use essa porta.

Posso trocar localhost por 127.0.0.1 nesta porta?

Normalmente sim no mesmo computador. Se um funcionar e o outro não, revise bind address, IPv6, certificados ou hosts file.

Por que o navegador mostra tela em branco ou JSON?

O serviço pode ser uma API, uma rota health ou backend sem página em /. Teste /api, /docs, /admin ou a rota impressa pelo framework.