| Causa | Diagnosi | Fix |
| Servizio non in ascolto (porta chiusa) | ss -ltnp / netstat -an non mostra porta. Log avvio servizio errori. | Avvia servizio. Controlla config bind address (0.0.0.0 vs 127.0.0.1). systemd: systemctl status. |
| Firewall host (iptables/nftables/ufw/Windows Firewall) blocca INPUT | nmap -p PORTA IP_SERVER da esterno = filtered. Da localhost = open. | Regola allow: ufw allow PORTA, iptables -A INPUT -p tcp --dport PORTA -j ACCEPT, Windows: Nuova regola entrata TCP PORTA. |
| Security Group / NSG / Firewall cloud (AWS SG, Azure NSG, GCP FW, Cloudflare, WAF) | Porta aperta su host ma bloccata a livello infrastruttura. | Console cloud: verifica Inbound Rules. CIDR sorgente corretto (0.0.0.0/0 o IP specifici). |
| Load Balancer / Reverse Proxy (Nginx, HAProxy, ALB, Cloudflare) timeout backend | LB risponde 504, o client timeout se LB non risponde. Log LB: upstream timed out. | Aumenta proxy_read_timeout (Nginx), timeout connect/server (HAProxy), Idle Timeout (ALB). Ottimizza query DB/backend. |
| Application pool / thread pool esaurito (Node.js, Java, .NET, PHP-FPM, Python Gunicorn/uWSGI) | Log: "queue full", "rejecting", "timeout waiting for worker". CPU/RAM OK ma thread bloccati (I/O, lock, deadlock). | Aumenta workers/threads. Fix codice blocking (async/await, connection pool DB). Circuit breaker. Monitora queue length. |
| Database / servizio dipendente lento/giù | App risponde piano poi timeout. Log: "context deadline exceeded", "query timeout". | Indici DB, connection pool, read replicas, cache (Redis), circuit breaker, timeout client per chiamate downstream. |
| CGNAT / Double NAT / IP pubblico mancante (server casalingo) | Port forwarding su router ma IP WAN router ≠ IP pubblico. ISP usa CGNAT (100.64.x.x). | Richiedi IP pubblico ISP. O: VPN con port forwarding (Tailscale Funnel, ngrok, Cloudflare Tunnel, Mullvad, AirVPN). |
Strumenti diagnostica
ping IP (ICMP, non TCP) - verifica reachability base.
telnet IP PORTA / nc -zv IP PORTA - test TCP handshake.
nmap -p PORTA IP - stato porta (open/closed/filtered).
traceroute IP / mtr IP - dove muore il pacchetto.
curl -v --connect-timeout 10 https://IP:PORTA - test HTTP con timeout.
- Browser DevTools (F12) > Network > Timing: "Connection Start", "Stalled", "DNS Lookup", "Initial Connection".
Timeout tipici da conoscere
| Contesto | Default tipico | Dove cambiare |
| Browser HTTP (Chrome/Firefox/Edge) | 30-120 s (connessione), 300 s (lettura) | Impostazioni avanzate / flags / registry (raro serve) |
| Linux TCP (sysctl) | tcp_syn_retries = 6 (~127 s) | /etc/sysctl.conf |
| Windows TCP | TcpInitialRtt, TcpMaxConnectRetransmissions | Registry HKLM\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters |
| Nginx | proxy_connect_timeout 60s, proxy_read_timeout 60s | nginx.conf |
| AWS ALB / ELB | Idle timeout 60 s (configurabile 1-4000 s) | Console / Terraform |
| Cloudflare | 100 s (HTTP), 15 s (Stream) | Dashboard / Page Rules / Workers |
Checklist rapida "Sito non carica / Timeout"
- Altri siti vanno? → No: tua rete (router, DNS, ISP, VPN). Sì: sito specifico.
- Sito down per tutti? (Downdetector) → Sì: aspetta. No: solo tu.
- Hotspot 4G telefono va? → Sì: tuo router/ISP. No: sito o tuo dispositivo.
- Disabilita antivirus/firewall/VPN/proxy → Va? Colpevole identificato.
- Cambia DNS (1.1.1.1) + flushdns → Va? DNS.
- IPv6 disabilitato → Va? IPv6 rotto.
- Se sviluppatore: log server, firewall host, security group cloud, LB timeout, thread pool, DB.