عن المشروع

3X-UI هي لوحة تحكم ويب مفتوحة المصدر لنشر وتهيئة ومراقبة خوادم Xray-core. توصف بأنها شوكة محسّنة لمشروع X-UI الأصلي، تضيف دعمًا أوسع للبروتوكولات، وحساب حركة مرور لكل عميل، وميزات إدارة إضافية. يذكر ملف README أنها مخصصة للاستخدام الشخصي وليست للاستخدام الإنتاجي أو للأغراض غير القانونية. دعم البروتوكولات والنقل تشمل البروتوكولات الواردة: VLESS وVMess وTrojan وShadowsocks وWireGuard وAmneziaWG وTUIC v5 وHysteria2 وMTProto وHTTP وSOCKS (المختلط) وDokodemo-door / Tunnel وTUN. أما وسائل النقل فتشمل TCP (خام) وmKCP وWebSocket وgRPC وHTTPUpgrade وXHTTP، مع أمان TLS وXTLS وREALITY. تسمح عمليات التراجع (Fallbacks) بمشاركة منفذ واحد بين بروتوكولات متعددة. يُوصف AmneziaWG بأنه يعمل داخل اللوحة على حزمة شبكة بمساحة المستخدم دون وحدة نواة أو DKMS. أما TUIC v5 فيُنفَّذ كعملية جانبية مع قياس حركة مرور ترحيل UDP ومصافحة 0-RTT والتحكم بالازدحام BBR. تدعم بروكسيات MTProto أسرار FakeTLS لكل عميل وعلامات إعلانية وحصصًا تُطبق مباشرة. إدارة العملاء وحركة المرور تشمل الميزات لكل عميل: حصص حركة المرور، وتواريخ الانتهاء، وحدود عناوين IP مع استثناءات العناوين الموثوقة، وحدود أجهزة HWID، ودورات تجديد مجدولة، وحالة اتصال مباشرة، وروابط مشاركة، ورموز QR، واشتراكات. تُتتبع إحصائيات حركة المرور لكل قناة دخول ولكل عميل ولكل قناة خروج، مع أدوات إعادة تعيين. يتكامل Fail2ban لفرض حدود IP لكل عميل. النشر والتشغيل يتم التثبيت عبر سكربت شل يولّد بيانات اعتماد عشوائية ومسار وصول؛ ويُفتح عبر أمر x-ui. ويدعم التثبيت غير التفاعلي لـ cloud-init، مع كتابة بيانات الاعتماد إلى /etc/x-ui/install-result.env. وتأتي إصدارات النشر مع مجاميع .sha256 يتحقق منها المثبت والمحدِّث. تشمل أنظمة التشغيل المدعومة: Ubuntu وDebian وArmbian وFedora وCentOS وRHEL وAlmaLinux وRocky Linux وOracle Linux وAmazon Linux وVirtuozzo وArch وManjaro وParch وopenSUSE وAlpine وWindows، عبر معماريات amd64 و386 وarm64 وarmv7 وarmv6 وarmv5 وs390x. يمكن أن يكون التخزين SQLite (الافتراضي) أو PostgreSQL، مع أمر ترحيل موثق من SQLite إلى PostgreSQL. ويدعم النشر عبر Docker Compose، بما في ذلك ملف تعريف اختياري يتضمن PostgreSQL؛ وتضم الصورة Fail2ban وتتطلب صلاحيتي NET_ADMIN وNET_RAW لتطبيق الحظر. إمكانات أخرى يتيح الدعم متعدد العقد الإدارة والتوسع عبر خوادم متعددة من لوحة واحدة، بما في ذلك استنساخ قنوات الدخول إلى عقد أخرى. تشمل ميزات الخروج والتوجيه: WARP وNordVPN وPIA وقواعد توجيه مخصصة وموازنات تحميل مع تجاوز الفشل من موازن إلى موازن وسلاسل بروكسي للخروج وفئات geosite/geoip قابلة للتصفح في محرر القواعد. يوفر خادم اشتراكات مدمج تنسيقات raw وJSON وClash بناءً على User-Agent الخاص بالعميل، مع قوالب صفحات مخصصة. يوفر بوتا Telegram وDiscord مراقبة وإدارة عن بُعد. تقدم واجهة RESTful API رموزًا مميزة بصلاحيات محدودة وقد تنتهي صلاحيتها، ومرجعًا للـ API داخل اللوحة. يمكن تثبيت اللوحة كتطبيق ويب تقدمي (PWA). الواجهة متاحة بـ 13 لغة مع ثيمات داكنة وفاتحة. يمكن لمراقب صحة النفق فحص عنوان URL وإعادة تشغيل xray بعد فشل متكرر. يمكن تشفير رموز API الخاصة بالعقد أثناء التخزين عبر إعداد keyring. يوجد مرجع كامل لمتغيرات البيئة مرتبط في الوثائق. تشمل الأدوات المجتمعية المذكورة مزود Terraform/OpenTofu لإدارة قنوات الدخول والعملاء وإعدادات اللوحة وتهيئة Xray كرمز، وتطبيق Android أصلي للوحات المعلومات وقنوات الدخول والعملاء مع مشاركة QR والعقد والإدارة متعددة اللوحات.