كيفية استضافة n8n ذاتيًا وتشغيل عقدة CometAPI محليًا

يتحرك الذكاء الاصطناعي بسرعة: النماذج متعددة الوسائط الجديدة وواجهات برمجة التطبيقات الفورية المُحسّنة تجعل من الأسهل تضمين ذكاء اصطناعي قوي في منصات الأتمتة، بينما تعيد النقاشات المتوازية حول الأمان والقابلية للملاحظة تشكيل كيفية تشغيل الفرق لأنظمة الإنتاج. بالنسبة لمن يبنون أتمتات محلية، يظهر نمط عملي: استخدم بوابة نماذج موحّدة (مثل CometAPI) للوصول إلى العديد من النماذج، واربط تلك الاستدعاءات ضمن مشغّل أتمتة مُستضاف ذاتيًا (مثل n8n) لتحافظ على التحكم في البيانات وزمن الاستجابة والتكاليف. يوضّح هذا الدليل، خطوة بخطوة، كيفية البدء بـ CometAPI + n8n (محلي)، وما الذي ينبغي الانتباه إليه، وكيفية استكشاف الأخطاء وإصلاحها عندما تسير الأمور بشكل غير متوقع.

ما هو n8n ولماذا يهم أتمتة الذكاء الاصطناعي؟

n8n هو أداة مفتوحة المصدر لأتمتة سير العمل مع محرّر بصري ونظام واسع من العُقَد (الموصلات). صُمِّم للسماح لك بسلسلة المشغّلات والتحويلات واستدعاءات واجهات برمجة التطبيقات الخارجية في سير عمل قابل للتكرار (webhooks، المهام المجدولة، معالجة الملفات، روبوتات الدردشة، إلخ). إن استضافة n8n محليًا يمنحك تحكمًا كاملًا في موضع البيانات والتنفيذ، وهو أمر ذو قيمة خاصة عند استدعاء نماذج ذكاء اصطناعي من جهات خارجية تتعامل مع مدخلات حساسة.

كيف يعمل n8n عمليًا؟

لوحة مرئية مع مشغّلات (Webhook، Cron) وعُقَد الإجراءات (HTTP Request، عُقَد قواعد البيانات، البريد الإلكتروني).
عُقَد المجتمع توسّع القدرات — يمكنك تثبيت حِزم المجتمع والتعامل معها كعُقَد أصلية.

الاستضافة الذاتية لـ n8n تمنحك:

تحكم كامل في البيانات — تظل سير الأعمال وبيانات التنفيذ على البنية التحتية التي تديرها.
التخصيص — أضف عُقَد خاصة أو تكاملات محلية دون انتظار ميزات سحابية.
إمكانية توقع التكلفة — لا مفاجآت فوترة لكل مهمة في السحابة للأتمتة الداخلية الثقيلة.
الأمان والامتثال — أسهل في تلبية السياسات الداخلية والمتطلبات التنظيمية.

ما هو CometAPI ولماذا تستخدمه كبوابة نماذج؟

CometAPI هي بوابة واجهة برمجة تطبيقات موحّدة تعرض مئات نماذج الذكاء الاصطناعي من جهات خارجية (نص، تضمينات، توليد الصور، إلخ) خلف واجهة واحدة متوافقة مع OpenAI ونموذج فوترة واحد. هذا يعني أنه بدلًا من إضافة تكاملات مخصّصة لكل نموذج لغوي كبير أو محرّك صور تريد تجربته، تستدعي واجهة برمجة تطبيقات واحدة وتختار النموذج الذي تريد ضمن الطلب. هذا يبسط التجريب، والتحكم في التكلفة، والتكامل التشغيلي.

الفوائد:

اختيار النماذج: جرّب العديد من المورّدين/النماذج عبر نفس مسار الشفرة.
تجميع الرموز/حصص مجانية: العديد من البوابات الموحّدة توفّر أرصدة/شرائح للتجربة.
بنية أبسط: نظام مصادقة واحد وعنوان أساسي واحد لإدارته.

كيف أحصل على وصول ومفاتيح CometAPI؟

