Skip to content

حل المشاكل ​

الفحوصات الأولى ​

bash
systemctl status hostpanel hostagent --no-pager
journalctl -u hostpanel -u hostagent -n 150 --no-pager

إذا تعطل شيء بعد تعديل يدوي، فإن «الإعدادات» ← «التحديثات» ← «إصلاح» يعيد تثبيت النسخة الحالية ويعيد الملفات والخدمات. راجع الإصلاح.

اللوحة ​

المشكلةالحل
الصفحة لا تفتحتأكد أن البورت 8443 مفتوح في جدار مزوّد الخدمة وأن hostpanel يعمل.
تحذير الشهادة في المتصفحطبيعي مع الشهادة الذاتية. أعطِ اللوحة دوميناً وشهادة حقيقية: SSL.
«الوكيل لا يعمل، فلا تستطيع اللوحة تغيير شيء»sudo systemctl restart hostagent، ثم راجع journalctl -u hostagent.
«انتهت صلاحية النموذج أو جاء من موقع آخر»حدّث الصفحة وحاول مجدداً، واخرج وادخل إن تكرر.
«محاولات فاشلة كثيرة»انتظر المدة الظاهرة، أو ادخل من عنوان أدمن.
نسيت كلمة السرsudo merp reset-admin --username NAME على السيرفر.
ضاع هاتف التحقق بخطوتيناستخدم رمز استرجاع، أو sudo merp reset-2fa NAME.
انقطعت بسبب الجدار الناري أو قاعدة الدولمن كونسول المزوّد: sudo /opt/hostpanel/bin/hostagent firewall-reset
«وضع الطوارئ مُفعّل»ينهيه المدير من حماية السيرفر، أو sudo /opt/hostpanel/bin/hostagent safe-mode off.
«دورك لا يسمح بهذا»اطلب من المدير تغيير دورك أو إعطاءك الموقع.

المواقع ​

المشكلةالحل
شارة DNS: لا يوجد سجل، أو يشير لمكان آخرأضف أو صحّح سجل A لدى مزوّد DNS إلى IP السيرفر.
502 Bad Gateway في موقع تطبيقلا شيء يعمل على بورت التطبيق. شغّل تطبيقك أو غيّر نوع الموقع.
«الموقع يستخدم PHP X وهو غير مثبّت»ثبّت الإصدار من المتجر، أو اختر غيره في صفحة الموقع.
403 أو صفحة بيضاء في موقع React/Vueيجب أن يشير مجلد الموقع إلى البناء (public_html/dist) وأن يحتوي index.html.
404 عند تحديث صفحة في تطبيق صفحة واحدةاستخدم نوع «تطبيق React / Vue» لا «ملفات ثابتة».
«المجلد غير موجود في الموقع بعد»أنشئه من مدير الملفات ثم اضبط مجلد الموقع.
الملف المرفوع كبيرارفع «أقصى حجم رفع» في صفحة الموقع، وحد الرفع في إصدار PHP إن لزم. الأصغر هو الذي يسري.
ووردبريس لا يستطيع تحديث الإضافاتتأكد أن «الاتصالات الطالعة» في حماية السيرفر ليست «القائمة بس» لهذا الموقع.
إضافة تحتاج execفعّل «اسمح لـ PHP يشغّل برامج» في صفحة الموقع (للمدير).

SSL ​

المشكلةالحل
«اضبط إيميل Let's Encrypt أولاً»اكتبه في صفحة SSL.
فشل طلب الشهادةيجب أن يشير الدومين إلى السيرفر وأن يكون البورت 80 مفتوحاً. انتظر بضع دقائق بعد تعديل DNS.
Too many redirects خلف Cloudflareيجب ضبط SSL في Cloudflare على Full (strict). راجع Cloudflare.
خطأ 526 خلف Cloudflareالموقع يحتاج شهادة صالحة (Let's Encrypt أو Origin).
دومين إضافي خارج الشهادةأصلح DNS الخاص به ثم اضغط «تحديث الشهادة».

سيرفر الويب وقواعد البيانات ​

المشكلةالحل
«رفض سيرفر الويب التغيير فلم يتغير شيء»في تعديلك خطأ، والرسالة تذكر السطر. الإعدادات القديمة ما زالت تعمل.
تفعيل WAF يفشل برسالة "unicode map file"أُصلح في 1.4.4، حدّث اللوحة.
قاعدة WAF تحجب استخداماً عادياًأطفئ القاعدة من «الزيارات»، أو أعد WAF إلى «مراقبة بس».
«سيرفر قواعد البيانات لا يعمل»قواعد البيانات ← الخدمة ← تشغيل، واقرأ السجل.
«MariaDB/MySQL غير مثبّت»ثبّته من المتجر.
تطبيقك لا يتصل بالقاعدةاستخدم المضيف localhost ومستخدم القاعدة وكلمة سرها، وأعد تعيينها إن ضاعت.

البريد ​

المشكلةالحل
البريد إلى Gmail/Outlook لا يصلغالباً البورت 25 الصادر محجوب. اطلب فتحه من المزوّد أو استخدم SMTP relay.
البريد يذهب إلى المزعجأضف كل سجلات DNS (SPF و DKIM و DMARC) واضبط DNS العكسي (PTR) على اسم سيرفر البريد.
برامج البريد تحذّر من الشهادةخذ شهادة لاسم سيرفر البريد من صفحة البريد.

طلب المساعدة ​

أرسل صورة للصفحة ونتيجة الأمر:

bash
journalctl -u hostpanel -u hostagent -n 150 --no-pager

ولمشاكل الجدار الناري أضف sudo nft list ruleset | head -80.

دليل SetServer Panel