Système de proxy HTTP BLE

Un système de proxy HTTP basé sur Bluetooth Low Energy (BLE) qui achemine le trafic du navigateur web via un appareil iOS. Cela permet de naviguer sur le web via la connexion Internet de l'appareil iOS en utilisant BLE comme couche de transport.

Architecture

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

Composants du système

1. Proxy Windows (`windows-proxy/`)

Objectif : Sert de serveur proxy HTTP pour les navigateurs
Transport : Central BLE (se connecte à iOS) ou TCP (se connecte au service simulé)
Fonctionnalités : support HTTP/HTTPS, compression des données, gestion des connexions
Port : 127.0.0.1:8080 (par défaut)

2. Application iOS (À venir - pas encore implémenté)

Objectif : Périphérique BLE qui relaie le trafic vers Internet via WiFi
Transport : Périphérique BLE, client WiFi
Fonctionnalités : traitement en arrière-plan, décompression des données, client HTTP

3. Service iOS simulé (`mock-ios-service/`)

Objectif : Simule le comportement de l'application iOS pour les tests sans appareil iOS
Transport : Serveur TCP, client HTTP/HTTPS
Fonctionnalités : compatibilité complète du protocole, statistiques, débogage
Port : 127.0.0.1:9999 (par défaut)

Démarrage rapide

Option 1 : Test avec le service simulé (Recommandé)

Terminal 1 - Démarrer le service iOS simulé :

cd mock-ios-service
npm install
npm start

Terminal 2 - Démarrer le proxy Windows en mode simulé :

cd windows-proxy
npm install
npm run mock

Configurer le navigateur :

Définir le proxy HTTP sur 127.0.0.1:8080
Naviguer normalement

Option 2 : Mode BLE réel (Nécessite un appareil iOS)

Terminal 1 - Démarrer le proxy Windows :

cd windows-proxy
npm install
npm start

Appareil iOS :

Lancer l'application iOS BLE Proxy (bientôt disponible)

Configurer le navigateur :

Définir le proxy HTTP sur 127.0.0.1:8080
Naviguer normalement

Fonctionnalités

✅ Implémentées

Serveur proxy HTTP : support complet HTTP/HTTPS CONNECT
Compression des données : compression Gzip pour un transfert efficace
Central BLE : client BLE Windows pour la connexion iOS
Service simulé : simulation iOS complète via TCP
Gestion des erreurs : logique complète de délai d'attente et de reconnexion
Configuration : variables d'environnement et fichiers de configuration
Journalisation : sortie console colorisée avec modes de débogage

🚧 En cours

Application périphérique BLE iOS : application native Swift avec Core Bluetooth

📋 Planifiées

Support du tunnel HTTPS : implémentation complète du tunnel CONNECT
Pool de connexions : optimisation des performances pour plusieurs requêtes
Tableau de bord web : surveillance et configuration via navigateur
Intégration point d'accès mobile : détection automatique du mode hotspot iOS

Détails du protocole

Format des données

Toutes les données sont transmises dans un format compressé par blocs :

[en-tête de longueur 4 octets][charge utile JSON compressée]

JSON requête/réponse

// Requête
{
  id: "uuid",           // Identifiant unique de la requête
  method: "GET",        // Méthode HTTP
  url: "https://...",   // URL cible
  headers: {},          // En-têtes HTTP
  body: "base64...",    // Corps de la requête (base64)
  isConnect: false      // Indicateur HTTPS CONNECT
}

// Réponse
{
  id: "uuid",           // Identifiant de la requête correspondante
  statusCode: 200,      // Code statut HTTP
  headers: {},          // En-têtes de réponse
  body: "base64...",    // Corps de la réponse (base64)
  success: true         // Pour les requêtes CONNECT
}

Configuration

Proxy Windows

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

Variables d'environnement

# Mode simulé
MOCK_MODE=true

# Paramètres du proxy
PROXY_HOST=127.0.0.1
PROXY_PORT=8080

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

# Service simulé
MOCK_SERVICE_HOST=127.0.0.1
MOCK_SERVICE_PORT=9999

Configuration du navigateur

Chrome/Edge

Paramètres → Avancé → Système → Ouvrir les paramètres de proxy
Proxy HTTP : 127.0.0.1:8080
Proxy HTTPS : 127.0.0.1:8080
Ne pas utiliser de proxy pour : localhost, 127.0.0.1

