n8n الدليل العملي للأتمتة الذكية (التثبيت، الربط، والأمثلة الجاهزة)

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

في هذا الدليل ستتعرف على n8n من الصفر: ما هو، لماذا يُفضّل على أدوات الأتمتة الأخرى، وكيف تثبته على ويندوز أو لينكس، وكيف تربطه بـ OpenAI وTelegram وExcel وMySQL، إضافة إلى الـ API والـ HTTPS والتحديث والأمان. المقال مبني للتطبيق العملي، لا للتنظير.

ما هو n8n؟

n8n (يُنطق “إن-إيت-إن” أو بالعربية “إن 8 إن”) هي منصة مفتوحة المصدر لبناء سير العمل الآلي (Workflow Automation) بأسلوب مرئي قائم على العقد (Node-based). تتخيل مهمتك كسلسلة من المربعات: كل مربع يمثّل خطوة — استقبال حدث، استدعاء خدمة، تحويل بيانات، أو إرسال نتيجة — وتربطها بخطوط لتمرّ البيانات من خطوة لأخرى.

تُصدر n8n برخصة fair-code (كود متاح المصدر)، ما يعني أنك تستطيع استضافتها على خوادمك مجانًا وبلا حدود على التنفيذ في النسخة المجتمعية (Community Edition). الفرق الجوهري عن أدوات مثل Zapier أن n8n يمنحك تحكمًا كاملًا في بيئتك، ويسمح بكتابة كود JavaScript أو Python داخل العقد عند الحاجة، ويدعم أكثر من 400 تكامل جاهز مع خدمات مثل Google وTelegram وMySQL وOpenAI.

ببساطة: n8n هو “موصل” بين التطبيقات. بدل أن تنسخ يدويًا، تجعل n8n ينقل البيانات ويتصرف بناءً عليها تلقائيًا.

لماذا يستخدم n8n بدل أدوات الأتمتة الأخرى؟

السبب المباشر هو المزج بين السهولة البصرية والعمق التقني. أدوات مثل Zapier سهلة لكنها مقيّدة عند الحلول المعقدة وتُسعّر حسب المهام. n8n يعطيك:

• استضافة ذاتية مجانية: شغّل النسخة المجتمعية على خادمك دون دفع رسوم تنفيذ.
• كود عند الحاجة: عقدة Code تدعم JavaScript/Python لتحويلات معقدة.
• ذكاء اصطناعي أصيل: عقد LangChain و AI Agent لبناء وكلاء تفكير.
• خصوصية البيانات: بياناتك لا تغادر خادمك إن استضفتها ذاتيًا.
• مرونة غير محدودة: أي خدمة ذات REST API تصلها عبر عقدة HTTP Request.

لمقارنة أوضح، إليك جدولًا يلخّص الفروقات الجوهرية:

أهم استخدامات n8n في الواقع

لا يقتصر n8n على حالة واحدة. أكثر السيناريوهات شيوعًا:

• مزامنة البيانات: نقل سجلات من نموذج إلى MySQL أو Google Sheets تلقائيًا.
• الرد الآلي: بوت Telegram يجيب باستخدام OpenAI على أسئلة متكررة.
• تقارير دورية: تجميع بيانات أسبوعية ووضعها في ملف Excel ثم إرسالها بالبريد.
• تنبيهات: إشعار فوري عند فشل عملية أو وصول طلب جديد.
• معالجة المستندات: استخراج نص من فواتير وترتيبه في قاعدة بيانات.
• خطوط ذكاء اصطناعي: تصنيف رسائل الدعم أو تلخيص محتوى قبل توجيهه.

أي مهمة تتكرر بنفس المنطق مرشّحة لتكون Workflow في n8n.

n8n API شغّل الأتمتة برمجيًا

يوفّر n8n واجهة REST API رسمية (الإصدار v1) لإدارة المثيّل برمجيًا: تشغيل workflows، جلب سجل التنفيذ، إنشاء مستخدمين، وإدارة الوسوم والمتغيرات. هذا مفيد إن أردت نشر workflows عبر CI، أو مراقبة التنفيذ من لوحة خارجية، أو بناء أداة إدارة حول n8n.

طريقة التوثيق (Authentication) تعتمد مفتاح API يُرسل في ترويسة الطلب X-N8N-API-KEY. تولّد المفتاح من داخل n8n عبر: Settings ← n8n API ← Create an API key. العنوان الأساسي (Base URL) يكون:

• للسحابة: https://<subdomain>.app.n8n.cloud/api/v1
• للاستضافة الذاتية: https://<your-domain>/api/v1

مثال عملي لجلب الـ workflows النشطة باستخدام curl:

