الأتمتة باستخدام n8n

Custom Nodes في N8N: شرح كامل بالأمثلة

محمد عبد الوهابنُشر · 6 دقايق قراءة
شرح Custom Nodes في n8n وبناء Node مخصصة بالأسلوب الوصفي

مقدمة

الـ Custom Nodes في n8n هي Nodes بتبنيها بنفسك لما الـ Node اللي محتاجها مش موجودة، وبتظهر في قائمة n8n زي أي Node رسمية. وغالباً مش هتحتاج تبنيها أصلاً، لأن في Community Nodes جاهزة ممكن تثبّتها بكليكات.

يعني إيه Custom Node؟ هي Node خاصة بيك، مكتوبة بـ TypeScript، بتغلّف API معيّن بواجهة اختيارات واضحة بدل ما تكرر إعدادات HTTP Request في كل Workflow.

بعد المقال ده هتعرف تفرّق بين أنواع الـ Nodes، وتقرر إمتى تبني ومتى تكتفي بحل أبسط، وتبني Node بسيطة بالأسلوب الوصفي وتجربها عندك.

باختصار:

  • n8n فيها أكتر من 400 تكامل مدمج، ولو الخدمة اللي عايزها ناقصة تقدر توسّع بـ Community Nodes أو Custom Nodes (حسب docs.n8n.io، 2026).
  • الأول دوّر على Community Node جاهزة، وبعدها فكّر تبني بنفسك.
  • لو الـ API عادي (REST)، استخدم Declarative Style: إعدادات JSON من غير كود تنفيذ معقد.
  • الأداة الرسمية للبداية هي npm create @n8n/node.

إيه الفرق بين Built-in وCommunity وCustom Nodes؟

الفرق في مين كتب الـ Node وإزاي بتوصل لـ n8n بتاعتك.

  • Built-in Nodes: جاية مع n8n نفسها، زي Gmail وGoogle Sheets وHTTP Request.
  • Community Nodes: حزم على npm كتبها مطورين تانيين، وانت بتثبّتها.
  • Private Custom Nodes: بتكتبها انت لنفسك أو لشركتك، ومش بتنشرها لحد.

حزم الـ Community لازم اسمها يبدأ بـ n8n-nodes- أو @scope/n8n-nodes-، وفي package.json لازم الكلمة المفتاحية n8n-community-node-package (حسب docs.n8n.io، 2026). يعني الـ Custom Node اللي بتنشرها على npm بتبقى Community Node للناس التانية.

إمتى تبني Custom Node وإمتى تكتفي بـ HTTP Request؟

ابني Custom Node لما نفس إعدادات الـ API بتتكرر في Workflows كتير أو بين ناس كتير. غير كده، الحلول الأبسط كفاية.

الموقف الحل الأنسب
محتاج API مرة واحدة في Workflow واحد HTTP Request
عندك سلسلة Nodes بتتكرر ومش مرتبطة بـ API واحد Sub-workflow
الخدمة مشهورة دوّر على Community Node جاهزة
API داخلي أو خدمة محلية، والفريق كله هيستخدمه Custom Node بالأسلوب الوصفي
Trigger مخصص، أو GraphQL، أو تحويل بيانات معقد Custom Node بالأسلوب البرمجي

لو لسه بتبني أساساتك في n8n، ابدأ بـ خطة تعلم n8n من الصفر قبل ما تفكر في بناء Nodes.

ازاي تثبّت Community Node جاهزة من الواجهة؟

الـ Verified Community Nodes يقدر الـ Owner أو الـ Admin يثبّتها مباشرة من لوحة الـ Nodes في الواجهة، على n8n Cloud وعلى Self-Hosted (حسب docs.n8n.io، 2026).

  1. افتح قائمة إضافة Node وابحث عن اسم الخدمة.
  2. لو ظهرت Node من نوع Community، اختارها واضغط تثبيت.
  3. بعد التثبيت هتلاقيها في القائمة زي أي Node تانية.

التفاصيل بتختلف حسب نسختك وإعدادات السيرفر، فراجع صفحة التثبيت الرسمية. وخد بالك: الـ Nodes غير الـ Verified بتشتغل بصلاحيات كاملة على سيرفرك، فاقرا عنها قبل ما تثبّتها.

شرح Custom Nodes في n8n وبناء Node مخصصة بالأسلوب الوصفي

Declarative ولا Programmatic: أنهي أسلوب أختار؟

اختار Declarative لو الـ API عادي (REST)، وProgrammatic لو العملية معقدة.

  • Declarative Style: بتوصف الـ Node بـ JSON: الرابط، والـ Method، والحقول. n8n هي اللي بتبعت الطلب. مناسب لمعظم الـ REST APIs.
  • Programmatic Style: بتكتب كود الـ execute بنفسك. مناسب للـ Triggers والـ GraphQL وتحويل البيانات المعقد.

التفاصيل في دوكس الـ Declarative Style.

ازاي تبني Custom Node بسيطة خطوة بخطوة؟

هنبني Node لخدمة أسعار عملات افتراضية، بحيث تختار العملتين من قايمة بدل ما تكتب الرابط والـ Headers كل مرة.

المتطلبات

  • Node.js وnpm متسطبين.
  • معرفة بسيطة بـ JavaScript أو TypeScript. مش لازم تبقى محترف في الأسلوب الوصفي، لأنك هتعدّل على قالب جاهز.
  • n8n شغالة Self-Hosted عندك للتجربة.

