منهج الأتمتة والنو-كود: من أول سير عمل إلى أول عميل ← الدرس 2

الدرس 2 من 9 · التثبيت الأول

شغّل n8n على جهازك وابنِ أول سير عمل

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

المدة: فيديو 7 دقيقة + تمرين حتى 20 دقيقة · آخر تحقق من الروابط والفيديو: 2 تشرين الأول 2026

الدرس 2 من 9

ليش هالدرس مهم

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

عميل بحلب ما رح يسألك عن اسم الأداة؛ رح يسألك «شو بتعمل وقديش بتضمن». ومن أول يوم لازم تعرف إن الأتمتة اللي بنيتها لازم تضل تشتغل لما تسكّر جهازك، وهاد سبب فهمنا للفرق بين الجهاز المحلي والسيرفر.

هالدرس بيعلمك التعلّم المحلي. التركيب على سيرفر دائم بنعمله لما يصير عندك عميل فعلي، مو قبل.

الفيديو

القناة: Oussama | Web & Ai · المدة: 6:43 · انتبه لـخطوات التثبيت على دوكر؛ قارن ما بتشوفه بالأمر المكتوب تحت، وإذا اختلف شي، اتبع توثيق n8n الرسمي لأنه الأحدث.

فيديو بديل اختياري: «كيفية تثبيت N8N على خادم VPS - خطوة بخطوة» — قناة Metics Media | عربى (5:48) — youtube.com/watch?v=u-c1Njj1rLc

الشرح خطوة بخطوة

في ثلاث طرق لتشغيل n8n على جهازك. الأولى دوكر (Docker)، وهي الأنظف والأقرب لما بيصير على السيرفر لاحقاً. الثانية npx عبر Node.js، وهي الأخف لما جهازك ضعيف أو دوكر ما بيشتغل عندك. الثالثة سيرفر افتراضي (VPS) مدفوع، وبنأجّلها لحد العميل الأول.

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

  1. افتح الطرفية: بويندوز اكتب PowerShell بقائمة ابدأ. هي النافذة اللي بتكتب فيها الأوامر. شو رح تشوف على الشاشة: نافذة زرقاء أو سوداء بسطر ينتهي بعلامة أكبر من.إذا ما ظهرلك: إذا ما فتحت، اضغط زر ويندوز وحرف X واختر Terminal.
  2. الطريقة الأولى (دوكر): بعد ما تثبّت Docker Desktop، شغّله وانتظر لحد ما يظهر أنه جاهز، ثم اكتب بالطرفية: docker volume create n8n_data شو رح تشوف على الشاشة: سطر بيرجّع اسم المجلد n8n_data، يعني تم إنشاء مساحة تخزين دائمة.إذا ما ظهرلك: إذا ظهر خطأ اتصال بالمحرك، دوكر لسا ما خلّص تشغيل؛ استنى دقيقة وكرر.
  3. شغّل n8n: docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n شو رح تشوف على الشاشة: أسطر كتيرة بتتحرك، وبالآخر جملة فيها رابط localhost:5678.إذا ما ظهرلك: إذا ظهر خطأ «port is already allocated»، في برنامج تاني شاغل المنفذ؛ غيّر أول 5678 لـ5679 وافتح الرابط بالرقم الجديد.
  4. الطريقة الثانية (بدون دوكر): ثبّت Node.js بنسخة LTS، وبعدين اكتب npx n8n وجاوب y إذا سألك. بياناتك بتتخزن بمجلد المستخدم .n8n. شو رح تشوف على الشاشة: تحميل حزم لدقيقتين، ثم نفس رسالة الرابط على المنفذ 5678.إذا ما ظهرلك: إذا طلع خطأ نسخة Node، افتح توثيق n8n الرسمي (n8n Docs) وشوف النسخ المدعومة حالياً قبل ما تغيّر شي.
  5. افتح المتصفح على http://localhost:5678. أول مرة بيطلب منك إنشاء حساب مالك (Owner) بإيميل واسم وكلمة سر؛ هالحساب محلي على جهازك بس. شو رح تشوف على الشاشة: صفحة ترحيب بنموذج بسيط. بعد ما تعبّيه بتدخل للوحة فاضية فيها زر لإنشاء أول سير عمل.إذا ما ظهرلك: إذا الصفحة ما فتحت، تأكد إن نافذة الطرفية ما زالت شغالة؛ لو سكّرتها بيتوقف n8n.
  6. اضغط Create workflow وسمّيه «اختبار أول». اضغط على علامة الزائد وأضف عقدة Manual Trigger (تشغيل يدوي). شو رح تشوف على الشاشة: مربع على اللوحة اسمه Manual Trigger وبيده خط خارج منه.إذا ما ظهرلك: إذا ما لقيت العقدة، اكتب manual بخانة البحث بالقائمة الجانبية.
  7. أضف عقدة ثانية: Edit Fields (Set)، وأنشئ حقلين: الاسم، وقيمته «متجر الشام»، والمدينة وقيمتها «دمشق». شو رح تشوف على الشاشة: جدول صغير بالعقدة فيه الحقلان، وعلى اليمين معاينة للنتيجة بصيغة JSON.إذا ما ظهرلك: إذا ما ظهرت القيم، اضغط Execute step على العقدة نفسها.
  8. أضف عقدة ثالثة: If، والشرط: المدينة تساوي دمشق. العقدة لها مخرجان: صح وخطأ. شو رح تشوف على الشاشة: مربع بخطين خارجين، واحد أخضر للصح وواحد أحمر للخطأ.إذا ما ظهرلك: إذا الشرط ما اشتغل، تأكد إن الكتابة حرفاً بحرف متل المخزنة، لأن المقارنة حساسة للمسافات.
  9. اضغط Execute workflow وراقب الأرقام اللي بتظهر على الخطوط بين العقد. هي عدد العناصر اللي مرّت. شو رح تشوف على الشاشة: رقم 1 على الخط الأخضر وبلا شي على الأحمر، يعني الطلب مرّ من مسار الصح.إذا ما ظهرلك: إذا ظهر اللون الأحمر على عقدة، افتحها واقرأ رسالة الخطأ كاملة، غالباً بتحكيلك أي حقل ناقص.
  10. من قائمة النقاط الثلاث أعلى اللوحة اختر Download لتصدير الـworkflow كملف JSON، واحفظه بمجلد exports باسم 01-first-flow.json. شو رح تشوف على الشاشة: ملف نصي صغير ينزل لمجلد التنزيلات، بيبدأ بقوس مجعّد.إذا ما ظهرلك: إذا الزر ما ظهر، ابحث بالقائمة عن Export أو Download؛ التسمية بتختلف بين الإصدارات.