curl -X 'GET' \
  'https://your-domain.com/api/v1/workflows?active=true' \
  -H 'accept: application/json' \
  -H 'X-N8N-API-KEY: مفتاحك_هنا'

curl -X 'GET' \
  'https://your-domain.com/api/v1/workflows?active=true' \
  -H 'accept: application/json' \
  -H 'X-N8N-API-KEY: مفتاحك_هنا'

إلى جانب REST API، هناك أسلوب آخر: تحويل أي Workflow إلى نقطة نهاية عبر عقدة Webhook. الفرق أن REST API يدير المثيّل نفسه، بينما Webhook يجعل الـ Workflow قابلًا للاستدعاء كخدمة. تفاصيل التوثيق في توثيق n8n الرسمي للـ API.

نصيحة أمان: عامل مفتاح API كما تعامل كلمة المرور. لا تضعه في كود يصل المتصفح، وخزّنه في مدير أسرار، وبدّله دوريًا.

n8n Excel أتمتة الجداول والملفات

الكلمة المفتاحية n8n excel تغطي مسارين مختلفين يجب فهم الفرق بينهما:

• Microsoft Excel (عبر السحابة): عقدة Microsoft Excel تتحدث مع Excel عبر Microsoft Graph API، أي أنها تتعامل مع ملفات في OneDrive أو SharePoint. تحتاج تطبيق Azure AD وتوثيق OAuth2. المناسبة عند عمل فريق على ملفات سحابية.
• ملفات محلية (.xlsx): إن كان ملف Excel على القرص، استخدم عقدة Spreadsheet File لقراءة وكتابة CSV/XLSX محليًا دون حساب سحابي. كما توجد عقدة Convert to File لتوليد ملف متعدد الأوراق من بيانات JSON.
• Google Sheets: عقدة جاهزة وأبسط إعدادًا إن كنت على منظومة Google.

مثال نموذجي: نموذج يستقبل طلبات ← n8n ينظّف البيانات ← يكتب صفًا جديدًا في شيت Excel أو يولّد ملفًا ويُرسله بالبريد.

راجع توثيق عقدة Microsoft Excel وتوثيق Microsoft Graph للتفاصيل.

n8n HTTPS تشغيل آمن عبر الإنترنت

عند نشر n8n على خادم حقيقي يجب ألا تكشف المنفذ 5678 مباشرة. الطريقة المعتمدة هي وضعه خلف Reverse Proxy (مثل Nginx أو Traefik أو Caddy) مع شهادة TLS، فيصبح الوصول عبر https://. هذا ضروري كي تعمل الـ Webhooks الواردة من خدمات خارجية، ولحماية بيانات الاعتماد.

خطوات عامة:

1. ثبّت n8n خلف proxy ووجّه النطاق إليه.
2. فعّل شهادة مجانية عبر Let’s Encrypt (Traefik/Caddy يسهّلان ذلك).
3. اضبط متغيرات البيئة: N8N_PROTOCOL=https و WEBHOOK_URL=https://your-domain.com و N8N_HOST=your-domain.com.

بدون ضبط WEBHOOK_URL الصحيح ستُولّد روابط الويب هوك خاطئة ولا تعمل الم triggers الخارجية. التفاصيل في مثال إعداد HTTPS الرسمي.

n8n Linux التثبيت على خوادم لينكس

لينكس هو البيئة الأكثر شيوعًا لاستضافة n8n ذاتيًا. الطريقتان الرئيسيتان:

الطريقة الأولى Docker (موصى بها)

لتجربة سريعة:

docker run -it --rm --name n8n -p 5678:5678 \
  -v n8n_data:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

docker run -it --rm --name n8n -p 5678:5678 \
  -v n8n_data:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

ثم افتح http://localhost:5678. للإنتاج يُفضّل ملف docker-compose.yml مع قاعدة بيانات وحدود موارد. التفاصيل في توثيق تثبيت Docker الرسمي.

الطريقة الثانية npm

تحتاج Node.js 18 فأعلى:

npm install n8n -g
n8n

npm install n8n -g
n8n

لتشغيل لمرة واحدة دون تثبيت: npx n8n. للإنتاج شغّلها كخدمة عبر systemd أو pm2 مع متغيرات البيئة.

n8n MySQL ربط قاعدة البيانات

عبر عقدة MySQL يتصل n8n بقاعدة البيانات مباشرة لتنفيذ استعلامات SQL أو إدراج/تحديث سجلات. العمليات المدعومة: Execute Query، Insert، Update، Delete، Select.

سيناريو عملي: ويب هوك يستقبل طلبًا ← عقدة MySQL تنفّذ استعلامًا لجلب بيانات العميل ← عقدة معالجة تبني رسالة ← إرسال النتيجة عبر Telegram أو بريد.

