n8n بالتفصيل: من أول سير عمل إلى أتمتة إنتاجية — الدليل العربي الكامل

أداة n8n (تُنطق «n-eight-n») أداة أتمتة تُحوّل عملاً تتكرّره كل يوم إلى سير عمل يعمل وحده. ملفها الرسمي يعرّفها بجملة واحدة: «Fair-code platform to build and deploy AI agents and workflows. Combine a visual canvas with custom code, run it self-hosted or in the cloud, and connect to 1500+ integrations.» — أي لوحة ترسم عليها، وكود تكتبه حيث تحتاجه فقط، وخادمك أنت إن أردت أن يعمل الأمر هناك.

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

ولمن هذه السلسلة؟ كتبناها أولاً لمن يدير عمليات في شركة صغيرة ولا يكتب كوداً: أول صفحاتها لا تفترض منه شيئاً سوى تجربة. ثم تنحدر تدريجياً — منطق المسارات، فالتعبيرات، فالاستضافة الذاتية، حتى مشروع إنتاجي كامل. ومن يعرف بايثون سيجد نفسه مرتاحاً في نهاية السلسلة لا في بدايتها.

وشيء أخير قبل أن نبدأ، لأنه سيوفّر عليك وقتاً: الاسم ليس كلمة عربية. نكتبه ونقوله ونبحث عنه باللاتينية تماماً كما هو: n8n. إن كتبت «إن إتش إن» أو «إن-إيت-إن» في محرك البحث فلن تجد شيئاً، فهاتان صيغتان للقراءة الصوتية فقط لا اسم. والأسماء داخل الأداة — AI Agent وn8n Assistant — تُترك لاتينية أيضاً، لأن ترجمتها تختلط بمعنى عربي عام لا يحدّد أيّهما تقصد.

ما هذه السلسلة، ولماذا هي مرتّبة بهذا الترتيب؟

خريطة الطريق في الجدول أدناه هي أهم ما في هذه الصفحة: أي مقال تقرأ، وبأي ترتيب، وماذا تبني بعده. والترتيب ليس اعتباطياً؛ كل مقال يفترض ما سبقه ولا يكرّره، فالقارئ الذي يبدأ من الأول لن يحتاج إلى صفحة أخرى ليفسّر له مصطلحاً.

#	slug	العنوان	السؤال الذي يجيب عنه	ماذا تبني بعده
1 ★	what-is-n8n-and-when-you-need-it	ما هو n8n بالضبط؟ ومتى يكون هو الأداة الصحيحة — ومتى لا يكون	«ما هذا الشيء تقنياً، ولمن يصلح، ولمن لا يصلح؟»	قرار: هل n8n هو اختيارك أصلاً، وماذا يعني ترخيص fair-code عملياً
2 ★	n8n-first-workflow-no-code	أول سير عمل لك: من رسالة واردة إلى إشعار في Slack — بدون كتابة سطر برمجي واحد	«كيف أبني أول سير عمل يعمل فعلاً، وأفهم ماذا يحدث في كل عقدة؟»	سير عمل يعمل من طرف إلى طرف، ومعرفة الفرق بين العنصر والحقل
3 ★★ ⭐	n8n-three-agents-explained	الوكلاء الثلاثة في n8n: عقدة AI Agent، والوكلاء كمنتج مستقل، وn8n Assistant — أيّهم تستخدم ومتى	«يوجد ثلاثة أشياء مختلفة اسمها agent — ما الفرق الدقيق بينها، وأيهما يحل مشكلتي؟»	معرفة أي نوع وكيل تبني، ومتى لا تبنيه أصلاً
4 ★★★	n8n-expressions-and-data	التعبيرات في n8n: $json و$now ولماذا $node غير موجود — دليل $	«كيف أستخرج قيمة من عقدة سابقة، وما هي كل المتغيّرات المتاحة فعلاً؟»	كتابة $ بثقة، وتشخيص أخطاء التعبير بنفسك
5 ★★★	n8n-flow-logic-errors-and-retries	منطق المسار ومعالجة الأخطاء: If وSwitch وRetry On Fail وسير عمل الأخطاء	«كيف أجعل سير العمل ينجو من فشل واحد بدل أن ينهار بالكامل؟»	سير عمل لا ينهار عند فشل خدمة خارجية
6 ★★★★	n8n-self-hosting-and-security	الاستضافة الذاتية بأمان: مفتاح التشفير، وضع الطابور، والتخزين	«كيف أشغّل n8n على خادمي دون أن أتسريب أسرار ولا أن أُغرق قاعدة البيانات؟»	نسخة مستضافة ذاتياً، مؤمّنة، ومقيسة
7 ★★★	n8n-licensing-and-editions-honestly	الترخيص والإصدارات بلا تجميل: Sustainable Use License، وCommunity مقابل Business، وn8n 3.0	«هل أستطيع استخدام n8n تجارياً؟ وما الذي سأفقده مجاناً، وما الذي سيُحذف عند الترقية؟»	قرار بين n8n Cloud والاستضافة الذاتية، وإصداراً، بمعرفة ما سيُحذف
8 ★★★★★	n8n-production-project-end-to-end	من الصفر إلى الإنتاج: نظام فواتير آلي كامل + نشره كخادم MCP	«كيف أبني أتمتة حقيقية تعمل في الإنتاج، ثم أعرضها على Claude وأدوات أخرى عبر MCP؟»	أتمتة إنتاجية منشورة، محميّة، مقيسة التكلفة، ومكشوفة كخادم MCP

