Sistema de Proxy HTTP por BLE

Un sistema de proxy HTTP basado en Bluetooth Low Energy (BLE) que enruta el tráfico del navegador web a través de un dispositivo iOS. Esto permite navegar por internet usando la conexión del dispositivo iOS mediante BLE como capa de transporte.

Descripción General de la Arquitectura

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

Componentes del Sistema

1. Proxy de Windows (windows-proxy/)

• Propósito: Actúa como servidor proxy HTTP para navegadores
• Transporte: BLE Central (se conecta a iOS) o TCP (se conecta al servicio simulado)
• Características: Soporte HTTP/HTTPS, compresión de datos, gestión de conexiones
• Puerto: 127.0.0.1:8080 (predeterminado)

2. App iOS (Futuro - aún no implementado)

• Propósito: Periférico BLE que retransmite el tráfico a internet vía WiFi
• Transporte: Periférico BLE, cliente WiFi
• Características: Procesamiento en segundo plano, descompresión de datos, cliente HTTP

3. Servicio iOS Simulado (mock-ios-service/)

• Propósito: Simula el comportamiento de la app iOS para pruebas sin dispositivo iOS
• Transporte: Servidor TCP, cliente HTTP/HTTPS
• Características: Compatibilidad total con el protocolo, estadísticas, depuración
• Puerto: 127.0.0.1:9999 (predeterminado)

Inicio Rápido

Opción 1: Pruebas con el Servicio Simulado (Recomendado)

Terminal 1 - Iniciar el Servicio iOS Simulado:

cd mock-ios-service
npm install
npm start

Terminal 2 - Iniciar el Proxy de Windows en Modo Simulado:

cd windows-proxy
npm install
npm run mock

Configurar el Navegador:

• Establecer el proxy HTTP en 127.0.0.1:8080
• Navegar con normalidad

Opción 2: Modo BLE Real (Requiere dispositivo iOS)

Terminal 1 - Iniciar el Proxy de Windows:

cd windows-proxy
npm install
npm start

Dispositivo iOS:

• Iniciar la app de proxy BLE para iOS (próximamente)

Configurar el Navegador:

• Establecer el proxy HTTP en 127.0.0.1:8080
• Navegar con normalidad

Características

✅ Implementadas

• Servidor Proxy HTTP: Soporte completo para CONNECT HTTP/HTTPS
• Compresión de Datos: Compresión Gzip para una transferencia eficiente
• BLE Central: Cliente BLE de Windows para la conexión iOS
• Servicio Simulado: Simulación iOS completa mediante TCP
• Manejo de Errores: Lógica integral de tiempos de espera y reconexión
• Configuración: Variables de entorno y archivos de configuración
• Registro: Salida de consola con colores y modos de depuración

🚧 En Progreso

• App Periférico BLE para iOS: App nativa Swift con Core Bluetooth

📋 Planificadas

• Soporte de Túnel HTTPS: Implementación completa del túnel CONNECT
• Agrupación de Conexiones: Optimizar el rendimiento para múltiples solicitudes
• Panel Web: Monitoreo y configuración basados en navegador
• Integración con Hotspot Móvil: Detección automática del modo hotspot de iOS

Detalles del Protocolo

Formato de Datos

Todos los datos se transmiten en un formato comprimido y fragmentado:

[encabezado de longitud de 4 bytes][carga útil JSON comprimida]

JSON de Solicitud/Respuesta

// Solicitud
{
  id: "uuid",           // ID único de solicitud
  method: "GET",        // Método HTTP
  url: "https://...",   // URL de destino
  headers: {},          // Encabezados HTTP
  body: "base64...",    // Cuerpo de la solicitud (base64)
  isConnect: false      // Indicador de CONNECT HTTPS
}

// Respuesta
{
  id: "uuid",           // ID de solicitud correspondiente
  statusCode: 200,      // Estado HTTP
  headers: {},          // Encabezados de respuesta
  body: "base64...",    // Cuerpo de la respuesta (base64)
  success: true         // Para solicitudes CONNECT
}

Configuración

Proxy de Windows

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

Variables de Entorno

# Modo simulado
MOCK_MODE=true

# Ajustes del proxy
PROXY_HOST=127.0.0.1
PROXY_PORT=8080

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

# Servicio simulado
MOCK_SERVICE_HOST=127.0.0.1
MOCK_SERVICE_PORT=9999

Configuración del Navegador

Chrome/Edge

