لو عندك سير عمل على n8n بينشر مقالات على ووردبريس، أو بيبعت إشعار لكل طلب في WooCommerce، فالإصدار 3.0 مش تحديث تدوس عليه وتكمل. فيه عقد اتشالت، وطريقة تثبيت اتلغت، وافتراضيات اتغيرت. والأهم: الترقية في اتجاه واحد، مفيش رجوع لـ 2.x.
ماذا حدث وما الموعد؟
أطلقت n8n في 27 أكتوبر 2026 النسخة التجريبية 3.0.0 BETA، والإصدار المستقر مخطط له مطلع ديسمبر 2026 بحسب إعلان الشركة. الإصدار لا يحمل ميزات جديدة تقريباً؛ هدفه تنظيف الكود القديم وجعل الافتراضيات أكثر أماناً، لأن n8n تتبع الترقيم الدلالي (Semantic Versioning) ولا تُدخل تغييراً كاسراً (Breaking Change) إلا مع رقم إصدار رئيسي جديد.
بصراحة: هذا المقال قراءة لإعلان n8n ووثائق التغييرات الكاسرة الرسمية، مع مقال تقني مستقل جرّب نسخة تطوير قبل الإعلان. لم نشغّل 3.0 على خادم إنتاج بعد، فتعامل مع الخطوات كخطة استعداد لا كتجربة منتهية.
هل أنت متأثر؟ ثلاث أسئلة سريعة
| السؤال | لو الإجابة نعم |
|---|---|
هل تشغّل n8n بـ npm أو npx n8n على VPS؟ | لازم تنتقل إلى Docker قبل الترقية |
| — | — |
| هل تستخدم عقد Function أو Cron أو Interval أو عقدة OpenAI القديمة؟ | سير العمل سيفشل حتى تستبدلها |
| هل عندك Code node يستدعي API بطيئاً كنموذج ذكاء اصطناعي؟ | المهلة الافتراضية نزلت إلى 60 ثانية |
لو تستخدم n8n Cloud فالخادم ليس مسؤوليتك، لكن العقد المحذوفة والافتراضيات الجديدة تخصك أيضاً. اختيار الإصدار التجريبي هناك يتم من إعدادات تغيير الإصدار.
تقرير الترحيل: أول ما تفتحه
كل نسخة n8n من 2.39 فما بعد فيها Settings → Migration Report. التقرير يسرد سير العمل (Workflow) والإعدادات المتأثرة بالإصدار 3.0، ويصلح كثيراً منها تلقائياً ويحفظ الإصلاح كنسخة جديدة من سير العمل تراجعها قبل النشر، بينما تستمر النسخ المنشورة في العمل على 2.x.
ويقترح التقرير مسؤولاً عن كل سير عمل (آخر من عدّله)، ويستبعد ما لم يُنشر أو لم يعمل منذ مدة طويلة لتضع عليه «won’t fix»، ويصدّر ملخصاً بصيغة CSV. ولا يحتاج هذه المرة صلاحية مدير؛ كل مستخدم يرى سير العمل المتاح له.
ملاحظة: حدّث أولاً إلى آخر إصدار من 2.x، لأن n8n تقول إن أحدث نسخة من التقرير موجودة فيه وما زالت تُحسَّن.
العقد التي اختفت وبدائلها
هذه أكثر العقد المحذوفة شيوعاً في سير عمل مواقع ووردبريس والمتاجر، من قائمة الوثائق الرسمية:
| المحذوف | البديل |
|---|---|
| Function و Function Item | Code node (وضع All Items أو Each Item) |
| — | — |
| Cron و Interval | Schedule Trigger |
| Item Lists | Split Out أو Aggregate أو Sort أو Limit أو Remove Duplicates أو Summarize |
| OpenAI (legacy) و OpenAI Assistant | عقدة OpenAI الحالية |
| OpenAI Model | OpenAI Chat Model |
| Read Binary File(s) و Write Binary File | Read/Write Files from Disk |
| Read PDF | Extract from File |
| HTML Extract | عقدة HTML، عملية Extract HTML Content |
| AI Agent الإصدار 1 | Tools Agent في أحدث إصدار من AI Agent |
بعض العقد تُرحَّل تلقائياً، وبعضها بلا بديل مثل LangChain Code. وفي الإعلان أيضاً: إزالة وضع تخزين البيانات الثنائية في الذاكرة، وإيقاف Chat Hub افتراضياً، وحذف «Import from URL» من المحرر، وحذف تبويب Ask AI من Code node (الكود الموجود يستمر في العمل).
في ووردبريس: سير العمل الذي ينشر مقالات مجدولة غالباً يبدأ بعقدة Cron قديمة، والذي يلخص المقالات بالذكاء الاصطناعي قد يعتمد على عقدة OpenAI القديمة. هذان أول ما تفتحه في التقرير.
الافتراضيات التي تغيّرت
هذه لا تكسر سير العمل بشكل واضح، لكنها قد توقفه في منتصف التنفيذ:
- مهلة Code node:
N8N_RUNNERS_TASK_TIMEOUTأصبحت 60 ثانية بدل 300. لو عندك كود ينتظر رداً طويلاً من نموذج لغوي، اضبط القيمة صراحة. - الإضافات المجتمعية غير الموثّقة:
N8N_UNVERIFIED_PACKAGES_ENABLEDأصبحتfalse. لو تعتمد على عقدة مجتمعية غير موثّقة، فعّلها بقرار واعٍ. - مسار التخزين: المجلد
~/.n8n/binaryDataيصبح~/.n8n/storageعند أول تشغيل، ولن يعمل n8n لو وُجد المجلدان معاً. لإبقاء المسار القديم استخدمN8N_STORAGE_PATH. - عقدة الضغط: حد فك الضغط نزل من 2 جيجابايت إلى 256 ميجابايت، وحد الملفات داخل الأرشيف من 5,000 إلى 1,000.
- Slack: بيانات اعتماد Slack تتطلب Signing Secret، وبدونه يفشل نشر سير العمل الذي يبدأ بـ Slack Trigger.
- حماية SSRF: عند تفعيلها، تتوسع قائمة النطاقات المحجوبة افتراضياً، ومنها
100.64.0.0/10. مقال jacar.es ينبّه إلى أن هذا النطاق يستخدمه Tailscale، فلو تصل n8n بخوادمك عبره فاسمح بالعناوين المطلوبة.
من npm إلى Docker: التغيير الأكبر للمستقلين
الإصدار 3.0 لا يدعم التثبيت عبر npm أو npx n8n، ولن يُنشر على npm كحزمة قابلة للتشغيل. الاستضافة الذاتية (Self-hosting) صارت عبر Docker فقط، وسكربت الإعداد الرسمي ينشئ نسخة مبنية عليه:
curl -fsSL https://get.n8n.io | sh
لو تستخدم ملف Docker Compose خاصاً بك فلا تحتاج تغييره. وتوصي الوثائق بـ Postgres بدل SQLite المدمجة للفرق والإنتاج.
النقطة التي لا تحتمل الخطأ هي مفتاح التشفير (Encryption Key). يحفظ n8n بيانات الاعتماد مشفرة به، فلو نقلت التثبيت إلى Docker بمفتاح جديد لن تُقرأ أي كلمة مرور أو مفتاح API محفوظ. لذلك انقل البيانات بالمفتاح نفسه: مقال jacar.es يوضح أن مجلد ~/.n8n يُركَّب داخل الحاوية على /home/node/.n8n بملكية المستخدم uid 1000، وأن ملف config داخله يحمل المفتاح ما لم تحدد N8N_ENCRYPTION_KEY.
تنبيه: شغّل في Docker الإصدار نفسه الذي تعمل عليه الآن أولاً، وتأكد أن كل شيء سليم، ثم رقِّ. نقل البيئة والترقية في خطوة واحدة يصعّب معرفة مصدر أي عطل.
خطة ترقية آمنة
n8n 3.0
خطة ترقية آمنة في 5 خطوات
حدّث إلى آخر 2.x
ثم افتح Settings ← Migration Report.
أصلح ما يظهر
استبدل العقد المحذوفة أو علّم المتروك «won't fix».
ثبّت إصدار الصورة
لا تستخدم latest في Docker.
نسخة احتياطية كاملة
قاعدة البيانات ومجلد البيانات بمفتاح التشفير.
اختبار ثم إنتاج
رقِّ نسخة اختبار أولاً، فلا رجوع إلى 2.x.
- حدّث إلى آخر 2.x وافتح Migration Report.
- أصلح كل ما يظهر أو علّمه «won’t fix» إن كان سير عمل متروكاً.
- ثبّت إصدار الصورة في Docker بدل
latest، حتى لا تحدث الترقية وحدك في منتصف الليل. - خذ نسخة احتياطية كاملة: قاعدة البيانات، ومجلد البيانات بما فيه مفتاح التشفير.
- رقِّ نسخة اختبار أولاً، شغّل سير العمل الحساس يدوياً، ثم رقِّ الإنتاج.
لنسخة احتياطية من تثبيت Docker Compose مع Postgres، هذه الأوامر من مقال jacar.es (عدّل اسم الحجم ورقم الإصدار حسب خادمك):
docker compose stop n8n
docker compose exec -T postgres pg_dump -U n8n -Fc n8n > n8n-2.39.6.dump
docker run --rm -v your_volume_name:/from:ro -v "$PWD":/to alpine:3
tar -C /from -czf /to/n8n_data-2.39.6.tgz .
ولو أردت تأجيل بعض الافتراضيات الجديدة إلى أن تراجع سير عملك، ثبّتها صراحة في ملف البيئة:
N8N_RUNNERS_TASK_TIMEOUT=300
N8N_UNVERIFIED_PACKAGES_ENABLED=false
بصراحة: المقال المستقل يذكر أن تشغيلاً فاشلاً لنسخة تطوير نفّذ ترحيلات على قاعدة البيانات وحذف جداول، وأن تغيير وسم الصورة وحده لم يكفِ للرجوع؛ احتاج استرجاع قاعدة البيانات من النسخة الاحتياطية. الخلاصة: النسخة الاحتياطية هنا ليست احتياطاً شكلياً، بل طريق العودة الوحيد.
العربية والتكلفة وحدود الترقية
- العربية: التغييرات في 3.0 تخص البنية والعقد والإعدادات، والإعلان لا يذكر أي تغيير في معالجة النصوص. سلوك سير العمل مع المحتوى العربي واتجاه RTL في 3.0 لم يُختبر بالعربية بعد.
- التكلفة: الترقية نفسها مجانية للاستضافة الذاتية. التكلفة الحقيقية هي ساعات مراجعة سير العمل، وثمن الخطأ: سير عمل نشر متوقف لأيام دون أن تلاحظ، أو بيانات اعتماد ضاعت مع مفتاح تشفير مفقود.
- الحدود: لا رجوع من 3.x إلى 2.x، والإصدار حالياً تجريبي. لا تضعه على خادم عميل قبل الإصدار المستقر.
اقرأ أيضًا
الأسئلة الشائعة
س: هل يجب أن أرقّي n8n إلى 3.0 الآن؟
ج: لا على الإنتاج. الإصدار تجريبي والمستقر متوقع مطلع ديسمبر 2026. الأفضل الآن أن تحدّث إلى آخر 2.x وتفتح تقرير الترحيل وتصلح ما فيه، ثم ترقّي نسخة اختبار.
س: هل يمكنني الرجوع إلى n8n 2.x بعد الترقية؟
ج: لا، الترقية في اتجاه واحد بحسب n8n. طريق العودة الوحيد هو استرجاع نسخة احتياطية كاملة لقاعدة البيانات ومجلد البيانات أُخذت قبل الترقية.
س: أشغّل n8n بـ npm على VPS، فماذا أفعل؟
ج: انتقل إلى Docker أولاً مع الاحتفاظ بقاعدة البيانات ومفتاح التشفير نفسيهما، وشغّل الإصدار الحالي نفسه، ثم رقِّ بعد التأكد. الإصدار 3.0 لا يُنشر على npm كحزمة قابلة للتشغيل.
س: ماذا يحدث لسير العمل الذي يستخدم عقدة Cron؟
ج: يفشل في 3.0 لأن Cron وInterval حُذفتا. استبدلهما بـ Schedule Trigger، وتقرير الترحيل يحدد سير العمل المتأثر وقد يصلح بعضه تلقائياً.
الخلاصة
n8n 3.0 إصدار تنظيف وأمان لا إصدار ميزات، لكنه يكسر عقداً قديمة وطريقة تثبيت شائعة بين المستقلين. افتح تقرير الترحيل، وانقل التثبيت إلى Docker بمفتاح التشفير نفسه، وخذ نسخة احتياطية تستطيع الاسترجاع منها فعلاً. ابدأ النهارده بالتقرير، وسيب الترقية نفسها لحد ما الإصدار المستقر ينزل.
مراجع إضافية: n8n v3.0 breaking changes — n8n Docs، How to prepare your self-hosted n8n for n8n 3.0 — jacar.es
مرجع المقال (بالإنجليزية): Introducing n8n 3.0 — n8n Blog
المقال ده مش ترجمة حرفية: متكيّف للقارئ العربي ومضاف عليه سياق ووردبريس وElementor وJetEngine.