ليش المحلي مو كافي للشغل الحقيقي؟

n8n المحلي بيشتغل طول ما جهازك شغال ونافذة الطرفية مفتوحة. للتعلم هاد ممتاز، لكن أي أتمتة بتعتمد عليها لعميل لازم تضل شغالة بالليل. هون بيجي دور السيرفر. بنرجع للموضوع بالدرس السابع وبالدرس التاسع، ولا تدفع ثمن سيرفر قبل ما يكون عندك سبب مكتوب.

وفي نقطة تقنية بتتكرر: بعض العقد، متل مُطلِق تيليغرام، بتحتاج عنواناً علنياً بصيغة https حتى يوصلها الخبر من الخارج. جهازك المحلي ما عنده عنوان علني. رح نتعامل مع هالنقطة بالدرس الخامس بطريقة صادقة.

فهم الواجهة بدقيقة

  • اللوحة (Canvas): المساحة اللي بترسم فيها سير العمل.
  • العقدة (Node): مربع واحد يعمل شغلة وحدة، مُطلِق أو فعل أو شرط.
  • التنفيذات (Executions): سجل بكل مرة اشتغل فيها سير العمل وهل نجح.
  • بيانات الاعتماد (Credentials): مكان آمن لحفظ مفاتيح الحسابات بدل كتابتها بالعقد.

خطأ شائع: الخروج بدون حفظ

بالتعلم الأول كتير ناس بيسكّروا النافذة قبل الحفظ ويخسروا ساعة شغل. اضغط حفظ بعد كل عقدة جديدة، وصدّر نسخة JSON بنهاية كل جلسة. ملف JSON صغير جداً وبيرجّعلك كل شي لو تعطل الجهاز.

جرّب بنفسك

ابنِ سير عمل اسمه «طلب متجر»: تشغيل يدوي، ثم حقول (الاسم، المنتج، المدينة)، ثم شرط يفصل طلبات المدينة اللي اخترتها عن غيرها. شغّله مرتين بمدينتين مختلفتين وراقب أي مسار اشتغل بكل مرة.

صدّر الملف باسم 02-order-flow.json، والتقط لقطة شاشة للوحة وهي تظهر الأرقام على الخطوط.

معيار النجاح:

  • عندك على اللوحة ثلاث عُقد متصلة ببعضها وبتشتغل بلا لون أحمر.
  • جربت المسارين (صح وخطأ) وشفت الفرق بالأرقام على الخطوط.
  • ملف JSON محفوظ بمجلد exports وبتعرف تفتحه بمحرر نصوص.

فحص سريع

ليش بنستخدم مجلداً خارجياً (volume) مع دوكر؟

حتى تضل البيانات والـworkflows محفوظة حتى لو انحذفت الحاوية أو أُعيد تشغيلها.

شو بيعني الرقم على الخط بين عقدتين؟

عدد العناصر اللي مرت من العقدة الأولى للتانية بآخر تنفيذ.

ليش n8n المحلي مو كافي لعميل؟

لأنه بيشتغل بس وجهازك شغال ونافذة الطرفية مفتوحة، والعميل بيحتاج أتمتة تشتغل على مدار الساعة.

مستند الدرس

انسخ هالخلاصة لملاحظاتك، أو اطبعها من مستند المنهج الكامل.

n8n مفتوحة المصدر: بتنثبّت عندك، ما في حساب مركزي بيتقفل. طريقتان للتشغيل المحلي: دوكر (الأنظف) أو npx عبر Node.js (الأخف). المنفذ الافتراضي 5678: الرابط http://localhost:5678. الأمر الأساسي: docker run مع volume اسمه n8n_data لحفظ البيانات. أول دخول: إنشاء حساب مالك محلي. العقد الأولى: Manual Trigger ← Edit Fields ← If. الأرقام على الخطوط = عدد العناصر المارّة. التصدير: النقاط الثلاث ← Download ← ملف JSON بمجلد exports. المحلي للتعلم، والسيرفر للعميل.

وصلات ذات صلة: مسار الأتمتة · مراجعة n8n Academy · نظام النسخ الاحتياطي · قائمة فحص الأتمتة

التالي

خطوة وحدة بعد القراءة

خلّصت الكورس؟ ثبّتو بشهادة موثّقة

الاختبار مجاني، والشهادة بتصدر بالدعوات بلا أي دفع. والقناة فيها فرص لتطبّق يلي تعلّمتو.

ابدأ التعلم مجاناً 🎁 ادخل القناة