Go MITM Proxy

Un proxy HTTP/HTTPS Man‑in‑the‑Middle (MITM) leggero e amichevole per sviluppatori scritto in Go. Supporta HTTP/1.1 e HTTP/2, tunneling CONNECT, tunneling WebSocket (ws/wss), caching delle risposte su disco con filtri flessibili e ricaricamento della configurazione a caldo.

Badge

Anteprima della Dashboard Admin

Panoramica

Go MITM Proxy è un proxy di intercettazione progettato per debug, test, apprendimento e intercettazione controllata del traffico HTTP(S). Quando MITM è abilitato, genera dinamicamente certificati foglia per host firmati da una CA locale, consentendo al proxy di decifrare e ispezionare il traffico HTTPS. Può anche funzionare come tunnel TCP trasparente quando MITM è disabilitato o per domini/porte escluse.

Avviso e Requisiti per un Uso Responsabile

Importante: Questa applicazione esegue un'intercettazione Man-in-the-Middle (MITM) attiva, inclusa la generazione e l'uso di certificati TLS per decifrare il traffico HTTPS. A seconda della tua giurisdizione e dell'ambiente di rete, intercettare il traffico senza il consenso chiaro e preventivo di tutti gli utenti interessati potrebbe essere illegale e può violare la privacy, le politiche aziendali o i requisiti normativi.

Prima di utilizzare questo software in qualsiasi ambiente diverso dalla tua macchina locale:

1. Ottieni il Consenso Esplicito

Tutti gli utenti di qualsiasi rete in cui questo proxy potrebbe intercettare il traffico devono essere chiaramente informati che avverrà l'intercettazione e l'ispezione HTTP(S). Il consenso deve essere esplicito e idealmente documentato.

2. Utilizza Solo su Reti Autorizzate

Non eseguire questo software su reti di cui non sei proprietario, che non amministri o per le quali non hai esplicita autorizzazione a testare o monitorare.

3. Rispetta le Leggi sulla Privacy e sulla Protezione dei Dati

Molte regioni hanno leggi severe che regolano l'intercettazione, la registrazione e l'archiviazione dei dati degli utenti (es. GDPR, CCPA, leggi sulle intercettazioni). Sei responsabile di garantire che il tuo utilizzo sia conforme a tutte le normative applicabili.

4. Proteggi la Chiave CA Generata

La chiave privata CA generata (di solito ca-key.pem) consente al detentore di impersonare qualsiasi dominio per gli utenti che fidano del certificato corrispondente.

• Conservala in modo sicuro.
• Non condividerla mai.
• Ruota/eliminala se compromessa.

5. Utilizza Solo per Test e Debug

Questo proxy è progettato per sviluppo, debug, test controllati o scopi educativi — non per monitoraggio occulto o sorveglianza non autorizzata.

---

Usando questo software, riconosci e accetti la piena responsabilità di garantire che il tuo utilizzo sia lecito, etico e correttamente comunicato a tutti gli utenti interessati.

Caratteristiche

• Proxy HTTP e HTTPS tramite semantica proxy standard
• Intercettazione MITM per HTTPS con certificati per host
• Gestione downstream di HTTP/1.1 e HTTP/2 con negoziazione ALPN
• Tunneling WebSocket: ws:// e wss://
• Cache su disco flessibile per risposte GET
  • Includi/escludi per dominio e per estensione file
  • Scadenza basata su TTL
  • Indicatori di cache hit nelle risposte (intestazione Via e una personalizzata x--uid)
• Ricaricamento a caldo della configurazione: polling opzionale di config.json e applicazione a caldo delle modifiche
• API/dashboard di amministrazione locale con autenticazione bearer-token, supporto token di sola lettura, record di ruoli utente admin, endpoint health/version/audit, SSE del traffico in tempo reale e metadati/download CA
• Politica di blocco runtime per porte, domini e intervalli IP/CIDR
• Scanner di minacce opzionale con verdetti euristici e basati su IA, redazione, caching dei verdetti, metadati di quarantena ed endpoint della dashboard
• Controlli di logging verbosi e per richiesta
• Impostazioni predefinite ragionevoli con configurazione JSON opzionale

Installazione

Prerequisiti:

• Go 1.25 o successivo

Clona e compila: bash git clone https://github.com/Welfordian/mitm-proxy.git cd mitm-proxy go build ./

Questo produce un binario mitm-proxy (o mitm-proxy.exe su Windows) nella directory principale del progetto.


## Avvio Rapido

1) Esegui il proxy con le impostazioni predefinite (ascolta su :8080): ```bash
./mitm-proxy

Al primo avvio, verrà creato un CA locale e salvato in ca-cert.pem e ca-key.pem.

2. Configura il tuo browser o curl per usare il proxy su http://localhost:8080.

3. Fida del certificato CA generato (ca-cert.pem) nel tuo sistema operativo/browser per consentire l'intercettazione HTTPS. Vedi Trusting the Local CA.

4. Visita un sito HTTPS attraverso il proxy e osserva i log. Usa la modalità verbose per maggiori dettagli: ```bash ./mitm-proxy --verbose

## Utilizzo

### Flag della riga di comando

- --config string: Percorso del file config.json
- --listen string: Indirizzo di ascolto (sovrascrive la configurazione)
- --ca-cert string: Percorso del certificato CA esistente (sovrascrive la configurazione)
- --ca-key string: Percorso della chiave CA esistente (sovrascrive la configurazione)
- --mitm bool: Abilita l'intercettazione MITM (default true; impostare false forza il tunneling)
- --verbose bool: Abilita logging verboso
- --watch-config bool: Controlla le modifiche a config.json e applica automaticamente (default true)
- --admin-enabled bool: Abilita API/dashboard di amministrazione locale (default true)
- --admin-addr string: Indirizzo di ascolto API/dashboard amministrazione (default 127.0.0.1:9090)
- --admin-token string: Token bearer di amministrazione (generato all'avvio se omesso)
- --admin-read-token string: Token bearer di sola lettura per accesso amministrativo GET/HEAD/OPTIONS
- --admin-ui bool: Fornisci interfaccia utente amministrativa incorporata (default true)
- --admin-store string: Percorso del database SQLite di amministrazione (default dashboard.db)

I flag CLI sovrascrivono i valori del file di configurazione dove indicato.


### Configurazione (config.json)