WebGee Docsمركز المساعدة
التطوير

نشر تطبيق Node.js من مركز Websites

انشر تطبيق Node.js على نطاقك من مستودع Git أو ملف ZIP أو وكيل ذكي، واضبط إصدار Node ومجلد مخرجات البناء ومتغيّرات البيئة.

انشر تطبيق Node.js على أحد نطاقاتك من مركز Websites في cPanel — باستنساخ مستودع Git أو رفع ملف ZIP أو تكليف وكيل ذكي. ويتولّى cPanel تثبيت الاعتماديات وبناء التطبيق وتقديمه.

تنطبق على حسابات cPanel التي تستخدم قالب Meridian حيث Node.js مفعَّل في الباقة. أما مسار Node.js Selector في Jupiter فراجع إعداد تطبيق Node.js.

يحمل حساب cPanel الواحد أربعة تطبيقات منشورة كحدّ أقصى. فاحذف واحدًا قبل نشر الخامس.

اختر النطاق

  1. في مركز Websites، اختر Add Website.
  2. اختر نطاقًا موجودًا أو أضف نطاقًا جديدًا. والنطاق المضاف هنا لا يمكن تغيير اسمه بعد النشر، فأصِبْه من الآن.
  3. اختر AI App Hosting.
  4. اختر Continue ثم Launch My Website.

على نطاق موجود تبقى الملفات التي عليه في مكانها، لكن التطبيق هو ما يراه الزوّار. فوجّه النشر إلى نطاق أو نطاق فرعي لا يقدّم موقعًا تحتاجه.

اختر مصدر الكود

مستودع Git — الأفضل حين تحدّث التطبيق بانتظام.

  1. اختر Git repository وأدخل رابط الاستنساخ:
    • مستودع عام: رابط HTTPS، https://example.com/user/my-app.git
    • مستودع خاص: رابط SSH، git@github.com:user/my-app.git
  2. ولرابط SSH أرفق مفتاح SSH — اختر مفتاحًا موجودًا أو ولّد جديدًا تحت Security — ثم أضفه إلى مستضيف Git لديك مفتاحَ نشر، باتّباع تعليمات ذلك المستضيف.
  3. أدخل عبارة مرور المفتاح إن كانت له واحدة. وستحتاجها ثانية مع كل إعادة نشر.
  4. اختر Continue ثم Deploy.

ملف ZIP — الأفضل لتطبيق لا تنوي تغييره.

  1. اختر Upload a ZIP file.
  2. اسحب ملف .zip إلى منطقة الرفع، أو اختر Browse Files.
  3. اختر Continue.

WebPros MCP — يُسلّم النشر إلى وكيل ذكي.

  1. اختر Deploy via WebPros MCP.
  2. اربط حساب WebPros إن لم تكن قد فعلت، ونزّل mcp.json — راجع ربط cPanel بـ Claude Code عبر MCP.
  3. اطلب من الوكيل نشر التطبيق وإعادة رابط HTTPS المباشر.

اضبط التطبيق

  1. تفقّد Website Name، وهو ما يصير رابط التطبيق، وعدّله إن لزم.

  2. افتح Advanced Settings إن لم تناسبك الإعدادات الافتراضية:

    الإعدادفائدته
    إصدار Node.jsالإصدار الذي يحتاجه تطبيقك
    مدير الحزميُكتشف من مستودعك — تأكّد أنه الذي تستخدمه
    مجلد مخرجات البناءحيث يكتب بناؤك مخرجاته. أدخله يدويًا إن لم يكتشفه cPanel
    متغيّرات البيئةقيم يقرؤها تطبيقك أثناء التشغيل
  3. اختر Deploy.

إن فشل النشر

نجح البناء لكنه لم يُنتج مجلد مخرجات. أشيع الأعطال. ويذكر cPanel في رسالة الفشل اسم المجلد الذي توقّعه — فإما أن سكربت البناء لا ينتجه، أو أن إعداد Build output directory يشير إلى مسار خاطئ. شغّل البناء محليًا وانظر أي مجلد يكتبه فعلًا، ثم اضبطه عليه.

تعذّر استنساخ المستودع. للمستودع الخاص، تأكّد أنك استخدمت رابط SSH لا HTTPS، وأن المفتاح مضاف مفتاحَ نشر لدى مستضيف Git.

نُشر التطبيق لكنه لا يستجيب. تفقّد متغيّرات البيئة — فالتطبيق الذي يقرأ رابط قاعدة بيانات أو مفتاح API أثناء التشغيل يبدأ ثم يفشل بدونها.

أدِرْه بعد النشر

تعيش التطبيقات المنشورة في مركز Websites، حيث تعيد نشرها وتغيّر إعداداتها وتحذفها لتفسح مجالًا ضمن حدّ الأربعة تطبيقات.

اقرأ أيضًا

في هذه الصفحة