نشر n8n محليًا

انشر n8n محليًا على Linux/macOS، وثبّت عقدة مجتمع CometAPI، واضبط بيانات اعتماد API لتشغيل تدفقات عمل مؤتمتة على جهازك.

انشر n8n على جهازك الخاص واربطه بـ CometAPI عبر عقدة المجتمع لتشغيل تدفقات عمل AI مؤتمتة محليًا.

​

المتطلبات المسبقة

• Linux ‏(Ubuntu/Debian/CentOS، إلخ) أو macOS
• ذاكرة RAM بسعة 2 GB أو أكثر، ومساحة قرص فارغة 10 GB أو أكثر
• وصول إلى Shell مع إمكانية الوصول إلى سجل npm العام
• Node.js 18.x أو 20.x LTS (راجع الخطوة 1)
• حساب CometAPI مع API key نشط — احصل عليه من هنا

1. احصل على CometAPI API key الخاص بك

   سجّل الدخول إلى CometAPI console. انقر على Add API Key وانسخ المفتاح sk-xxxxx الخاص بك.

   

   
2. ثبّت Node.js عبر nvm

   يتطلب n8n 1.x استخدام Node.js 18.x أو 20.x. والطريقة الموصى بها هي nvm:

   # Install nvm
   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
   
   # Reload your shell profile
   source ~/.bashrc   # or ~/.zshrc on macOS
   
   # Install and activate the LTS version
   nvm install --lts
   nvm use --lts
   
   # Verify
   node -v
   npm -v
   

   إذا ظهرت لك لاحقًا الرسالة n8n: command not found، فأعد تشغيل الطرفية أو تأكد من أن دليل npm global bin الذي يديره nvm موجود ضمن PATH لديك.

3. ثبّت n8n وابدأ تشغيله

   npm install -g n8n
   n8n -v       # verify the installed version
   n8n start    # runs on http://localhost:5678/
   

   إذا كان المنفذ 5678 مستخدمًا بالفعل:

   export N8N_PORT=5679
   n8n start
   

   للإبقاء على n8n قيد التشغيل بعد إغلاق الطرفية:

   npm install -g pm2
   pm2 start "n8n" --name n8n
   pm2 save
   pm2 status
   

   

   
4. أنشئ حساب المالك الخاص بك

   افتح http://localhost:5678/ في المتصفح. عند أول تشغيل، سيطلب منك معالج الإعداد إنشاء حساب Owner (بريد إلكتروني + كلمة مرور). أكمل ذلك ثم سجّل الدخول.

   
5. ثبّت عقدة مجتمع CometAPI

   1. انتقل إلى Settings (أسفل اليسار) → Community nodes
   2. انقر على Install a community node
   3. أدخل اسم الحزمة: @cometapi-dev/n8n-nodes-cometapi
   4. فعّل مربع الإقرار بالمخاطر ثم انقر على Install

   بعد التثبيت، يمكنك البحث عن CometAPI في لوحة العقد.

   

   

   إذا كان قسم Community Nodes غير موجود: تأكد من أنك مسجّل الدخول باستخدام حساب Owner، وتحقق من Settings → Security للتأكد من أن تثبيت community node مفعّل.

6. أنشئ workflow واضبط بيانات الاعتماد

   1. انقر على + New في الأعلى لإنشاء workflow.
   2. انقر على + في مساحة العمل وابحث عن CometAPI لإضافة العقدة.

   

   

   3. أضف عقدة Manual Trigger ووصلها بعقدة CometAPI.
   4. في عقدة CometAPI، ضمن Credential to connect with، اختر Create new. الصق المفتاح sk-xxxxx في CometAPI Key ثم انقر على Save. تكون قيمة Base URL الافتراضية هي https://api.cometapi.com وعادة لا تحتاج إلى تغييرها.

   

   5. اضبط العقدة:

   • Model: أدخل معرّف model الحالي الذي تريد استخدامه
   • Messages: اضبط Role على user، وContent على Prompt الاختبار الخاص بك (مثل Hello)
   • اختياري: أضف رسالة system، واضبط Max Tokens وTemperature وغير ذلك.

   6. انقر على Execute step لتشغيل العقدة. ستعرض لوحة Output استجابة JSON.

   

استكشاف الأخطاء وإصلاحها

• أخطاء node-gyp أو أخطاء البناء الأصلية — ثبّت أدوات البناء: sudo apt install build-essential python3 ‏(Debian/Ubuntu) أو Xcode Command Line Tools ‏(macOS).
• أخطاء أذونات npm ‏(EACCES) — استخدم nvm لتثبيت Node.js على مستوى المستخدم؛ ولا حاجة إلى sudo.
• تعارض المنفذ (localhost:5678 غير متاح) — اضبط N8N_PORT=5679 (أو أي منفذ حر آخر) قبل تشغيل n8n start.
• قسم Community Nodes غير موجود — سجّل الدخول باستخدام حساب Owner وتحقق من Settings → Security.
• فشل npm install على شبكات الشركات — اضبط وكيلاً: npm config set proxy http://user:pass@host:port
• تعيد عقدة CometAPI خطأ 401/403 — تحقق من API key الخاص بك ومن أن model متاح ضمن خطة CometAPI لديك.
• استجابات فارغة أو أخطاء حد token — زد قيمة Max Tokens؛ واضبط Temperature وTop P حسب الحاجة.
• يتوقف n8n عند إغلاق الطرفية — استخدم pm2: pm2 start "n8n" --name n8n && pm2 save.