🇷🇺 Русский · 🇬🇧 English · 🇪🇬 العربية · 🇮🇷 فارسی · 🇨🇳 简体中文 · 🇪🇸 Español · 🇹🇷 Türkçe
REALITY · XHTTP · HYSTERIA2 · NGINX · HTTPS · BACKUP / RESTORE
نطاقان وخادم VPS جديد وبضع دقائق لإكمال التثبيت.
📦 الإصدارات · 🔗 الربط المتسلسل · 🌐 مواقع التمويه ·
3X-UI AUTO NGINX أداة تثبيت مجانية لنشر 3x-ui وXray على خادم VPS خاص بك. تضبط Nginx وشهادات HTTPS واتصالات REALITY وXHTTP وHysteria2 والاشتراكات (بما فيها الاشتراكات بصيغة Clash/Mihomo) وأدوات التشخيص. ومن خلال المدير التفاعلي يمكنك تثبيت الخادم وتغيير النطاقات وإدارة Backup/Restore v3 وإعداد الربط المتسلسل بين خادمي VPS. وتشمل الميزات الاختيارية XTLS Vision وAmneziaWG 3.1 وCloudflare WARP للمواقع الروسية وAdGuard Home مع DNS-over-HTTPS (DoH).
أكثر من مجرد تثبيت اعتيادي لـ 3x-ui: تحصل الخوادم الجديدة على مواقع مستقلة ومتعددة الصفحات للوحة وREALITY. يتوفر ما لا يقل عن 2592 تركيبة جاهزة من التصميم والنصوص، مع تغييرات إضافية في الألوان والأيقونات والتواريخ عند كل تثبيت. تحتوي المواقع على تنقّل فعلي وصفحات إضافية. وعلى نطاق REALITY يعرض HTTPS العادي عبر TCP وطلبات HTTP/3 غير المصادَق عليها عبر UDP الموقع نفسه. تعمل هذه الميزات باستخدام Nginx وXray الموجودين، دون Docker أو خوادم ويب إضافية.
| اتصالات جاهزة للاستخدام تُضبط REALITY وXHTTP وHysteria2 تلقائيًا. ويمكن اختيار XTLS Vision وAmneziaWG وXHTTP لشبكات CDN أثناء التثبيت، وتُضبط تلقائيًا أيضًا. |
مواقع تمويه متكاملة ما لا يقل عن 2592 تركيبة جاهزة من التصميم والنصوص. مواقع متعددة الصفحات مع روابط تنقّل فعّالة ونصوص وصور خاصة بها، ودعم تمويه HTTP/3 لـ Hysteria2. |
| ربط متسلسل بين خادمي VPS اربط خادمين من القائمة بسهولة. تمر المواقع وعناوين IP الروسية مباشرةً عبر خادم الدخول، بينما تمر بقية الحركة عبر خادم الخروج. |
Nginx وHTTPS على خادمك يستقبل Nginx على خادم VPS اتصالات TCP الواردة. تعمل اللوحة والاشتراكات عبر HTTPS على نطاقك، دون كشف المنافذ الداخلية مباشرةً للإنترنت. |
| Backup / Restore v3 النسخ الاحتياطي والاستعادة والنقل إلى خادم VPS آخر مع الاحتفاظ بالبيانات والمواقع المخصّصة. |
المدير وتغيير النطاقات غيّر نطاق اللوحة أو REALITY أو كليهما دون إعادة تثبيت 3X-UI أو الخدمات الأخرى. |
| شهادات تلقائية وأمان إضافي تُجدَّد شهادات Let's Encrypt تلقائيًا دون إيقاف Nginx، مع خيار حماية SSH وتحديثات الأمان التلقائية للخادم. |
ميزات إضافية XTLS Vision وAmneziaWG 3.1 وXHTTP لشبكات CDN وCloudflare WARP وAdGuard Home مع DoH وإعداد الربط المتسلسل. |
وجّه سجلات DNS الخاصة بـ نطاقين إلى عنوان IP لخادم VPS: أحدهما للوحة والآخر لـ REALITY. اتصل عبر SSH بحساب root وتأكد من إمكانية الوصول من الإنترنت إلى منفذي TCP 80 و443 ومنفذ UDP 443. راجع الأنظمة المدعومة.
curl -fSL https://github.com/xPROMSx/3x-ui-auto-nginx/releases/latest/download/x-ui-latest.sh -o x-ui-latest.sh && bash x-ui-latest.shبعد تشغيل السكربت اختر 1 — English أو 2 — Русский، ثم ستظهر القائمة الرئيسية:
- 1 — Installation: إعداد خادم جديد أو إعادة التثبيت بالكامل.
- 2 — Change Domains: تغيير نطاق اللوحة أو REALITY أو كليهما دون إعادة تثبيت.
- 3 — Backups: إنشاء النسخ الاحتياطية وعرضها واستعادتها.
- 4 — Telegram Web Proxy Manager: تشغيل مدير بروكسي Telegram المستقل أو تثبيته.
- 5 — Cascade: ربط خادمين والتحقق من الحالة أو إيقاف الربط.
- 0 — Exit: خروج.
تحتاج القائمة إلى جلسة SSH مع طرفية تفاعلية.
تنزيل احتياطي — إذا تعذّر الوصول إلى GitHub Releases
يحتوي فرع main على نسخة ألفا من المشروع. لا يُنصح بتثبيتها. استخدم الإصدار المستقر عبر الأمر الأساسي أعلاه.
curl -fSL https://raw.githubusercontent.com/xPROMSx/3x-ui-auto-nginx/main/x-ui-latest.sh -o x-ui-latest.sh && bash x-ui-latest.shCaution
التثبيت ليس تحديثًا!
إعادة تشغيل السكربت دون معاملات تفتح المدير ولا تعيد تثبيت الخادم. لكن خيار Installation مخصّص لخادم VPS نظيف أو لإعادة تثبيت كاملة.
إذا اكتُشف تثبيت قائم، يحذّر السكربت من حذف البيانات التي يديرها المشروع ويطلب كتابة YES تمامًا للتأكيد. تحلّ إعادة التثبيت محل قاعدة بيانات 3X-UI وإعدادات nginx. احتفظ أولًا بنسخة احتياطية خارج VPS.
Change Domains وBackups عمليتان مستقلتان لا تعيدان تثبيت اللوحة.
كيف أحدّث المكوّنات؟
- 3X-UI وXray: استخدم أدوات التحديث المدمجة في اللوحة. قد لا يكون توافق الإصدارات الجديدة مع إعدادات المشروع قد اختُبر بعد.
- 3X-UI AUTO NGINX: لا يُدعم تحديث المكوّنات المثبّتة مباشرةً. لاستخدام وظائف المدير الجديدة مثل 5 — Cascade، نزّل السكربت الحالي واختر العملية المطلوبة. سيتحقق المدير من توافق الإعدادات الموجودة.
- Backup / Restore: يحفظ البيانات ويستعيدها، لكنه لا يحدّث المكوّنات.
لا تختر Installation لمجرّد التحديث! حدّث nginx ونواة Linux وحزم النظام الأخرى باستخدام أدوات نظام التشغيل.
فيما يلي الإعدادات التي يعرضها المُثبّت عند اختيار Installation من القائمة الرئيسية.
Enter the domain for your 3X-UI panel:
أدخل النطاق الذي ستُتاح عبره لوحة الإدارة والاشتراكات وخدمات الويب الإضافية.
Enter the domain for VLESS REALITY:
أدخل نطاقًا ثانيًا لاتصال REALITY. يجب أن تشير سجلات DNS لكلا النطاقين إلى عنوان IP الخاص بخادم VPS.
ℹ️ خيارات تشغيل إضافية
يمكنك تمرير النطاقين مباشرة عبر سطر الأوامر دون إدخالهما عند ظهور الأسئلة:
bash x-ui-latest.sh -subdomain panel.example.com -reality_domain reality.example.comاستبدل panel.example.com وreality.example.com بنطاقيك. سيستمر اختيار الميزات الاختيارية تفاعليًا أثناء التثبيت.
Enhance VPS security? [Y/n]:
يُنصح به للمستخدمين الأقل خبرة · مفعّل افتراضيًا (Y)
يضبط المُثبّت Fail2ban لحماية SSH وDNS مشفّرًا للنظام (DoT) والتحديثات الأمنية التلقائية. وعند توفّر الشروط المناسبة، ينشئ أيضًا ملف swap بحجم 1 GiB، بغض النظر عن اختيار الحماية الإضافية.
اطّلع على التفاصيل التالية قبل تفعيل هذا الخيار، وخاصة جدول إعادة التشغيل التلقائي.
🔐 تفاصيل إعدادات الأمان
يؤدي اختيار Y إلى تفعيل إعدادات الحماية الإضافية. ويُضبط swap بشكل مستقل عن هذا الاختيار:
- Swap بحجم 1 GiB. إذا لم تكن هناك مساحة swap نشطة، وكان نظام الملفات مدعومًا وتوفرت مساحة حرة لا تقل عن 4 GiB، ينشئ المُثبّت ملف swap ويُفعّله. لا تتغير إعدادات swap الحالية. إذا لم تتحقق الشروط، تُتخطى هذه الخطوة دون إيقاف التثبيت.
- حماية SSH — Fail2ban. الحدّ من محاولات تسجيل الدخول الفاشلة المتكررة بناءً على منافذ SSH الفعلية، دون تغيير إعدادات المصادقة الحالية.
- DNS مشفّر (DoT). تستخدم خوادم Cloudflare وGoogle العامة DNS-over-TLS الإلزامي عبر
systemd-resolved. تُحفظ مسارات DNS ونطاقات البحث الخاصة بالواجهات وVPN؛ وقد تبقى استعلاماتها غير مشفّرة. إذا فشل إعداد DoT واستُعيد DNS الأصلي بنجاح، يستمر تثبيت المكونات الأساسية وFail2ban والتحديثات التلقائية بشكل مستقل عن DoT؛ وتُظهر النتيجة النهائية الفشل مع رمز خروج غير صفري. - تحديثات أمنية تلقائية. تحديث قوائم الحزم الساعة 02:30 وتثبيت التحديثات الأمنية الساعة 02:50.
- إعادة التشغيل التلقائية — 04:38. إذا تطلّبت التحديثات إعادة التشغيل، فستتم في الوقت المحدد حتى مع وجود جلسات مستخدمين نشطة، وقد تنقطع الاتصالات.
تُحسب المواعيد حسب المنطقة الزمنية المحلية لخادم VPS.
تُفحص إعدادات النظام الحالية للتأكد من التوافق قبل التعديل، وتتوفر آلية تراجع منضبطة عند فشل إعدادات الأمان.
مهم: لا يعطّل هذا الخيار تسجيل الدخول إلى SSH بكلمة مرور ولا يغني عن إدارة الخادم. اضبط الدخول بمفاتيح SSH أولًا، ثم عطّل المصادقة بكلمة المرور بنفسك.
Set up an additional VLESS TCP/TLS (XTLS Vision) connection? (requires a separate domain) [y/N]:
اتصال إضافي · معطّل افتراضيًا (N)
اتصال VLESS بديل عبر TLS قد يكون مفيدًا إذا كان REALITY غير مستقر أو محجوبًا على شبكتك. يُضاف كملف اتصال مستقل في لوحة 3X-UI.
Important
يتطلّب XTLS Vision نطاقًا ثالثًا مستقلًا يختلف عن نطاقَي اللوحة وREALITY. يجب أن يشير سجل DNS الخاص به إلى IP الخادم. يجري إعداد شهادة HTTPS وتوجيه nginx تلقائيًا.
بعد اختيار Y، سيطلب المُثبّت أيضًا إدخال هذا النطاق: Enter the domain for VLESS TLS Vision (must differ from the panel and REALITY domains):.
Set up an additional AmneziaWG connection? [y/N]:
اتصال إضافي · معطّل افتراضيًا (N)
يُنشأ اتصال AmneziaWG مستقل داخل لوحة 3X-UI. لا يلزم نطاق إضافي.
ℹ️ المزيد عن Amnezia WG
يُعدّ المُثبّت AmneziaWG 3.1 عبر UDP/8443 ويضيف قاعدة UFW المطلوبة تلقائيًا.
بعد التثبيت، أنشئ عميلًا من لوحة 3X-UI للحصول على ملف الإعداد أو رابط vpn:// لتطبيق Amnezia متوافق.
يُنشئ المُثبّت اتصال الخادم لكنه لا ينشئ عملاء AmneziaWG تلقائيًا.
تُضمَّن الإعدادات وقاعدة جدار الحماية اللازمة في Backup / Restore v3.
Add an additional CDN-compatible XHTTP connection? [y/N]:
اتصال إضافي · لا يُثبّت افتراضيًا (N)
يُنشأ اتصال VLESS مستقل يستخدم نقل XHTTP في وضع packet-up، بإعدادات خادم مهيأة للاستخدام عبر CDN. يُنشأ الاتصال معطّلًا في لوحة 3X-UI.
يستخدم نطاق HTTPS الحالي للوحة، فلا يلزم نطاق أو شهادة إضافية. بعد تفعيله، يمكن استخدام الاتصال مباشرةً دون CDN أيضًا.
للاستخدام عبر CDN، يتولى المستخدم إعداد مزوّده وتعديل إعدادات Host في 3X-UI. لا يُعدّ المُثبّت خدمات CDN، بل يوفّر ملف خادم جاهزًا لتخصيصه لاحقًا.
Route Russian websites through Cloudflare WARP to hide your VPS IP? [y/N]:
توجيه اختياري · مفعّل افتراضيًا في القائمة الروسية (Y) ومعطّل في القائمة الإنجليزية (N)
إذا كنت ستستخدم هذا VPS كخادم دخول للربط المتسلسل، فاختر N. لا يتوافق WARP مع خادم الدخول، لكن يمكن استخدامه على خادم الخروج.
عند اختيار Y، يضبط المُثبّت Cloudflare WARP (MASQUE) بحيث ترى المواقع الروسية وبعض خدمات الشبكة عنوان IP تابعًا لـ Cloudflare بدلًا من عنوان IP الخاص بخادم VPS. وهذا ضروري لحماية عنوان IP الخاص بخادمك.
ينطبق هذا الإعداد فقط على حركة البيانات التي تمر عبر VPS. إذا اتصل تطبيق بموقع مباشرةً، فلن يؤثر WARP الموجود على الخادم في ذلك الاتصال.
عند تفعيل الميزة، يسجّل المُثبّت جهازًا لدى Cloudflare ويوافق على شروط استخدام الخدمة.
إذا فشل إعداد WARP، يستمر التثبيت دونه ويُظهر التقرير النهائي نتيجة جزئية. إذا تعذّر التحقق من التراجع عن التغييرات، فتحقّق من عمل Xray في اللوحة.
ℹ️ المواقع التي تستخدم WARP وكيفية التحقق من الإعداد
يضيف المُثبّت اتصالًا صادرًا باسم warp-masque وثلاث قواعد توجيه إلى إعدادات Xray:
- WARP - RU: النطاقات الروسية المدرجة في
geosite:category-ru. - WARP - RU2: عناوين IP المدرجة في
geoip:ru. - WARP - RU3:
ipify.orgوifconfig.meوcheckip.amazonaws.comوipapi.isوiplocate.ioوip.sbو2gis.com.
تُضاف القواعد في نهاية قائمة التوجيه، وتحتفظ القواعد السابقة بأولويتها. هذا ليس ملف اتصال مستقلًا للعميل ولا VPN يشمل النظام بأكمله؛ يتم التوجيه داخل Xray.
بعد التثبيت، افتح لوحة 3X-UI وتحقّق من وجود warp-masque ضمن Xray → Outbounds، والقواعد الثلاث ضمن Xray → Routing. تُحفظ الإعدادات في Backup v3 مع إعدادات 3X-UI.
Install and configure AdGuard Home? [y/N]:
خادم DNS اختياري · معطّل افتراضيًا (N)
خادم DNS شخصي لحجب الإعلانات والتتبّع وإدارة العملاء وإرسال استعلامات DNS مشفّرة.
ℹ️ تفاصيل AdGuard Home والتحكم في الوصول
لا يلزم نطاق إضافي.
بعد التثبيت، تتوفر العناوين التالية:
- لوحة إدارة AdGuard Home:
https://panel.example.com/adg-.../— مسار عشوائي فريد. - DNS-over-HTTPS:
https://panel.example.com/dns-query.
لا يُفتح المنفذ العام 53 عبر TCP أو UDP. تُضمَّن إعدادات AdGuard Home وبياناته في Backup / Restore v3.
لخادم VPS شخصي، أنشئ ClientID مستقلًا لكل جهاز.
في AdGuard Home افتح الإعدادات ← إعدادات DNS ← إعدادات الوصول ← العملاء المسموح لهم، وأضف معرّفات ClientID هذه فقط، دون عناوين IP أو شبكات فرعية.
استخدم روابط DoH بالشكل التالي:
https://panel.example.com/dns-query/<ClientID>
بعد ضبط ذلك ستُرفض الطلبات التي لا تتضمن ClientID مسموحًا به، بما فيها الطلبات إلى /dns-query الافتراضي.
اختر معرّفات عشوائية طويلة. راجع إرشادات AdGuard Home الرسمية للأمان.
بدءًا من v2.4.1، يمكنك في التثبيتات الجديدة التحقق من تحديثات AdGuard Home وتثبيتها مباشرةً من واجهته على الويب. إذا ثبّتَّ AdGuard Home بإصدار أقدم من هذا المثبّت، فعِّل التحديثات بأمر واحد على خادم VPS:
sudo bash -c 'set -euo pipefail; umask 077; d=$(mktemp -d); trap '\''rm -rf -- "$d"'\'' EXIT; cd "$d"; u=https://github.com/xPROMSx/3x-ui-auto-nginx/releases/download/v2.4.2; curl -fLsS --connect-timeout 15 --max-time 120 "$u/x-ui-latest.sh" -o x-ui-latest.sh; curl -fLsS --connect-timeout 15 --max-time 120 "$u/x-ui-latest.sh.sha256" -o x-ui-latest.sh.sha256; sha256sum --check --strict x-ui-latest.sh.sha256; bash ./x-ui-latest.sh --enable-agh-updates'
Create a client in 3X-UI and display a subscription link after installation? [Y/n]:
موصى به · مفعّل افتراضيًا (Y)
ينشئ المُثبّت عميلًا في 3X-UI ويولّد رابط اشتراك HTTPS شخصيًا للاتصالات المُهيّأة والمدعومة.
يظهر رابط الاشتراك في تقرير التثبيت النهائي. إذا لم تختر إنشاء العميل تلقائيًا، يمكنك إنشاؤه يدويًا من اللوحة.
يعرض التقرير النهائي عنوان اللوحة واسم المستخدم وكلمة المرور وعنوان التشخيص ورابط الاشتراك (إذا اخترت إنشاء عميل). وعند تثبيت AdGuard Home، يعرض أيضًا عنوان الإدارة وكلمة المرور وعنوان DoH. ويعرض أيضًا نتيجة إعداد WARP.
إذا استلزم تحديث نظام التشغيل إعادة التشغيل، فسينبّهك المُثبّت. إعادة التشغيل الأولى يدوية باستخدام sudo reboot.
مواقع متكاملة بدلًا من الصفحات المؤقتة البسيطة. ينشئ التثبيت الجديد تلقائيًا مواقع مختلفة ومتعددة الصفحات للوحة وREALITY. يتوفر ما لا يقل عن 2592 تركيبة جاهزة من التصميم والنصوص، مع تنقّل فعلي ورسومات وتصميم ملائم للهواتف. ويحصل XTLS Vision الاختياري على موقع مستقل.
لكل تثبيت مظهره الخاص. تُخصّص الأسماء والألوان والصور والأيقونات والنصوص تلقائيًا. تتضمن الصفحات الإضافية مواد مختلفة وتواريخ نشر. ويُحفظ التصميم عند إجراء Backup/Restore أو تغيير النطاقات.
Hysteria2 مع تمويه HTTP/3. تحصل طلبات HTTPS العادية عبر TCP وطلبات HTTP/3 غير المصادَق عليها عبر UDP على نطاق REALITY على الموقع الكامل نفسه. وتبقى اللوحة والاشتراكات معزولة عن تمويه HTTP/3 العام.
| الاتصال | الحالة |
|---|---|
| VLESS + REALITY | ✅ مُفعّل افتراضيًا |
| VLESS + XHTTP | ✅ مُفعّل افتراضيًا |
| VLESS + XHTTP لشبكات CDN | 🔧 اختياري، معطّل |
| Hysteria2 | ✅ مُفعّل افتراضيًا |
| VLESS + WebSocket (TLS) | ◻️ معطّل افتراضيًا |
| Trojan + gRPC | ◻️ معطّل افتراضيًا |
| VLESS + XTLS Vision | 🔧 اختياري |
| Amnezia WG | 🔧 اختياري |
تُفعّل REALITY وXHTTP وHysteria2 بعد التثبيت. ويُنشأ WebSocket TLS وTrojan gRPC لكنهما يظلان معطّلين حتى تفعّلهما من لوحة 3X-UI.
تُضاف XTLS Vision وAmnezia WG وXHTTP لشبكات CDN فقط عند اختيارها أثناء التثبيت. يُنشأ XHTTP لشبكات CDN معطّلًا ولا يظهر في الاشتراكات إلا بعد تفعيله وربط عميل به.
لاستخدام الاتصالات، أنشئ العملاء تلقائيًا أثناء التثبيت أو يدويًا من اللوحة. يُنشأ عملاء Amnezia WG بصورة منفصلة.
يعتمد التوافق على تطبيق العميل وإصداره. وعند استخدام XHTTP عبر CDN، تؤثر أيضًا إعدادات المزوّد وقيوده.
تُقدَّم الاشتراكات العادية وJSON وMihomo / Clash عبر nginx وHTTPS. يعيد provider=1 الاشتراك الأصلي لمزوّدي البروكسي بدلًا من إعداد Clash كامل.
اختر 2 — Change Domains من القائمة الرئيسية. يمكنك تغيير نطاق اللوحة أو REALITY أو كليهما دون إعادة تثبيت. يجب أن تشير سجلات DNS الجديدة إلى VPS وأن يكون TCP/80 متاحًا لإصدار الشهادات. يجب أن تختلف النطاقات عن بعضها وعن نطاق Vision.
تُنشأ نسخة Backup v3 كاملة تلقائيًا قبل أي تغيير. تبقى بيانات العملاء والمفاتيح والإعدادات وإحصاءات الاستخدام محفوظة، ولا يتغيّر نطاق Vision. بعد التغيير قد تحتاج إلى تحديث روابط الاشتراك وإعدادات العملاء.
لا تُدعم إلا تثبيتات المشروع التي يمكن التعرف عليها، ومنها تثبيتات v2.1.7 المتوافقة. عند حدوث خطأ، لا تحذف النسخ الاحتياطية أو بيانات الاسترداد. إذا ظهر ROLLBACK_UNVERIFIED، فتوقّف واحتفظ بمعلومات التشخيص. التفاصيل والقيود والاسترداد.
من القائمة الرئيسية افتح 3 — Backups لإنشاء نسخة احتياطية أو عرض الأرشيفات أو إجراء Restore. يمكنك استخدام النسخة بعد إعادة تثبيت نظام التشغيل أو عند الانتقال إلى VPS آخر. للاستعادة، يجب أن يتطابق نظام التشغيل وإصداره وبنية المعالج مع النسخة الاحتياطية.
تتوفر أيضًا الأوامر التالية بحساب root:
# إنشاء نسخة احتياطية
x-ui-backup backup
# عرض النسخ الاحتياطية
x-ui-backup list
# استعادة نسخة محددة
x-ui-backup restore /var/backups/x-ui/<archive>.tar.gzتُحفظ الأرشيفات في /var/backups/x-ui/.
تحتوي النسخ الاحتياطية على بيانات حساسة: قاعدة بيانات العملاء وكلمات المرور والمفاتيح الخاصة للشهادات. احتفظ بنسخة خارج VPS ولا تستعد إلا أرشيفات موثوقة.
يربط الربط المتسلسل خادمي VPS يعمل عليهما مشروع 3X-UI AUTO NGINX. تتصل أجهزتك بخادم الدخول، ثم تصل إلى الإنترنت عبر خادم الخروج. قد يفيدك ذلك إذا واجهت مشكلات في الاتصال بأحد خوادم VPS أو أردت الوصول إلى الإنترنت عبر خادم في بلد آخر.
الجهاز → خادم الدخول VPS → خادم الخروج VPS → الإنترنت
تُفتح المواقع الروسية وعناوين IP الروسية مباشرةً من خادم الدخول. ويمكن تعطيل هذا السلوك بعد الإعداد من قواعد التوجيه على خادم الدخول. أما حركة البيانات التي لا تنطبق عليها القواعد السابقة فتمر عبر خادم الخروج.
يتم الإعداد من الخيار 5 — Cascade في القائمة الرئيسية، دون تعديل ملفات الإعداد يدويًا.
كيفية إعداد الربط المتسلسل والتحقق من حالته وإيقافه
- خادما VPS يعمل عليهما 3X-UI AUTO NGINX.
- اسم المستخدم وكلمة المرور للوحة 3X-UI على كل خادم.
- أحدث سكربت تثبيت يتضمن الخيار 5 — Cascade.
- يجب ألا يكون WARP مضبوطًا على خادم الدخول (يمكنك إزالته يدويًا).
شغّل أحدث سكربت تثبيت على خادم VPS الذي تريد الخروج إلى الإنترنت عبره.
اختر 5 — Cascade → 1 — Create key (exit server).
أدخل اسم المستخدم وكلمة المرور للوحة 3X-UI. يكون الإدخال مخفيًا ولا تُحفظ بيانات الدخول. يُنشئ المدير عميلًا باسم cascade في اتصال REALITY الحالي ويعرض رابط مفتاح يبدأ بـ vless://.
انسخ الرابط لاستخدامه على الخادم الثاني.
لا تشارك رابط المفتاح علنًا: فهو يسمح بالاتصال باستخدام هذا العميل.
لا تتغير إعدادات العملاء الحاليين.
شغّل أحدث سكربت تثبيت على خادم VPS الذي تتصل به أجهزتك.
اختر 5 — Cascade → 2 — Connect exit server (entry server).
أدخل اسم المستخدم وكلمة المرور للوحة 3X-UI (ولا تُحفظ هذه البيانات)، ثم ألصق رابط المفتاح من الخطوة الأولى. سيظهر الرابط في الطرفية أثناء لصقه، لكنه لا يُحفظ.
سيتحقق المدير أولًا من الاتصال بخادم الخروج. عند نجاح الاختبار، يضيف اتصالًا صادرًا باسم cascade-exit وثلاث قواعد توجيه CASCADE.
تمر المواقع وعناوين IP الروسية مباشرةً عبر خادم الدخول، ما لم تُعطّل قواعدها لاحقًا. وتُرسل بقية الحركة المناسبة عبر خادم الخروج.
قد يؤدي تطبيق الإعدادات إلى انقطاع اتصالات المستخدمين لبضع ثوانٍ. إذا فشل الفحص، يحاول المدير استعادة الإعدادات السابقة ويعرض النتيجة.
تظل اتصالات العملاء والاشتراكات الحالية مستخدمة؛ ولا حاجة إلى إنشاء ملفات اتصال خاصة بالربط المتسلسل.
افتح 5 — Cascade → 3 — Status على كل خادم.
سيطلب المدير بيانات دخول لوحة 3X-UI، كما يفعل في العمليات الأخرى.
يعرض حالة دور الدخول والخروج على هذا الخادم وحالة تشغيل Xray. لا يغيّر هذا الفحص أي إعدادات.
افتح 5 — Cascade → 4 — Disable على الخادم المطلوب.
على خادم الدخول سيعرض المدير إزالة الاتصال cascade-exit وقواعد CASCADE الثلاث. تبقى الاتصالات وقواعد اللوحة الأخرى دون تغيير.
على خادم الخروج يُحذف العميل cascade فقط. ولن تتمكن خوادم الدخول التي تستخدم مفتاحه من الاتصال بهذا الخروج بعد ذلك.
تتطلب إزالة كل دور تأكيدًا مستقلًا، وقد تؤدي تغييرات خادم الدخول إلى انقطاع الاتصالات لفترة قصيرة.
- WARP: لا يتوافق مع خادم الدخول. إذا كان موجودًا، احذف الاتصال الصادر وقواعده من لوحة 3X-UI قبل الربط. يُسمح باستخدامه على خادم الخروج.
- AmneziaWG: لا تمر اتصالاته عبر خادم الخروج.
- قواعد التوجيه: قد توجه القواعد السابقة بعض الحركة إلى مسار آخر، وسيحذرك المدير من ذلك.
- تعذّر الوصول إلى الخروج: تتوقف الحركة الموجهة إليه إلى أن يعود الاتصال. لا يوجد خادم خروج احتياطي تلقائي.
- QUIC عبر Vision: لا تمر حركة UDP/443 عبر هذا الربط.
- تغيير النطاقات: بعد تغيير نطاقات خادم الخروج، أعد توصيله من خادم الدخول.
يحفظ Backup v3 إعدادات الربط المتسلسل. وعند استعادة النسخة على خادم الدخول، تبقى هذه الإعدادات مع بقية بيانات 3X-UI.
اختُبر الربط المتسلسل على خادمي VPS حقيقيين باستخدام REALITY وXHTTP وHysteria2. لم يتأكد توافقه مع جميع تطبيقات العملاء والإعدادات.
إذا وجدت خطأً، أبلغ عنه على GitHub.
لا تُعرَض واجهات الخدمات مباشرةً على الإنترنت. تُتاح اللوحة والاشتراكات والخدمات الإضافية عبر nginx وHTTPS، بينما تظل المنافذ الداخلية محلية.
لست متأكدًا من كيفية حماية خادم VPS؟ يمكنك تفعيل إعدادات الأمان المحسّنة أثناء التثبيت لضبط حماية SSH من محاولات التخمين وDNS المشفّر والتحديثات الأمنية تلقائيًا. اقرأ أولًا الشرح التفصيلي وجدول إعادة التشغيل الليلية في قسم بدء التثبيت.
مهم: احرص على حماية الوصول إلى الخادم نفسه. استخدم مفاتيح SSH، وتحقّق من نجاح الدخول بها قبل تعطيل المصادقة بكلمة المرور. لا يعطّل المُثبّت الدخول بكلمة المرور تلقائيًا.
Telegram Web Proxy Manager مشروع مستقل لإنشاء Telegram WEB Proxy خاص بك، مع HTTPS وموقع تمويه وتحديثات تدعم التراجع عند حدوث مشكلة.
TWPM ليس جزءًا من التثبيت الأساسي لـ 3X-UI. يتيح الخيار 4 في القائمة الرئيسية تشغيله أو بدء تثبيته بشكل منفصل بعد التأكيد. وتُدار المشروعات بصورة مستقلة.
- الأنظمة: Ubuntu 24.04 وUbuntu 26.04 وDebian 13.
- UFW: يسمح بالمنافذ 80/tcp و443/tcp و443/udp (ويضيف 8443/udp عند اختيار AmneziaWG). أثناء Installation، لا يُفعّل UFW إلا بعد التحقق من إمكانية الوصول عبر SSH؛ وإلا يبقى غير نشط مع تحذير. بعد Restore من القائمة، يمكن تفعيله فقط إذا اخترت ذلك صراحةً واجتازت الإعدادات فحوص الأمان. الأمر
x-ui-backup restoreلا يفعّل UFW. - الشهادات: يجري إصدار شهادات Let's Encrypt وتجديدها تلقائيًا باستخدام webroot و
certbot.timer، دون إيقاف nginx. - إصدار 3x-ui: يثبّت المُثبّت افتراضيًا أحدث إصدار جرى التحقق جيدًا من توافقه مع 3x-ui Auto Nginx، وقد لا يكون أحدث إصدار صادر عن المشروع الأصلي. يمكنك تحديث 3x-ui لاحقًا بآليته المدمجة، لكن قد لا يكون توافق الإصدار الجديد مع إعداداتنا قد اختُبر بعد. ويمكنك اختيار إصدار مستقر آخر صراحةً باستخدام
-version <tag>(الحد الأدنى المدعوم v3.8.0)؛ وسيظهر تحذير إذا لم يُتحقق من توافقه.
يجب أن تتطابق توزيعة نظام التشغيل وإصداره ومعمارية المعالج مع النسخة الاحتياطية. إذا تغيّر عنوان IP لخادم VPS، فحدّث سجلات DNS الخاصة بالنطاقات. لا تشغّل x-ui-latest.sh؛ ثبّت أداة النسخ الاحتياطي فقط، ثم استعد أرشيفًا موثوقًا:
curl -fSL https://raw.githubusercontent.com/xPROMSx/3x-ui-auto-nginx/main/assets/backup/x-ui-backup.sh -o /tmp/x-ui-backup
install -o root -g root -m 0755 /tmp/x-ui-backup /usr/local/bin/x-ui-backup
rm -f /tmp/x-ui-backup
x-ui-backup restore /root/<archive>.tar.gzتبقى إدارة SSH ونظام التشغيل وجدار الحماية الأساسي مسؤولية مدير الخادم. لاستعادة أرشيفات v2، استخدم أداة الإصدار الأقدم المطابق.
يستند المشروع إلى 3x-ui-pro الذي طوّره mozaroc. نشأ ذلك المشروع من تفريع x-ui-pro، الذي يعود بدوره إلى مشروع x-ui-pro الأصلي لـ GFW4Fun. ويُطوَّر مشروعنا الآن بصورة مستقلة. بعد إنشاء التفريع، أُعيدت هندسة توجيه nginx/SNI وإعداد XHTTP بشكل واسع، وأُعيد تصميم إصدار شهادات TLS وتجديدها التلقائي، وأضيفت Backup / Restore v3 مع إمكانات الاستعادة والتراجع. كما أضيف Hysteria2 على UDP/443 وعولجت مشكلات أمنية مكتشفة.
اللوحة الأصلية من MHSanaei/3x-ui. يحتفظ مؤلفو المكونات الخارجية بحقوقهم وتراخيصهم الحالية.
تُتاح مساهمات xPROMSx الأصلية وتعديلاته بموجب GNU GPL-3.0-only. Copyright (C) 2026 xPROMSx contributors. ينطبق الترخيص فقط على الحقوق التي نملكها في هذه المواد، ولا يعيد ترخيص الشيفرة الموروثة أو يثبت أن المستودع بأكمله خاضع لـ GPL. راجع إشعارات المكونات الخارجية ونطاق الترخيص.
إذا أردت استخدام شيفرتنا في مشروعك. لا يلزمك فعل أي شيء لتثبيت هذا المشروع واستخدامه، فهو مجاني كما كان. أما إذا نشرت نسختك الخاصة أو نقلت شيفرتنا إلى مشروع آخر، فأبقِ سطر الإشارة إلى المصدر © xPROMSx · github.com/xPROMSx/3x-ui-auto-nginx في ملف README، وكذلك في شاشة بدء المثبّت أو قائمته الرئيسية إذا كان لمشروعك مثبّت تفاعلي. واذكر بوضوح أن نسختك معدّلة، ولا تنسب عملنا إلى نفسك. الشروط الكاملة: docs/NOTICE.md.
إذا ظهرت رموز الدول (FI وDE وUS) بدلًا من أعلامها عند فتح لوحة 3x-ui في Chrome أو Edge أو Brave على Windows 11، يمكنك استخدام مشروعنا الصغير Flag Emojis Windows Installer. يساعد على إظهار الأعلام، ويحافظ على خط Windows الأصلي، ويتيح التراجع عن التغييرات.
إذا كان هذا المشروع مفيدًا لك، يمكنك دعم استمرار تطويره طوعًا. يبقى المشروع وجميع ميزاته مجانيًا ومفتوح المصدر بغض النظر عن التبرعات.
- 🌍 دوليًا: الدعم عبر Tribute (بطاقة مصرفية)
- 🇷🇺 روسيا: الدعم عبر SBP / Mir (تطبيق البنك)
- جميع طرق الدعم — بما فيها USDT وUSDC وBitcoin.
نطاقان. بضع دقائق. خادم 3x-ui / Xray خاص بك.
⭐ إذا أفادك المُثبّت، فادعم المشروع بإضافة نجمة على GitHub لتساعد الآخرين على اكتشافه.