عند إعداد الاعتمادات استخدم مستخدمًا مخصصًا بصلاحيات محدودة لا حساب الجذر. راجع توثيق عقدة MySQL وتوثيق MySQL الرسمي.

n8n OpenAI دمج الذكاء الاصطناعي في سير عملك

هذا أقوى جوانب n8n اليوم. عبر عقدة OpenAI (أو عقد LangChain الفرعية) تستدعي نماذج الذكاء الاصطناعي داخل الـ Workflow: توليد نص، تصنيف، ترجمة، تلخيص، أو بناء وكيل (AI Agent) يستخدم أدوات.

للحصول على أفضل نتائج، اهتم بصياغة البرومببt (Prompt)؛ يمكنك الاستعانة بـ دليل كتابة البرومببt الاحترافي ومجموعة 50 برومببt جاهزًا لـ ChatGPT. النماذج نفسها تتطور باستمرار، ويمكنك الاستعانة بـ نماذج GPT-5/6 من OpenAI أو بدائل مثل Gemini.

مثال: رسالة تليجرام واردة ← عقدة OpenAI تولّد ردًا مختصرًا ← إرسال الرد للدردشة. يمكن أيضًا استبدال OpenAI بنموذج محلي عبر Ollama للخصوصية التامة.

تفاصيل العقدة في توثيق عقدة OpenAI ومعاملات النماذج في توثيق منصة OpenAI.

n8n Telegram بناء بوتات أتمتة

عبر n8n تبني بوت تليجرام دون كتابة خادم كامل. الخطوات:

1. أنشئ البوت عبر BotFather واحصل على التوكن.
2. أضف عقدة Telegram Trigger في n8n واربط التوكن.
3. ضمن منطق المعالجة (تصنيف، استدعاء OpenAI، استعلام MySQL…).
4. أضف عقدة Telegram لإرسال الرد للدردشة.

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

راجع توثيق عقدة Telegram للعمليات المدعومة.

n8n Update كيف تحدّث n8n بأمان

يُصدِر فريق n8n تحديثات متكررة تحمل إصلاحات أمان وميزات. طريقة التحديث تعتمد على طريقة التثبيت:

تحديث عبر Docker

docker compose pull
docker compose up -d

docker compose pull
docker compose up -d

أو سحب الصورة وإعادة إنشاء الحاوية مع الإبقاء على وحدة التخزين (Volume) الذي يحوي بياناتك.

تحديث عبر npm

npm update -g n8n
n8n --version

npm update -g n8n
n8n --version

للتحقق من الإصدار: من الواجهة عبر Settings ← About، أو عبر السطر n8n --version، أو عبر الـ API: /api/v1/info.

قبل أي تحديث: انسخ مجلد البيانات احتياطيًا (~/.n8n عند npm، أو وحدة التخزين عند Docker). ولا تبدّل قيمة N8N_ENCRYPTION_KEY وإلا تعذّرت قراءة الاعتمادات المشفّرة.

n8n Windows التثبيت على ويندوز

رغم أن الخوادم غالبًا لينكس، يعمل n8n على ويندوز بعدة طرق مناسبة للتعلّم والتطوير:

1. تطبيق سطح المكتب (الأسهل): n8n Desktop يجمع كل شيء في برنامج واحد. التفاصيل في توثيق تطبيق سطح المكتب.
2. Docker Desktop: نفس أوامر لينكس بعد تثبيت Docker Desktop على ويندوز.
3. WSL2: تشغيل بيئة لينكس داخل ويندوز للحصول على تجربة قريبة من الخادم.
4. npm: بعد تثبيت Node.js، شغّل npx n8n.

للإنتاج المستمر يُفضّل نقل المشروع لاحقًا إلى خادم لينكس أو VPS كما في القسم التالي.

أمثلة عملية على Workflows جاهزة

إليك ثلاثة أنماط جاهزة للتطبيق فورًا:

1) بوت دعم ذكي (Telegram + OpenAI)

Telegram Trigger ← عقدة OpenAI (تصنيف + توليد رد) ← Telegram (إرسال). يقلّل الأعباء على فريق الدعم ويرد خلال ثوانٍ.

2) تقرير أسبوعي (MySQL + Excel + بريد)

جدول زمني (Schedule) ← عقدة MySQL (استعلام مبيعات) ← عقدة Spreadsheet File (توليد XLSX) ← عقدة بريد (إرسال الملف). ينهي مهمة كانت تستغرق ساعة كل أسبوع.

3) استقبال طلبات (نموذج + MySQL + إشعار)

Webhook ← عقدة MySQL (إدراج سجل) ← Telegram (إشعار للفريق). كل طلب جديد يُحفظ ويُبلَّغ عنه تلقائيًا.

