نظام وسيط HTTP عبر BLE

نظام وسيط HTTP قائم على تقنية Bluetooth Low Energy (BLE) يوجّه حركة مرور متصفح الويب عبر جهاز iOS. يتيح هذا التصفح عبر اتصال الإنترنت لجهاز iOS باستخدام BLE كطبقة نقل.

نظرة عامة على البنية

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

مكونات النظام

1. وسيط ويندوز (windows-proxy/)

• الغرض: يعمل كخادم وسيط HTTP للمتصفحات
• النقل: BLE Central (يتصل بـ iOS) أو TCP (يتصل بخدمة المحاكاة)
• الميزات: دعم HTTP/HTTPS، ضغط البيانات، إدارة الاتصالات
• المنفذ: 127.0.0.1:8080 (افتراضي)

2. تطبيق iOS (مستقبلي - غير منفذ بعد)

• الغرض: طرفية BLE تعيد توجيه حركة المرور إلى الإنترنت عبر WiFi
• النقل: طرفية BLE، عميل WiFi
• الميزات: معالجة في الخلفية، فك ضغط البيانات، عميل HTTP

3. خدمة محاكاة iOS (mock-ios-service/)

• الغرض: يحاكي سلوك تطبيق iOS للاختبار دون الحاجة لجهاز iOS
• النقل: خادم TCP، عميل HTTP/HTTPS
• الميزات: توافق كامل مع البروتوكول، إحصائيات، تصحيح أخطاء
• المنفذ: 127.0.0.1:9999 (افتراضي)

بدء سريع

الخيار 1: الاختبار مع خدمة المحاكاة (موصى به)

الطرفية 1 - تشغيل خدمة محاكاة iOS:

cd mock-ios-service
npm install
npm start

الطرفية 2 - تشغيل وسيط ويندوز في وضع المحاكاة:

cd windows-proxy
npm install
npm run mock

تكوين المتصفح:

• اضبط وسيط HTTP على 127.0.0.1:8080
• تصفح بشكل طبيعي

الخيار 2: وضع BLE الحقيقي (يتطلب جهاز iOS)

الطرفية 1 - تشغيل وسيط ويندوز:

cd windows-proxy
npm install
npm start

جهاز iOS:

• شغّل تطبيق وسيط BLE لنظام iOS (قريباً)

تكوين المتصفح:

• اضبط وسيط HTTP على 127.0.0.1:8080
• تصفح بشكل طبيعي

الميزات

✅ منفّذة

• خادم وسيط HTTP: دعم كامل لـ HTTP/HTTPS CONNECT
• ضغط البيانات: ضغط Gzip لنقل فعال
• BLE Central: عميل BLE لويندوز للاتصال بـ iOS
• خدمة المحاكاة: محاكاة كاملة لنظام iOS باستخدام TCP
• معالجة الأخطاء: منطق شامل لانتهاء المهلة وإعادة الاتصال
• الإعدادات: متغيرات بيئة وملفات إعدادات
• التسجيل: مخرجات وحدة تحكم ملونة مع أوضاع تصحيح

🚧 قيد التطوير

• تطبيق طرفية BLE لنظام iOS: تطبيق Swift أصلي مع Core Bluetooth

📋 مخطط

• دعم نفق HTTPS: تنفيذ كامل لنفق CONNECT
• تجميع الاتصالات: تحسين الأداء للطلبات المتعددة
• لوحة تحكم ويب: مراقبة وإعدادات عبر المتصفح
• التكامل مع نقطة الاتصال المحمولة: اكتشاف تلقائي لوضع نقطة الاتصال في iOS

تفاصيل البروتوكول

تنسيق البيانات

تُنقل جميع البيانات بتنسيق مضغوط ومجزأ:

[4-byte length header][compressed JSON payload]

طلبات/استجابات JSON

// Request
{
  id: "uuid",           // Unique request ID
  method: "GET",        // HTTP method
  url: "https://...",   // Target URL
  headers: {},          // HTTP headers
  body: "base64...",    // Request body (base64)
  isConnect: false      // HTTPS CONNECT flag
}

// Response
{
  id: "uuid",           // Matching request ID
  statusCode: 200,      // HTTP status
  headers: {},          // Response headers
  body: "base64...",    // Response body (base64)
  success: true         // For CONNECT requests
}

الإعدادات

وسيط ويندوز

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

متغيرات البيئة

# Mock mode
MOCK_MODE=true

# Proxy settings
PROXY_HOST=127.0.0.1
PROXY_PORT=8080

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

# Mock service
MOCK_SERVICE_HOST=127.0.0.1
MOCK_SERVICE_PORT=9999

إعداد المتصفح

كروم/إيدج