★ صفر كود · ★★ فهم معماري بلا كتابة · ★★★ تعبيرات ومتغيّرات · ★★★★ استضافة ذاتية وأمان · ★★★★★ JSON وأوامر. وعلامة ⭐ تعني أن هذا مقال عمود السلسلة: كل ما بعده يردّ إليه بدل إعادة شرح الوكلاء.

مساران للقراءة. إن كان هدفك أتمتة تخدم عملك هذا الشهر، اقرأ 1 ثم 2 ثم 3 ثم 5. إن كنت تشغّل نسخة على خادمك أو تبني منتجاً، مرّ على 6 و7 قبل أن تكتب شيئاً في الإنتاج، ثم ختم بـ8. والقرار الذي لا يؤجّله أحد: n8n Cloud أم استضافة ذاتية — ونظامه في المقال السابع.

لماذا n8n تحديداً؟

الجواب الذي نصدّقه ميزة واحدة فقط: أن الأداة تجمع ثلاث صفات في المنتج نفسه. ولهذا لن نضع هنا جدول مقارنة بأرقام مع Zapier ولا Make — لأن أي رقم في جدول كهذا يعني رقماً عن إصداراتهم وإعدادهم وحصصهم، وهي أرقام تتغيّر أسرع مما نستطيع التحقق منها في كل نشرة، وجدول مقارنة يقدّم معلومة قديمة هو جدول مقارنة مضلِّل.

الصفات الثلاث في الجملة الرسمية واضحة: لوحة بصرية فلا تكتب لتركيب. كود مخصص تكتبه داخل الخطوة التي تحتاجه فحسب. استضافة ذاتية أو سحابة فأنت من يختار. وهذا كله يترجم إلى أمرين لك: إن كان عملك خطوتين متصلتين لا خمس، فلن تحتاج كوداً؛ وإن كانت خطوة واحدة تحتاج معالجة تعقيد، فالعقدة هناك مفتوحة للكود بدل أن تبدأ مشروعاً برمجياً من الصفر.

والأرقام التي تُذكر دائماً رقمان: «1500+ integrations» و«9,000+ workflow templates»، وكلاهما من ملف المشروع الرسمي. انتبه إلى ما لا يقوله هذان الرقمان. «تكامل» قد يكون تطبيقاً تقرأ منه فقط بلا كتابة سطر واحد. و«قالب» هو منطقه كاتبه هو، فاستيراده نقطة بداية لا حلّ — وإلّا اختبر كل فرع على بياناتك قبل أن تسند عملك إليه. والمعنى الثاني يربك أكثر: شريط التنقّل في صفحة الأسعار يعلن «Explore +10k workflow automation templates»، وهو تسويق لا قياس، فالتزمنا برقم ملف المشروع.

