الانتقال إلى المحتوى الرئيسي
انشر 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 الخاص بك.
لوحة تحكم CometAPI تعرض زر Add API Key
تفاصيل CometAPI API key مع Base URL
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
طرفية تعرض بدء تشغيل n8n بنجاح
سجلات بدء تشغيل n8n في الطرفية
4

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

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

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

  1. انتقل إلى Settings (أسفل اليسار) → Community nodes
  2. انقر على Install a community node
  3. أدخل اسم الحزمة: @cometapi-dev/n8n-nodes-cometapi
  4. فعّل مربع الإقرار بالمخاطر ثم انقر على Install
بعد التثبيت، يمكنك البحث عن CometAPI في لوحة العقد.
لوحة Settings في n8n تعرض قسم Community nodes
مربع حوار التثبيت مع إدخال اسم حزمة CometAPI
إذا كان قسم Community Nodes غير موجود: تأكد من أنك مسجّل الدخول باستخدام حساب Owner، وتحقق من Settings → Security للتأكد من أن تثبيت community node مفعّل.
6

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

  1. انقر على + New في الأعلى لإنشاء workflow.
  2. انقر على + في مساحة العمل وابحث عن CometAPI لإضافة العقدة.
مساحة workflow في n8n مع فتح بحث عقدة CometAPI
تمت إضافة عقدة CometAPI إلى مساحة n8n
  1. أضف عقدة Manual Trigger ووصلها بعقدة CometAPI.
  2. في عقدة CometAPI، ضمن Credential to connect with، اختر Create new. الصق المفتاح sk-xxxxx في CometAPI Key ثم انقر على Save. تكون قيمة Base URL الافتراضية هي https://api.cometapi.com وعادة لا تحتاج إلى تغييرها.
مربع حوار بيانات اعتماد CometAPI مع إدخال API key
  1. اضبط العقدة:
  • Model: أدخل معرّف model الحالي الذي تريد استخدامه
  • Messages: اضبط Role على user، وContent على Prompt الاختبار الخاص بك (مثل Hello)
  • اختياري: أضف رسالة system، واضبط Max Tokens وTemperature وغير ذلك.
  1. انقر على Execute step لتشغيل العقدة. ستعرض لوحة Output استجابة JSON.
لوحة Output في n8n تعرض استجابة JSON ناجحة من CometAPI
  • أخطاء 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.