---
title: تثبيت NexCMP
description: ثبّت NexCMP على Ubuntu بأمر تثبيت من سطر واحد — المعلمات، وما يفعله المثبت، وTLS وnginx، وكيفية الوصول إلى معالج الإعداد.
url: https://nexcmp.com/ar/docs/getting-started/installation/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# تثبيت NexCMP {#install-nexcmp}

برنامج التثبيت عبارة عن سكريبت فردي يوفره خادم التراخيص الخاص بك. يفحص الجهاز، ويفعّل ترخيصك، وينزّل البرنامج ويتحقق منه، ويثبّت الخدمات ويهيئ nginx (اختيارياً) بشهادة Let's Encrypt.

## قبل أن تبدأ {#before-you-start}

- خادم يستوفي [المتطلبات](https://nexcmp.com/ar/docs/getting-started/requirements/)، مع صلاحيات root.
- **مفتاح الترخيص** و**النطاق الرئيسي** من [صفحة الترخيص](https://nexcmp.com/licenses) الخاصة بك — راجع [الترخيص والشراء](https://nexcmp.com/ar/docs/getting-started/license-and-purchase/).
- سجل DNS للنطاق — راجع [DNS وCloudflare](https://nexcmp.com/ar/docs/getting-started/dns-and-cloudflare/). يمكنك أيضاً التثبيت أولاً وضبط DNS لاحقاً؛ حيث يخبرك برنامج التثبيت بما ينقصك ويمكن إعادة تشغيله ببساطة.

## التثبيت {#install}

1. سجّل الدخول إلى الخادم وانتقل إلى مستخدم root (أو أضف `sudo` في بداية الأمر).
2. شغّل الأمر الموجود في صفحة الترخيص الخاصة بك، والذي يبدو كالتالي:

```bash
curl -fsSL https://nexcmp.com/install.sh | sudo bash -s -- \
  --license NXC-XXXXX-XXXXX-XXXXX-XXXXX \
  --domain cloud.example.com \
  --email admin@example.com
```

3. انتظر حتى تظهر علامات التحقق. يستغرق التثبيت الجديد بضع دقائق؛ حيث يُنشئ التشغيل الأول مخطط قاعدة البيانات وقد يستغرق ما يصل إلى دقيقة على الأقراص البطيئة.
4. اقرأ الملخص في النهاية، حيث يعرض روابط البوابة ولوحة الإدارة، و**رمز الإعداد**، والخطوة التالية.

![اكتمال برنامج التثبيت مع عرض رابط البوابة ورابط الإدارة ورمز الإعداد لمرة واحدة](https://nexcmp.com/ar/docs/images/getting-started/installation-01-finish.webp)

## المعلمات {#parameters}

| المعلمة | القيمة الافتراضية | المعنى |
|---|---|---|
| `--license KEY` | مطلوبة عند أول تثبيت | مفتاح الترخيص. |
| `--domain NAME` | مطلوبة عند أول تثبيت | النطاق الرئيسي. يجب أن يطابق الترخيص. تُزال `https://` والمسارات اللاحقة تلقائياً. |
| `--email ADDRESS` | لا يوجد | البريد الإلكتروني للتواصل لتلقي إشعارات انتهاء صلاحية Let's Encrypt. بدونه تُسجَّل الشهادة بدون بريد إلكتروني. |
| `--port N` | `3000` | المنفذ المحلي للوحة التحكم (1–65535). |
| `--no-nginx` | معطّل | عدم تثبيت أو تكوين nginx / TLS. استخدم هذا الخيار إذا كنت تشغّل وكيل عكسي خاصاً بك أو ترغب في إلقاء نظرة على NexCMP أولاً. |
| `--behind-cloudflare` | يُكتشف تلقائياً | فرض وضع "النطاق مخدوم عبر وكيل Cloudflare". يُكتشف عادةً من DNS. |
| `--channel NAME` | `stable` | قناة الإصدار. |

إعادة تشغيل برنامج التثبيت **بدون معلمات** تعيد استخدام المعلمات المحفوظة (`/etc/nexcmp/install.conf`) وتُجري الترقية بأمان، مع الاحتفاظ بالبيانات والإعدادات والحسابات. هذا هو تماماً ما يقوم به `sudo nexcmp update`.

## ما يفعله برنامج التثبيت {#what-the-installer-does}

1. **يفحص الجهاز** — Ubuntu 22.04/24.04، ومعمارية x86_64، وذاكرة وصول عشوائي (RAM) لا تقل عن 2 GB، ومساحة قرص فارغة 8 GB.
2. **يثبّت الحزم** المطلوبة (`curl`، `zstd`، `openssl`، `python3`، `openssh-client` …).
3. **يُنشئ مستخدم الخدمة** `nexcmp` والدلائل: `/opt/nexcmp` (البرنامج، مملوك للمستخدم root، للقراءة فقط بالنسبة للخدمة)، `/etc/nexcmp` (الإعدادات)، `/var/lib/nexcmp` (البيانات)، `/var/log/nexcmp`.
4. **يفعّل الترخيص** للنطاق ويخزن معرّف مثيل ثابت لهذا الجهاز.
5. **ينزّل أحدث إصدار يحق لك الحصول عليه**، ثم يتحقق من تجزئة SHA-256 وتوقيع Ed25519 الخاص به. يُرفض أي إصدار لا يحمل توقيعاً صالحاً، ولا يُرجع النظام أبداً إلى إصدار أقدم من الإصدار الأحدث قيد التشغيل.
6. **يكتب ملفات التكوين ووحدات systemd** (`nexcmp`، `nexcmp-vmd`، `nexcmp-update`) ويبدأ تشغيل الخدمات؛ وينتظر حتى يستجيب `/healthz`.
7. **يُعدّ nginx وTLS** (ما لم يتم تحديد `--no-nginx`): يحصل على شهادة Let's Encrypt عبر certbot (باستخدام تحدي webroot) للنطاق ولكل من `admin.<domain>` / `partner.<domain>` عندما يتم حل هذه الأسماء أيضاً. إذا كان DNS لا يشير إلى هذا الخادم (أو Cloudflare) بعد، فسيتم تخطي هذه الخطوة مع إظهار تنبيه.
8. **يعرض ملخصاً** يتضمن عناوين URL، وفي حال عدم وجود أي مسؤول بعد، يعرض **رمز الإعداد**.

## منفذ لوحة التحكم (3000) {#the-panel-port-3000}

- خلال التثبيت لأول مرة، تستمع اللوحة على `0.0.0.0:3000` لتتمكن من فتح معالج الإعداد عبر `http://<server-IP>:3000/setup`.
- بمجرد اكتمال المعالج **و**تفعيل TLS، تستمع اللوحة على `127.0.0.1` فقط؛ ويقوم nginx بتمرير `https://<domain>` إليها كوكيل.
- لحالات الطوارئ (تعطل nginx، أو خطأ في DNS) يمكنك فتح المنفذ لفترة محددة: `sudo nexcmp open-port 30` (لمدة 30 دقيقة، ثم يُغلق تلقائياً) — أو استخدام نفق SSH: `ssh -L 3000:127.0.0.1:3000 <server>` ثم التصفح عبر `http://127.0.0.1:3000/`.

::: warning بروتوكول HTTP غير المشفر
المنفذ 3000 يعتمد بروتوكول HTTP غير المشفر. استخدمه فقط لمعالج الإعداد على شبكة موثوقة، أو عبر نفق SSH. لا تتركه مفتوحاً.
:::

## التثبيت بدون نطاق عام (للمختبرات أو الاختبار) {#installing-without-a-public-domain-lab-or-test}

يمكنك التثبيت على جهاز لا يتوفر له DNS بعد:

```bash
curl -fsSL https://nexcmp.com/install.sh | sudo bash -s -- \
  --license NXC-XXXXX-XXXXX-XXXXX-XXXXX --domain lab.example.com --no-nginx
```

ثم افتح المعالج عبر نفق SSH (`ssh -L 3000:127.0.0.1:3000 <server>`، وتصفح `http://127.0.0.1:3000/setup`). أعد تشغيل برنامج التثبيت بدون `--no-nginx` بمجرد توفر DNS.

## Docker وKubernetes {#docker-and-kubernetes}

لا توجد صورة حاوية منشورة. برنامج التثبيت (تثبيت systemd أصلي) هو طريقة التثبيت المدعومة.

## التحقق {#verify}

```bash
sudo nexcmp status
```

يجب أن يظهر لك رقم الإصدار، و`nexcmp: active`، و`nexcmp-vmd: active`، و`healthz: ok`، و— حتى يكتمل المعالج — رمز الإعداد. تابع باستخدام [معالج الإعداد](https://nexcmp.com/ar/docs/getting-started/setup-wizard/).

إذا حدث خطأ ما، فراجع [أخطاء التثبيت](https://nexcmp.com/ar/docs/troubleshooting/installation-errors/).