الانتقال إلى المحتوى الرئيسي
انشر 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 نشط — احصل على مفتاحك من هنا
1

احصل على مفتاح CometAPI API الخاص بك

سجّل الدخول إلى وحدة تحكم CometAPI. انقر على Add API Key ثم انسخ مفتاح <COMETAPI_KEY> الخاص بك.
لوحة تحكم CometAPI تعرض زر Add API Key
تفاصيل مفتاح CometAPI API مع 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 للتأكد من أن تثبيت عقد المجتمع مفعّل.
6

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

  1. انقر على + New في الأعلى لإنشاء سير عمل.
  2. انقر على + في لوحة العمل وابحث عن CometAPI لإضافة العقدة.
لوحة سير العمل في n8n مع فتح بحث عقدة CometAPI
تمت إضافة عقدة CometAPI إلى لوحة n8n
  1. أضف عقدة Manual Trigger ثم صِلها بعقدة CometAPI.
  2. في عقدة CometAPI، ضمن Credential to connect with، اختر Create new. الصق مفتاح <COMETAPI_KEY> الخاص بك في CometAPI Key ثم انقر على Save. تكون قيمة Base URL افتراضيًا https://api.cometapi.com ولا تحتاج عادةً إلى تغيير.
مربع حوار بيانات اعتماد CometAPI مع إدخال مفتاح API
  1. اضبط إعدادات العقدة:
  • Model: أدخل model ID الحالي الذي تريد استخدامه
  • Messages: اضبط Role على user، وContent على Prompt الاختبار الخاص بك (مثلًا Hello)
  • اختياري: أضف رسالة system، واضبط Max Tokens وTemperature وغير ذلك.
  1. انقر على Execute step لتشغيل العقدة. تعرض لوحة Output استجابة JSON.
لوحة Output في n8n تعرض استجابة CometAPI 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 على شبكات الشركات — اضبط proxy: npm config set proxy http://user:pass@host:port
  • تعيد عقدة CometAPI الخطأ 401/403 — تحقق من مفتاح API الخاص بك ومن أن النموذج متاح ضمن خطة CometAPI الخاصة بك.
  • استجابات فارغة أو أخطاء حد Token — زد قيمة Max Tokens؛ واضبط Temperature وTop P حسب الحاجة.
  • يتوقف n8n عند إغلاق الطرفية — استخدم pm2: pm2 start "n8n" --name n8n && pm2 save.