NetBoxy VPN - تطبيق Android

تطبيق VPN احترافي لنظام Android يدعم بروتوكول VLESS مع واجهة مستخدم HTML5.

المميزات ✨

• ✅ دعم بروتوكول VLESS الكامل
• ✅ واجهة مستخدم HTML5 احترافية
• ✅ دعم 6 لغات (العربية، الإنجليزية، الفرنسية، الإسبانية، الألمانية، التركية)
• ✅ اتصال VPN حقيقي باستخدام VpnService API
• ✅ إشعارات للحالة
• ✅ حفظ التكوين تلقائياً
• ✅ تصميم عصري مع تأثيرات حركية

المتطلبات 📋

• Android Studio Arctic Fox أو أحدث
• Android SDK 21+ (Android 5.0 Lollipop)
• JDK 8 أو أحدث
• Gradle 7.0+

البنية 🏗️

NetBoxyVPN/
├── app/
│   ├── src/
│   │   └── main/
│   │       ├── java/com/netboxy/vpn/
│   │       │   ├── MainActivity.kt          # النشاط الرئيسي + WebView
│   │       │   └── VpnService.kt           # خدمة VPN
│   │       ├── res/
│   │       │   ├── layout/
│   │       │   │   └── activity_main.xml   # تخطيط الشاشة
│   │       │   ├── values/
│   │       │   │   ├── strings.xml
│   │       │   │   └── themes.xml
│   │       │   └── xml/
│   │       │       ├── backup_rules.xml
│   │       │       └── data_extraction_rules.xml
│   │       ├── assets/
│   │       │   └── index.html              # الواجهة الأمامية
│   │       └── AndroidManifest.xml
│   └── build.gradle
├── build.gradle
├── settings.gradle
└── gradle.properties

كيفية البناء 🔨

1. باستخدام Android Studio:

1. افتح Android Studio
2. اختر File > Open
3. اختر مجلد NetBoxyVPN
4. انتظر حتى ينتهي Gradle من المزامنة
5. اضغط على Run (▶️) أو Build > Build Bundle(s) / APK(s) > Build APK(s)

2. باستخدام سطر الأوامر:

cd NetBoxyVPN

# Linux/Mac
./gradlew assembleDebug

# Windows
gradlew.bat assembleDebug

سيتم إنشاء ملف APK في:

app/build/outputs/apk/debug/app-debug.apk

كيفية الاستخدام 📱

1. قم بتثبيت التطبيق على جهاز Android
2. افتح التطبيق
3. الصق تكوين VLESS في الحقل المخصص
4. اضغط على زر "اتصال"
5. امنح التطبيق إذن VPN عند الطلب
6. انتظر حتى يتم الاتصال

مثال على تكوين VLESS:

vless://ba0e3984-ccc9-48a3-8074-b2f507f41ce8@34.143.73.2:443?encryption=none&security=tls&sni=youtube.com&type=ws&host=seifszx-581425403466.europe-west1.run.app&path=/@NetBoxy#NetBoxy_Config

الميزات التقنية 🔧

MainActivity.kt

• يحتوي على WebView لعرض واجهة HTML
• يوفر JavaScript Interface للتواصل بين HTML و Android
• يطلب إذن VPN من المستخدم
• يبدأ/يوقف خدمة VPN

VpnService.kt

• يقوم بإنشاء VPN Interface
• يوجه حركة المرور عبر خادم VPN
• يعرض إشعار للحالة
• يدعم بروتوكول VLESS

index.html

• واجهة مستخدم HTML5 احترافية
• تحليل تلقائي لتكوين VLESS
• دعم متعدد اللغات
• حفظ التكوين تلقائياً
• تأثيرات حركية سلسة

الأذونات المطلوبة 🔐

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

التخصيص 🎨

تغيير الألوان:

عدّل المتغيرات في index.html:

:root {
    --primary: #00d4ff;
    --secondary: #6c5ce7;
    --accent: #ff6b6b;
    --success: #00e676;
}

إضافة لغة جديدة:

أضف الترجمة في كائن translations في index.html:

const translations = {
    ar: { ... },
    en: { ... },
    // لغتك الجديدة
    it: {
        subtitle: "La tua VPN per connessioni sicure",
        // ...
    }
};

استكشاف الأخطاء 🔍

المشكلة: التطبيق لا يتصل

• تأكد من صحة تكوين VLESS
• تحقق من اتصال الإنترنت
• تأكد من منح إذن VPN

المشكلة: الواجهة لا تظهر

• تأكد من وجود ملف index.html في مجلد assets
• تحقق من تفعيل JavaScript في WebView

المشكلة: خطأ في البناء

• قم بتنظيف المشروع: Build > Clean Project
• أعد بناء المشروع: Build > Rebuild Project
• تحديث Gradle: File > Sync Project with Gradle Files

ملاحظات مهمة ⚠️

1. VPN Service API: التطبيق يستخدم VpnService API من Android
2. الأمان: يجب استخدام خوادم VPN موثوقة
3. البروتوكول: الكود الحالي يحتوي على تطبيق مبسط لـ VLESS - للإنتاج، استخدم مكتبات مثل v2ray-core
4. الاختبار: اختبر على أجهزة حقيقية للحصول على أفضل النتائج

الترخيص 📄

هذا المشروع مفتوح المصدر ومتاح للاستخدام الحر.

المساهمة 🤝

المساهمات مرحب بها! يرجى:

1. Fork المشروع
2. إنشاء branch للميزة الجديدة
3. Commit التغييرات
4. Push إلى Branch
5. فتح Pull Request

الدعم 💬

للدعم والأسئلة، يرجى فتح Issue في GitHub.

---

تم التطوير بواسطة NetBoxy Team 🚀