# NexCMP Docs > Documentation for NexCMP 1.6.1: a self-hosted cloud management and billing platform for CloudStack and Proxmox VE (customer portal, billing, resellers, AI chat/agent, API). Every page below is also available as raw Markdown by adding .md to the URL; the whole documentation is in llms-full.txt. - [Overview](https://nexcmp.com/ar/docs/): what is in these docs ## البدء - [ما هو NexCMP](https://nexcmp.com/ar/docs/getting-started/what-is-nexcmp.md): NexCMP هي بوابة عملاء ونظام فوترة ولوحة تحكم مستضافة ذاتياً لبيع الأجهزة الافتراضية والخدمات السحابية عبر CloudStack أو Proxmox VE الخاصين بك. - [متطلبات خادم NexCMP](https://nexcmp.com/ar/docs/getting-started/requirements.md): متطلبات العتاد ونظام التشغيل والشبكة وDNS للخادم الذي يشغّل NexCMP نفسه. - [الترخيص والشراء](https://nexcmp.com/ar/docs/getting-started/license-and-purchase.md): آلية ترخيص NexCMP — الحصول على المفتاح وربطه بنطاق، ونطاقات الموزعين، واستحقاق التحديثات، وما يحدث عند انتهاء صلاحية الترخيص. - [تثبيت NexCMP](https://nexcmp.com/ar/docs/getting-started/installation.md): ثبّت NexCMP على Ubuntu بأمر تثبيت من سطر واحد — المعلمات، وما يفعله المثبت، وTLS وnginx، وكيفية الوصول إلى معالج الإعداد. - [DNS وCloudflare](https://nexcmp.com/ar/docs/getting-started/dns-and-cloudflare.md): وجّه نطاقك نحو خادم NexCMP، اختيارياً عبر Cloudflare، واحصل على شهادة صالحة بنمط SSL المناسب. - [معالج الإعداد](https://nexcmp.com/ar/docs/getting-started/setup-wizard.md): تعرّف على خطوات معالج التشغيل الأول عبر /setup — رمز الإعداد، والترخيص، وCloudStack أو Connect later، والمسؤول والعلامة التجارية. - [تسجيل الدخول الأول والخطوات التالية](https://nexcmp.com/ar/docs/getting-started/first-login.md): سجّل الدخول إلى لوحة تحكم المسؤول لأول مرة وأكمل قائمة التحقق الموصى بها للإعداد. - [تحديث NexCMP](https://nexcmp.com/ar/docs/getting-started/updating.md): تحديث NexCMP من لوحة الإدارة أو سطر الأوامر، وكيفية التحقق من الإصدارات، وما يحق لك الحصول عليه. - [ملاحظات الإصدار](https://nexcmp.com/ar/docs/getting-started/release-notes.md): التغييرات من NexCMP 1.3 إلى 1.6.1 وما يجب التحقق منه عند الترقية: إدارة الذكاء الاصطناعي، وقياس استهلاك VPN، وخدمات العملاء، وBare Metal. - [النسخ الاحتياطي والاستعادة](https://nexcmp.com/ar/docs/getting-started/backup-and-restore.md): أنشئ نسخة احتياطية متسقة لبيانات وإعدادات NexCMP باستخدام nexcmp backup، واستعدها على الخادم نفسه أو خادم جديد. - [إلغاء تثبيت NexCMP](https://nexcmp.com/ar/docs/getting-started/uninstall.md): إزالة خدمات وبرنامج NexCMP، مع حذف البيانات أو الإبقاء عليها، وما يتبقى على بنيتك التحتية. - [مرجع أمر nexcmp](https://nexcmp.com/ar/docs/getting-started/cli-reference.md): جميع الأوامر الفرعية لأداة سطر أوامر خادم nexcmp — وهي status وupdate وbackup وuninstall وopen-port وclose-port وfix-owner. ## البنية التحتية - [متطلبات البنية التحتية](https://nexcmp.com/ar/docs/infrastructure/requirements.md): جدول واحد: يوضح لكل وحدة في NexCMP الحد الأدنى من البنية التحتية المطلوبة والصفحة التي تشرح كيفية إعدادها وربطها. - [البنية المعمارية](https://nexcmp.com/ar/docs/infrastructure/architecture.md): بنية NexCMP: النطاق وnginx واللوحة وخدمات worker وجميع الأنظمة المتصلة بها، مع المنافذ والبيانات لكل مسار. - [الوحدات](https://nexcmp.com/ar/docs/infrastructure/modules.md): جميع وحدات NexCMP بحالتها الافتراضية، وما تضيفه، وبنيتها التحتية المطلوبة، ومكان تفعيلها؛ بما في ذلك الوحدات الإضافية المقروءة عند بدء التشغيل. - [المناطق](https://nexcmp.com/ar/docs/infrastructure/zones.md): كيف تعمل مناطق NexCMP: الموقع الذي يختاره العملاء عند الطلب، وكيفية ربط المنطقة بـ CloudStack وProxmox VE وVPN وS3، ومتى تكون جاهزة للبيع. - [CloudStack](https://nexcmp.com/ar/docs/infrastructure/cloudstack.md): اربط Apache CloudStack بـ NexCMP: أنشئ domain وحساباً ومفتاح API مخصصين عبر cmk، ثم أدخلها في معالج الإعداد أو لوحة تحكم الإدارة. - [Proxmox VE](https://nexcmp.com/ar/docs/infrastructure/proxmox.md): إضافة مجموعات Proxmox VE كمصدر VM: رمز API token بأقل الصلاحيات، والتخزين، وقوالب cloud-image، ومجمعات IP، وتثبيت TLS ومصدر مخصص لكل خطة. - [قوالب أنظمة التشغيل وملفات ISO](https://nexcmp.com/ar/docs/infrastructure/templates.md): جهّز صور أنظمة التشغيل التي ينشر منها العملاء: أنشئ قوالب CloudStack وسجّلها، واصنع قوالب cloud-image لـ Proxmox VE. - [الخوادم المخصصة (bare metal)](https://nexcmp.com/ar/docs/infrastructure/dedicated.md): قم ببيع خوادم Dell المدارة عبر iDRAC وRedfish: المتطلبات، استيراد الخوادم، مفاتيح الأمان، والقوالب. - [عقد VPN ووكيل IPv6](https://nexcmp.com/ar/docs/infrastructure/vpn-proxy-nodes.md): إعداد أجهزة Linux كعقد VPN (cmp-agent) ووكيل IPv6: نظام التشغيل، عناوين IP، بادئات IPv6، المنافذ، sysctl، والتثبيت ونبض الاتصال. - [AI Models](https://nexcmp.com/ar/docs/infrastructure/ai-models.md): بِع الوصول لنماذج الذكاء الاصطناعي عبر بوابتك: أضف مزوديك المتوافقين مع OpenAI أو Anthropic، زامن النماذج، حدد الأسعار، ودع العملاء يطلبون نقطة موحدة بمحفظتهم. - [Object Storage (S3, Ceph RGW)](https://nexcmp.com/ar/docs/infrastructure/s3.md): قم ببيع مساحة تخزين S3 بالدفع حسب الاستخدام على كتلة Ceph لديك: متطلبات RGW، وحساب المشرف والصلاحيات، وربط الواجهة الخلفية بمنطقة في NexCMP. - [Kubernetes وPrivate Cloud](https://nexcmp.com/ar/docs/infrastructure/kubernetes-and-private-cloud.md): بع مجموعات Kubernetes عبر CKS وPrivate Cloud بنطاق ترددي مخصص عبر VPC على CloudStack: العروض المطلوبة ومكان ربطها. ## الكتالوج والأسعار - [الخطط والأسعار](https://nexcmp.com/ar/docs/catalog/plans.md): إنشاء وتسعير خطط VM: الأحجام، والأسعار بالساعة وشهرياً، ودورات الفوترة، والخطط المخصصة، والاستنساخ، وأثر تغيير السعر على أجهزة VM قيد التشغيل. - [حصص Bandwidth والإضافات](https://nexcmp.com/ar/docs/catalog/bandwidth.md): كيف يقيس NexCMP الترافيك لكل خدمة من إحصاءات CloudStack، والحصص الافتراضية، وتنبيهات 80% و100%، وإجراءات التجاوز والإضافات. - [العملة وأسعار الصرف](https://nexcmp.com/ar/docs/catalog/currency-and-exchange-rates.md): كيف تحتفظ NexCMP بالأموال بالدولار الأمريكي، وتعرّض العملات الأخرى حسب اللغة، وكيف ينشر المسؤول سعر صرف USD/VND وأسعار العرض. ## الفوترة والمدفوعات - [قنوات الدفع](https://nexcmp.com/ar/docs/billing/payment-channels.md): كيف يقوم العملاء بشحن محافظهم في NexCMP — القنوات المتاحة، وكيفية تمكين كل منها، والرسوم والحدود وكيفية مراقبتها. - [Stripe](https://nexcmp.com/ar/docs/billing/stripe.md): اربط Stripe بـ NexCMP لمدفوعات البطاقات، وApple Pay، وGoogle Pay، وLink، وAlipay — مفاتيح API، وwebhook، وتسجيل النطاق، والدفع التجريبي. - [PayPal](https://nexcmp.com/ar/docs/billing/paypal.md): ربط PayPal بـ NexCMP لشحن المحفظة — بيانات اعتماد تطبيق REST، وWebhook، واختبار البيئة التجريبية (Sandbox)، وحسابات PayPal المحفوظة. - [USDT (Binance)](https://nexcmp.com/ar/docs/billing/usdt.md): قبول شحن المحافظ بعملة USDT من خلال مراقبة عنوان إيداع Binance — مفتاح API للقراءة فقط، اختيار الشبكة، التحقق من العنوان والإيداعات غير المطابقة. - [التحويل البنكي (فيتنام)](https://nexcmp.com/ar/docs/billing/bank-transfer-vn.md): قبول التحويلات البنكية الفيتنامية (VND) باستخدام Sepay — حساب الاستلام، بادئة المذكرة، خطاف الويب، الحدود، وكيفية تعيين التحويلات غير المطابقة. - [الحد الأدنى للشحن](https://nexcmp.com/ar/docs/billing/minimum-top-up.md): قم بتعيين الحدين الأدنى والأقصى لشحن المحفظة لكل عملية دفع، وتعرف على حدود الرصيد الأخرى التي تحدد ما إذا كان بإمكان العميل الطلب. - [طرق الدفع المحفوظة](https://nexcmp.com/ar/docs/billing/saved-payment-methods.md): تعرف على كيفية قيام العملاء بحفظ بطاقة أو محفظة Stripe أو حساب PayPal للشحن التلقائي، وكيفية إزالتها، وما تخزنه NexCMP. - [التعبئة التلقائية](https://nexcmp.com/ar/docs/billing/auto-top-up.md): الحفاظ على تمويل محافظ العملاء تلقائياً من بطاقة محفوظة أو حساب PayPal — أوضاع تعتمد على الاستخدام وثابتة، حدود عامة ومعالجة الفشل. - [الفواتير دفتر الأستاذ](https://nexcmp.com/ar/docs/billing/invoices-and-ledger.md): مكان تسجيل الأموال في NexCMP - دفتر أستاذ المحفظة، الفواتير، مدفوعات الشحن، الاستردادات وعمليات الدفع، قسائم الشراء وتقارير الإيرادات. - [العروض الترويجية](https://nexcmp.com/ar/docs/billing/promotions.md): إصدار رموز تعبئة الرصيد: مكافآت المحفظة، رصيد الخدمات فقط، وخصومات نسبية مع حد أقصى وطلب أدنى — أنشئها وتتبّعها ووزّعها بسهولة. - [الحصص](https://nexcmp.com/ar/docs/billing/quotas.md): الحد مما يمكن للعميل الجديد إنشاؤه حتى يقوم بتمويل محفظته — مستويات موارد VM، وعدد VMs وحصص الاستخدام لكل خدمة، مع إمكانية التجاوز لكل عميل. ## العملاء والموزعون - [إدارة العملاء](https://nexcmp.com/ar/docs/customers/managing-customers.md): البحث عن العملاء ودعمهم: قائمة العملاء، الدولة حسب IP، مصدر الإحالة، إجراءات الحساب، طلبات الحذف وعمليات نقل الخدمات. - [تسجيل الدخول كعميل](https://nexcmp.com/ar/docs/customers/login-as.md): افتح بوابة العملاء كعميل محدد لمدة ساعة واحدة لإعادة إنتاج مشكلة ما — الشروط، والضوابط، وما يتم حظره وتسجيله. - [الموزعون (ذو العلامة البيضاء)](https://nexcmp.com/ar/docs/customers/resellers.md): دع الشركاء يبيعون سحابتك تحت علامتهم التجارية ونطاقهم الخاص — أنشئ موزعاً، وحدد النطاقات ونظام الأسعار (DNS)، وأسعار الجملة، والافتراضيات، وفتحات التراخيص. - [Branding](https://nexcmp.com/ar/docs/customers/branding.md): ضع اسمك وشعارك وألوانك وعملتك على بوابة العملاء، وحدة تحكم المشرف والبريد الإلكتروني — قواعد الرفع وأماكن ظهور كل إعداد. - [الصفحات القانونية](https://nexcmp.com/ar/docs/customers/legal.md): اكتب شروط الخدمة وسياسة الخصوصية المعروضة على /terms و /privacy — نص محايد افتراضي، نسختان باللغتين الإنجليزية والفيتنامية، وقواعد تخفيض آمنة. ## بوابة العملاء - [نظرة عامة على بوابة العملاء](https://nexcmp.com/ar/docs/portal/overview.md): جولة في بوابة العملاء: لوحة التحكم، القائمة، المحفظة، الأجهزة الافتراضية، إعدادات الحساب، اللغة والعملة. - [التسجيل، المحفظة والشحن](https://nexcmp.com/ar/docs/portal/sign-up-and-wallet.md): كيف يسجل العملاء، ويتحققون من بريدهم الإلكتروني، ويضيفون رصيداً إلى المحفظة، ويدخلون الرموز، ويقرؤون سجل الفوترة الخاص بهم. - [طلب خدمة](https://nexcmp.com/ar/docs/portal/ordering.md): خطوات صفحة الطلب خطوة بخطوة: الخدمة، الموقع، الخطة، دورة الفوترة، نظام التشغيل، اسم المضيف والكمية، ثم الدفع من المحفظة. - [الأجهزة الافتراضية](https://nexcmp.com/ar/docs/portal/virtual-machines.md): إدارة جهاز افتراضي من البوابة: نظرة عامة، إجراءات الطاقة، إعادة تعيين كلمة المرور، إعادة التثبيت، المراقبة، الشبكة، التكوين والنشاط. - [وحدة التحكم](https://nexcmp.com/ar/docs/portal/console.md): افتح وحدة تحكم الجهاز الافتراضي في المتصفح (VNC)، واختيارياً طرفية SSH للويب؛ وما يحتاجه كل منها من البنية التحتية الخاصة بك. - [Snapshots و Backups](https://nexcmp.com/ar/docs/portal/snapshots.md): التقاط واستعادة وحذف لقطات الأجهزة الافتراضية من البوابة، جدولتها، وما تدعمه كل بيئة تشغيل. - [دعم العملاء](https://nexcmp.com/ar/docs/portal/support.md): كيف يحصل العملاء على المساعدة: فقاعة الدردشة مع ردود الذكاء الاصطناعي، اختصارات Telegram و Zalo، والتذاكر. ## الذكاء الاصطناعي - [مزود الذكاء الاصطناعي](https://nexcmp.com/ar/docs/ai/ai-providers.md): ربط نقطة نهاية AI متوافقة مع OpenAI لـ AI Chat وAI Agent — شغّل وحدة AI، وأدخل نقطة النهاية والمفتاح، واختبرها، وحدد القيود. - [AI Chat](https://nexcmp.com/ar/docs/ai/ai-chat.md): دردشة دعم تلقائية للعملاء المسجلين: ما يمكنها فعله، وتحويل المحادثة إلى فريقك عبر تيليجرام، زالو وأزرار اختصار تيليجرام، والحدود التي تتحكم بها. - [AI Agent](https://nexcmp.com/ar/docs/ai/ai-agent.md): دع العملاء يديرون أجهزة Linux VM الخاصة بهم عن طريق وصف مهمة بلغة بسيطة — كيف يتصل Agent عبر SSH، وما يمكنه تشغيله بمفرده، وما يجب توفيره لديك. ## المطورون - [REST API](https://nexcmp.com/ar/docs/developers/api.md): استدعاء واجهة برمجة التطبيقات (API) الخاصة بالعملاء لتثبيت NexCMP: المصادقة، المرجع التفاعلي، تنزيلات OpenAPI و Postman، الأخطاء، حدود الاستخدام، الثبات وأمثلة curl. - [مفاتيح API والنطاقات](https://nexcmp.com/ar/docs/developers/api-keys.md): كيف يُنشئ العملاء مفاتيح API (بادئة vk_)، ويختارون النطاقات، ويقيدونها حسب عنوان IP وتاريخ انتهاء الصلاحية، وكيف يراجعها المشرفون ويلغونها. - [أداة سطر الأوامر cmp](https://nexcmp.com/ar/docs/developers/cmp-cli.md): تثبيت cmp CLI واستخدامها من لوحتك: تسجيل الدخول عبر المتصفح برمز لمرة واحدة، وأوامر منشأة من API، ومخرجات ورموز خروج، واستخدام CI، وتحديثات موقعة. - [خادم MCP](https://nexcmp.com/ar/docs/developers/mcp.md): قم بربط مساعدي الذكاء الاصطناعي (Claude و Cursor و VS Code وغيرها) بـ API تثبيتك عبر نقطة نهاية الـ MCP المضمنة على العنوان /mcp — المصادقة، وإعدادات العميل، والأدوات وقواعد الأمان. ## التهيئة باستخدام الذكاء الاصطناعي - [التهيئة باستخدام الذكاء الاصطناعي](https://nexcmp.com/ar/docs/configure-with-ai/overview.md): دع مساعد AI يهيئ NexCMP ويشغله: AI Chat في لوحة الإدارة، أو عميل AI عبر MCP، أو ملف YAML. تعرّف على إمكاناته وقواعد الأمان الخاصة به. - [AI Chat في لوحة التحكم](https://nexcmp.com/ar/docs/configure-with-ai/ai-chat-in-admin.md): قم بتكوين NexCMP عبر الدردشة في لوحة المشرف: اختر مصدر ذكاء اصطناعي، وراجع بطاقات التأكيد لكل تغيير، ومرر البيانات السرية بأمان، واحتفظ بحد أقصى يومي للإنفاق. - [حسابات واشتراكات الذكاء الاصطناعي](https://nexcmp.com/ar/docs/configure-with-ai/ai-accounts-and-subscriptions.md): ربط مصدر AI لـ AI Chat (مفاتيح API، تسجيل OpenRouter أو Google، مزود اللوحة) واستخدام اشتراكك في Claude أو ChatGPT أو Gemini عبر CLIs الرسمية. - [مفاتيح Admin API](https://nexcmp.com/ar/docs/configure-with-ai/admin-api-keys.md): أنشئ وألغِ مفاتيح إدارة ak_ لوكلاء AI والبرامج النصية: النطاقات الثمانية، الصلاحية، نطاقات IP، حد المعدل، ما لا تستطيع المفاتيح فعله أبداً، وكل رمز خطأ. - [توصيل عميل ذكاء اصطناعي (MCP)](https://nexcmp.com/ar/docs/configure-with-ai/mcp-admin.md): اربط Claude Code وCodex CLI وGemini CLI وCursor وClaude Desktop وclaude.ai وChatGPT أو OpenAI SDKs بنقطة نهاية MCP لإدارة لوحتك مع كامل قائمة الأدوات. - [موصلات claude.ai و ChatGPT](https://nexcmp.com/ar/docs/configure-with-ai/oauth-connectors.md): اربط تطبيقات الذكاء الاصطناعي الوبوية مثل claude.ai و ChatGPT بلوحتك عبر OAuth 2.1: سجّل الدخول كمسؤول، واختر النطاق والمدة، وألغِ الاتصال متى شئت. - [التكوين كشفرة برمجية](https://nexcmp.com/ar/docs/configure-with-ai/config-as-code.md): قم بتصدير تكوين لوحة التحكم إلى ملف YAML، واستعرض التغييرات وطبقها باستخدام أمر nexcmp config أو صفحة الاستيراد/التصدير؛ تبقى الأسرار خارج الملف ويتحقق منها مخطط JSON. - [أمثلة على التوجيهات](https://nexcmp.com/ar/docs/configure-with-ai/example-prompts.md): مطالبات جاهزة للنسخ لـ AI Chat أو عميل AI الخاص بك: الإعداد الأول، إضافة Proxmox، جدول خطط بهامش، SMTP، Stripe، Telegram، رصيد العميل وتصدير إعداداتك. - [قائمة التحقق من تقدم الإعداد](https://nexcmp.com/ar/docs/configure-with-ai/setup-checklist.md): توضح بطاقة تقدم الإعداد في نظرة عامة للمدير الخطوات العشر لمتجر يعمل، وتتيح لمساعد الذكاء الاصطناعي تنفيذ الخطوة التالية لك باستخدام ميزة Do it for me. ## الإدارة - [إعدادات SMTP وقوالب البريد الإلكتروني](https://nexcmp.com/ar/docs/administration/smtp-and-emails.md): تكوين البريد الإلكتروني الصادر (SMTP)، وإرسال رسالة اختبار، وتعديل قوالب البريد الإلكتروني بكل لغة، وقراءة سجل التسليم. - [تنبيهات تيليجرام والمسؤول](https://nexcmp.com/ar/docs/administration/telegram-notifications.md): إرسال تنبيهات التشغيل وأحداث تسجيل العملاء والإيداع إلى مجموعة تيليجرام أو خطاف ويب أو بريد إلكتروني، وإعداد اختصارات الدعم المعروضة للعملاء. - [سجل التدقيق والنشاط](https://nexcmp.com/ar/docs/administration/audit-log.md): تعرّف على من قام بماذا: الخط الزمني الموحد للنشاط، إجراءات المشرفين، تسجيلات دخول العملاء، أحداث VM والرسائل المرسلة، وكيفية البحث برمز الحدث. - [الأمان](https://nexcmp.com/ar/docs/administration/security.md): حماية وحدة تحكم المسؤول بالمصادقة الثنائية وقوائم السماح لعناوين IP، وإدارة أدوار المسؤولين، وتكوين تسجيل دخول العملاء: مفاتيح المرور، Google وGitHub، اختبار CAPTCHA ونطاقات البريد الإلكتروني المحظورة. - [الإعدادات العامة](https://nexcmp.com/ar/docs/administration/general-settings.md): اسم العلامة التجارية وعناوين URL، تفاصيل البائع المطبوعة على الفواتير، بادئة رقم الفوعة، اللغة الافتراضية، وضع صيانة العملاء. - [الإبلاغ عن خطأ](https://nexcmp.com/ar/docs/administration/report-a-bug.md): أرسل تقرير خطأ من لوحة الإدارة مباشرة إلى فريق NexCMP كتذكرة: النموذج، البيانات المرسلة، ما لا يُرسل مطلقاً، والحدود وحلول الأخطاء الشائعة. ## استكشاف الأخطاء وإصلاحها والأسئلة الشائعة - [أخطاء التثبيت](https://nexcmp.com/ar/docs/troubleshooting/installation-errors.md): كل رسالة خطأ قد يطبعها مثبت NexCMP، وسببها وكيفية إصلاحها — المتطلبات، تفعيل الترخيص، التحقق من التنزيل، الخدمات و nginx/TLS. - [أخطاء التحديث](https://nexcmp.com/ar/docs/troubleshooting/update-errors.md): لماذا قد ي فشل تحديث NexCMP — الاستحقاق، التحقق من التنزيل، التوقيع، إعادة التشغيل — وكيفية الاسترداد أو التراجع. - [الأسئلة الشائعة](https://nexcmp.com/ar/docs/troubleshooting/faq.md): الأسئلة المتكررة حول التثبيت، الترخيص، ربط البنية التحتية وتشغيل NexCMP. - [الدعم](https://nexcmp.com/ar/docs/troubleshooting/support.md): كيفية الحصول على المساعدة بشأن NexCMP: ما الذي يجب جمعه، وما الذي يجب تضمينه في رسالتك وأين تُرسلها. ## Optional - [Full documentation in one file](https://nexcmp.com/ar/docs/llms-full.txt) - [Sitemap](https://nexcmp.com/ar/docs/sitemap.xml) - [Product site](https://nexcmp.com)