Sistema Proxy HTTP BLE

Un sistema proxy HTTP basato su Bluetooth Low Energy (BLE) che instrada il traffico del browser web attraverso un dispositivo iOS. Permette di navigare sul web usando la connessione internet del dispositivo iOS tramite BLE come livello di trasporto.

Panoramica dell'Architettura

Browser → Proxy Windows → BLE/TCP → iOS/Mock Service → WiFi → Internet
        ← Proxy Windows ← BLE/TCP ← iOS/Mock Service ← WiFi ←

Componenti del Sistema

1. Proxy Windows (windows-proxy/)

• Scopo: Agisce come server proxy HTTP per i browser
• Trasporto: Central BLE (si connette a iOS) o TCP (si connette al servizio mock)
• Caratteristiche: Supporto HTTP/HTTPS, compressione dati, gestione connessioni
• Porta: 127.0.0.1:8080 (predefinita)

2. App iOS (Futura - non ancora implementata)

• Scopo: Periferica BLE che inoltra il traffico a internet tramite WiFi
• Trasporto: Periferica BLE, client WiFi
• Caratteristiche: Elaborazione in background, decompressione dati, client HTTP

3. Servizio iOS Mock (mock-ios-service/)

• Scopo: Simula il comportamento dell'app iOS per test senza dispositivo iOS
• Trasporto: Server TCP, client HTTP/HTTPS
• Caratteristiche: Piena compatibilità del protocollo, statistiche, debug
• Porta: 127.0.0.1:9999 (predefinita)

Avvio Rapido

Opzione 1: Test con Servizio Mock (Consigliato)

Terminale 1 - Avvia il Servizio iOS Mock:

cd mock-ios-service
npm install
npm start

Terminale 2 - Avvia il Proxy Windows in Modalità Mock:

cd windows-proxy
npm install
npm run mock

Configura il Browser:

• Imposta il proxy HTTP su 127.0.0.1:8080
• Naviga normalmente

Opzione 2: Modalità BLE Reale (Richiede dispositivo iOS)

Terminale 1 - Avvia il Proxy Windows:

cd windows-proxy
npm install
npm start

Dispositivo iOS:

• Avvia l'app iOS BLE Proxy (in arrivo)

Configura il Browser:

• Imposta il proxy HTTP su 127.0.0.1:8080
• Naviga normalmente

Caratteristiche

✅ Implementate

• Server Proxy HTTP: Supporto completo HTTP/HTTPS CONNECT
• Compressione Dati: Compressione Gzip per trasferimento efficiente
• Central BLE: Client BLE Windows per connessione iOS
• Servizio Mock: Simulazione iOS completa tramite TCP
• Gestione Errori: Logica completa di timeout e riconnessione
• Configurazione: Variabili d'ambiente e file di configurazione
• Logging: Output console colorizzato con modalità debug

🚧 In Corso

• App Periferica BLE iOS: App Swift nativa con Core Bluetooth

📋 Pianificate

• Supporto Tunnel HTTPS: Implementazione completa del tunnel CONNECT
• Pooling di Connessioni: Ottimizzazione delle prestazioni per richieste multiple
• Dashboard Web: Monitoraggio e configurazione basati su browser
• Integrazione Hotspot Mobile: Rilevamento automatico della modalità hotspot iOS

Dettagli del Protocollo

Formato Dati

Tutti i dati vengono trasmessi in formato compresso e chunked:

[Intestazione lunghezza 4 byte][Payload JSON compresso]

JSON Richiesta/Risposta

// Richiesta
{
  id: "uuid",           // ID univoco richiesta
  method: "GET",        // Metodo HTTP
  url: "https://...",   // URL di destinazione
  headers: {},          // Intestazioni HTTP
  body: "base64...",    // Corpo richiesta (base64)
  isConnect: false      // Flag CONNECT HTTPS
}

// Risposta
{
  id: "uuid",           // ID richiesta corrispondente
  statusCode: 200,      // Stato HTTP
  headers: {},          // Intestazioni risposta
  body: "base64...",    // Corpo risposta (base64)
  success: true         // Per richieste CONNECT
}

Configurazione

Proxy Windows

// windows-proxy/config.js
{
  proxy: {
    host: "127.0.0.1",
    port: 8080,
    timeout: 30000
  },
  ble: {
    serviceUUID: "a1b2c3d4-...",
    // ... altri UUID
  }
}

Variabili d'Ambiente

# Modalità mock
MOCK_MODE=true

# Impostazioni proxy
PROXY_HOST=127.0.0.1
PROXY_PORT=8080

# UUID BLE
BLE_SERVICE_UUID=a1b2c3d4-e5f6-7890-1234-567890abcdef

