دليل تثبيت وإعداد nexcore-s-ui (لوحة عُقد sing-box)
دليل Astrenix/nexcore-s-ui الكامل: تثبيت sing-box بأمر واحد وملفات musl ثابتة وشهادات SSL تلقائية عبر Cloudflare DNS-01 وواجهة /api/v1 وCLI.
- واجهة Vue 3 + Element Plus جديدة لإدارة المداخل والمخارج وقواعد التوجيه وحسابات المستخدمين في sing-box.
- ملفات musl ثابتة تدعم amd64 وarm64 ومعماريات Linux أخرى دون اعتماد على GLIBC الخادم.
- واجهة REST /api/v1 كاملة مع سجل تدقيق متوافقة مع وحدات التحكم المصممة لـ nexcore-x-ui.
- تكامل مدمج مع Cloudflare API Token لإصدار وتجديد شهادات SSL تلقائيًا عبر DNS-01 دون تعارض مع المنفذ 80.
البنية والمزايا الأساسية
أُعيد تصميم nexcore-s-ui من alireza0/s-ui لبيئات sing-box والأتمتة القائمة على API ويشمل:
- واجهة Vue 3 + Element Plus جديدة لإدارة المداخل والمخارج وقواعد التوجيه وحسابات المستخدمين في sing-box.
- ملفات musl ثابتة تدعم amd64 وarm64 ومعماريات Linux أخرى دون اعتماد على GLIBC الخادم.
- واجهة REST /api/v1 كاملة مع سجل تدقيق متوافقة مع وحدات التحكم المصممة لـ nexcore-x-ui.
- تكامل مدمج مع Cloudflare API Token لإصدار وتجديد شهادات SSL تلقائيًا عبر DNS-01 دون تعارض مع المنفذ 80.
متطلبات النظام والمعمارية
- النظام المدعوم — Ubuntu 24.04 LTS (مُختبَر بالكامل وموصى به)، ويتوافق أيضًا مع Ubuntu 20.04+ وDebian 11+ وCentOS Stream 8+ مع systemd.
- معماريات المعالج — ملفات تنفيذية ثابتة لمعماريات amd64 وarm64 و386 وarmv5 وarmv6 وarmv7 وs390x.
- الصلاحيات — يتطلب صلاحية root لربط المنافذ 80 / 443 وكتابة شهادات ACME وإنشاء واجهات tun عند الحاجة.
- التعايش المستقل — مسارات ووحدة systemd ومنفذ عشوائي مستقل يتيح التشغيل المتوازي مع s-ui الأصلي.
التثبيت بأمر واحد وتحديد الإصدار وإعادة التثبيت
اتصل عبر SSH بصلاحية root وشغّل المثبّت الرسمي، حيث يولّد أول تثبيت اسم مستخدم وكلمة مرور ومنفذًا عشوائيًا:
bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-s-ui/main/install.sh)
لتثبيت إصدار محدد أو استبدال الملفات التنفيذية مع الحفاظ على قاعدة البيانات الحالية، مرّر وسم الإصدار أو --force:
bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-s-ui/main/install.sh) --force
# bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-s-ui/main/install.sh) v1.0.0
تُطبع بيانات الدخول العشوائية ورابط اللوحة مرة واحدة فقط في نهاية التثبيت؛ احفظها فورًا قبل إغلاق الطرفية.
إعداد شهادات SSL التلقائية عبر Cloudflare DNS-01
لبروتوكولات Hysteria2 وTrojan وAnyTLS وأي مدخل يعتمد على TLS، اضبط Cloudflare DNS-01 للإصدار والتجديد التلقائي:
- وجّه نطاقًا مُدارًا على Cloudflare إلى خادمك: سجّل نطاقًا في Tovanix Cloud (أو استخدم نطاقك) وأضف سجل A / AAAA يشير إلى عنوان IP العام للعُقدة.
- أنشئ Cloudflare API Token بصلاحيات محدودة: أنشئ في Cloudflare رمز API مقصورًا على نطاقك بصلاحية Zone:DNS:Edit فقط بدلًا من المفتاح العام.
- أدخل النطاق والرمز داخل اللوحة: من إعدادات الشهادات في nexcore-s-ui اختر وضع DNS-01 وأدخل النطاق وAPI Token ثم احفظ ليبدأ الإصدار والتجديد التلقائي.
يتحقق وضع DNS-01 من ملكية النطاق عبر سجلات DNS TXT، لذا يعمل حتى لو كان المنفذ 80 مشغولًا أو مغلقًا.
مرجع سريع لأوامر nexcore-s-ui CLI
استخدم الأمر nexcore-s-ui للتحكم بالخدمة وفحص السجلات والترقية والإزالة:
- nexcore-s-ui — فتح القائمة التفاعلية لإدارة اللوحة.
- nexcore-s-ui start | stop | restart | status — تشغيل خدمة nexcore-s-ui أو إيقافها أو إعادة تشغيلها أو فحص حالتها.
- nexcore-s-ui log — عرض أحدث سجلات اللوحة والنواة لتشخيص أخطاء المداخل أو ACME.
- nexcore-s-ui update — الترقية إلى أحدث إصدار في GitHub Releases مع الاحتفاظ بقاعدة البيانات.
- nexcore-s-ui uninstall — إزالة الملفات التنفيذية وخدمة systemd والبيانات المحلية بالكامل (خذ نسخة احتياطية مسبقًا).
استكشاف الأخطاء
- رابط اللوحة لا يستجيب بعد التثبيت — المنفذ العشوائي غير مفتوح في الجدار الناري أو تم نسيان مسار URI المُولَّد. — راجع المنفذ وURI الكامل في مخرجات التثبيت وافتح المنفذ ثم تحقّق عبر nexcore-s-ui status.
- فشل إصدار شهادة Cloudflare DNS-01 — يفتقر API Token إلى صلاحية Zone:DNS:Edit على النطاق أو لم تنتشر سجلات DNS بعد. — تحقق من نطاق صلاحيات الرمز وراجع رسالة ACME الدقيقة باستخدام nexcore-s-ui log.
- فشل اتصال Hysteria2 أو بروتوكولات UDP — تم فتح TCP فقط مع بقاء UDP محجوبًا، أو وجود اختلاف في نطاق الشهادة أو ALPN. — اسمح بحركة UDP على منفذ المدخل وتأكد من تطابق SNI العميل مع نطاق الشهادة.
- إصلاح الملف التنفيذي دون فقدان الإعدادات — تنفيذ uninstall يحذف الملفات التنفيذية وقاعدة البيانات معًا. — لا تشغّل uninstall؛ نفّذ install.sh --force لاستبدال الملف التنفيذي مع إبقاء قاعدة البيانات سليمة.
الأسئلة الشائعة
هل يعتمد nexcore-s-ui على إصدار محدد من GLIBC؟
لا، تُبنى الإصدارات بشكل ثابت مع musl لمعماريات Linux متعددة مع التوصية بـ Ubuntu 24.04 LTS.
هل يمكن تشغيل nexcore-s-ui مع alireza0/s-ui الأصلي؟
نعم، المجلدات وخدمة systemd والمنافذ معزولة ويمكن تشغيلهما معًا دون تعارض في المنافذ.
لماذا يُفضَّل Cloudflare DNS-01 على HTTP-01 للشهادات؟
لا يحتاج DNS-01 إلى المنفذ 80 ويدعم الشهادات الشاملة ولا يتعارض مع خوادم الويب القائمة.
صفحات ذات صلة: دليل تثبيت وتشغيل nexcore-x-ui (لوحة عُقد Xray) · دليل اختيار لوحات العُقد: nexcore-x-ui وnexcore-s-ui والبروكسي المخصص · حل نشر الشبكة الخاصة · الوكيل المخصص
جارٍ التحميل…