سجّل في موقع CometAPI (أو لوحة تحكم المورّد). معظم البوابات لديها شريحة مجانية للاختبار.
احصل على مفتاح واجهة برمجة التطبيقات من لوحة تحكم CometAPI — سلسلة سرية طويلة. لاحظ أين تُخبرك الوثائق بوضعه (CometAPI تستخدم تفويض Bearer مقابل https://api.cometapi.com/v1).
اقرأ وثائق الواجهة للنقطة النهائية التي تخطّط لاستخدامها (محادثات، صور، تضمينات). توثّق CometAPI نقاطًا نهائية مثل /v1/chat/completions و/v1/images/generations.

كيفية استضافة n8n ذاتيًا وتشغيل عقدة CometAPI محليًا

لماذا يُعد الربط (التكامل) بين n8n وCometAPI مهمًا؟

“الربط” هنا يعني مسار تكامل موثوق وآمن بين مشغّل الأتمتة لديك (n8n) وبوابة النماذج. الربط الصحيح مهم لأنه:

يحافظ على السياق عبر الاستدعاءات (سجل المحادثة، التضمينات).
يركّز المعتمدات والأسرار في مكان واحد لسهولة التدوير.
يقلّل زمن الاستجابة وسطح الخطأ باستخدام نقاط نهائية متوقعة وصيغ طلب قياسية.
يتيح القابلية للملاحظة واستكشاف الأخطاء — معرفة أي نموذج، وموجّه، واستجابة أدت إلى النتيجة.

باختصار: الربط الجيّد يقلّل المخاطر التشغيلية ويسرّع وتيرة التكرار.

كيف أنشر n8n محليًا (دليل عملي سريع)؟

يمكنك تشغيل n8n محليًا إما باستخدام npm أو Docker؛ يُنصح باستخدام Docker Compose لمعظم حالات الاستضافة الذاتية (فهو قابل لإعادة الإنتاج ويعزل التبعيات). أدناه مثال Docker Compose أدنى وحدود أساسية.

كيف أستضيف n8n ذاتيًا باستخدام Docker؟

Docker (وDocker Compose) هي الطريقة الأكثر صلابة وقابلية لإعادة الإنتاج لتشغيل n8n في الإنتاج. يعزل التطبيق، ويجعل الترقيات أبسط، ويتوافق جيدًا مع وكلاء عكسية والمنسّقات (Docker Swarm، Kubernetes). تتضمّن وثائق n8n الرسمية مرجع Docker Compose الذي سأتّبعه وأكيّفه هنا.

للإنتاج ستشغّل عادةً حزمة تتكون من:

خدمة n8n (الصورة الرسمية: docker.n8n.io/n8nio/n8n أو n8nio/n8n حسب الوسم).
PostgreSQL (أو قاعدة بيانات مدعومة أخرى).
Redis (إذا كنت تخطط لاستخدام وضع قائمة الانتظار).
وكيل عكسي (Traefik، Caddy، أو nginx) لأجل TLS وتوجيه المضيف وقواعد الحد من المعدّل.

تفصل هذه البنية المعمارية الاهتمامات بوضوح (ثبات قاعدة البيانات، الاصطفاف، وكيل الويب) وتُسهّل التوسيع والنسخ الاحتياطي. توفّر وثائق n8n الرسمية أنماط Docker Compose ومراجع متغيرات البيئة.

هذا هو الدليل خطوة بخطوة:

أنشئ مجلدًا وملف docker-compose.yml مع خدمة n8n القياسية. أدناه مثال docker-compose عملي يغطي احتياجات الإنتاج النموذجية: Postgres خارجي، Redis (لوضع قائمة الانتظار/التنفيذ)، مجلدات ثابتة، ووكيل Nginx عكسي يتعامل مع TLS:

```yaml
version: "3.8"
services:
  n8n:
    image: n8nio/n8n:latest
    restart: unless-stopped
    environment:
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=n8n
      - DB_POSTGRESDB_USER=n8n
      - DB_POSTGRESDB_PASSWORD=supersecretpassword
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=anothersecret
      - WEBHOOK_TUNNEL_URL=https://n8n.example.com
      - EXECUTIONS_MODE=queue
      - QUEUE_BULL_REDIS_HOST=redis
    ports:
      - "5678:5678"
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on:
      - postgres
      - redis

  postgres:
    image: postgres:15
    environment:
      POSTGRES_DB: n8n
      POSTGRES_USER: n8n
      POSTGRES_PASSWORD: supersecretpassword
    volumes:
      - pgdata:/var/lib/postgresql/data

  redis:
    image: redis:7
    volumes:
      - redisdata:/data

volumes:
  n8n_data:
  pgdata:
  redisdata:
```

البدء:

docker compose up -d

زر http://localhost:5678 وأنشئ مستخدم الإدارة الخاص بك. للإنتاج ستحتاج إلى Postgres وSSL ومتغيرات بيئة مناسبة — راجع وثائق Docker Compose الرسمية.

ملاحظات وتعزيز الأمان:

لا تُخزّن الأسرار بنص واضح في docker-compose.yml؛ استخدم ملفات البيئة أو أسرار Docker أو مديري أسرار خارجيين في الإنتاج.
استبدل WEBHOOK_URL بعنوان URL العام الحقيقي لديك وامنح الوكيل العكسي توجيه n8n.example.com إلى الحاوية الخاصة بـ n8n.
استخدم EXECUTIONS_MODE=queue لمعالجة خلفية قوية؛ يتطلب عمال قائمة الانتظار وRedis.

كيف أستضيف n8n ذاتيًا باستخدام npm / Node.js؟

التثبيت عبر npm (أو pnpm) يشغّل n8n مباشرة على المضيف. هذا أخف (لا طبقة حاوية) وقد يكون مفيدًا لتثبيتات مستخدم واحد منخفضة التعقيد أو أجهزة المطوّرين. ومع ذلك، يضع المزيد من المسؤولية على المدير لإدارة التبعيات والعزل والإشراف على الخدمة. تتضمن وثائق n8n الرسمية دليل تثبيت npm والتنبيهات.

الحِزم المطلوبة للنظام وإصدار Node:

استخدم إصدار Node.js LTS ثابتًا (Node 18 أو Node 20+، بما يتوافق مع متطلبات إصدارات n8n).
ثبّت build-essential وgit ومدير عمليات (يوصى بـ systemd).
للإنتاج، استخدم PostgreSQL وRedis كخدمات خارجية (نفس منطق Docker).

كيف أثبّت وأشغّل n8n عبر npm (خطوة بخطوة)؟

تثبيت Node.js (مُوصى به: nvm)

# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# Reload your shell (adjust to your shell startup file if needed)
source ~/.bashrc  # or ~/.zshrc

# Install and use the latest LTS (usually 18 or 20)
nvm install --lts
nvm use --lts

# Verify
node -v
npm -v

إذا رأيت لاحقًا “n8n: command not found”، أعد تشغيل الطرفية أو تأكّد من أن مسار مجلّد bin العالمي الخاص بـ npm المُدار عبر nvm موجود ضمن PATH لديك.

تثبيت وتشغيل n8n (محلي)

npm install -g n8n
n8n -v  # verify version

التشغيل في المقدّمة:

n8n start

عنوان URL الافتراضي: http://localhost:5678/ إذا كان المنفذ مستخدمًا:

export N8N_PORT=5679
n8n start

اختياري: إبقاؤه يعمل في الخلفية (ما يزال محليًا):

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

4 .أول وصول وتسجيل الدخول:

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

كيف أثبّت أو أُهيّئ عقدة مجتمع CometAPI في n8n؟

يدعم n8n عُقَد المجتمع المُتحقّق منها (تثبيت عبر الواجهة الرسومية) والتثبيت اليدوي من npm عند الاستضافة الذاتية. هناك طريقتان لتكامل CometAPI مع n8n:

الخيار أ — استخدام عقدة مجتمع CometAPI (إذا كانت متاحة في لوحة العُقَد)

في n8n افتح لوحة العُقَد (اضغط + أو Tab).
CometAPI هي عقدة مجتمع مُتحقّق منها، ستظهر ضمن “المزيد من المجتمع”. انقر وثبّت.
بعد التثبيت، أعد تشغيل n8n إذا طُلب منك ذلك. أنشئ بيانات اعتماد جديدة في الإعدادات → بيانات الاعتماد (اختر نوع بيانات اعتماد CometAPI إذا وفّرت العقدة ذلك) وألصق رمز CometAPI.

الخيار ب — التثبيت اليدوي (عندما لا يتوفر التثبيت عبر الواجهة)

1.SSH إلى مضيف/حاوية n8n لديك.

ثبّت الحزمة في node_modules العالمي لـ n8n أو مجلّدك المخصّص :

اذهب إلى الإعدادات (أسفل اليسار) > Community nodesانقر “
تثبيت عقدة مجتمع”
في “npm Package Name”، أدخل: @cometapi-dev/n8n-nodes-cometapiضع علامة على مربع الإقرار بالمخاطرانقر “
تثبيت”بعد التثبيت، يمكنك البحث عن “CometAPI” في لوحة العُقَد.

أعد تشغيل n8n. إذا كانت مثيلتك تعمل في وضع قائمة الانتظار، يجب اتباع مسار التثبيت اليدوي الموضّح في الوثائق.

كيفية التحقق من تثبيت العقدة

بعد إعادة التشغيل، افتح لوحة العُقَد وابحث عن “CometAPI” أو “Comet”. ستُعلَّم العقدة كحزمة مجتمع.
إن لم تتمكّن من رؤية العقدة: تحقّق من أنك تستخدم حساب مالك المثيل (فقط مالكو المثيل يمكنهم التثبيت)، أو أن حزمة العقدة تثبّتت دون أخطاء في سجلات الحاوية/الصورة.

كيفية إنشاء سير عمل وتهيئة الواجهة

1. إنشاء سير عمل جديد

سجّل الدخول إلى مثيل n8n الخاص بك (مُستضاف ذاتيًا).
انقر "Add Workflow" لبدء لوحة أتمتة جديدة.

2.إضافة عقدة

أضف عقدة مشغّل: ابحث عن “Manual Trigger” أو “When clicking ‘Execute workflow’”.
انقر “+” على يمين اللوحة وابحث عن “CometAPI” لإضافة العقدة.
يمكنك أيضًا البحث عن “CometAPI” من قائمة العُقَد على اليسار وسحبها إلى اللوحة.

3.تهيئة بيانات الاعتماد (مرة أولى فقط):

في عقدة CometAPI، تحت “Credential to connect with”، اختر “Create new”.
ألصق الرمز الذي أنشأته في وحدة تحكم CometAPI ضمن “CometAPI Key”.
احفظ. عنوان الأساس يُضبط افتراضيًا إلى https://api.cometapi.com وعادةً لا يحتاج إلى تغيير.

4. تهيئة النموذج والرسائل:

النموذج: أدخل نموذجًا مدعومًا، مثلًا gpt-4o أو gpt-4o-mini.

الرسائل: تحتاج إلى ملء الدور والسياق، ويمكنك اختيار user أو system للدور.

المعلمات الاختيارية (حسب الحاجة): Maximum Number of Tokens (مثلًا، 4096)؛ Sampling Temperature (مثلًا، 0.7)؛ PenaltyStream (تفعيل/تعطيل البث). للحصول على توثيق وشرح محدّدين للمعلمات، يُرجى الرجوع إلى وثائق CometAPI.

5.تنفيذ النص:

حدّد عقدة CometAPI وانقر “Execute step”، أو انقر “Execute workflow” في الأسفل.
يجب أن تعرض لوحة OUTPUT على اليمين استجابة JSON (تتضمن choices وusage، إلخ).

لقد ثبّت الآن n8n (موصى به) محليًا على Linux عبر npm، وثبّتت وتهيّأت عقدة مجتمع CometAPI، ويمكنك تشغيل سير أعمال تستدعي نماذج مثل gpt-4o لتلقي الردود.

ما هي المشاكل الشائعة وكيف أستكشف الأخطاء وأصلحها؟

1) “401 Unauthorized” أو “Invalid API key”

