استكشاف الأخطاء

معظم مشكلات الإعداد تعود إلى DNS، أو جدار الحماية السحابي، أو حجب المنفذ 25 الصادر. إليك كيفية التعرّف على كلٍّ منها وإصلاحه.

اللوحة لا تُفتَح على نطاقي

• http://server-IP/ يعمل لكن النطاق لا — DNS لا يُحلّ بعد. افحص panel.yourdomain.com في dnschecker.org (اكتب A). إن كان فارغًا، فسجلات DNS أو خوادم أسمائك غير مضبوطة — راجع وجِّه نطاقك.
• النطاق لا خوادم أسماء له إطلاقًا — توكيل المُسجِّل غير منشور، أو ضبطت سجلات لدى مضيف DNS غير مرجعي. تحقّق من NS في dnschecker.org (اكتب NS)؛ إن كان فارغًا أو خاطئًا، أصلِح خوادم الأسماء لدى مُسجِّلك، أو انقل إلى Cloudflare.
• خوادم الأسماء تشير إلى مكان ما، لكنه لا يزال لا يُحلّ ("REFUSED") — مضيف DNS لا يُقدّم المنطقة فعليًا. فعّل إدارة DNS هناك، أو انقل النطاق إلى Cloudflare (يُقدّم المنطقة دائمًا بمجرد إضافتها).

HTTPS غير نشط (القفل مفقود)

يُفعَّل HTTPS تلقائيًا خلال ~5 دقائق بمجرد أن يشير panel.yourdomain.com إلى الخادم. إن لم يُفعَّل:

• تأكّد من أن سجل A يُحلّ إلى عنوان IP الصحيح (dnschecker.org).
• تأكّد من أن المنفذين 80 و 443 مفتوحان في جدار الحماية السحابي لديك.
• إن كنت تستخدم Cloudflare، فاضبط سجل panel على DNS only (grey cloud)، لا مُوكَّلًا.
• لفرضه الآن: ادخل بـ SSH كـ root وشغّل sudo nimbopanel-enable-https.

العملاء لا يستطيعون إرسال البريد / البريد الصادر يرتد أو تنتهي مهلته

افتح النظام ← البريد الصادر قبل افتراض أي شيء. تقيس البطاقة ما إذا كان هذا الخادم يستطيع الوصول إلى الإنترنت على المنفذ 25 وتقول ذلك بوضوح. إن أبلغت أن المنفذ محجوب، فأعِدّ مُرحِّلًا من النموذج على البطاقة نفسها — راجع إمكانية تسليم البريد وإرساله. المُرحِّل العامل يُظهر status=sent في سجل البريد.

إن قالت البطاقة إن المنفذ 25 مفتوح، فالحجب ليس مشكلتك والسبب في مكان آخر: افحص رسالة ارتداد المستلِم، وافحص SPF/DKIM/DMARC أدناه.

البريد يُرسَل، لكنه يحطّ في المزعج

الرسالة ليست مُوثَّقة بالكامل. تحقّق من أن الثلاثة كلها منشورة وناجحة للنطاق المُرسِل:

• SPF يتضمّن مُرحِّلك (مثل include:spf.brevo.com).
• DKIM — النطاق مُتحقَّق منه في مُرحِّلك وسجلات DKIM الخاصة به في DNS لديك.
• DMARC — سجل v=DMARC1; p=none; … موجود (يضيف Nimbopanel واحدًا لكل نطاق).

البريد الوارد لا يصل أبدًا

• تأكّد من أن سجل MX للنطاق يشير إلى mail.yourdomain.com وأن mail.yourdomain.com يُحلّ إلى خادمك.
• تأكّد من أن المنفذ الوارد 25 مفتوح في جدار الحماية السحابي (الوارد 25 نادرًا ما يُحجَب — الصادر فقط).

صفحة أداة (بريد الويب، phpMyAdmin) تُظهر خطأ أو لا تُحمَّل

• phpMyAdmin يُعيد 401 دون جلسة لوحة — هذا متوقّع؛ افتحه من داخل اللوحة (تسجيل دخول موحّد).
• لا تظهر أي بلاطة في لوحة العميل — إنهما لـ Debian/Ubuntu فقط. على AlmaLinux و Rocky و RHEL تخفي اللوحة كليهما بدلًا من إرسال عميل إلى صفحة غير موجودة. هذا بالتصميم، لا عطل.
• بريد الويب / موقع يُعيد 502 — قد تكون خدمة PHP أُعيد تشغيلها. افحص الخدمات بـ systemctl status. إن استمر بعد لحظة، فأعِد تشغيل المُحدِّث (sudo nimbopanel update) لإعادة تطبيق الإعداد المُدار.

مشكلات موقع عميل

• قاعدة في .htaccess لا تفعل شيئًا. الموقع في الوضع المُترجَم. إما اضغط ترجمة الآن في النطاقات ← Apache / ‏.htaccess، أو فعّل دعم .htaccess كامل. يُدرِج الجدول في تلك الصفحة بالضبط أيّ التوجيهات تُتخطّى. راجع ‏.htaccess — الوضعان.
• تُعيد كل صفحة 500 مباشرةً بعد التبديل إلى دعم .htaccess كامل. يفتقد Apache وحدة يحتاجها الملف — mod_rewrite هي المعتادة، وهي مُطفأة افتراضيًا على Debian و Ubuntu. أعِد تشغيل المُثبِّت (sudo nimbopanel update)، الذي يفعّل الوحدات المطلوبة؛ بدّل الحساب رجوعًا في الأثناء.
• تُعيد كل صفحة 502 على حساب في وضع .htaccess كامل، بينما المواقع الأخرى بخير. Apache لا يعمل: systemctl status apache2 (Debian/Ubuntu) أو httpd (عائلة RHEL).
• الموقع يُعيد 404 أو يُظهر مجلدًا فارغًا بعد تغيير جذر المستند. يُنشَر المجلد بالضبط كما كُتب ويُنشأ إن لم يكن موجودًا، فالمطبعة تُنتِج مجلدًا فارغًا لا خطأً. اقرأ القيمة في صف النطاق وصحّحها. راجع النشر من مجلد غير public_html.
• ملف .env أو ملف إعداد لموقع قابل للتنزيل. جذر المستند فوقه. انقل جذر المستند إلى مجلد public للتطبيق؛ يجب أن يُجيب curl -sI https://domain/.env بـ 403.

كل المواقع توقّفت دفعة واحدة

إن توقّفت كل المواقع في اللحظة نفسها، فعادةً php-fpm لا يعمل. افحص بـ systemctl status php*-fpm. إن رفض البدء بـ Address already in use بينما لا عملية php-fpm حيّة، فقد تُرك ملف مقبس قديم خلفه بعملية ماتت فجأة — إصدارات Nimbopanel الحالية تنظّفها بنفسها قبل البدء.

أين تنظر

• سجلات اللوحة + الخدمة تعيش في سجل systemd: journalctl -u nimbopanel -n 50.
• نتائج تسليم البريد: journalctl -t postfix/smtp --since -10min (ابحث عن status=sent / status=bounced).
• سجل التثبيت في /var/log/nimbopanel-install.log.

لا تزال عالقًا؟ دوِّن العرض الدقيق وسطر السجل ذا الصلة — عادةً يكفي ذلك لتحديده بسرعة.