1. Configuración → Opciones avanzadas → Sistema → Abrir configuración de proxy
2. Proxy HTTP: 127.0.0.1:8080
3. Proxy HTTPS: 127.0.0.1:8080
4. No usar proxy para: localhost, 127.0.0.1

Firefox

1. Configuración → Ajustes de red → Configuración manual de proxy
2. Proxy HTTP: 127.0.0.1 Puerto: 8080
3. Proxy HTTPS: 127.0.0.1 Puerto: 8080
4. Usar este servidor proxy para todos los protocolos: ✓

Desarrollo

Estructura del Proyecto

ble_proxy/
├── windows-proxy/          # BLE Central de Windows + Proxy HTTP
│   ├── proxy.js           # Servidor proxy principal
│   ├── ble-client.js      # Cliente BLE real
│   ├── mock-ble-client.js # Cliente BLE simulado (TCP)
│   ├── config.js          # Configuración
│   └── demo.js            # Script de demostración
├── mock-ios-service/       # Periférico BLE iOS simulado
│   ├── mock-ios.js        # Servidor TCP principal
│   ├── http-client.js     # Manejador de solicitudes HTTP
│   └── demo.js            # Script de demostración
└── ios-app/               # App nativa iOS (futuro)

Pruebas

Pruebas Unitarias:

# Probar el proxy de Windows
cd windows-proxy
npm test

# Probar el servicio simulado
cd mock-ios-service
npm test

Prueba de Integración:

# Iniciar ambos servicios y probar con curl
curl -x http://127.0.0.1:8080 https://httpbin.org/ip

Depuración

Habilitar el Registro de Depuración:

# Proxy de Windows
NODE_ENV=development npm start

# Servicio simulado
NODE_ENV=development npm start

Depuración BLE (Windows):

# Verificar el estado del adaptador BLE
Get-PnpDevice | Where-Object {$_.Name -like "*Bluetooth*"}

# Monitorear el tráfico BLE (requiere herramientas)

Rendimiento

Métricas Típicas

• Latencia: +100-200ms frente a la conexión directa
• Rendimiento: ~50-100KB/s por BLE, ~1-10MB/s por TCP simulado
• Compresión: Reducción del 60-80% en el tamaño de contenido de texto
• Batería: la app iOS consume ~10-20% más batería cuando está activa

Consejos de Optimización

1. Usar para contenido con mucho texto (HTML, JSON, CSS)
2. Evitar descargas grandes (videos, imágenes grandes)
3. Habilitar la caché del navegador
4. Mantener la app iOS en primer plano para un mejor rendimiento

Solución de Problemas

Problemas con el Proxy de Windows

# BLE no funciona
npm run mock  # Usar el modo simulado en su lugar

# Puerto ya en uso
netstat -ano | findstr :8080

# Fallo de dependencias
npm run install-build-tools

Problemas con el Servicio Simulado

# Puerto 9999 en uso
netstat -ano | findstr :9999

# Conexión rechazada
# Asegurarse de que el servicio simulado se inicie antes que el proxy

Problemas con el Navegador

# Limpiar la configuración de proxy
# Revisar la configuración de proxy de Windows
# Desactivar otras VPN/proxies

Consideraciones de Seguridad

⚠️ Esta es una herramienta de desarrollo/pruebas. Considere las implicaciones de seguridad:

• Sin autenticación entre componentes
• Solo red local - no exponer a internet
• El tráfico HTTP no está cifrado por BLE
• HTTPS está cifrado de extremo a extremo pero los metadatos son visibles
• El modo simulado es solo para pruebas

Contribuciones

1. Haga un fork del repositorio
2. Cree una rama de características (git checkout -b feature/nombre)
3. Pruebe tanto el modo BLE como el modo simulado
4. Envíe una solicitud de extracción con pruebas

Licencia

Licencia MIT - consulte el archivo LICENSE para más detalles

Hoja de Ruta

v2.0 - App Nativa iOS

• App Swift para iOS con Core Bluetooth
• Procesamiento en segundo plano con audio silencioso
• Envío a App Store
• Pruebas beta con TestFlight

v2.1 - Características Mejoradas

• Panel web para monitoreo
• Soporte de múltiples dispositivos iOS
• Balanceo de carga entre dispositivos
• Métricas de rendimiento y gráficas

v2.2 - Listo para Producción

• Autenticación y seguridad
• Interfaz de configuración
• Paquetes de instalación
• Guías de implementación empresarial

Estado: ✅ Pruebas simuladas listas | 🚧 App iOS en desarrollo | 📋 Características de producción planificadas