الخطوات

  1. ولّد المشروع: شغّل npm create @n8n/node. لو سألك عن الأسلوب اختار Declarative. تقدر كمان تبدأ من قالب n8n-nodes-starter.
  2. افتح ملف الـ Credentials: هتلاقيه باسم .credentials.ts. فيه اسم الـ Credentials، وحقل لمفتاح الـ API، وجزء authenticate بيحدد إزاي المفتاح بيتحط في الـ Header.
  3. افتح ملف الـ Node: باسم .node.ts. جوّه كائن description ثبّت الحاجات دي:
    • displayName وname: الاسم اللي هيظهر في القايمة.
    • credentials: ربط الـ Node بملف الـ Credentials.
    • requestDefaults: الـ baseURL والـ Headers المشتركة.
    • properties: الحقول والعمليات، وكل عملية فيها routing بيحدد الـ Method والمسار.
  4. ضيف عملية Get Rate: حقلين: from وto. كل حقل ليه routing يبعته كـ Query parameter.
  5. اتأكد من package.json: قسم n8n لازم يشاور على الملفات المبنية للـ Node والـ Credentials.

التشغيل والتجربة

  1. في المشروع المتولّد هتلاقي سكريبتات في package.json للتشغيل التجريبي والبناء. جرّب الأمر الخاص بالتشغيل المحلي (غالباً اسمه dev).
  2. أو ابني المشروع وانسخ الناتج لفولدر ~/.n8n/custom (اعمله لو مش موجود)، وأعد تشغيل n8n.
  3. على Docker: اربط الفولدر ده كـ Volume جوّه الحاوية، وأعد تشغيلها.
  4. ابحث عن الـ Node باسمها في n8n، وأنشئ Credentials، وشغّلها وراجع الـ Output.

لو الـ Node مظهرتش، راجع مسارات الملفات في package.json وأعد تشغيل n8n. ولو لسه، شوف أشهر مشاكل n8n وحلولها.

إيه أشهر غلطة في بناء Custom Nodes؟

الغلطة إنك تبني Node من الصفر بـ Programmatic Style المعقد عشان تربط REST API عادي.

الصح تمشي بالترتيب:

  1. دوّر في الـ Verified Community Nodes جوّه n8n.
  2. لو ملقيتش، جرّب HTTP Request لو الاستخدام محدود.
  3. لو الاستخدام بيتكرر، ابني Node بالأسلوب الوصفي.
  4. الأسلوب البرمجي يبقى آخر حل.

الأسئلة الشائعة

إيه الفرق بين Community Node وCustom Node في n8n؟
الـ Community Node حزمة منشورة على npm وأي حد يقدر يثبّتها. الـ Custom Node بتكتبها انت، وممكن تفضل خاصة بيك أو بشركتك. ولو نشرتها على npm بالشروط الصحيحة، تبقى Community Node للناس التانية.
هل ينفع أثبت Community Nodes على n8n Cloud ولا لازم Self-Hosted؟
الـ Verified Community Nodes تتثبّت على Cloud وSelf-Hosted من الواجهة، بصلاحية Owner أو Admin. أما الـ Custom Nodes الخاصة اللي بتحطها في فولدر على السيرفر، فبتحتاج Self-Hosted لأن Cloud مش بتديك وصول للسيرفر.
هل لازم أكون مبرمج TypeScript محترف عشان أبني Custom Node؟
لأ. الأسلوب الوصفي مبني أغلبه على إعدادات JSON داخل قالب جاهز، فمعرفة بسيطة بـ JavaScript أو TypeScript بتكفي لبداية. هتحتاج خبرة أكبر بس لو اخترت الأسلوب البرمجي.
إمتى أعمل Custom Node وإمتى أكتفي بـ HTTP Request Node؟
اكتفي بـ HTTP Request لو الاستخدام مرة واحدة أو في Workflow واحد. ابني Custom Node لما نفس إعدادات الـ API تتكرر في Workflows كتير، أو لما فريق كامل محتاج واجهة اختيارات واضحة من غير ما كل واحد يعيد الإعدادات.
إزاي أشارك الـ Custom Node بتاعتي مع فريقي أو أنشرها على npm؟
سمّي الحزمة بـ n8n-nodes- وحط n8n-community-node-package في package.json وانشرها على npm. للفريق الداخلي، ممكن تستخدم registry خاص أو تبني الحزمة وتحطها في فولدر custom على كل سيرفر. التفاصيل في دوكس n8n.

ملخص المقالة

الـ Custom Nodes في n8n حل ممتاز لما نفس الـ API بيتكرر في شغلك، بس مش أول حل. دوّر على Community Node، وبعدها HTTP Request، وبعدها ابني Node بالأسلوب الوصفي. الأسلوب البرمجي سيبه للحالات المعقدة بس.

كمّل اتعلّم بناء Workflows وAutomations عملية خطوة بخطوة من كورسات الأتمتة بالـ AI على AI Mentor.

كورس على Udemyعايز تبني Workflows زي دي بإيدك؟كورس «أساسيات الأتمتة بالذكاء الاصطناعي باستخدام n8n» بياخدك من الصفر لمشروع كامل.تفاصيل الكورس
كتبهمحمد عبد الوهاب

مؤسس AI Mentor. بيعلّم الـ AI والأتمتة بالعربي وبالعملي.

صفحة المدرّب على Udemy