Firefox

Paramètres → Paramètres réseau → Configuration manuelle du proxy
Proxy HTTP : 127.0.0.1 Port : 8080
Proxy HTTPS : 127.0.0.1 Port : 8080
Utiliser ce serveur proxy pour tous les protocoles : ✓

Développement

Structure du projet

ble_proxy/
├── windows-proxy/          # Central BLE Windows + Proxy HTTP
│   ├── proxy.js           # Serveur proxy principal
│   ├── ble-client.js      # Client BLE réel
│   ├── mock-ble-client.js # Client BLE simulé (TCP)
│   ├── config.js          # Configuration
│   └── demo.js            # Script de démonstration
├── mock-ios-service/       # Périphérique BLE iOS simulé
│   ├── mock-ios.js        # Serveur TCP principal
│   ├── http-client.js     # Gestionnaire de requêtes HTTP
│   └── demo.js            # Script de démonstration
└── ios-app/               # Application iOS native (future)

Tests

Tests unitaires :

# Tester le proxy Windows
cd windows-proxy
npm test

# Tester le service simulé
cd mock-ios-service
npm test

Test d'intégration :

# Démarrer les deux services et tester avec curl
curl -x http://127.0.0.1:8080 https://httpbin.org/ip

Débogage

Activer la journalisation de débogage :

# Proxy Windows
NODE_ENV=development npm start

# Service simulé
NODE_ENV=development npm start

Débogage BLE (Windows) :

# Vérifier le statut de l'adaptateur BLE
Get-PnpDevice | Where-Object {$_.Name -like "*Bluetooth*"}

# Surveiller le trafic BLE (nécessite des outils)

Performances

Métriques typiques

Latence : +100-200 ms par rapport à une connexion directe
Débit : ~50-100 Ko/s sur BLE, ~1-10 Mo/s sur TCP simulé
Compression : 60-80% de réduction de taille pour le contenu texte
Batterie : l'application iOS utilise ~10-20% de batterie supplémentaire lorsqu'elle est active

Conseils d'optimisation

Utiliser pour du contenu textuel (HTML, JSON, CSS)
Éviter les gros téléchargements (vidéos, grandes images)
Activer le cache du navigateur
Garder l'application iOS au premier plan pour les meilleures performances

Dépannage

Problèmes du proxy Windows

# BLE ne fonctionne pas
npm run mock  # Utiliser le mode simulé à la place

# Port déjà utilisé
netstat -ano | findstr :8080

# Échec des dépendances
npm run install-build-tools

Problèmes du service simulé

# Port 9999 utilisé
netstat -ano | findstr :9999

# Connexion refusée
# S'assurer que le service simulé démarre avant le proxy

Problèmes du navigateur

# Effacer les paramètres de proxy
# Vérifier les paramètres de proxy Windows
# Désactiver les autres VPN/proxy

Considérations de sécurité

⚠️ Cet outil est destiné au développement/à des tests. Tenez compte des implications de sécurité :

Pas d'authentification entre les composants
Réseau local uniquement - ne pas exposer à Internet
Le trafic HTTP n'est pas chiffré sur BLE
HTTPS est chiffré de bout en bout mais les métadonnées sont visibles
Le mode simulé est réservé aux tests

Contribution

Forker le dépôt
Créer une branche de fonctionnalité (git checkout -b feature/name)
Tester les modes BLE et simulé
Soumettre une pull request avec des tests

Licence

Licence MIT - voir le fichier LICENSE pour les détails

Roadmap

v2.0 - Application iOS native

Application Swift iOS avec Core Bluetooth
Traitement en arrière-plan avec audio silencieux
Soumission à l'App Store
Test bêta TestFlight

v2.1 - Fonctionnalités améliorées

Tableau de bord web pour la surveillance
Prise en charge de plusieurs appareils iOS
Équilibrage de charge entre les appareils
Métriques de performances et graphiques

v2.2 - Prêt pour la production

Authentification et sécurité
Interface utilisateur de configuration
Paquets d'installation
Guides de déploiement en entreprise

Statut : ✅ Tests simulés prêts | 🚧 Application iOS en développement | 📋 Fonctionnalités de production planifiées

ble_proxy

Populaires