أكّد سلسلة الرمز الدقيقة في لوحة تحكم CometAPI (قد تكون هناك رموز متشابهة في الاسم). انسخ → ألصق ضمن بيانات اعتماد n8n وأعد تشغيل العقدة إن لزم.
تأكّد من تنسيق ترويسة Authorization ليكون Bearer sk-xxxxx.

2) عقدة المجتمع لا تُثبّت / “queue mode”

إذا كان n8n يعمل في وضع قائمة الانتظار، قد يكون التثبيت عبر الواجهة الرسومية معطّلًا؛ اتّبع وثائق التثبيت اليدوي لتثبيت عُقَد المجتمع عبر npm أو ابنِ صورة مخصّصة تتضمّن العقدة. أعد تشغيل n8n بعد التثبيت.

3) لم يتم العثور على العقدة في اللوحة بعد التثبيت

أعد تشغيل n8n.
تأكّد من أنك ثبّتت الحزمة في السياق الصحيح (داخل صورة الحاوية أو في مسار .n8n/custom إن استخدمت هذا النمط).
افحص سجلات الحاوية لأخطاء حلّ الوحدات.

4) حدود المعدّل أو مشكلات الحصة

تحقّق من لوحة تحكم CometAPI للاستخدام والحصة.
نفّذ تراجعًا أُسِّيًا واحتياطيًا إلى نماذج أرخص عند اكتشاف تحذيرات حدود أو HTTP 429.

