دليل تثبيت وتشغيل nexcore-x-ui (لوحة عُقد Xray)
دليل Astrenix/nexcore-x-ui الكامل: التثبيت بأمر واحد، وواجهة Vue 3 وملف Go ثابت، وتحصين systemd، وواجهة REST /api/v1، وأوامر CLI وحل الأعطال.
- ملف Go تنفيذي ثابت مع واجهة Vue 3 + Element Plus ونواة Xray-core دون ارتباط صارم بإصدار GLIBC للخادم.
- واجهة REST كاملة على /api/v1 مهيأة لوحدات التحكّم الخارجية والسكربتات وإدارة عدة عُقد.
- تحصين systemd صارم (مثل ProtectSystem=strict وNoNewPrivileges=true) وأذونات 0700 للمجلدات و0600 لقاعدة البيانات وتخزين API Token بصيغة SHA256.
- VLESS مع نقل XTLS-Reality وTCP وWebSocket وgRPC لأداء خفيف واتصال مستقر.
البنية والمزايا الأساسية
أُعيد بناء nexcore-x-ui من vaxilu/x-ui للنشر السحابي الآلي والأمان الإنتاجي مع المزايا التالية:
- ملف Go تنفيذي ثابت مع واجهة Vue 3 + Element Plus ونواة Xray-core دون ارتباط صارم بإصدار GLIBC للخادم.
- واجهة REST كاملة على /api/v1 مهيأة لوحدات التحكّم الخارجية والسكربتات وإدارة عدة عُقد.
- تحصين systemd صارم (مثل ProtectSystem=strict وNoNewPrivileges=true) وأذونات 0700 للمجلدات و0600 لقاعدة البيانات وتخزين API Token بصيغة SHA256.
- مسارات تثبيت ووحدة systemd وأمر CLI مستقل (nexcore-x-ui) دون أي تعارض مع x-ui الأصلي.
متطلبات النظام والبيئة
- نظام التشغيل — نظام Linux حديث 64 بت مع systemd (يُوصى بنظام Ubuntu 22.04 / 24.04 LTS نظيف أو Debian 12).
- الصلاحيات — يلزم دخول root لتسجيل خدمة systemd وفتح المنافذ وتأمين مجلد البيانات.
- الشبكة — عنوان IP عام مع إمكانية الوصول إلى GitHub Releases لتنزيل الملفات وفتح منافذ اللوحة والبروتوكولات في الجدار الناري.
- الخوادم الموصى بها — يعمل بسلاسة مع خوادم Tovanix بعناوين أصلية أو Dual-ISP أو سكنية أو الخوادم الفعلية.
التثبيت بأمر واحد والنشر المؤتمت
سجّل الدخول عبر SSH بصلاحية root وشغّل السكربت الرسمي لتنزيل الملف الثابت وتفعيل الخدمة وتوليد بيانات دخول عشوائية:
bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-x-ui/main/install.sh)
للنشر الآلي عبر cloud-init أو لوحة تحكم خارجية، مرّر متغيرات المسار الآمن ونداء Webhook قبل تشغيل المثبّت:
REPORT_URL=https://your-controller.example/callback \
REPORT_KEY=your_secret \
SECURE_ENTRY=1 \
bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-x-ui/main/install.sh)
بدءًا من الإصدار v2.1.3 لم تعد بيانات الدخول النصية الأولية تُكتب في ملف install-info.txt على القرص؛ بل تظهر فقط في لافتة الطرفية وفي systemd journal.
استرجاع بيانات الدخول الأولية
إذا أغلقت الطرفية بعد اكتمال التثبيت، استرجع لافتة التثبيت الأولية عبر أمر CLI أو من سجل systemd journal مباشرة:
nexcore-x-ui creds
journalctl -u nexcore-x-ui --no-pager --since "1 day ago"
بعد تسجيل الدخول لأول مرة، غيّر كلمة المرور العشوائية من إعدادات اللوحة أو عبر nexcore-x-ui passwd وقيّد الوصول إلى منفذ اللوحة في الجدار الناري.
مرجع سريع لأوامر nexcore-x-ui CLI
يسجّل التثبيت الأمر العام nexcore-x-ui لتسهيل تشغيل الخدمة وفحص السجلات وتغيير كلمة المرور والترقية والإزالة:
- nexcore-x-ui — فتح القائمة التفاعلية لإدارة اللوحة من الطرفية.
- nexcore-x-ui start | stop | restart | status — تشغيل خدمة اللوحة أو إيقافها أو إعادة تشغيلها أو عرض حالتها.
- nexcore-x-ui creds / info — عرض منفذ اللوحة ومسار الدخول وبيانات التثبيت الأولية.
- nexcore-x-ui reset — إعادة توليد اسم مستخدم وكلمة مرور ومنفذ عشوائي جديد للوحة.
- nexcore-x-ui passwd <user> <new_password> — تعيين كلمة مرور جديدة يدويًا لحساب المدير المحدد.
- nexcore-x-ui log / log-tail — عرض آخر 200 سطر من السجلات أو متابعة السجل المباشر.
- nexcore-x-ui update — الترقية السلسة إلى أحدث إصدار من GitHub Releases وإعادة تشغيل الخدمة.
- nexcore-x-ui uninstall — إزالة الملفات التنفيذية ووحدة systemd ومجلد البيانات بالكامل (خذ نسخة احتياطية أولًا).
البروتوكولات وطرق النقل المدعومة
بالاعتماد على Xray-core تدعم اللوحة بيانات مستقلة لكل مستخدم وحدود بيانات وتواريخ انتهاء عبر:
- VLESS مع نقل XTLS-Reality وTCP وWebSocket وgRPC لأداء خفيف واتصال مستقر.
- VMess وTrojan للتوافق مع العملاء القائمين وإعدادات نطاقات TLS.
- Shadowsocks وShadowsocks-2022 للعملاء الخفيفين وروابط التمرير السريعة.
- SOCKS وHTTP وDokodemo-door لبروكسي التطبيقات وتمرير المنافذ والسلاسل متعددة القفزات.
بعد اختبار الاتصال، افحص عنوان IP الخارج عبر أداة فحص جودة IP المجانية للتأكد من تصنيفه الأصلي وتصنيف المشغّل.
استكشاف الأخطاء
- صفحة تسجيل الدخول لا تفتح في المتصفح — المنفذ العشوائي محجوب في الجدار الناري أو تم إغفال مسار الدخول الآمن في الرابط. — شغّل nexcore-x-ui status وnexcore-x-ui info للتأكد من المنفذ والمسار ثم افتح منفذ TCP في الجدار الناري.
- فقدان كلمة المرور العشوائية الأولية — الإصدارات v2.1.3 فما فوق لا تحفظ ملف كلمة مرور نصي على القرص. — استخدم nexcore-x-ui creds لقراءة السجل أو أعد تعيينها عبر nexcore-x-ui passwd <user> <new_password>.
- المدخل يعمل لكن العملاء يفشلون في الاتصال — منفذ البروتوكول مغلق أو مصافحة Reality تفشل أو ساعة الخادم غير متزامنة. — راجع قواعد TCP / UDP وزامن وقت NTP ثم تتبع أخطاء Xray عبر nexcore-x-ui log-tail.
- الترقية من داخل اللوحة لم تتفعّل — انتهاء مهلة التنزيل من GitHub Releases أو بقاء عملية قديمة عالقة. — نفّذ nexcore-x-ui update عبر SSH لمتابعة المخرجات ثم تحقّق باستخدام nexcore-x-ui status.
الأسئلة الشائعة
هل يمكن تثبيت nexcore-x-ui إلى جانب vaxilu/x-ui على الخادم نفسه؟
نعم، الملفات التنفيذية ومجلد البيانات ووحدة systemd وأمر CLI منفصلة تمامًا؛ يكفي ألا تتقاطع المنافذ.
هل تحذف الترقية المداخل أو المستخدمين الحاليين؟
لا، الترقية داخل اللوحة وأمر nexcore-x-ui update يستبدلان الملف التنفيذي فقط مع الحفاظ على قاعدة بيانات SQLite.
كيف أؤتمت إدارة العُقد عبر /api/v1؟
أنشئ API Token من إعدادات اللوحة (يُحفظ كـ SHA256 على الخادم) ثم أرسل طلبات REST قياسية للمداخل والمستخدمين والإحصاءات.
صفحات ذات صلة: دليل تثبيت وإعداد nexcore-s-ui (لوحة عُقد sing-box) · دليل اختيار لوحات العُقد: nexcore-x-ui وnexcore-s-ui والبروكسي المخصص · حل نشر الشبكة الخاصة · خوادم VPS بعناوين IP أصلية وسكنية
جارٍ التحميل…