---
title: مرجع أمر nexcmp
description: جميع الأوامر الفرعية لأداة سطر أوامر خادم nexcmp — وهي status وupdate وbackup وuninstall وopen-port وclose-port وfix-owner.
url: https://nexcmp.com/ar/docs/getting-started/cli-reference/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# مرجع أمر `nexcmp` {#nexcmp-command-reference}

يضع برنامج التثبيت أداة مساعدة في `/usr/local/bin/nexcmp`. قم بتشغيلها على خادم NexCMP. تتطلب الأوامر التي تُجري تغييرات على النظام صلاحيات `sudo`. (الأداة الخاصة بالعملاء للتعامل مع API هي برنامج مختلف، راجع [cmp CLI](https://nexcmp.com/ar/docs/developers/cmp-cli/)).

| الأمر | يتطلب root | الوظيفة |
|---|---|---|
| `nexcmp status` | لا (تفاصيل إضافية مع `sudo`) | الإصدار، وحالة الخدمة (`nexcmp`، `nexcmp-vmd`)، و`/healthz`، وملخص الترخيص، وحالة المنفذ العام، ورمز الإعداد إذا لم يكتمل معالج الإعداد |
| `nexcmp update` | نعم | تشغيل برنامج التثبيت المرفق مع الإصدار المثبت بالمعلمات المحفوظة — راجع [التحديث](https://nexcmp.com/ar/docs/getting-started/updating/) |
| `nexcmp backup [dir]` | نعم | النسخ الاحتياطي إلى `/var/backups/nexcmp` (أو `dir`) — راجع [النسخ الاحتياطي والاستعادة](https://nexcmp.com/ar/docs/getting-started/backup-and-restore/) |
| `nexcmp uninstall [--purge]` | نعم | إزالة الخدمات والبرنامج؛ كما يزيل `--purge` البيانات — راجع [إلغاء التثبيت](https://nexcmp.com/ar/docs/getting-started/uninstall/) |
| `nexcmp open-port [minutes]` | نعم | وضع **طوارئ**: الاستماع على منفذ اللوحة (الافتراضي 3000) على جميع واجهات الشبكة لمدة 1–1440 دقيقة (الافتراضي 30)، ثم الإغلاق تلقائياً |
| `nexcmp close-port` | نعم | إغلاق نافذة الطوارئ الآن |
| `nexcmp fix-owner` | نعم | إعادة ملكية الملفات في `/var/lib/nexcmp` التابعة لـ root إلى المستخدم `nexcmp` |

## `nexcmp status`

```text
Version   : 1.6.1
nexcmp     : active
nexcmp-vmd : active
healthz    : ok
License   : active · domain cloud.example.com · token valid until 2026-11-12 · updates until 2027-10-30
Public port: 127.0.0.1 only (nginx proxy; emergency: sudo nexcmp open-port)
```

إذا كانت الملفات الموجودة في دليل البيانات مملوكة لـ root (على سبيل المثال تم إنشاؤها عبر تشغيل أمر `nexcmp` آخر باستخدام `sudo` بصلاحيات root)، فسيقوم `status` بطباعة تحذير، لأن مستخدم الخدمة لا يمكنه قراءتها — وتظهر هذه المشكلة عادةً بعرض الترخيص لرمز HTTP 421. قم بالإصلاح عبر `sudo nexcmp fix-owner`. كما يتم تطبيق الإصلاح نفسه تلقائياً عند كل بدء تشغيل للخدمة.

## الوصول في حالات الطوارئ {#emergency-access}

عند تعطل النطاق أو nginx أو TLS، يظل بإمكانك الوصول إلى اللوحة:

```bash
sudo nexcmp open-port 30          # http://<server-IP>:3000/ for 30 minutes
sudo nexcmp close-port            # close it earlier
```

طريقة أكثر أماناً، دون فتح أي شيء: `ssh -L 3000:127.0.0.1:3000 user@server` وتصفح `http://127.0.0.1:3000/`.

## البيئة {#environment}

| المتغير | يُستخدم لـ |
|---|---|
| `NEXCMP_BASE` | تجاوز عنوان URL الأساسي لخادم الترخيص (الافتراضي `https://nexcmp.com`)؛ للاختبار فقط |

الملفات والأدلة: البرنامج `/opt/nexcmp`، والتكوين `/etc/nexcmp`، والبيانات `/var/lib/nexcmp`، وسجلات الأحداث `/var/log/nexcmp` و`journalctl -u nexcmp -u nexcmp-vmd`.