
مقدمة
الـ 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).
- افتح قائمة إضافة Node وابحث عن اسم الخدمة.
- لو ظهرت Node من نوع Community، اختارها واضغط تثبيت.
- بعد التثبيت هتلاقيها في القائمة زي أي Node تانية.
التفاصيل بتختلف حسب نسختك وإعدادات السيرفر، فراجع صفحة التثبيت الرسمية. وخد بالك: الـ Nodes غير الـ Verified بتشتغل بصلاحيات كاملة على سيرفرك، فاقرا عنها قبل ما تثبّتها.

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 عندك للتجربة.
الخطوات
- ولّد المشروع: شغّل
npm create @n8n/node. لو سألك عن الأسلوب اختار Declarative. تقدر كمان تبدأ من قالبn8n-nodes-starter. - افتح ملف الـ Credentials: هتلاقيه باسم
.credentials.ts. فيه اسم الـ Credentials، وحقل لمفتاح الـ API، وجزءauthenticateبيحدد إزاي المفتاح بيتحط في الـ Header. - افتح ملف الـ Node: باسم
.node.ts. جوّه كائنdescriptionثبّت الحاجات دي:displayNameوname: الاسم اللي هيظهر في القايمة.credentials: ربط الـ Node بملف الـ Credentials.requestDefaults: الـbaseURLوالـ Headers المشتركة.properties: الحقول والعمليات، وكل عملية فيهاroutingبيحدد الـ Method والمسار.
- ضيف عملية Get Rate: حقلين:
fromوto. كل حقل ليهroutingيبعته كـ Query parameter. - اتأكد من
package.json: قسمn8nلازم يشاور على الملفات المبنية للـ Node والـ Credentials.
التشغيل والتجربة
- في المشروع المتولّد هتلاقي سكريبتات في
package.jsonللتشغيل التجريبي والبناء. جرّب الأمر الخاص بالتشغيل المحلي (غالباً اسمهdev). - أو ابني المشروع وانسخ الناتج لفولدر
~/.n8n/custom(اعمله لو مش موجود)، وأعد تشغيل n8n. - على Docker: اربط الفولدر ده كـ Volume جوّه الحاوية، وأعد تشغيلها.
- ابحث عن الـ Node باسمها في n8n، وأنشئ Credentials، وشغّلها وراجع الـ Output.
لو الـ Node مظهرتش، راجع مسارات الملفات في package.json وأعد تشغيل n8n. ولو لسه، شوف أشهر مشاكل n8n وحلولها.
إيه أشهر غلطة في بناء Custom Nodes؟
الغلطة إنك تبني Node من الصفر بـ Programmatic Style المعقد عشان تربط REST API عادي.
الصح تمشي بالترتيب:
- دوّر في الـ Verified Community Nodes جوّه n8n.
- لو ملقيتش، جرّب HTTP Request لو الاستخدام محدود.
- لو الاستخدام بيتكرر، ابني Node بالأسلوب الوصفي.
- الأسلوب البرمجي يبقى آخر حل.
الأسئلة الشائعة
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.



