Redes e diagnóstico

Entenda IP, portas, DNS e firewall e siga um roteiro de comandos para descobrir em que ponto uma conexão falha.

Cerca de 15 min · Revisado em

Ao final, você vai conseguir

  • Explicar IP, porta, localhost, DNS, TCP, UDP e firewall com exemplos do dia a dia
  • Aplicar o roteiro ping, dig, curl -v, ss e traceroute na ordem certa
  • Ler a saída desses comandos para distinguir erro de DNS, porta sem programa e bloqueio de firewall
  • Classificar um sintoma de rede na camada onde a investigação deve começar

“O site caiu” é a frase mais vaga que existe, e você vai ouvi-la muitas vezes. Pode ser um nome digitado errado, um servidor desligado, uma porta bloqueada ou um programa travado, e cada caso tem um conserto diferente. Quem sabe seguir a requisição passo a passo descobre o culpado em minutos, em vez de reiniciar tudo e torcer.

Endereço e porta: o prédio e o apartamento

Um IP comum tem quatro números de 0 a 255, como 192.168.0.15. Uma mesma máquina roda vários programas ao mesmo tempo, cada um “morando” numa porta, um número de 0 a 65535. O endereço completo de um serviço junta os dois: 192.168.0.15:5432.

Portas que você vai encontrar o tempo todo
PortaQuem costuma morar lá
22SSH: acesso remoto ao terminal de um servidor
80HTTP: sites sem criptografia
443HTTPS: sites com criptografia, quase todos hoje
5432PostgreSQL, um banco de dados muito usado
3000, 5173, 8000, 8080Aplicações rodando em desenvolvimento
localhost ou 127.0.0.1
Um endereço especial que sempre significa “esta mesma máquina”. É como falar com alguém do próprio apartamento sem sair de casa.
IP privado
Endereços como 192.168.x.x e 10.x.x.x só valem dentro de uma rede local, como a do Wi-Fi da sua casa. De fora, ninguém chega neles diretamente.
IP público
O endereço visível na internet. Quando seu celular acessa um site, o servidor vê o IP público do seu roteador ou da operadora.

Uma pessoa da equipe roda a API no notebook dela e manda para você: “acessa http://localhost:8000”. Você abre no seu computador e não carrega. Por quê?

  • localhost no seu computador aponta para o seu computador, onde a API não está rodando
  • A porta 8000 só funciona em notebooks
  • Faltou o www antes de localhost

DNS, TCP, UDP e o porteiro

Na aula Como a web funciona você viu que o DNS traduz nomes como loja.exemplo.com.br em endereços IP, como uma agenda de contatos. Quando o DNS falha ou aponta para o lugar errado, nada mais funciona, mesmo com o servidor perfeito. Por isso ele é um dos primeiros suspeitos.

Sites, APIs, bancos de dados e SSH usam TCP, porque não podem perder nenhum byte. Chamadas de vídeo e jogos online costumam usar UDP: um quadro perdido é melhor do que a imagem congelar esperando. As consultas de DNS normalmente vão por UDP, por serem pequenas e rápidas.

Quando a porta está fechada, às vezes a resposta vem na hora (Connection refused) e às vezes a conexão fica esperando até desistir (timeout). O que cada caso sugere?

Connection refused é o prédio respondendo “não mora ninguém nesse apartamento”: a máquina está lá, mas nenhum programa ouve aquela porta. O timeout é o porteiro que nem responde: geralmente um firewall descartando o pacote em silêncio, ou uma máquina inalcançável.

Qual protocolo costuma ser usado em cada situação?

TCP: tudo precisa chegar, em ordem · UDP: rapidez importa mais

  • Carregar a página de um banco
  • Gravar um pedido no PostgreSQL
  • Acessar um servidor por SSH
  • Chamada de vídeo com a família
  • Partida de jogo online
  • Consulta rápida de DNS

O roteiro de diagnóstico

Diagnosticar rede é fazer perguntas em ordem, da mais básica para a mais específica, e só passar para a próxima quando a anterior foi respondida. Cada pergunta tem uma ferramenta de terminal.