# Servizio mock
MOCK_SERVICE_HOST=127.0.0.1
MOCK_SERVICE_PORT=9999

Configurazione del Browser

Chrome/Edge

1. Impostazioni → Avanzate → Sistema → Apri impostazioni proxy
2. Proxy HTTP: 127.0.0.1:8080
3. Proxy HTTPS: 127.0.0.1:8080
4. Ignora proxy per: localhost, 127.0.0.1

Firefox

1. Impostazioni → Impostazioni di rete → Configurazione proxy manuale
2. Proxy HTTP: 127.0.0.1 Porta: 8080
3. Proxy HTTPS: 127.0.0.1 Porta: 8080
4. Usa questo server proxy per tutti i protocolli: ✓

Sviluppo

Struttura del Progetto

ble_proxy/
├── windows-proxy/          # Central BLE Windows + Proxy HTTP
│   ├── proxy.js           # Server proxy principale
│   ├── ble-client.js      # Client BLE reale
│   ├── mock-ble-client.js # Client BLE mock (TCP)
│   ├── config.js          # Configurazione
│   └── demo.js            # Script demo
├── mock-ios-service/       # Periferica BLE iOS mock
│   ├── mock-ios.js        # Server TCP principale
│   ├── http-client.js     # Gestore richieste HTTP
│   └── demo.js            # Script demo
└── ios-app/               # App iOS nativa (futura)

Test

Test Unitari:

# Test proxy Windows
cd windows-proxy
npm test

# Test servizio mock
cd mock-ios-service
npm test

Test di Integrazione:

# Avvia entrambi i servizi e testa con curl
curl -x http://127.0.0.1:8080 https://httpbin.org/ip

Debug

Abilita Logging di Debug:

# Proxy Windows
NODE_ENV=development npm start

# Servizio mock
NODE_ENV=development npm start

Debug BLE (Windows):

# Controlla stato adattatore BLE
Get-PnpDevice | Where-Object {$_.Name -like "*Bluetooth*"}

# Monitora traffico BLE (richiede strumenti)

Prestazioni

Metriche Tipiche

• Latenza: +100-200ms rispetto alla connessione diretta
• Throughput: ~50-100KB/s su BLE, ~1-10MB/s su TCP mock
• Compressione: Riduzione del 60-80% per contenuti testuali
• Batteria: L'app iOS consuma ~10-20% di batteria in più quando attiva

Suggerimenti per l'Ottimizzazione

1. Usa per contenuti pesanti in testo (HTML, JSON, CSS)
2. Evita download grandi (video, immagini grandi)
3. Abilita la cache del browser
4. Mantieni l'app iOS in primo piano per prestazioni ottimali

Risoluzione dei Problemi

Problemi del Proxy Windows

# BLE non funziona
npm run mock  # Usa invece modalità mock

# Porta già in uso
netstat -ano | findstr :8080

# Dipendenze che falliscono
npm run install-build-tools

Problemi del Servizio Mock

# Porta 9999 in uso
netstat -ano | findstr :9999

# Connessione rifiutata
# Assicurati che il servizio mock parta prima del proxy

Problemi del Browser

# Pulisci impostazioni proxy
# Controlla impostazioni proxy di Windows
# Disabilita altre VPN/proxy

Considerazioni sulla Sicurezza

⚠️ Questo è uno strumento di sviluppo/test. Considera le implicazioni di sicurezza:

• Nessuna autenticazione tra i componenti
• Solo rete locale - non esporre a internet
• Il traffico HTTP non è crittografato su BLE
• HTTPS è crittografato end-to-end ma i metadati sono visibili
• La modalità mock è solo per test

Contribuire

1. Fai un fork del repository
2. Crea un branch per la funzionalità (git checkout -b feature/nome)
3. Testa sia la modalità BLE che quella mock
4. Invia una pull request con i test

Licenza

Licenza MIT - vedi file LICENSE per i dettagli

Roadmap

v2.0 - App iOS Nativa

• App iOS Swift con Core Bluetooth
• Elaborazione in background con audio silenzioso
• Invio all'App Store
• Beta testing su TestFlight

v2.1 - Funzionalità Avanzate

• Dashboard web per il monitoraggio
• Supporto per più dispositivi iOS
• Bilanciamento del carico tra dispositivi
• Metriche prestazionali e grafici

v2.2 - Pronto per la Produzione

• Autenticazione e sicurezza
• UI di configurazione
• Pacchetti di installazione
• Guide per distribuzione enterprise

Stato: ✅ Test mock pronto | 🚧 App iOS in sviluppo | 📋 Funzionalità di produzione pianificate