أخطاء التثبيت
يتوقف المثبت عند أول مشكلة حرجة ويطبع خطاً أحمر يبدأ بـ ✗. قم بإصلاح السبب وشغل نفس الأمر مرة أخرى — من الآمن تكرار تشغيل المثبت. تبدأ الأسطر الإعلامية بـ •، والخطوات الناجحة بـ ✓.
فحوصات الجهاز
| الرسالة | السبب | الحل |
|---|---|---|
must be run as root (sudo) | لا يتم التشغيل بصلاحيات الجذر (root) | أضف sudo قبل الأمر، أو قم بتشغيله بصلاحيات الجذر (root). |
only Ubuntu 22.04/24.04 is supported (this host: …) | توزيعة أو إصدار آخر | استخدم خادم Ubuntu 22.04 أو 24.04. |
only x86_64 is supported | ARM أو وحدة معالجة مركزية أخرى | استخدم خادم x86_64. |
requires ≥ 2 GB RAM (host has … MB) | ذاكرة غيرเพียงية | أضف ذاكرة وصول عشوائي (RAM). |
requires ≥ 8 GB free disk space on / (… GB available) | نظام ملفات الجذر ممتلئ تقريباً | حرر مساحة أو قم بتوسيع /. |
missing --license / missing --domain | التثبيت الأول بدون تلك المعلمات | تمرير كلاهما — راجع Installation. |
unknown argument: … | خطأ مطبعي في المعلمة | تحقق من الإملاء؛ قم بالتنفيذ باستخدام --help. |
apt-get failed (another apt/dpkg process, e.g. unattended-upgrades, may still be running) | مدير الحزم مقفل | انتظر بضع دقائق (يقوم نظام Ubuntu الجديد بتشغيل التحديثات التلقائية بعد التمهيد) ثم أعد التشغيل. |
… is a symlink — aborting | /opt/nexcmp أو /etc/nexcmp عبارة عن رابط رمزي | استبدله بدليل حقيقي — يرفض المثبت الروابط الرمزية لأسباب تتعلق بالأمان. |
تنشيط الترخيص
| الرسالة | السبب | الحل |
|---|---|---|
cannot connect to https://nexcmp.com | لا توجد اتصالات HTTPS صادرة إلى خادم الترخيص | تحقق من نظام أسماء النطاقات (DNS) والجدار الناري والخادم الوكيل على الخادم: curl -I https://nexcmp.com. |
license activation failed (HTTP …): <message> | رفض خادم الترخيص المفتاح | اقرأ الرسالة: مفتاح خاطئ، نطاق غير مطابق للترخيص، ترخيص معلق أو ملغي. تحقق من صفحة الترخيص على nexcmp.com/licenses. |
no release available for this license yet | الترخيص ليس له إصدار قابل للتنزيل | اتصل بالمبيعات؛ راجع Support. |
التنزيل والتحقق
| الرسالة | السبب | الحل |
|---|---|---|
failed to download release X | مشكلة في الشبكة أثناء التنزيل | أعد التشغيل. |
sha256 mismatch (… ≠ …) | وصل الملف تالفاً أو تم تعديله | أعد التشغيل؛ إذا تكرر ذلك، فقد يقوم خادم وكيل بإعادة كتابة التنزيلات — جرب من شبكة أخرى. |
release X is unsigned — refusing to install | لم يقدم الخادم أي توقيع | لا تتخطي أبداً؛ اتصل بالدعم. |
INVALID SIGNATURE for version X — aborting | توقيع Ed25519 لا يتم التحقق منه | لا تقم بالتثبيت أبداً. اتصل بالدعم — هذا يعني أن الملف ليس إصداراً رسمياً. |
openssl failed to read public key | OpenSSL قديم جداً أو معطل | قم بتحديث حزمة openssl. |
invalid version: … | بيانات غير متوقعة من الخادم | أعد التشغيل؛ اتصل بالدعم إذا استمرت المشكلة. |
بدء الخدمة
| الرسالة | السبب | الحل |
|---|---|---|
service failed to start — check: journalctl -u nexcmp -n 50 | لم ترد اللوحة على /healthz خلال 3 دقائق | اقرأ السجل. الأسباب الشائعة: المنفذ (الافتراضي 3000) قيد الاستخدام بالفعل (`ss -ltnp |
nginx و TLS
| الرسالة | السبب | الحل |
|---|---|---|
DNS <domain> does not point to <IP> (nor to Cloudflare) — skipping nginx/TLS | سجل A/AAAA مفقود أو خاطئ | راجع DNS and Cloudflare، ثم أعد التشغيل. |
certbot could not get a certificate yet — re-run the installer once DNS has settled | فشل التحقق من Let's Encrypt (المنفذ 80 محظور، لم ينتشر نظام أسماء النطاقات، حد المعدل) | افتح المنفذ 80، وانتظر انتشار نظام أسماء النطاقات، وأعد التشغيل. تحقق من /var/log/letsencrypt/letsencrypt.log. |
certbot could not renew now — keeping the existing certificate | فشل التجديد المؤقت | غير ضار؛ أعد التشغيل لاحقاً. |
nginx rejected the HTTPS configuration — kept the previous one (check: nginx -t) | يتعارض موقع nginx آخر (نفس server_name، إعدادات مكررة) | قم بتشغيل sudo nginx -t وإصلاح التعارض، ثم أعد التشغيل. |
apt-get could not install nginx / certbot، أو E: Failed to fetch … 404 Not Found | مدير الحزم مقفل، أو أن فهرس حزم الخادم قديم (يحدث عادةً في صور القوالب التي لم يتم تحديثها منذ فترة) | قم بتشغيل sudo apt-get update، وانتظر حتى تنتهي أي عملية apt أخرى، ثم أعد تشغيل مثبت البرنامج. |
openssl could not create the self-signed certificate | مشكلة في OpenSSL | قم بتحديث openssl؛ ثم أعد التشغيل. |
بعد التثبيت
| العَرَض | السبب | الحل |
|---|---|---|
لا يمكن للمتصفح فتح https://<domain> | نظام الأسماء النطاقية (DNS) أو شهادة TLS غير جاهزة | sudo nexcmp status؛ استخدم emergency access. |
ERR_TOO_MANY_REDIRECTS | وضع SSL في Cloudflare هو Flexible | قم بتعيين Full (strict) — details. |
| يظهر المعالج رسالة تفيد بأن "setup code" غير صحيح | خطأ مطبعي أو استخدام رمز من عملية تثبيت سابقة | قم بتشغيل sudo nexcmp status وانسخ الرمز الحالي. |
| تظهر الرخصة HTTP 421 | الملفات الموجودة في /var/lib/nexcmp مملوكة للمستخدم root | sudo nexcmp fix-owner، ثم sudo systemctl restart nexcmp. |