Cinco ferramentas, cinco perguntas
FerramentaPergunta que ela respondeOnde rodar
ping hostA máquina responde na rede?Do seu lado
dig host ou nslookup hostO nome vira o IP certo?Do seu lado
curl -v urlA conexão abre e o serviço responde HTTP? Com que status?Do seu lado
ss -tlnp (ou o antigo netstat -tlnp)Tem algum programa ouvindo na porta, e em qual endereço?No servidor
traceroute hostEm que ponto do caminho os pacotes param?Do seu lado

Coloque o roteiro de diagnóstico na ordem usada nesta aula.

  • ping: a máquina responde?
  • dig: o nome aponta para o IP certo?
  • curl -v: a conexão abre e o HTTP responde?
  • ss -tlnp: no servidor, quem ouve a porta?
  • traceroute: onde o caminho para?

Três chamados, três culpados

Agora você vai atender três chamados reais, numa simulação. Em cada um, leia a saída com calma: a resposta está escrita ali, só precisa ser encontrada.

Chamado 1: “a API não abre”

A integração com a API da loja parou de funcionar depois de uma mudança de configuração. Descubra em que etapa a conversa quebra.

  1. Teste se a máquina api.lojaexemplo.com.br responde, mandando 2 pacotes.

    ping -c 2 api.lojaexemplo.com.br
    ping: api.lojaexemplo.com.br: Name or service not known
  2. O ping nem chegou a tentar: o nome não foi encontrado. Pergunte ao DNS pelo nome.

    dig api.lojaexemplo.com.br
    ;; ->>HEADER<<- opcode: QUERY, status: NXDOMAIN, id: 40211
    ;; QUESTION SECTION:
    ;api.lojaexemplo.com.br.		IN	A
    
    ;; AUTHORITY SECTION:
    lojaexemplo.com.br.	300	IN	SOA	ns1.lojaexemplo.com.br. admin.lojaexemplo.com.br.
  3. NXDOMAIN quer dizer “esse nome não existe”. Confira o nome que a documentação da loja informa: api.loja-exemplo.com.br, com hífen.

    dig +short api.loja-exemplo.com.br
    203.0.113.42

Culpado do chamado 1: DNS, por um nome digitado sem o hífen na configuração. O servidor estava perfeito o tempo todo. Repare na pista: Name or service not known aparece antes de qualquer tentativa de conexão.

Chamado 2: “o site está fora”

O site da padaria parou de responder. O nome resolve normalmente. Siga em frente no roteiro.

  1. Veja em detalhes a tentativa de conexão com http://padaria.exemplo.com.br:8080.

    curl -v http://padaria.exemplo.com.br:8080
    *   Trying 203.0.113.80:8080...
    * connect to 203.0.113.80 port 8080 failed: Connection refused
    * Failed to connect to padaria.exemplo.com.br port 8080 after 41 ms: Couldn't connect to server
    curl: (7) Failed to connect to padaria.exemplo.com.br port 8080 after 41 ms: Couldn't connect to server
  2. A resposta veio rápido: “Connection refused”. A máquina existe, mas ninguém atendeu. Entre no servidor e veja quem ouve quais portas TCP.

    ss -tlnp
    State   Recv-Q  Send-Q   Local Address:Port   Peer Address:Port  Process
    LISTEN  0       128            0.0.0.0:22          0.0.0.0:*      users:(("sshd",pid=702,fd=3))
    LISTEN  0       511          127.0.0.1:8080        0.0.0.0:*      users:(("node",pid=3310,fd=19))
    LISTEN  0       244          127.0.0.1:5432        0.0.0.0:*      users:(("postgres",pid=1033,fd=6))

Achou? O programa node ouve a porta 8080, mas em 127.0.0.1, ou seja, só aceita conversas vindas da própria máquina. O SSH, em 0.0.0.0, aceita de qualquer lugar. Culpado do chamado 2: a aplicação foi configurada para ouvir só o localhost. O conserto é fazê-la ouvir em 0.0.0.0, ou colocar um proxy na frente.

Na saída do ss, o PostgreSQL aparece em 127.0.0.1:5432. A aplicação roda na mesma máquina. Isso é um problema?

  • Não. A aplicação está na mesma máquina, e esconder o banco do resto da rede é até mais seguro
  • Sim. Todo serviço deveria ouvir em 0.0.0.0
  • Sim. A porta 5432 está errada para o PostgreSQL

