عندما يُبلغ Zimbra عن "توقف خدمة Nginx Proxy"، فهذا يعني أن عملية البروكسي متوقفة أو أن فحص حالتها لا يُؤكد تشغيلها. يُمكن إعادة تشغيلها لاستعادة الوصول إذا كان التوقف مؤقتًا، ولكن قد تظهر الرسالة نفسها إذا لم يتمكن NGINX من تحميل إعداداته المُولّدة، أو ربط منفذ مطلوب، أو قراءة شهادة، أو الوصول إلى خادم مصدر صالح. والنتيجة المُفيدة ليست مجرد ظهور الحالة باللون الأخضر: يجب أن يستمر البروكسي في العمل، ويجب تحميل بريد Zimbra الإلكتروني عبر عنوان URL العام المقصود، ويجب ألا تُظهر سجلات البروكسي فشل بدء التشغيل.
ينطبق هذا الدليل على عمليات نشر Zimbra التي تستخدم خدمة Zimbra Proxy المدمجة. قد تختلف الأوامر الدقيقة وتفاصيل التكوين باختلاف إصدار Zimbra وبنيته. في حالة التثبيت على عدة خوادم، قم بإجراء فحوصات على عقدة الوكيل، ولا تقم بتفعيل الوكيل على عقدة صندوق البريد أو خادم نقل البريد (MTA) لمجرد أن خادمًا آخر أبلغ عن توقفه. يصف دليل Zimbra Proxy ومرجع واجهة سطر الأوامر (CLI) للوكيل الخدمة وملفات التشخيص الخاصة بها. بعض صفحات استكشاف الأخطاء وإصلاحها في مركز الدعم الفني مُصنّفة على أنها قيد التطوير، لذا استخدمها جنبًا إلى جنب مع وثائق الإصدار المُثبّت لديك.
1. تأكد من أن الخادم الوكيل مُفترض أن يعمل على هذا الخادم
اتصل بخادم Zimbra الذي يستضيف الخادم الوكيل، ثم انتقل إلى حساب Zimbra. تحقق من قائمة الخدمات العامة وحالة الخادم الوكيل تحديدًا.
su - zimbra
zmcontrol status
zmproxyctl status
zmprov gs `zmhostname` zimbraServiceEnabled
ابحث عن proxyالخدمات المُفعّلة وعن عملية NGINX قيد التشغيل في مخرجات الحالة. تُوثّق Zimbra الإجراءات zmproxyctlباستخدام startو stopو restartو reloadو و status. إذا كان هذا المضيف عبارة عن عقدة بريد فقط أو خادم نقل بريد فقط، فقد يكون الخادم الوكيل متوقفًا. تأكد من دور الخادم في بيئة النشر قبل محاولة تشغيله.
إذا كان من المفترض أن يكون الخادم الوكيل نشطًا وكانت حالته متوقفة، فقم بتسجيل الحالة الحالية قبل إجراء أي تغيير. يساعد هذا في التمييز بين إعادة التشغيل الفاشلة والخدمة التي لم يتم تفعيلها على العقدة.
2. اقرأ سجل أخطاء NGINX قبل إعادة التشغيل
/opt/zimbra/log/nginx.logيُحدد دليل استكشاف أخطاء بروكسي Zimbra /opt/zimbra/log/nginx.access.logملفات سجلات البروكسي الرئيسية. تحقق من إدخالات الأخطاء الأخيرة وما إذا كان ملف التكوين الرئيسي موجودًا.
tail -n 100 /opt/zimbra/log/nginx.log
tail -n 50 /opt/zimbra/log/nginx.access.log
ls -l /opt/zimbra/conf/nginx.conf
يشير نص الخطأ عادةً إلى الفحص التالي. nginx.confيشير غياب عنصر ما إلى ضرورة مراجعة التكوين المُنشأ. يشير "منفذ غير صالح" في listenالتوجيه إلى منفذ أو إعداد ربط. يشير خطأ المفتاح الخاص أو الشهادة إلى مواد SSL. يشير فشل الربط إلى أن عملية أخرى قد تكون تمتلك العنوان والمنفذ بالفعل.
لا تقم بحذف ملفات تهيئة NGINX أو تعديل الملفات المُنشأة لإخفاء الخطأ. تُنشئ Zimbra تهيئة NGINX الخاصة بها من قوالب وقيم مُخزّنة في دليل التهيئة وLDAP. يشرح دليل تهيئة الوكيل والقوالب الخاص بالمورّد نموذج الإنشاء هذا. قد تُستبدل التعديلات اليدوية على الملفات المُنشأة أثناء إعادة التشغيل أو تحديث التهيئة لاحقًا.
3. جرّب إعادة تشغيل الخادم الوكيل المدعوم وتحقق من النتيجة
إذا لم تُشر السجلات إلى وجود خطأ مستمر في التكوين أو الشهادة، فأعد تشغيل الخدمة من خلال وحدة تحكم Zimbra بصفتك مستخدم Zimbra:
zmproxyctl restart
zmproxyctl status
ثم تحقق من قائمة الخدمات الكاملة مرة أخرى:
zmcontrol status
النتيجة الناجحة هي أن يُبلغ الخادم الوكيل عن تشغيله ويستمر في العمل بعد اكتمال الأمر. تُوضح وثائق خادم Zimbra الوكيل zmproxyctl restartأن هذه العملية هي التي تستدعي أيضًا إنشاء التكوين. تجنب استخدام خادم وكيل systemctl restart nginxعلى مستوى النظام كبديل: إذ تُدير Zimbra تكوين الخادم الوكيل وخدمته بنفسها. إذا فشلت إعادة التشغيل، فارجع إلى أحدث خطأ في سجل الأخطاء nginx.log؛ فإعادة التشغيل المتكررة دون قراءة الخطأ عادةً لا تُصلح السبب.
4. قم بمطابقة الخطأ مع الإصلاح المستهدف
في حالة فقدان ملف التكوين أو فشل عملية الإنشاء
توضح ملاحظة استكشاف الأخطاء وإصلاحها الخاصة بـ Zimbra لحالة فقدان أحد العناصر، /opt/zimbra/conf/nginx.confالحالات التي يفشل فيها إنشاء تكوين الوكيل بسبب احتواء سمة المصدر على خادم غير موجود أو خادم ليس خادم علب بريد. تحقق أولاً من القيم ذات الصلة على مستوى الخادم والقيم العامة.
zmprov -l gs `zmhostname` zimbraReverseProxyAvailableLookupTargets
zmprov -l gs `zmhostname` zimbraReverseProxyUpstreamEwsServers
zmprov -l gs `zmhostname` zimbraReverseProxyUpstreamLoginServers
zmprov -l gcf zimbraReverseProxyAvailableLookupTargets
zmprov -l gcf zimbraReverseProxyUpstreamEwsServers
zmprov -l gcf zimbraReverseProxyUpstreamLoginServers
قارن كل اسم مضيف مع قائمة الخوادم الفعلية وتصميم التوجيه المُعتمد. صحّح الإدخالات القديمة أو غير الصالحة فقط بعد التأكد من الخادم المُخصّص لاستقبال حركة البيانات. لا تنسخ اسم مضيف نموذجي من صفحة المورّد إلى بيئة الإنتاج. توضح ملاحظة استكشاف الأخطاء وإصلاحها الرسمية "فشل بدء تشغيل Nginx" أمر مُولّد التكوين لنمط خطأ التكوين المفقود/المولد المحدد.
/opt/zimbra/libexec/zmproxyconfgen -s `zmhostname`
zmproxyctl restart
استخدم هذا الخيار فقط عندما يتطابق الخطأ الملاحظ مع هذا النمط وبعد مراجعة القيم ذات الصلة. إذا استمر المُولِّد في إظهار استثناء أو ظل الملف مفقودًا، فتوقف وتحقق من تتبع المكدس الكامل وخصائص الخادم بدلاً من إعادة تشغيله بشكل متكرر.
إذا سجل النظام وجود منفذ غير صالح أو فشل في الربط
حدد أولًا المستمع المُكوّن الذي يُعاني من عطل. تحقق من قيم منافذ خدمة Zimbra والوكيل لهذه العقدة، ثم افحص ما إذا كانت عملية أخرى تستمع بالفعل على العنوان المتأثر. على سبيل المثال، إذا أشارت الرسالة إلى المنفذ 443، فتحقق مما إذا كان مستمع HTTPS العام مملوكًا لـ Zimbra NGINX أو لخادم ويب منفصل أو وكيل موازنة أحمال. لا تُنهِ عملية غير معروفة أو تُعيّن منفذًا جديدًا حتى تفهم كيفية وصول العملاء إلى الخدمة.
لا يُعدّ ظهور خطأ كهذا invalid port ...:0سببًا لتخمين رقم المنفذ. فقد يشير إلى إعدادات غير متناسقة للوكيل أو التكوين المُنشأ. قارن القيمة مع البنية المتوقعة، وراجع التغييرات الأخيرة، وصحّح إعدادات المصدر باستخدام الأدوات المدعومة من Zimbra. ثم أعد التشغيل zmproxyctlوتأكد من صحة المُستمع المُنشأ.
إذا فشل بدء التشغيل أثناء تحميل الشهادة أو المفتاح الخاص
اقرأ رسالة خطأ SSL كاملةً وحدد مسار الشهادة المذكور فيها. تأكد من أن الشهادة والمفتاح الخاص مرتبطان ببعضهما، وأن حساب الخدمة المتوقع قادر على قراءتهما، وأن صلاحيتهما لم تنتهِ. تتضمن وثائق استكشاف أخطاء خادم Zimbra الوكيل حالةً يتعذر فيها على الخادم الوكيل تحميل بيانات المفتاح. اتبع إجراءات نشر الشهادة الخاصة بإصدار Zimbra لديك بدلاً من استبدال الملفات عشوائياً. من المفترض أن تؤدي إعادة التشغيل الناجحة إلى إزالة خطأ بدء تشغيل SSL، وأن يعرض المتصفح الشهادة المتوقعة لاسم مضيف البريد الإلكتروني العام.
إذا بدأ NGINX ولكن المستخدمين يرون أخطاء في البوابة
لا يُعدّ تشغيل خادم وكيل دليلاً قاطعاً على سلامة خوادم البريد. في حالة ظهور رسالة "لا يوجد مسار إلى المضيف"، توصي Zimbra بالتحقق من تحليل نظام أسماء النطاقات (DNS) من عقدة الوكيل، ومن إمكانية الوصول إلى الخادم المقصود عبر المنفذ. أما في حالة ظهور خطأ 502 أو 503، فيُرجى التحقق من خدمة البريد والمضيف والمنفذ الرئيسيين؛ إذ يُشير دليل الوكيل إلى أن عدم توفر عملية البريد قد يتسبب في ظهور خطأ 503. استخدم الخادم والمنفذ المُطابقين لإصدارك وبنيتك، وتحقق من سجلات خادم البريد قبل تغيير مهلة الوكيل أو عتبات الفشل.
5. تحقق من استعادة البيانات من كل من الخادم والمتصفح
بعد إجراء الإصلاح المحدد، تأكد من كل ما يلي:
zmproxyctl statusيُبلغ عن تشغيل الخادم الوكيل.
zmcontrol statusيعرض الخدمات المتوقعة لهذه العقدة.
/opt/zimbra/log/nginx.logلا تكرر الأسطر الأخيرة نفس فشل بدء التشغيل.
- المستمع المتوقع موجود ومملوك للخدمة المقصودة. في نظام لينكس، يمكن للمسؤول فحص المستمعين باستخدام الأمر
ss -ltnp`ls`؛ وتختلف الأذونات وتفاصيل الإخراج باختلاف التوزيعة.
- يمكن للمتصفح الوصول إلى اسم مضيف بريد Zimbra الإلكتروني العادي عبر بروتوكول HTTPS، وتسجيل الدخول، وتحميل صندوق البريد. إذا كانت برامج IMAP أو POP تستخدم هذا الخادم الوكيل أيضًا، فاختبر هذه البروتوكولات بشكل منفصل.
تُحدد هذه الفحوصات عملية استعادة فعّالة: الخدمة تعمل، والمستمع موجود، ومسار المتصفح يعمل، ولم يعُد العطل فورًا. إذا كانت حالة الخدمة جيدة ولكن البريد الإلكتروني لا يزال معطلاً، فانتقل إلى فحص نظام أسماء النطاقات (DNS)، وبروتوكول أمان طبقة النقل (TLS)، وقواعد جدار الحماية، وتوجيه موازن الأحمال، أو سلامة خادم البريد. إذا توقفت الخدمة مرة أخرى، فاحتفظ بسجلات النظام الجديدة ومخرجات مُولِّد التكوين؛ فهي أكثر فائدة من إعادة تشغيل عشوائية.
استخدم تسجيل التصحيح فقط لإجراء تحقيق قصير ومضبوط
إذا لم تُفسّر السجلات العادية عطلاً مستمراً، تُوثّق Zimbra زيادة مؤقتة لمستوى سجلات خادم NGINX الوكيل. قد يكشف تسجيل التصحيح معلومات حساسة، بما في ذلك رموز المصادقة، لذا تجنّب تفعيله على نظام الإنتاج إلا عند الضرورة. إذا أوصى فريق الدعم باستخدامه، فقيّد الوصول إلى السجلات، واجمع البيانات المطلوبة فقط، ثم أعد الإعداد إلى قيمته السابقة، وتعامل مع سجلات التصحيح وفقاً لسياسة الأمان الخاصة بك. راجع تعليمات Zimbra لتسجيل تصحيح NGINX لمعرفة الأمر المناسب للإصدار.
في حال استمرار فشل إنشاء التكوين، أو تعذر التحقق من صحة شهادة الوكيل، أو إذا كان الخطأ يشير إلى مستمع غير معروف، أو إذا كان دور العقدة غير واضح، يُرجى تصعيد المشكلة إلى مسؤول Zimbra أو دعم المورّد. يمكن لوحدة تحكم الخدمة إعادة تشغيل التكوين السليم، ولكنها لا تستطيع تحديد مسار البريد الصحيح، أو إصلاح شهادة غير صالحة، أو حل مشكلة مسار الشبكة المعطوب تلقائيًا.
المراجع الرسمية
تمت مراجعة المصادر في 6 أكتوبر 2026. تتضمن صفحات مركز زيمبرا التقني المشار إليها هنا أمثلة قديمة وبعضها مصنف على أنها أعمال قيد التقدم؛ تأكد من الأوامر مقابل إصدار زيمبرا المثبت على خادمك قبل تغيير تكوين الإنتاج.