لماذا يعمل مشغّل الجدولة في n8n بوقت خاطئ؟
تعرّف إلى أولوية المنطقة الزمنية لسير العمل والمثيل، واضبط GENERIC_TIMEZONE للجدولة وTZ لتوقيت نظام الحاوية، مع مثال فرق Berlin وNew York.
سبب تشغيل مشغّل الجدولة في n8n عند ساعة خاطئة
يعمل مشغّل الجدولة في n8n عند ساعة خاطئة عندما تختلف المنطقة الزمنية التي يعتمدها عن المنطقة التي قصدتها. تستخدم مشغّلات الجدولة المنطقة الزمنية لسير العمل إذا كانت محددة، وإلا فتستخدم المنطقة الزمنية للمثيل من GENERIC_TIMEZONE. يمكن أن يؤدي تحديد المنطقة الزمنية لسير العمل وحده إلى تصحيح جدول ذلك السير بالكامل؛ أما متغير TZ الخاص بالحاوية فيتحكم في المنطقة الزمنية للنظام بصورة مستقلة.
صحّح أولاً افتراضاً شائعاً. لا يضبط n8n المستضاف ذاتياً حديثاً جداولَه على UTC (التوقيت العالمي المنسق). تُدار الجدولة في طبقة مستقلة، والإعداد الافتراضي الموثق لدى n8n لـ GENERIC_TIMEZONE هو America/New_York (اعتباراً من November 19, 2026)، ولذلك يشغّل المثيل غير المعدّل مشغّلات الجدولة وفق توقيت New York. لهذا السبب نادراً ما يطابق فرق التوقيت الذي يبلّغ عنه المستخدمون فرقهم الفعلي عن UTC. فإذا طلب مالك في Berlin تشغيل المهمة عند 06:00، فستعمل عند 12:00 بالتوقيت المحلي، وعند 11:00 خلال الأسابيع الواقعة في March والأسبوع الذي يحيط بانتقال October وNovember، عندما تكون الولايات المتحدة على التوقيت الصيفي ولا تكون أوروبا كذلك.
طبقات المناطق الزمنية الثلاث، وأيّها له الأولوية
TZ هي المنطقة الزمنية لنظام التشغيل داخل الحاوية. تصفها وثائق n8n بأنّها المتغير الذي يضبط المنطقة الزمنية للنظام للتحكم في القيمة التي تُرجعها البرامج النصية والأوامر مثل date. وهي تحدد ما يطبعه date داخل الحاوية، والمنطقة الزمنية التي تستخدمها تنسيقات تواريخ JavaScript المحلية والبرامج النصية shell. ولا تؤثر في وقت تشغيل Schedule Trigger.
GENERIC_TIMEZONE هي المنطقة الزمنية لمثيل n8n. وتسمّيها الوثائق المنطقة الزمنية لمثيل n8n، وتوضح أنّها مهمة لعُقد الجدولة مثل Cron. ويعني Cron هنا صيغة الجدولة القياسية المستندة إلى الوقت، ويعرضها n8n باسم Custom (Cron) في Schedule Trigger.
تُضبط المنطقة الزمنية لسير العمل لكل سير عمل على حدة. افتح سير العمل على اللوحة، وحدد النقاط الثلاث في الزاوية العلوية اليمنى، ثم حدد Settings، وبعد ذلك غيّر قيمة Timezone. ويؤدي ذلك إلى تجاوز GENERIC_TIMEZONE في سير العمل هذا فقط. تنتمي كل إعدادات هذه الصفحة إلى الإصدار المجاني المستضاف ذاتياً، لذلك لا يعتمد ضبط الجداول الزمنية بشكل صحيح على خطة مدفوعة، كما أنّ الميزات التي تحتاج فعلاً إلى مفتاح ترخيص تمثل قائمة مختلفة تماماً.
يكون ترتيب الأولوية ثابتاً في Schedule Trigger. يستخدم n8n المنطقة الزمنية لسير العمل إذا كانت محددة له، وإلا يستخدم المنطقة الزمنية للمثيل من GENERIC_TIMEZONE، وإلا يستخدم القيمة الافتراضية المضمّنة فيه وهي America/New_York. ولا يتم الرجوع إلى TZ في أي خطوة من خطوات هذا القرار.
بالنسبة إلى التواريخ داخل العُقد، تعتمد الإجابة على الساعة التي يطلبها الكود. تستخدم Luxon، وهي مكتبة التواريخ التي تقف وراء تعبيرات n8n، المنطقة الزمنية لـ n8n، ولذلك يتبع $now و$today ترتيب سير العمل ثم المثيل نفسه الذي يتبعه المشغّل. ويمثل new Date() في JavaScript العادي لحظة زمنية؛ أما التنسيق المحلي مثل .toString() فيستخدم المنطقة الزمنية للنظام الذي يعمل عليه وقت التشغيل، لا المنطقة الزمنية لسير العمل. يفسر هذا الفصل كيف يمكن أن يعمل المشغّل بصورة صحيحة، بينما يعرض طابع زمني منسق وفق وقت النظام المحلي ساعة مختلفة.
اضبط القيم الثلاث كلها في ملف Compose
ضع TZ وGENERIC_TIMEZONE بجوار بعضهما في الملف حتى لا يضبط أحدهما وينسى الآخر. يوضح المقتطف أدناه الجزء المتعلق بالمنطقة الزمنية من خدمة عاملة. أما بقية الملف، بما في ذلك Reverse Proxy والشهادة، فتأتي من دليل استضافة n8n ذاتياً على VPS خلف HTTPS.
services:
n8n:
image: docker.n8n.io/n8nio/n8n
restart: unless-stopped
ports:
- "127.0.0.1:5678:5678"
environment:
- GENERIC_TIMEZONE=Europe/Berlin
- TZ=Europe/Berlin
- N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true
volumes:
- n8n_data:/home/node/.n8n
volumes:
n8n_data:طبّق التغييرات باستخدام docker compose up -d، وليس باستخدام docker compose restart. تعيد عملية إعادة التشغيل تشغيل الحاوية نفسها بالبيئة التي أُنشئت بها، لذلك تتغير الملفات ولا تتغير العملية قيد التشغيل. يكتشف up -d تغيّر البيئة ويعيد إنشاء الحاوية. إذا احتفظت بهذه القيم في ملف env بدلاً من تعريفها مباشرة، تنطبق قاعدة إعادة الإنشاء نفسها، ويوضح دليل ملف env والتعامل مع الأسرار في Compose مصدر قراءة ذلك الملف.
استخدم اسم منطقة زمنية من IANA (هيئة الإنترنت للأرقام المخصصة) بصيغة Region/City، مثل Europe/Berlin أو America/Sao_Paulo. تتضمن هذه الأسماء قواعد التوقيت الصيفي لذلك المكان، لذلك يتغير الإزاحة عندما تتغير الساعات المحلية. أما الاسم ذو الإزاحة الثابتة مثل Etc/GMT+5 فلا يتغير مع الفصول، كما أن إشارته معكوسة مقارنة بما قد تتوقعه. شغّل LC_ALL=C TZ=Etc/GMT+5 date +%z، وسيطبع -0500. تجنب هذه الأسماء.
لماذا يؤدي ضبط أحدهما فقط إلى إصلاح جزئي
يؤدي ضبط المنطقة الزمنية لسير العمل وحده إلى إصلاح المنطقة الزمنية لجدولة سير العمل بالكامل. اضبط GENERIC_TIMEZONE وحده، وستستخدم مشغلات الجدولة التي لا تتضمن تجاوزاً على مستوى سير العمل هذه المنطقة الزمنية، بينما تبقى المنطقة الزمنية للنظام دون تغيير. تستخدم عقدة Code التي تستدعي new Date().toString() وقت النظام المحلي، لذلك قد ينتقل اسم ملف مبني من حقول التاريخ المحلية إلى اليوم التالي عند منتصف ليل مختلف.
اضبط TZ وحده، ويحدث العكس. يطبع docker compose exec n8n date وقتك المحلي، ما يبدو نجاحاً، بينما يظل Schedule Trigger الذي لم تُضبط له منطقة زمنية على مستوى سير العمل أو المثيل مضبوطاً على America/New_York. هذا هو الخيار الذي يستهلك معظم الوقت، لأن الفحص الذي يجريه معظم الأشخاص أولاً ينجح الآن.
اضبط منطقة زمنية لسير العمل، ثم غيّر GENERIC_TIMEZONE لاحقاً، وسيتجاهل سير العمل ذلك التغيير. تنتصر قيمة سير العمل، وتظل كذلك إلى أن يفتح أحدهم إعدادات سير العمل. إذا كان أحد أساليب العمل يعمل في ساعة غير معتادة بينما تعمل أساليب العمل المجاورة بصورة سليمة، فغالباً يكون السبب هو ذلك.
تحقّق من الساعات بدلاً من التخمين
قارن بين المضيف والحاوية مباشرة.
date
docker compose exec n8n date
docker compose exec n8n printenv TZ GENERIC_TIMEZONEيجب أن يطبع الأمران الأولان الوقت الفعلي نفسه إذا كان المضيف والحاوية يستخدمان المنطقة الزمنية نفسها. يطبع printenv سطراً واحداً لكل متغير موجود، لذلك يعني ظهور سطرين أن المتغيرين مضبوطان، بينما يعني ظهور سطر واحد أن متغيراً واحداً فقط مضبوط في بيئة الحاوية.
اسأل n8n نفسه الآن من داخل سير عمل، لأن shell الحاوية لا يمكنه إخبارك بالمنطقة الزمنية المحددة على مستوى سير العمل. أضف عقدة Code إلى سير العمل الذي يتصرف بشكل غير صحيح، وشغّله مرة واحدة باستخدام Execute Workflow.
return [
{
json: {
n8n_time: $now.toISO(),
n8n_zone: $now.zoneName,
system_time: new Date().toString(),
},
},
];تمثل n8n_zone المنطقة الزمنية التي سيستخدمها Schedule Trigger في سير العمل، بعد حلّها وفق ترتيب سير العمل ثم المثيل، ولذلك فهي تجيب عن السؤال مباشرة. تعرض system_time المنطقة الزمنية المحلية لبيئة تشغيل JavaScript؛ وإذا كانت عقدة Code تعمل في حاوية task runner منفصلة، فتحقق من المنطقة الزمنية لتلك الحاوية أيضاً. شغّل الاختبار في سير العمل الذي يتصرف بشكل غير صحيح، وليس في سير عمل جديد، لأن إعداد مستوى سير العمل ينتقل معه. تفسر المناطق الزمنية المختلفة اختلاف الساعات المعروضة؛ قارن كل واحدة منها بالمنطقة الزمنية التي قصدت استخدامها.
تعبيرات Cron في عقدة Schedule Trigger
توفّر Schedule Trigger فواصل زمنية ثابتة تبدأ من الثواني وتصل إلى الأشهر، بالإضافة إلى خيار Custom (Cron) للحالات التي لا تغطيها هذه الفواصل. تُقرأ تعبيرات cron وفق المنطقة الزمنية الفعلية لسير العمل، لذلك يعني 0 6 * * * الساعة 06:00 في تلك المنطقة، وليس الساعة 06:00 بالتوقيت العالمي UTC. يمكن لصق تعبير مكوّن من خمسة حقول من crontab guru كما هو. يقبل n8n أيضاً حقلاً اختيارياً للثواني، ويضعه جدول الحقول في وثائقه أولاً: الثانية، الدقيقة، الساعة، يوم الشهر، الشهر، يوم الأسبوع.
اعتباراً من n8n 2.45.0، يقيس المجدول الدائم الافتراضي فواصل Seconds وMinutes ابتداءً من وقت نشر سير العمل، وليس من حدود الساعة. يحافظ Custom (Cron) على توقيته المعتمد على الساعة. احفظ سير العمل وانشره لكي تعمل Schedule Trigger.
لا تُشفّر فرق التوقيت يدوياً. إن كتابة 0 4 * * * على مثيل يستخدم UTC للوصول إلى الساعة 06:00 في برلين تكون صحيحة في الصيف، لكنها تسبق الموعد بساعة طوال الشتاء، لأن برلين تعمل بتوقيت UTC+2 في الصيف وUTC+1 في الشتاء. من آخر أحد في مارس إلى آخر أحد في أكتوبر، يُشغّل ذلك التعبير العملية عند الساعة 06:00 بتوقيت برلين، أما بقية العام فيُشغّلها عند الساعة 05:00، ولا يصل إلى الساعة 06:00 حينها إلا 0 5 * * *. حدّد المنطقة الزمنية واكتب الساعة المحلية التي تقصدها فعلياً.
ما الذي يفعله التوقيت الصيفي بمهمة مضبوطة على 02:30
لا يضمن الوقت المحلي على الساعة وقوعاً زمنياً محدداً. في برلين، تختفي ساعة واحدة وتتكرر ساعة واحدة مرتين كل عام، وتتأثر أي مهمة مجدولة خلال هاتين الساعتين. يمكنك توضيح الساعة المفقودة باستخدام GNU date على Linux، من دون استخدام n8n.
LC_ALL=C TZ=Europe/Berlin date -d '2027-03-28 02:30'date: invalid date '2027-03-28 02:30'هذا ليس خطأ مطبعياً في الأمر. في 2027-03-28 تنتقل ساعة برلين مباشرة من 02:00 إلى 03:00، ولذلك لا يوجد الوقت المحلي 02:30 في ذلك اليوم، ويرفض GNU date تحويله إلى وقوع زمني محدد. لا يجري BusyBox date فحص الرفض نفسه؛ إذ يمرر الوقت إلى mktime ويقبل النتيجة المطبّعة إذا نجح التحويل. يعمل المجدول الدائم الحالي في n8n على تقديم وقت cron المحلي غير الموجود بدلاً من تخطيه. أما الوقتان المجاوران فصحيحان: يحل date -d '2027-03-28 01:30' وفق CET، ويحل date -d '2027-03-28 03:30' وفق CEST.
يحدث الانتقال الخريفي بالعكس. في 2027-10-31 تتراجع ساعة برلين من 03:00 إلى 02:00، ولذلك يتكرر الوقت 02:30 مرتين.
LC_ALL=C TZ=Europe/Berlin date -d '2027-10-31 02:30 CEST' '+%s'
LC_ALL=C TZ=Europe/Berlin date -d '2027-10-31 02:30 CET' '+%s'1824942600
1824946200هذان وقوعان زمنيان مختلفان، وكلاهما يسمى 02:30 بالتوقيت المحلي، ويفصل بينهما 3600 ثانية. يشغّل المجدول الدائم الحالي في n8n وقت cron المحلي المتكرر مرة واحدة. انقل الجدول خارج هذه الفترة. في معظم المناطق الأوروبية وأمريكا الشمالية، تمتد الفترة الخطرة من 00:00 إلى 03:00 بالتوقيت المحلي.
جدولة البنية التحتية وفق UTC وعرض التوقيت المحلي للمستخدمين
تفصل القاعدة العامة بين وظيفتين للمنطقة الزمنية. تحتاج الآلات إلى فترة زمنية ثابتة. ويحتاج الأشخاص إلى ساعة مقروءة.
- بالنسبة إلى المهام التي لا يراقبها أحد، اضبط المنطقة الزمنية لسير العمل على UTC. تندرج النسخ الاحتياطية، وتسخين ذاكرة التخزين المؤقت، وشحن السجلات، وإنشاء التقارير ضمن هذه الفئة. يزيل UTC تغييرات التوقيت الصيفي من الجدول؛ لكن الجداول التقويمية، مثل عمليات التشغيل الشهرية، ما زالت تنتج فواصل زمنية غير متساوية.
- بالنسبة إلى المهام التي يقرأ نتائجها شخص، احتفظ بالجدول وفق UTC وحوّل التوقيت عند عرضه. ينجز تعبير واحد ذلك: يضع
{{ $now.setZone('Europe/Berlin').toFormat('yyyy-MM-dd HH:mm') }}التوقيت المحلي في نص الرسالة، بينما يظل المشغّل ثابتاً.
ينطبق الفصل نفسه خارج n8n. عندما يعمل جزء من التشغيل الآلي لديك على شكل خدمة ومؤقت في systemd على VPS، يستخدم سطر OnCalendar المنطقة الزمنية للنظام ما لم يحدّد التعبير منطقة أخرى. إبقاء كل أدوات الجدولة على UTC يترك لك قاعدة واحدة تتذكرها بدلاً من أربع قواعد. وهذا مهم أيضاً لأي شيء يلخّص فترة زمنية، لأن سير عمل وكيل ذكاء اصطناعي في n8n يطلب أرقام الأمس سيستخدم بهدوء يوماً تقويمياً مختلفاً، تبعاً للمنطقة الزمنية التي حُدّدت بها القيم.
أوضاع الفشل والمخرجات التي ستراها
يحدث كل شيء بفارق ست ساعات تقريباً. إذا لم تُضبط المنطقة الزمنية لسير عمل أو للمثيل، فسيُطبَّق الإعداد الافتراضي المضمّن America/New_York. لا يعرض docker compose exec n8n printenv GENERIC_TIMEZONE شيئاً عندما يكون متغير البيئة هذا غير مضبوط. اضبطه، ثم أعد إنشاء الحاوية.
عدّلت ملف Compose ولم يتغير شيء. شغّلت docker compose restart، ولذلك احتفظت الحاوية ببيئة التشغيل الأصلية. شغّل docker compose up -d، ثم تحقّق باستخدام docker compose exec n8n printenv TZ.
المشغّل صحيح والطوابع الزمنية خاطئة. تحقّق من التنسيق: يستخدم $now المنطقة الزمنية لسير العمل، بينما يستخدم new Date().toString() المنطقة الزمنية للنظام التي يعتمدها وقت تشغيل JavaScript. اضبط TZ لوقت التشغيل هذا، ثم أعد إنشاء حاويته إذا أردت أن يتطابق التنسيق المحلي.
يتجاهل أحد أساليب سير العمل إعداد المثيل. يحتوي سير العمل هذا على منطقته الزمنية الخاصة في إعداداته، وهي تتغلب على GENERIC_TIMEZONE. افتح اللوحة، ثم انقر على النقاط الثلاث، واختر Settings ثم Timezone.
نُفِّذت مهمة يومية في ساعة محلية مختلفة عند تغيّر الساعة. تقع الساعة المجدولة ضمن فترة انتقال التوقيت الصيفي. يقدّم المجدول الحالي أوقات cron المحلية غير الموجودة إلى الأمام، وينفّذ الأوقات المتكررة مرة واحدة. انقل الساعة، أو انقل سير العمل إلى UTC.
FAQ
لماذا يُشغّل مشغّل الجدولة في n8n سير العمل في ساعة خاطئة؟
يحلّ سير العمل منطقة زمنية تختلف عن المنطقة التي تفترضها. يختار n8n المنطقة الزمنية لسير العمل إذا كانت محددة، وإلا يستخدم المنطقة الزمنية للمثيل من GENERIC_TIMEZONE، وإلا يستخدم الإعداد الافتراضي المضمّن في America/New_York. إذا لم تُضبط منطقة زمنية لسير العمل أو للمثيل في مثيل مستضاف ذاتياً، فستُجدول المهام وفق توقيت New York لا وفق UTC. لذلك نادراً ما يطابق الفارق بُعد منطقتك عن UTC. شغّل docker compose exec n8n printenv GENERIC_TIMEZONE. يعني عدم ظهور أي ناتج أن متغير البيئة غير مضبوط؛ وتحقق أيضاً من المنطقة الزمنية لسير العمل.
ما الفرق بين TZ و GENERIC_TIMEZONE في n8n؟
يمثل TZ المنطقة الزمنية لنظام التشغيل داخل الحاوية. ويتحكم في القيمة التي يعرضها date داخل الحاوية، وفي المنطقة الزمنية التي تستخدمها تنسيقات التاريخ المحلي والبرامج النصية. أما GENERIC_TIMEZONE فهي المنطقة الزمنية لمثيل n8n، وتستخدمها عقد الجدولة وتعبيرات Luxon مثل $now ما لم تتجاوزها منطقة زمنية محددة لسير العمل. يمكن لمنطقة زمنية لسير العمل وحدها تصحيح Schedule Trigger بالكامل. اضبط متغيري البيئة على القيمة نفسها عندما تريد أيضاً أن تتطابق تنسيقات وقت النظام مع الإعداد الافتراضي للمثيل.
هل ينبغي أن أضبط المنطقة الزمنية لسير العمل أم GENERIC_TIMEZONE؟
اضبط GENERIC_TIMEZONE كإعداد افتراضي للمثيل بأكمله، واستخدم إعداد كل سير عمل فقط عندما ينتمي سير عمل فعلاً إلى منطقة زمنية أخرى. تتغلب قيمة سير العمل على قيمة المثيل، ولا تتبع التغييرات اللاحقة في GENERIC_TIMEZONE. لذلك يصعب اكتشاف تجاوز محدد لسير عمل بعد مرور أشهر إذا نُسي.
ماذا يحدث لمهمة مجدولة عند 02:30 عندما تتغير الساعات؟
يختفي ذلك الوقت المحلي أو يحدث مرتين. مع GNU date، يعرض LC_ALL=C TZ=Europe/Berlin date -d '2027-03-28 02:30' القيمة date: invalid date '2027-03-28 02:30'، لأن ساعة Berlin تقفز في ذلك اليوم من 02:00 إلى 03:00. يقبل BusyBox date التطبيع إذا نجح mktime، لذلك لا يحدث هذا الخطأ في جميع أنظمة Linux. في 2027-10-31، تشير قراءة الساعة المحلية نفسها إلى لحظتين تفصل بينهما ساعة واحدة. ينقل مجدول n8n الدائم حالياً أوقات cron المحلية غير الموجودة إلى الأمام، ويشغّل الأوقات المتكررة مرة واحدة. أبقِ المهام المجدولة خارج الفترة المحلية من 00:00 إلى 03:00، أو اضبط سير العمل على UTC وحوّل الوقت إلى التوقيت المحلي فقط عند عرضه على شخص.