تشغيل n8n محليًا مع CometAPI

انشر 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 نشط — احصل على مفتاحك من هنا

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

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

تفاصيل مفتاح API في CometAPI مع base URL

ثبّت 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 لديك.

ثبّت 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

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

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

معالج الإعداد الأول في n8n يطلب تفاصيل حساب Owner

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

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

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

لوحة Settings في n8n تعرض قسم Community nodes

نافذة التثبيت مع إدخال اسم حزمة CometAPI

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

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

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

مساحة سير العمل في n8n مع فتح البحث عن عقدة CometAPI

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

نافذة بيانات اعتماد CometAPI مع إدخال مفتاح API

اضبط العقدة:

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

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

لوحة الإخراج في 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 على شبكات الشركات — اضبط proxy: npm config set proxy http://user:pass@host:port
تعيد عقدة CometAPI رمز 401/403 — تحقّق من مفتاح API الخاص بك ومن أن model متاح ضمن خطة CometAPI الخاصة بك.
استجابات فارغة أو أخطاء حد token — زِد Max Tokens؛ واضبط Temperature وTop P حسب الحاجة.
يتوقف n8n عند إغلاق الطرفية — استخدم pm2: pm2 start "n8n" --name n8n && pm2 save.

نظرة عامة

وكلاء البرمجة بالذكاء الاصطناعي

وكلاء الذكاء الاصطناعي

عملاء دردشة الذكاء الاصطناعي

الترجمة واللغة

منصات الأتمتة

المراقبة والتقييم

أطر عمل الذكاء الاصطناعي

تشغيل n8n محليًا مع CometAPI

المتطلبات الأساسية

​المتطلبات الأساسية

المتطلبات الأساسية