---
title: أخطاء التثبيت
description: كل رسالة خطأ قد يطبعها مثبت NexCMP، وسببها وكيفية إصلاحها — المتطلبات، تفعيل الترخيص، التحقق من التنزيل، الخدمات و nginx/TLS.
url: https://nexcmp.com/ar/docs/troubleshooting/installation-errors/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# أخطاء التثبيت {#installation-errors}

يتوقف المثبت عند أول مشكلة حرجة ويطبع خطاً أحمر يبدأ بـ `✗`. قم بإصلاح السبب و**شغل نفس الأمر مرة أخرى** — من الآمن تكرار تشغيل المثبت. تبدأ الأسطر الإعلامية بـ `•`، والخطوات الناجحة بـ `✓`.

## فحوصات الجهاز {#machine-checks}

| الرسالة | السبب | الحل |
|---|---|---|
| `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](https://nexcmp.com/ar/docs/getting-started/installation/#parameters). |
| `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` عبارة عن رابط رمزي | استبدله بدليل حقيقي — يرفض المثبت الروابط الرمزية لأسباب تتعلق بالأمان. |

## تنشيط الترخيص {#license-activation}

| الرسالة | السبب | الحل |
|---|---|---|
| `cannot connect to https://nexcmp.com` | لا توجد اتصالات HTTPS صادرة إلى خادم الترخيص | تحقق من نظام أسماء النطاقات (DNS) والجدار الناري والخادم الوكيل على الخادم: `curl -I https://nexcmp.com`. |
| `license activation failed (HTTP …): <message>` | رفض خادم الترخيص المفتاح | اقرأ الرسالة: مفتاح خاطئ، نطاق غير مطابق للترخيص، ترخيص معلق أو ملغي. تحقق من صفحة الترخيص على [nexcmp.com/licenses](https://nexcmp.com/licenses). |
| `no release available for this license yet` | الترخيص ليس له إصدار قابل للتنزيل | اتصل بالمبيعات؛ راجع [Support](https://nexcmp.com/ar/docs/troubleshooting/support/). |

## التنزيل والتحقق {#download-and-verification}

| الرسالة | السبب | الحل |
|---|---|---|
| `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-start}

| الرسالة | السبب | الحل |
|---|---|---|
| `service failed to start — check: journalctl -u nexcmp -n 50` | لم ترد اللوحة على `/healthz` خلال 3 دقائق | اقرأ السجل. الأسباب الشائعة: المنفذ (الافتراضي 3000) قيد الاستخدام بالفعل (`ss -ltnp | grep 3000`) — أعد التثبيت باستخدام `--port`؛ الملفات مملوكة لـ root في `/var/lib/nexcmp` — قم بتشغيل `sudo nexcmp fix-owner`. |

## nginx و TLS {#nginx-and-tls}

| الرسالة | السبب | الحل |
|---|---|---|
| `DNS <domain> does not point to <IP> (nor to Cloudflare) — skipping nginx/TLS` | سجل A/AAAA مفقود أو خاطئ | راجع [DNS and Cloudflare](https://nexcmp.com/ar/docs/getting-started/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`؛ ثم أعد التشغيل. |

## بعد التثبيت {#after-installation}

| العَرَض | السبب | الحل |
|---|---|---|
| لا يمكن للمتصفح فتح `https://<domain>` | نظام الأسماء النطاقية (DNS) أو شهادة TLS غير جاهزة | `sudo nexcmp status`؛ استخدم [emergency access](https://nexcmp.com/ar/docs/getting-started/cli-reference/#emergency-access). |
| `ERR_TOO_MANY_REDIRECTS` | وضع SSL في Cloudflare هو **Flexible** | قم بتعيين **Full (strict)** — [details](https://nexcmp.com/ar/docs/getting-started/dns-and-cloudflare/). |
| يظهر المعالج رسالة تفيد بأن "setup code" غير صحيح | خطأ مطبعي أو استخدام رمز من عملية تثبيت سابقة | قم بتشغيل `sudo nexcmp status` وانسخ الرمز الحالي. |
| تظهر الرخصة HTTP 421 | الملفات الموجودة في `/var/lib/nexcmp` مملوكة للمستخدم root | `sudo nexcmp fix-owner`، ثم `sudo systemctl restart nexcmp`. |