Skip to content

Nicholas-Arcari/tor-networking-guide

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

416 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tor Networking Guide

Lingua / Language: Italiano (corrente) | English

Documentazione tecnica approfondita sulla rete Tor: architettura a livello di protocollo, crittografia dei circuiti, configurazione operativa, strumenti di analisi, sicurezza operativa, attacchi noti e difese, aspetti legali, scenari operativi reali.

Questo progetto raccoglie tutto il lavoro tecnico e l'esperienza personale accumulata durante lo studio e l'uso reale della rete Tor su Kali Linux (Debian), con proxychains, bridge obfs4, ControlPort, script di automazione e analisi dei circuiti.

Non è una guida ad alto livello: ogni documento scende nel dettaglio del protocollo, delle celle, della crittografia, delle interazioni reali con il sistema operativo e con la rete.


Quick Start

# Setup completo (installa tutto, configura torrc, crea profilo Firefox)
sudo ./setup.sh

# Verificare che tutto funzioni
./tests/smoke-test-tor.sh

Struttura del progetto

docs/01-fondamenti/

Architettura interna di Tor, protocollo delle celle, handshake ntor, crittografia AES-128-CTR/Curve25519, consenso e Directory Authorities.

docs/02-installazione-e-configurazione/

Installazione, configurazione torrc completa (ogni direttiva spiegata), gestione systemd.

docs/03-nodi-e-rete/

Analisi dettagliata di ogni tipo di nodo, bridge e pluggable transports, onion services v3, monitoring e metriche.

docs/04-strumenti-operativi/

Uso pratico di proxychains, torsocks, ControlPort, NEWNYM, verifica leak, nyx, browser, DNS.

docs/05-sicurezza-operativa/

DNS leak, traffic analysis, fingerprinting, OPSEC, isolamento, hardening, forensics.

docs/06-configurazioni-avanzate/

VPN+Tor ibrido, transparent proxy, multi-istanza, localhost.

docs/07-limitazioni-e-attacchi/

Limitazioni del protocollo, incompatibilità applicative, attacchi documentati.

docs/08-aspetti-legali-ed-etici/

Quadro legale Italia/UE, etica dell'anonimato, responsabilità.

docs/09-scenari-operativi/

Scenari pratici di utilizzo di Tor in contesti reali.

docs/10-laboratorio-pratico/

Esercizi pratici guidati passo a passo, dalla configurazione base all'isolamento avanzato.

Terminologia tecnica: celle, circuiti, handshake, flag, strumenti, attacchi.


Config examples

File Descrizione
torrc-client.example Configurazione client con bridge obfs4
torrc.example Template torrc di default con annotazioni
torrc-relay.example Configurazione relay (middle, non exit)
torrc-hidden-service.example Configurazione onion service v3
torrc-bridge.example Configurazione bridge server con obfs4
torrc-exit.example Configurazione exit node (reduced exit policy)
proxychains4.conf.example Configurazione ProxyChains per Tor
transparent-proxy.sh.example Script iptables per transparent proxy

Scripts

File Descrizione
newnym.example Rotazione IP via ControlPort (cookie auth)
newnym-with-verify.sh.example NEWNYM con verifica cambio IP e retry
check-dns-leak.sh.example Test automatico DNS leak
verify-tor-connection.sh.example Verifica completa stato Tor
tor-circuit-info.py.example Visualizza circuiti attivi (Python/Stem)
tor-health-monitor.sh.example Monitoring continuo con notifiche
setup-tor-profile.sh.example Crea profilo Firefox tor-proxy configurato
tor-newip.sh.example Rotazione IP continua con intervallo configurabile

Tests

File Descrizione
validate-docs.sh Valida struttura e contenuto documentazione
smoke-test-tor.sh Smoke test completo funzionamento Tor

Setup

# Installazione completa automatica
sudo ./setup.sh

Comandi rapidi

# Avviare Tor
sudo systemctl start tor@default.service

# Verificare il bootstrap
sudo journalctl -u tor@default.service | grep "Bootstrapped 100%"

# Verificare l'IP via Tor
proxychains curl https://api.ipify.org

# Cambiare IP (NEWNYM con verifica)
~/scripts/newnym-with-verify.sh

# Navigare via Tor (Firefox con profilo dedicato)
proxychains firefox -no-remote -P tor-proxy & disown

# Monitorare Tor in tempo reale
nyx

Automazione

# Mostra comandi disponibili
make help

# Validare la documentazione (212 check)
make validate

# Smoke test Tor (richiede Tor attivo)
make smoke

# Statistiche del progetto
make stats

# Installazione completa
make setup

Vedi anche: CHANGELOG.md per la cronologia delle modifiche.


Ambiente

  • OS: Kali Linux (Debian-based)
  • Tor: daemon + bridge obfs4 + ControlPort
  • Strumenti: proxychains4, torsocks, nyx, curl, Firefox (profilo tor-proxy)
  • Localizzazione: Parma, Italia

Licenza

MIT

About

Deep-dive technical documentation on Tor network architecture - circuit cryptography, onion routing protocols, OPSEC, traffic analysis attacks & defenses, and hands-on labs with 210+ automated validation checks

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors