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.
| Porta | Quem costuma morar lá |
|---|---|
22 | SSH: acesso remoto ao terminal de um servidor |
80 | HTTP: sites sem criptografia |
443 | HTTPS: sites com criptografia, quase todos hoje |
5432 | PostgreSQL, um banco de dados muito usado |
3000, 5173, 8000, 8080 | Aplicações rodando em desenvolvimento |
localhostou127.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.xe10.x.x.xsó 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ê?
localhostno seu computador aponta para o seu computador, onde a API não está rodando- A porta
8000só funciona em notebooks - Faltou o
wwwantes delocalhost
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.
| Ferramenta | Pergunta que ela responde | Onde rodar |
|---|---|---|
ping host | A máquina responde na rede? | Do seu lado |
dig host ou nslookup host | O nome vira o IP certo? | Do seu lado |
curl -v url | A 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 host | Em 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.
Teste se a máquina
api.lojaexemplo.com.brresponde, mandando 2 pacotes.ping -c 2 api.lojaexemplo.com.brping: api.lojaexemplo.com.br: Name or service not knownO 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.NXDOMAINquer 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.br203.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.
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 serverA 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 -tlnpState 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
5432está 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.
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 millisecondsNada de “refused”: a conexão ficou no vácuo. Veja até onde os pacotes chegam no caminho.
traceroute painel.exemplo.com.brtraceroute 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
curlnã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.comdigrespondeNXDOMAINtraceroutesó mostra* * *a partir do roteador do provedorcurl: (7) Connection refused- O
pingresponde, mas a conexão na porta5432dá timeout HTTP/1.1 500 Internal Server ErrorHTTP/1.1 404 Not Foundem/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 -tlnpetraceroute, do mais básico ao mais específico. NXDOMAINaponta para DNS,Connection refusedpara 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.
- Suba um servidor simples com
python3 -m http.server 8000e confirme comcurl -v localhost:8000que ele responde200 - Pare o servidor com
Ctrl+Ce repita ocurl: anote a mensagem de porta sem programa - Rode
curl -vcom um domínio digitado errado e depoisdigno mesmo nome: anote as duas mensagens - Com o servidor de pé, use
ss -tlne encontre a linha da porta8000e o endereço em que ela ouve - Escreva um parágrafo para cada falha dizendo o sintoma, a ferramenta que revelou a causa e o conserto