حل المشاكل
الفحوصات الأولى
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.