ERR_CONNECTION_REFUSED no Localhost (XAMPP, Laragon, MAMP)

O que este erro significa e como reconhecê-lo

• O navegador exibe imediatamente ERR_CONNECTION_REFUSED para localhost ou um hostname local.
• O XAMPP, Laragon ou MAMP mostra o Apache ou Nginx como parado, com falha ou não mais em execução.
• O servidor inicia e depois para, às vezes com uma mensagem sobre uma porta, um arquivo de configuração ou um erro de sintaxe.
• O problema aparece após uma reinicialização, mudança no sistema operacional, instalação de servidor local ou edição de configuração.
• Os arquivos do projeto existem no computador, mas o navegador não consegue se conectar ao servidor local.
• Um servidor em uma porta personalizada pode funcionar em um endereço enquanto o localhost simples falha, porque o navegador está usando a porta HTTP padrão.

Causas principais, por probabilidade

1. O Apache ou Nginx não está em execução — O serviço local pode não ter sido iniciado ou pode ter falhado durante a inicialização.
2. Outro processo está usando a porta configurada — O IIS, outra instalação do XAMPP/Laragon/MAMP, um Apache ou Nginx independente, software de virtualização ou outro aplicativo pode já estar escutando na porta 80 ou 443.
3. A configuração do servidor é inválida — Um erro de sintaxe no httpd.conf, em um arquivo de configuração do Nginx, em um arquivo de virtual host ou em outro arquivo do servidor editado recentemente pode fazer o serviço parar imediatamente.
4. O navegador está usando a porta errada — Uma stack configurada para a porta 8080 ou outra porta personalizada normalmente não responderá ao localhost simples na porta HTTP padrão.
5. O firewall ou o software antivírus está interferindo — Uma mudança recente no software de segurança pode bloquear o servidor local ou o bind de rede, embora isso seja menos comum do que um serviço parado ou um conflito de porta.

Como corrigir

1. Confirme o servidor local e o endereço

Abra o XAMPP Control Panel, o Laragon ou o aplicativo MAMP e verifique se o Apache ou Nginx está marcado como Running. Se estiver parado, selecione Start e anote a mensagem exata caso a inicialização falhe.

Verifique qual porta HTTP ou HTTPS está configurada para uso na stack. Se ela usar uma porta personalizada, teste o endereço correspondente — por exemplo, localhost:8080 — em vez de presumir que o localhost simples está correto.

2. Identifique um conflito de porta

Se a mensagem de inicialização mencionar uma porta já em uso, verifique a porta relevante. No Windows, abra o Prompt de Comando com permissão de Administrador, se exigido pelo ambiente, e execute estes comandos somente de leitura:

netstat -ano | findstr :80
netstat -ano | findstr :443

Use o ID do processo informado para identificar o responsável no Gerenciador de Tarefas. Não encerre um processo desconhecido. Se o IIS for o responsável pela porta e você tiver autorização para alterar a máquina, desative ou pare o serviço relevante do IIS somente quando ele não for necessário. Caso contrário, configure a stack local para usar uma porta disponível e use essa porta no navegador.

Os comandos acima são específicos do Windows. Em outro sistema operacional, use as ferramentas integradas de rede ou processos ou as informações de porta fornecidas pelo painel de controle da stack.

3. Verifique o log de erros do servidor

Se nenhum processo evidente estiver usando a porta configurada, abra o log de erros do Apache ou Nginx na stack local ou no diretório de logs configurado. Procure o primeiro erro específico, especialmente um caminho de arquivo, uma diretiva de configuração e um número de linha.

Se a falha começou após uma edição de configuração, corrija ou reverta essa alteração. Verifique o httpd.conf, os arquivos de configuração do Nginx, as definições de virtual host e todos os arquivos incluídos. Altere um arquivo por vez para que a causa continue identificável.

4. Verifique se há servidores locais duplicados

Procure uma segunda instalação do XAMPP, Laragon, MAMP, WAMP, Apache ou Nginx independente. Dois serviços normalmente não podem escutar no mesmo endereço e porta. Pare um serviço não utilizado somente se souber que isso é seguro e tiver autorização, ou atribua portas separadas às stacks que você precisa manter.

5. Revise alterações no software de segurança

Se a configuração do servidor for válida e nenhum processo concorrente estiver usando a porta, revise as alterações recentes no firewall ou no antivírus. Use as configurações normais do produto de segurança e crie uma exceção somente quando entender o acesso que ela permitirá. Evite desativar amplamente a proteção como primeira etapa de solução de problemas.

6. Verifique o reparo

Aguarde até que o Apache ou Nginx permaneça no estado Running e abra novamente o endereço configurado do localhost. Uma página padrão do servidor ou o projeto deverá carregar em vez de ERR_CONNECTION_REFUSED.

Se a página padrão carregar, mas o projeto não, o problema de conexão estará resolvido. Continue investigando o document root, o roteamento, o virtual host ou a aplicação, em vez de alterar novamente as configurações de porta.

Prevenção e como verificar a correção

• Registre as portas HTTP e HTTPS usadas por cada stack local, especialmente quando houver mais de uma stack instalada.
• Evite executar vários servidores locais no mesmo endereço e porta; atribua portas distintas quando ambos forem necessários.
• Mantenha uma anotação das alterações nos arquivos de configuração do Apache, Nginx e dos virtual hosts.
• Depois de editar a configuração do servidor, inicie o serviço e verifique o log de erros antes de presumir que o código do projeto está com problemas.
• Use o painel de controle da stack para confirmar que o serviço continua em execução, não apenas que iniciou uma vez.
• Antes de parar um processo ou serviço, confirme que ele não é necessário para o IIS, outra ferramenta de desenvolvimento ou um aplicativo não relacionado.

Perguntas frequentes