وأخيراً: «استضافة ذاتية» ليست دعوى انفصال كاملة. حتى مكان البيانات معلن: «For hosted plans, data is stored within the EU, on servers located in Frankfurt, Germany. For self-hosted plans, it's wherever you decide to host n8n.»

ثلاث كلمات لا تترجمها

سير عمل لا «خط أنابيب». عُقدة لا «نقطة» ولا «نود». وكيل لا «عميل» ولا «وكيل بشري». وn8n تبقى لاتينية دائماً. كل خطأ من هذه الأربعة يغيّر ما تفهمه فعلاً: «خط أنابيب» تجعلك تتوقع بيانات تمرّ في خط مستقيم بلا فروع ولا توقّفات، و«نقطة» تجعل العقدة رقماً بلا معنى واجهة، و«عميل» يحوّل الوكيل إلى زبون.

⚠️ قبل أن تبدأ: ثلاثة تحذيرات

ثلاثة أشياء نعرفها الآن توفّر عليك ساعات تصحيح لاحقاً: الترخيص ليس ما تظنه، والاسم «وكيل» لا يعني شيئاً واحداً، والإصدار القادم يكسر طريقاً تعرفه. اقرأها قبل أول نقرة، لا بعد أول خطأ.

⚠️ قبل أن تبدأ

(أ) n8n ليس MIT. ترخيصه هو Sustainable Use License من Version 1.0، ونصّه الحاكم: «You may use or modify the software only for your own internal business purposes or for non-commercial or personal use. You may distribute the software or provide it to others only if you do so free of charge for non-commercial purposes.» أي أن تشغيله داخل شركتك مشروع، وإعادة إتاحته كمنتج أو كجزء من منتجك ليست كذلك — والأخيرة تحتاج اتفاق OEM. ويضاف إليه أن ملفات الشيفرة التي تحمل .ee. ليست مشمولة بهذا الترخيص أصلاً. وأما ترخيص Business في الاستضافة الذاتية فله شرط صريح: «you receive a license key that must ping our license server daily to stay active. This ping includes data like the number of production executions». التفاصيل كاملة في مقال الترخيص.

(ب) «الوكيل» في n8n اسمٌ واحد لثلاثة أشياء مختلفة. هناك AI Agent — عقدة تعمل داخل سير العمل. وهناك وكيل يستطيع سير العمل أن يستدعيه: «An agent can use any workflow as a tool: the agent decides when the workflow runs». وهناك n8n Assistant الذي حلّ محل الاسم الأقدم، فـ«n8n Assistant supersedes the AI Workflow Builder». الاكتشاف الذي يربك الجميع أن هذه الثلاثة تظهر بصيغة المفرد نفسها في الواجهة نفسها، والأسماء نفسها تغيّرت أكثر من مرة — فالوكلاء الذين يعيشون في مشروعك حديثون: «Released: 2026-09-21 in n8n 2.40». لا تختر شيئاً قبل أن تقرأ مقال الوكلاء الثلاثة — هو عمود هذه السلسلة، وكل مقال بعده يفترض قراءته.

(ج) n8n 3.0، المزمع في أكتوبر 2026، ليست تحديثاً عادياً. التوثيق يقول حرفياً: «Self-hosted n8n will require a Docker-based deployment. n8n 3.0 will no longer support installations run using npm or npx n8n.» ويضيف: «n8n 3.0 doesn't publish a runnable n8n package to npm». أي أن كل تثبيت بـ npm سينتهي، وكل سلسلة تعليمية مبنية على تثبيت عبر npm ستنكسر أمامك. والأسوأ أنه يزيل النسخة الأولى من عقدة AI Agent وأوضاعها: «Version 1 of the AI Agent node supported several agent type modes, including SQL Agent, Conversational Agent, OpenAI Functions Agent, Plan and Execute Agent, and ReAct Agent. n8n 3.0 removes version 1 of the node, along with these modes.» قائمة التحقّق الكاملة قبل الترقية في مقال الإصدارات.