Chamado 3: “fica carregando para sempre”

Um painel interno não abre: o navegador fica girando até desistir. O nome resolve para 198.51.100.23. Investigue.

  1. Teste a conexão HTTPS com https://painel.exemplo.com.br, limitando a espera a 5 segundos com --max-time 5.

    curl -v --max-time 5 https://painel.exemplo.com.br
    *   Trying 198.51.100.23:443...
    * Connection timed out after 5001 milliseconds
    curl: (28) Connection timed out after 5001 milliseconds
  2. Nada de “refused”: a conexão ficou no vácuo. Veja até onde os pacotes chegam no caminho.

    traceroute painel.exemplo.com.br
    traceroute to painel.exemplo.com.br (198.51.100.23), 30 hops max
     1  192.168.0.1      1.8 ms   1.6 ms   1.7 ms
     2  10.42.0.1        9.4 ms   9.1 ms   9.8 ms
     3  200.160.0.9     14.2 ms  13.9 ms  14.5 ms
     4  198.51.100.1    18.7 ms  18.3 ms  18.9 ms
     5  * * *
     6  * * *

Os pacotes atravessam o seu roteador, o provedor e chegam ao roteador da rede do painel (198.51.100.1). Depois disso, silêncio: as estrelas mostram que ninguém responde. Com o timeout no curl, a suspeita forte é um firewall na frente do servidor descartando a porta 443. O próximo passo é pedir para quem administra conferir as regras.

No chamado 3, alguém propõe reiniciar a aplicação do painel. Por que isso provavelmente não vai resolver?

  • Porque a conexão nem chega à aplicação: os pacotes param antes, na rede do servidor
  • Porque o DNS está errado
  • Porque o curl não funciona com HTTPS

Do sintoma à camada

Com prática, você olha uma mensagem de erro e já sabe por onde começar. Pense em camadas: primeiro o nome precisa virar endereço, depois o caminho precisa levar até a máquina, depois a porta precisa estar aberta e atendida, e só então a aplicação responde.

Em qual camada você começaria a investigar cada sintoma?

Nome (DNS) · Caminho de rede · Porta ou firewall · Aplicação

  • Could not resolve host: api.exemplo.com
  • dig responde NXDOMAIN
  • traceroute só mostra * * * a partir do roteador do provedor
  • curl: (7) Connection refused
  • O ping responde, mas a conexão na porta 5432 dá timeout
  • HTTP/1.1 500 Internal Server Error
  • HTTP/1.1 404 Not Found em /api/v2/pedidos

Uma pessoa diz “a API caiu”. Você roda curl -v e recebe HTTP/1.1 503 Service Unavailable. O que dá para concluir?

  • DNS, rede e porta estão funcionando; quem respondeu com erro foi o software do outro lado
  • O DNS está apontando para o lugar errado
  • O firewall bloqueou a porta

Fechamento

  • O IP identifica a máquina e a porta identifica o programa dentro dela; localhost é sempre a própria máquina.
  • O DNS traduz nomes em IPs; o TCP garante entrega em ordem e o UDP troca garantia por rapidez; o firewall decide quais portas aceitam visitas.
  • O roteiro é ping, dig, curl -v, ss -tlnp e traceroute, do mais básico ao mais específico.
  • NXDOMAIN aponta para DNS, Connection refused para porta sem programa, timeout para firewall ou caminho, e um status HTTP para a aplicação.

Provoque e diagnostique três falhas

A prática desta etapa da trilha é diagnosticar separadamente uma porta fechada, um erro de DNS e um serviço indisponível. Você vai criar cada problema de propósito, no seu computador ou no laboratório Linux, e anotar como cada um aparece.

  1. Suba um servidor simples com python3 -m http.server 8000 e confirme com curl -v localhost:8000 que ele responde 200
  2. Pare o servidor com Ctrl + C e repita o curl: anote a mensagem de porta sem programa
  3. Rode curl -v com um domínio digitado errado e depois dig no mesmo nome: anote as duas mensagens
  4. Com o servidor de pé, use ss -tln e encontre a linha da porta 8000 e o endereço em que ela ouve
  5. Escreva um parágrafo para cada falha dizendo o sintoma, a ferramenta que revelou a causa e o conserto

Referências

Cursos relacionados