هل توجد بدائل إذا لم تكن عقدة المجتمع متاحة أو أردت مرونة أكبر؟

نعم — يمكنك دائمًا استخدام عقدة HTTP Request مباشرةً (تحكم كامل) أو عقدة OpenAI مع إعادة توجيه العنوان الأساسي (اختصار عملي). يسهّل استخدام HTTP الخام أيضًا اعتماد نقاط CometAPI النهائية الجديدة عند إطلاقها (مثل نقاط الصور/الفيديو). يُرجى الرجوع إلى الدليل.

اطلع أيضًا كيفية استخدام n8n مع CometAPI

الخلاصة:

CometAPI تمنحك اختيار النماذج وبساطة التشغيل؛ وn8n يمنحك تنظيمًا بصريًا وقابلية التوسعة. استخدم حيلة بيانات اعتماد OpenAI لدمج سريع للمحادثة/الإكمال، وعُقَد المجتمع حيثما وُجدت وتثق بها. قم بأدوات قياس لكل سير عمل من أجل التكلفة وزمن الاستجابة والأمان؛ وفضّل الرجوع البشري للقرارات المهمة؛ واجعل اختيارك للنماذج ديناميكيًا لتتكيّف مع التغيّرات السريعة في سوق مورّدي الذكاء الاصطناعي. إن الجمع بين n8n وCometAPI قوي، لكنه مثل جميع الأدوات القوية، يحتاج إلى مصدّات حماية — راقب، اختبر، وكرّر.