Tovanix
Tovanix

دليل تثبيت وإعداد 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 والبروكسي المخصص · حل نشر الشبكة الخاصة · الوكيل المخصص

جارٍ التحميل…