1. الإعدادات → خيارات متقدمة → النظام → فتح إعدادات الوسيط
2. وسيط HTTP: 127.0.0.1:8080
3. وسيط HTTPS: 127.0.0.1:8080
4. تجاهل الوسيط لـ: localhost, 127.0.0.1

فايرفوكس

1. الإعدادات → إعدادات الشبكة → تكوين الوسيط اليدوي
2. وسيط HTTP: 127.0.0.1 المنفذ: 8080
3. وسيط HTTPS: 127.0.0.1 المنفذ: 8080
4. استخدم هذا الخادم الوسيط لجميع البروتوكولات: ✓

التطوير

هيكل المشروع

ble_proxy/
├── windows-proxy/          # Windows BLE Central + HTTP Proxy
│   ├── proxy.js           # Main proxy server
│   ├── ble-client.js      # Real BLE client
│   ├── mock-ble-client.js # Mock BLE client (TCP)
│   ├── config.js          # Configuration
│   └── demo.js            # Demo script
├── mock-ios-service/       # Mock iOS BLE Peripheral
│   ├── mock-ios.js        # Main TCP server
│   ├── http-client.js     # HTTP request handler
│   └── demo.js            # Demo script
└── ios-app/               # iOS Native App (future)

الاختبار

اختبارات الوحدة:

# Test Windows proxy
cd windows-proxy
npm test

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

اختبار التكامل:

# Start both services and test with curl
curl -x http://127.0.0.1:8080 https://httpbin.org/ip

تصحيح الأخطاء

تفعيل تسجيل التصحيح:

# Windows proxy
NODE_ENV=development npm start

# Mock service
NODE_ENV=development npm start

تصحيح أخطاء BLE (ويندوز):

# Check BLE adapter status
Get-PnpDevice | Where-Object {$_.Name -like "*Bluetooth*"}

# Monitor BLE traffic (requires tools)

الأداء

مقاييس نموذجية

• زمن الاستجابة: +100-200ms مقارنة بالاتصال المباشر
• الإنتاجية: ~50-100KB/s عبر BLE، ~1-10MB/s عبر محاكاة TCP
• الضغط: تقليل الحجم بنسبة 60-80% للمحتوى النصي
• البطارية: تطبيق iOS يستهلك بطارية أكثر بنسبة ~10-20% عند التشغيل

نصائح التحسين

1. استخدمه للمحتوى النصي الكثيف (HTML، JSON، CSS)
2. تجنب التنزيلات الكبيرة (الفيديو، الصور الكبيرة)
3. فعّل التخزين المؤقت للمتصفح
4. أبقِ تطبيق iOS في المقدمة للحصول على أفضل أداء

استكشاف الأخطاء وإصلاحها

مشاكل وسيط ويندوز

# BLE not working
npm run mock  # Use mock mode instead

# Port already in use
netstat -ano | findstr :8080

# Dependencies failing
npm run install-build-tools

مشاكل خدمة المحاكاة

# Port 9999 in use
netstat -ano | findstr :9999

# Connection refused
# Ensure mock service starts before proxy

مشاكل المتصفح

# Clear proxy settings
# Check Windows proxy settings
# Disable other VPNs/proxies

اعتبارات أمنية

⚠️ هذه أداة تطوير/اختبار. ضع في اعتبارك الآثار الأمنية:

• لا مصادقة بين المكونات
• الشبكة المحلية فقط - لا تعرضها للإنترنت
• حركة مرور HTTP غير مشفرة عبر BLE
• HTTPS مشفر من طرف إلى طرف لكن البيانات الوصفية مرئية
• وضع المحاكاة للاختبار فقط

المساهمة

1. انسخ المستودع (Fork)
2. أنشئ فرع الميزة (git checkout -b feature/name)
3. اختبر وضعي BLE والمحاكاة
4. قدّم طلب سحب (Pull Request) مع الاختبارات

الترخيص

رخصة MIT - راجع ملف LICENSE للتفاصيل

خارطة الطريق

v2.0 - تطبيق iOS الأصلي

• تطبيق iOS بلغة Swift مع Core Bluetooth
• معالجة في الخلفية مع صوت صامت
• تقديم إلى App Store
• اختبار تجريبي عبر TestFlight

v2.1 - ميزات محسّنة

• لوحة تحكم ويب للمراقبة
• دعم أجهزة iOS متعددة
• موازنة الحمل بين الأجهزة
• مقاييس أداء ورسوم بيانية

v2.2 - جاهز للإنتاج

• المصادقة والأمان
• واجهة مستخدم للإعدادات
• حزم التثبيت
• أدلة نشر للمؤسسات

الحالة: ✅ اختبار المحاكاة جاهز | 🚧 تطبيق iOS قيد التطوير | 📋 ميزات الإنتاج مخطط لها