متى تحتاج أي معرفة من السلسلة؟

الجدول التالي هدفه أن توفّر على نفسك فتح صفحة لا تحتاجها: خذ صفّك واذهب مباشرة.

إن كنت...	اقرأ
لم تفتح لوحة n8n من قبل	1 ثم 2
تسمع عن «الوكلاء» ولا تعرف أيّهم تقصد	3، قبل أي شيء آخر
بنيت سير عمل وتوقّف عند عنصر واحد فيه	4
انهار سير عملك كله حين فشلت خدمة خارجية	5
ستشغّل n8n على خادمك أو خلف نطاقك	6
ستستخدمه تجارياً أو تنوي إدراجه في منتجك	7
تريد أن يبنيه Claude أو يشغّله، وأن يعرض أدواته على عميل آخر	8

كم ستدفع فعلاً؟ الاحتساب قبل النشر

الخطأ الأدق أن يكتشفه بعد الفاتورة، وهو بسيط: الحمل يُقاس بعدد مرات تشغيل سير عملك، لا بعدد ما يفعله. وعبارة صفحة الأسعار حاسمة: «An execution is a single run of your entire workflow. It doesn't matter how many steps are in the workflow or how much data it processes. It's still a single execution.» أي أن سير عمل بخطوات كثيرة يكلّف تشغيلة واحدة لا أكثر. ولهذا تُكتب الحصص بهذا الشكل: خطة Starter تعلن «2.5K» و«workflow executions with unlimited steps»، وخطة Pro تعلن «7 days of insights» — الشركة تقيس مرات تشغيل سير عملك، لا حجم ما يفعله.

ثم الحساب الذي يفاجئ الجميع: «For instance, a daily schedule would result in 30 or 31 executions per month, while one that runs every 5 minutes would result in about 8,600–8,900 executions monthly.» أي أن «جدول كل خمس دقائق» ليس رفاهية بل نحو ثمانية آلاف وألف تشغيل شهرياً، مقابل ثلاثين أو إحدى عشرة تشغيلاً في الشهر. والفرق بينهما ليس خيار أسلوب، بل قرار خطة.

⚠️ قبل أن تضبط جدولاً زمنياً اضرب عدد مرات التشغيل في الشهر في عدد السيرَيات المجدولة قبل أن تنشر أياً منها. وتذكّر أن هذا الاحتساب لا يعفيك من شرط الترخيص: مفاتيح Business وEnterprise في الاستضافة الذاتية «must ping our license server daily to stay active» والنبضة «includes data like the number of production executions». أي أن الاستضافة الذاتية تنقل مكان بياناتك إلى جهازك، لا قناع استهلاكها عن n8n.

Hmm, that second box is redundant. Let me remove it in the file assembly. I'll handle this by writing the final body without that duplicate box. Let me note it.

كيف تقرأ خطأ n8n بنفسك

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

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

سلسلة n8n بالعربية: كل المقالات

1. ما هو n8n بالضبط؟ ومتى يكون هو الأداة الصحيحة — ومتى لا يكون — القرار قبل الأدوات.
2. أول سير عمل لك: من رسالة واردة إلى إشعار في Slack — بدون كتابة سطر برمجي واحد — من الصفر، بلا كود.
3. الوكلاء الثلاثة في n8n — عمود السلسلة ⭐.
4. التعبيرات في n8n: $json و$now ولماذا $node غير موجود — دليل $.
5. منطق المسار ومعالجة الأخطاء — If وSwitch وRetry On Fail.
6. الاستضافة الذاتية بأمان — مفتاح التشفير ووضع الطابور.
7. الترخيص والإصدارات بلا تجميل — Community مقابل Business، وn8n 3.0.
8. من الصفر إلى الإنتاج: نظام فواتير آلي كامل + نشره كخادم MCP — المشروع النهائي.

---

تحتاج أتمتة تعمل فعلاً؟

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

---

أُراجع في n8n 2.42.5 (2026-10-08). n8n يُصدر نسخاً جديدة أسبوعياً تقريباً، فراجع التوثيق إن كان عمرك يتجاوز بضعة أشهر.