Tutorial do Debian 13 / Diagnosticar DNS, portas em escuta e falhas de conexão HTTP
Quando um servidor Debian 13 não pode ser alcançado, verifique os endereços e rotas, a resolução de nomes pelo DNS (Domain Name System), o socket de escuta e a resposta HTTP (Hypertext Transfer Protocol) separadamente. Um pedido que funciona dentro da VM não prova que um host pode alcançá-lo através do NAT. Um HTTP 404 significa que um servidor HTTP respondeu ao pedido, então inspecione o caminho solicitado e o servidor que respondeu, em vez de tratar isso como uma falha básica de conexão.
Identifique o caminho da conexão em teste
Este tutorial utiliza uma máquina virtual Debian 13 conectada ao VirtualBox NAT (Network Address Translation, tradução de endereços de rede) e um hospedeiro Windows (host). O endereço do convidado é 10.0.2.15, e o gateway é 10.0.2.2 em uma configuração de adaptador NAT único. Verifique os endereços reais do ambiente com os resultados da consulta abaixo e não aplique os endereços de exemplo em outras redes.
ip -br address
ip route
ip route get 10.0.2.2
getent ahostsv4 deb.debian.org
sudo ss -lntp
ip route get verifica a rota, a interface e o endereço de origem que o kernel seleciona ao enviar para o destino especificado. Não é um comando para verificar se o pacote realmente chegou ao destino. getent utiliza as configurações de resolução de nomes do sistema, e o endereço da rede de entrega de conteúdo (CDN) resolvido pode variar dependendo do momento. No comando ss, -l se refere a escuta, -n a endereço numérico e porta, -t a TCP, e -p a informações do processo.
| Resultados do Teste | Alvos para Verificar Primeiro |
|---|---|
| Não é possível resolver o nome para o endereço | Erro de digitação no nome, DNS e configurações de consulta de nome do sistema |
| Sem rota para o destino | Endereço da interface, rota de conexão e gateway padrão |
| Somente bem-sucedido dentro do convidado | Endereço de escuta, destino do encaminhamento de porta, firewall |
| Resposta HTTP 404 | Caminho da URL, localização do arquivo, host virtual e roteamento de aplicação |
| Tempo limite de conexão | Verifique novamente o destino, a porta, o caminho e o filtro; você não pode determinar uma causa apenas com este resultado. |
Os endereços 127.0.0.1 do host e 127.0.0.1 da VM são endereços de loopback de computadores diferentes. Para permitir que uma VM em NAT receba conexões normais do host, um caminho como o redirecionamento de portas é necessário. Mantendo as regras de encaminhamento SSH existentes, adicionaremos regras separadas para prática de HTTP. Para identificar as ferramentas responsáveis, consulte a aula sobre gerenciamento da rede e do DNS. Para alterar endereços no ambiente identificado, siga a configuração de IPv4 estático e recuperação do DHCP.
Prepare arquivos de teste e um servidor limitado ao loopback
Prepare dois terminais Debian e o PowerShell do host. O servidor HTTP Python é usado apenas para verificação de conexão e não como um servidor web de produção. Se um serviço existente usar a porta 8080, não o interrompa; selecione uma porta de prática não utilizada e aplique-a consistentemente em todos os comandos e regras de encaminhamento subsequentes.
sudo ss -lntp 'sport = :8080'
sudo apt update
sudo apt install --no-install-recommends python3 curl
python3 --version
curl --version
Se ss não mostrar nenhuma linha de escuta além do cabeçalho, nenhum ouvinte TCP foi listado para essa porta naquele momento. Revise dependências e alterações de pacotes antes de confirmar a instalação. A VM do curso original utilizou Python 3.13.5 e curl 8.14.1; atualizações de segurança do Debian podem alterar essas versões de pacotes.
Execute o seguinte em um terminal de usuário comum A. mkdir é feito para falhar se houver uma pasta com o mesmo nome. Não substitua a pasta existente; verifique seu conteúdo primeiro.
mkdir "$HOME/lf-net-demo" &&
printf 'debian-network-lab\n' > "$HOME/lf-net-demo/probe.txt" &&
python3 -m http.server 8080 --bind 127.0.0.1 --directory "$HOME/lf-net-demo"
Se a criação da pasta falhar, não execute o comando do servidor. Se iniciar normalmente, o terminal A permanece no estado de servidor em execução. Como a raiz do documento é limitada a uma pasta dedicada, o diretório home inteiro não é fornecido. A porta 8080 é uma porta que um usuário comum pode vincular, portanto sudo não é necessário para executar o servidor.
Execute o seguinte no terminal de convidado B. Faça solicitações após o servidor exibir a mensagem de início.
sudo ss -lntp 'sport = :8080'
curl --noproxy '*' --connect-timeout 3 --max-time 6 -sS http://127.0.0.1:8080/probe.txt
curl --noproxy '*' --connect-timeout 3 --max-time 6 -sS http://127.0.0.1:8081/probe.txt
A primeira solicitação gera debian-network-lab. O endereço local de ss é 127.0.0.1:8080. Se não houver outro serviço na porta 8081, a segunda solicitação falhará ao se conectar. O teste original produziu o código de saída 7 do curl. Esta comparação mostra a importância da porta do serviço em execução, e pode haver serviços em portas que você espera que falhem, então priorize os resultados de suas próprias consultas.
--noproxy '*' permite que esta solicitação ignore o proxy definido pelas variáveis de ambiente. --connect-timeout é uma limitação na etapa de conexão, e --max-time é uma limitação no tempo total da operação. Essa exceção se aplica somente à requisição; preserve as configurações globais de proxy necessárias à sua organização.
Compare o acesso pelo host alterando somente o endereço de escuta
No VirtualBox, abra as Configurações da VM de destino → Rede → Adaptador NAT → Avançado → Encaminhamento de Portas . A localização da interface pode variar dependendo da versão. Apenas adicione a nova regra abaixo e mantenha a regra SSH existente como está. Se a porta 18080 do host estiver em uso, selecione uma porta livre.
| Item | Configurações |
|---|---|
| Nome / Protocolo | lf-debian13-http15 / TCP |
| IP / Porta do Host | 127.0.0.1 / 18080 |
| IP / Porta do Convidado | Se você usar o endereço padrão de um único convidado NAT, deixe o IP em branco / 8080 |
Se você especificar um endereço de convidado, ele deve corresponder ao endereço atual do convidado. Este exercício usa o endereço NAT padrão 10.0.2.15, e VMs com endereços alterados devem ter seus destinos de encaminhamento verificados novamente. Restringir o IP do host ao loopback impede que outros computadores na LAN acessem o servidor de prática. Para operação detalhada, consulte a documentação do VirtualBox NAT e encaminhamento de porta.
Execute isso no PowerShell do host. curl.exe é especificado para distingui-lo dos aliases do Windows PowerShell.
curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS http://127.0.0.1:18080/probe.txt
$LASTEXITCODE
A solicitação dentro da VM teve sucesso, mas a solicitação no host falhou porque o servidor escutava apenas no loopback da VM, e não no endereço da interface de rede (NIC) da VM que recebia o tráfego encaminhado pelo NAT. O teste original produziu uma redefinição da conexão (connection reset) e o status de saída do curl 56. Outras versões de virtualização ou estados de conexão podem produzir erros ou tempos limite diferentes; obter exatamente o código 56 não é um requisito.
No terminal A da VM, pare o servidor com Ctrl+C . Mantenha o mesmo arquivo, porta e regra de encaminhamento, mudando apenas o endereço de vinculação.
python3 -m http.server 8080 --bind 0.0.0.0 --directory "$HOME/lf-net-demo"
Após confirmar a mensagem de inicialização do servidor, confira o endereço de escuta mostrado por ss e faça a requisição no terminal B da VM ao endereço de sua interface de rede.
sudo ss -lntp 'sport = :8080'
curl --noproxy '*' --connect-timeout 3 --max-time 6 -sS http://10.0.2.15:8080/probe.txt
0.0.0.0:8080 significa escutar em todos os endereços IPv4 locais; não fornece automaticamente escuta em IPv6. Após a solicitação ao endereço NIC do convidado ter sucesso, repita o mesmo comando curl.exe no host para verificar o conteúdo do arquivo e o status de saída 0. Se uma solicitação falhar imediatamente após a inicialização, primeiro confirme se o processo ainda está em execução e se o socket de escuta existe.
Esta comparação isola o efeito do endereço de escuta. Se sua solicitação ainda falhar, inspecione o encaminhamento, o endereço do convidado, o socket de escuta e as regras de filtragem ao invés de simplesmente desativar o firewall. A falha do ping isoladamente pode refletir a política do Protocolo de Mensagens de Controle da Internet (ICMP); isso não prova que todos os serviços do Protocolo de Controle de Transmissão (TCP) estão indisponíveis.
Distinga o status HTTP do código de saída do curl
O servidor está rodando em todos os endereços IPv4 e o PowerShell do host solicita um arquivo inexistente. -w imprime o código de resposta, e -o NUL descarta o corpo no Windows.
curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS -o NUL -w "%{http_code}\n" http://127.0.0.1:18080/missing.txt
$LASTEXITCODE
curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS --fail -o NUL -w "%{http_code}\n" http://127.0.0.1:18080/missing.txt
$LASTEXITCODE
O código HTTP para a primeira solicitação é 404, mas o código de saída do curl é 0. Por padrão, o curl não considera os próprios status de erro HTTP como falhas de transmissão. A segunda solicitação recebe o mesmo HTTP 404 e retorna o código de saída 22 por causa de --fail. Em verificações automatizadas, decidir se deve-se olhar apenas para o código de saída ou também julgar o status HTTP deve ser determinado de acordo com o propósito. Não substitua verificações operacionais que exigem confirmar redirecionamento, autenticação ou conteúdo real da resposta apenas verificando se é 200.
Neste teste controlado, o código 404 junto com o registro correspondente no servidor Python confirma a troca de uma requisição HTTP e sua resposta. Verifique o caminho da URL e o diretório raiz do documento, e compare o log do servidor para GET /missing.txt e o status 404. Em uma implementação real, também confirme qual servidor ou proxy retornou a resposta. O manual oficial do curl documenta o manuseio de HTTP e os códigos de saída de transferência separadamente.
Isole o DNS usando um endereço definido para uma única requisição
As regras de nomes de uso especial na RFC 6761 reservam .invalid para nomes que se espera que não se resolvam com sucesso. Mantenha o servidor e a regra de encaminhamento inalterados e solicite o nome de host de teste abaixo a partir do host Windows.
curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS http://lf-debian13-net15.invalid:18080/probe.txt
$LASTEXITCODE
curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS --resolve "lf-debian13-net15.invalid:18080:127.0.0.1" http://lf-debian13-net15.invalid:18080/probe.txt
$LASTEXITCODE
No caminho geral de consulta, a primeira requisição retorna uma falha de consulta de nome e código de saída 6. A segunda requisição especifica o endereço para esse nome de host e porta apenas para esta execução do curl, então ela recebe o arquivo e retorna o código de saída 0. --resolve não modifica o servidor DNS nem o arquivo hosts e mantém o nome do host na URL. No HTTPS, a verificação do certificado para o nome do host da URL ainda é necessária, então não confunda esta opção com ignorar a verificação do certificado.
Se apenas a segunda solicitação for bem-sucedida, isso indica que o caminho de transmissão para o endereço especificado funciona e fornece motivos para examinar mais detalhadamente o caminho original de consulta de nomes. Especificar um endereço arbitrário sem verificar se ele é o IP correto em um serviço real pode resultar na verificação de outro servidor. Você também não deve assumir que o proxy, cache ou método de consulta de nomes de um determinado programa é o mesmo que o resultado getent do sistema.
Limpe e registre os resultados do diagnóstico
- No terminal de convidado A, pare o servidor HTTP com Ctrl+C.
- Na tabela de encaminhamento de portas do VirtualBox, exclua apenas a regra
lf-debian13-http15criada desta vez. Mantenha a regra SSH. - No convidado, verifique o estado de escuta e o arquivo abaixo, e exclua apenas os arquivos e pastas vazias criados desta vez.
sudo ss -lntp 'sport = :8080'
cat "$HOME/lf-net-demo/probe.txt"
rm -- "$HOME/lf-net-demo/probe.txt"
rmdir -- "$HOME/lf-net-demo"
A linha de escuta do servidor deve desaparecer, e as solicitações HTTP práticas do host também não devem mais ter sucesso. Se rmdir falhar, verifique se há outros arquivos na pasta e não exclua forçadamente de forma recursiva. As ferramentas curl e Python instaladas podem ser usados para outras tarefas de gerenciamento, portanto, a remoção em lote sem verificar a necessidade não deve ser realizada.
Ao registrar problemas, é útil incluir o local de inspeção (hospedeiro/VM convidada), URL da solicitação, endereço e porta de destino reais, endereço de escuta, código de saída do curl e código HTTP. A consulta de endereços e rotas pode ser consultada na documentação ip-route do Debian 13, sockets de escuta na documentação ss, e opções do servidor de teste na documentação Python 3.13 http.server.