يمكنك بناء وكلاء تفكير أعقد مستلهمة من فكرة مساعد ChatGPT الشخصي لكن بمصادر بيانات حقيقية خاصة بك.

الفرق بين تشغيل n8n محليًا وعلى VPS

القرار بين التشغيل على جهازك والخادم يؤثر على ما يمكن لـ n8n فعله فعليًا:

أساسيات الأمان عند نشر n8n

الأتمتة تعني صلاحيات حساسة، فالأمان ليس اختياريًا:

• HTTPS دائمًا: عبر reverse proxy كما في قسم n8n HTTPS.
• حساب مالك قوي: أول مستخدم يُنشأ هو المالك بصلاحيات إدارية، استخدم كلمة سر قوية.
• مفتاح تشفير ثابت: اضبط N8N_ENCRYPTION_KEY ولا تبدّله بعد الإنشاء.
• إدارة مفاتيح API: لا تكشفها في الواجهة الأمامية، وبدّلها دوريًا.
• نسخ احتياطي: انسخ مجلد البيانات/الوحدة قبل كل تحديث.
• تقييد الشبكة: لا تكشف المنفذ 5678 للعامة، بل خلف proxy مع جدار ناري.

الأخطاء الشائعة وكيف تتجنّبها

• الويب هوك لا يطلق: لأن WEBHOOK_URL خاطئ أو المثيّل غير مكشوف للإنترنت. تأكد من ضبط HTTPS والنطاق.
• الاعتمادات تفشل: بسبب نطاقات (Scopes) OAuth ناقصة أو توكن منتهٍ. راجع صلاحيات التطبيق.
• الـ Workflow لا يشتغل: نسيت تفعيله (Active). فعّل السير من الزر أعلى المحرر.
• فقدان الاعتمادات بعد التحديث: بسبب تبديل N8N_ENCRYPTION_KEY. حافظ على قيمته.
• تعارض المنفذ 5678: شغّل على منفذ آخر أو أوقف الخدمة المتعارضة.

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

ما هو n8n؟

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

هل n8n مجاني؟

النسخة المجتمعية مجانية للاستضافة الذاتية بلا حدود تنفيذ. n8n Cloud مدفوع يبدأ من حوالي 20 دولارًا شهريًا، والنسخة المؤسسية تضيف SSO ومفاتيح محددة النطاق.

هل يمكن تشغيل n8n على Windows؟

نعم، عبر تطبيق سطح المكتب، أو Docker Desktop، أو WSL2، أو npm بعد تثبيت Node.js. الأنسب للتعلّم؛ للإنتاج يُفضّل الخادم.

هل يمكن تشغيل n8n على Linux؟

نعم، وهو الأكثر شيوعًا عبر Docker أو npm، ويعمل كخدمة على خوادم Ubuntu والتبعات.

كيف يتم تحديث n8n؟

عبر Docker: docker compose pull && docker compose up -d. عبر npm: npm update -g n8n. أنسخ البيانات احتياطيًا قبل التحديث.

هل يمكن ربط n8n بـ OpenAI؟

نعم عبر عقدة OpenAI وعقد LangChain، لتوليد النصوص والتصنيف وبناء وكلاء ذكاء اصطناعي داخل السير.

هل يمكن ربط n8n بـ Telegram؟

نعم عبر عقدتي Telegram Trigger و Telegram لبناء بوتات تستقبل وتجيب وتُبلّغ تلقائيًا.

هل يمكن ربط n8n بـ Excel؟

نعم. عقدة Microsoft Excel للملفات السحابية (OneDrive/SharePoint)، وعقدة Spreadsheet File للملفات المحلية بصيغة XLSX/CSV.

هل يمكن استخدام MySQL مع n8n؟

نعم عبر عقدة MySQL لتنفيذ الاستعلامات وإدراج وتحديث السجلات مباشرة من داخل السير.

ما هو n8n API؟

واجهة REST رسمية (v1) لإدارة المثيّل: تشغيل workflows، جلب التنفيذ، إدارة المستخدمين والمتغيرات، توثيقها بمفتاح في ترويسة X-N8N-API-KEY.

خلاصة عملية

n8n ليس مجرد أداة ربط، بل منصة تحكم كامل في أتمتة عملك: تبدأ من تجربة على جهازك عبر تطبيق سطح المكتب، ثم تنقلها لخادم لينكس مع HTTPS عند الجاهزية. تربطه بـ OpenAI لذكاء اصطناعي، بـ Telegram للتفاعل، بـ Excel وMySQL للبيانات، وتديره برمجيًا عبر الـ API. الميزة الأهم أن الكود مفتوح والبيانات تحت سيطرتك.

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