# نشر تطبيق Node.js من مركز Websites
Source: https://docs.webgee.com/ar/development/deploy-a-nodejs-app-in-meridian



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

تنطبق على حسابات cPanel التي تستخدم قالب
[Meridian](/ar/hosting/the-meridian-theme) حيث Node.js مفعَّل في الباقة. أما
مسار Node.js Selector في Jupiter فراجع
[إعداد تطبيق Node.js](/ar/development/how-to-setup-a-nodejs-application-on-cpanel).

<Callout type="info">
  يحمل حساب cPanel الواحد **أربعة** تطبيقات منشورة كحدّ أقصى. فاحذف واحدًا قبل
  نشر الخامس.
</Callout>

## اختر النطاق [#اختر-النطاق]

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

<Callout type="warn">
  على نطاق موجود تبقى الملفات التي عليه في مكانها، لكن التطبيق هو ما يراه
  الزوّار. فوجّه النشر إلى نطاق أو نطاق فرعي لا يقدّم موقعًا تحتاجه.
</Callout>

## اختر مصدر الكود [#اختر-مصدر-الكود]

**مستودع 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](/ar/hosting/connect-cpanel-to-mcp).
3. اطلب من الوكيل نشر التطبيق وإعادة رابط HTTPS المباشر.

## اضبط التطبيق [#اضبط-التطبيق]

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

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

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

3. اختر **Deploy**.

## إن فشل النشر [#إن-فشل-النشر]

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

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

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

## أدِرْه بعد النشر [#أدِرْه-بعد-النشر]

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

## اقرأ أيضًا [#اقرأ-أيضًا]

* [إعداد تطبيق Node.js](/ar/development/how-to-setup-a-nodejs-application-on-cpanel)
* [ربط cPanel بـ Claude Code عبر MCP](/ar/hosting/connect-cpanel-to-mcp)
* [قالب Meridian](/ar/hosting/the-meridian-theme)