إنتقل إلى المحتوى الرئيسي

استكشاف أخطاء التثبيت

يتحقق المثبّت من كل خطوة ويعرض سطرًا لكل تحقق:

PASS  NET-01  ims.my-company.ma resolves to this server
WARN  PRE-06  the clock is not NTP-synchronized
FAIL  KC-01   the authentication service advertises another address

لـالمعرّف (NET-01، KC-01…) المعنى نفسه في كل مكان، وهو ما يجب ذكره في أي طلب دعم. يقدّم ملف TROUBLESHOOTING.md في الحزمة، لكل معرّف، السبب المفصّل وأوامر التصحيح؛ وتقدّم هذه الصفحة معناه وأول إجراء.

تشغيل التشخيص​

لا يغيّر التشخيص شيئًا ويمكن تشغيله في بيئة الإنتاج. يُجري كل التحققات دون التوقف عند الخطأ الأول، وينتهي بالرمز 0 إن كان كل شيء سليمًا و1 خلاف ذلك، لذا يمكن جدولته.

./install.sh --doctor

شغّله بعد إعادة تشغيل الخادم أو تحديث أو تجديد شهادة، أو عندما يبدو شيء غير طبيعي.

قواعد تتجنّب معظم الأعطال​

  • لا تعدّل يدويًا القيم المستنتَجة في الإعدادات (عناوين المصادقة، الأصول المسموح بها). غيّر اسم المضيف أو البروتوكول بإعادة تشغيل المثبّت: فهو يعيد كتابة كل ما يعتمد عليهما.
  • لا تغيّر أبدًا كلمات مرور قواعد البيانات في .env.
  • شغّل الأوامر دائمًا من مجلد التثبيت.

PRE · المتطلبات​

المعرّفما يُتحقق منهأول إجراء
PRE-01Docker يستجيبتشغيل Docker (على Windows لا يعمل Docker Desktop إلا بعد تسجيل الدخول)
PRE-02وجود Docker Compose v2تثبيت إضافة Compose v2؛ لا يكفي docker-compose القديم
PRE-034 غيغابايت من الذاكرة لـ Dockerإضافة ذاكرة؛ على Windows رفع الذاكرة المخصّصة لـ WSL2
PRE-0420 غيغابايت حرة على القرصتحرير مساحة (صور قديمة، نسخ قديمة)
PRE-05المنفذان 80 و443 حرّانإيقاف الخدمة التي تشغلهما (خادم ويب آخر، IIS، VPN)
PRE-06الساعة متزامنةتفعيل مزامنة NTP: الساعة المنحرفة تُفشل تسجيل الدخول
PRE-07قواعد بيانات من تثبيت سابقالاحتفاظ بالبيانات بإعادة استخدام بيانات الاعتماد القديمة، أو حذفها بعد نسخ احتياطي فقط
PRE-08خادم التراخيص متاحالسماح بـ HTTPS الصادر، أو استخدام ملف ترخيص
PRE-09سلامة الحزمةإعادة نسخ الحزمة: تغيّر ملف أثناء النقل
PRE-10آثار تثبيت سابقمعلومة فقط في الإصدارات الحديثة

CFG · الإعدادات​

المعرّفما يُتحقق منهأول إجراء
CFG-01كتابة الإعدادات من القالباستخدام المثبّت والقالب من الحزمة نفسها
CFG-02لا متغيّر غير محلولإعادة تشغيل المثبّت الذي يعيد كتابة القيم المستنتَجة
CFG-03إجابة ناقصة (تثبيت دون أسئلة)إكمال ملف الإجابات
CFG-04حفظ الملخص والإجاباتتشغيل المثبّت بمستخدم يستطيع الكتابة في المجلد
CFG-05إجابة غير صالحةتصحيح القيمة المذكورة (اسم المضيف، البريد، المنطقة الزمنية…)
CFG-06الإعدادات مطابقة للإصدارإعادة تشغيل المثبّت: يضيف الناقص ويحتفظ بالأسرار
CFG-07القيم المستنتَجة متّسقة مع اسم المضيفإعادة تشغيل المثبّت؛ لا تصحّح هذه القيم واحدة واحدة
CFG-08موقع HTTPS يحمل اسم المضيف الصحيحإعادة تشغيل المثبّت بعد تغيير اسم المضيف
CFG-09إعدادات مشاركة الخادم متّسقةتخصّ الخوادم التي تستضيف عدة تثبيتات؛ اتصل بالدعم

IMG · الصور​

المعرّفما يُتحقق منهأول إجراء
IMG-01تحميل الصور من الحزمةالتحقق من مساحة القرص وسلامة الحزمة
IMG-02تنزيل الصورلخادم لا يصل إلى السجل، اطلب حزمة تتضمن الصور
IMG-03وجود صور الإصدارتحميل الإصدار المذكور بالضبط؛ لا تنتقل أبدًا إلى «latest»

TLS · الشهادات​

المعرّفما يُتحقق منهأول إجراء
TLS-01الحصول على شهادة Let's Encryptالتحقق من أن اسم DNS يشير إلى الخادم وأن المنفذ 80 متاح من الإنترنت
TLS-02الشهادة الموجودة في مكانهاوضع الشهادة والمفتاح في المكان المنتظر
TLS-03إعدادات HTTPS يتولاه وكيلكتقديم إعدادات وكيلك
TLS-04صلاحية الشهادةإعادة التجديد؛ تنبيه قبل 21 يومًا من انتهاء الصلاحية
TLS-05التجديد التلقائي يعملإعادة تشغيل خدمة التجديد

RUN · التشغيل​

المعرّفما يُتحقق منهأول إجراء
RUN-00تشغيل التطبيققراءة السبب المعروض: منفذ مشغول، قيمة ناقصة، صورة غائبة
RUN-01كل المكوّنات تعمل—
RUN-02كل مكوّن موجودتشغيل الأوامر من مجلد التثبيت
RUN-03كل مكوّن سليمالانتظار أثناء التشغيل الأول (3 إلى 5 دقائق) ثم قراءة السجلات

API وDB وKC وWEB · التطبيق​

المعرّفما يُتحقق منهأول إجراء
API-01الخدمات التطبيقية تستجيبقراءة سجل الخدمات: أول خطأ يسمّي السبب
API-02المتصفح مسموح له باستدعاء الـ APIإعادة تشغيل المثبّت (انظر CFG-07)
DB-01نجاح ترحيل قاعدة البياناتالتوقف عن استخدام التثبيت: استعادة نسخة ما قبل التحديث والاتصال بالدعم
DB-02القاعدة مطابقة للإصدارعدم تعديل أي شيء يدويًا؛ الاتصال بالدعم
DB-03إمكانية إعادة بناء القواعدإعادة بيانات الاعتماد الأصلية للقواعد
KC-01العنوان الذي تعلنه المصادقةإعادة تشغيل المثبّت (انظر CFG-07): هذا سبب رفض الدخول المتكرر
KC-02تهيئة المصادقة عند التشغيل الأولقراءة سجل التشغيل الأول
KC-03الواجهة الويب معروفة لدى المصادقةاتباع التصحيح في TROUBLESHOOTING.md
WEB-01الواجهة الويب تستجيبالتحقق من أن الواجهة تعمل

LIC وSEC وNET · الترخيص، الوصول، الشبكة​

المعرّفما يُتحقق منهأول إجراء
LIC-00تقديم ملف الترخيص عند التثبيتتفعيل الترخيص بعد تسجيل الدخول
LIC-01الترخيص نشطتسجيل الدخول كمسؤول وتفعيل الترخيص؛ بدونه يبقى التطبيق في الوضع المقيّد
LIC-02تخزين الترخيصإعادة ملف الترخيص إلى مكانه؛ التحقق من صلاحيات الكتابة
SEC-01العناوين المسموح لها بواجهات الإدارةمعلومة: دون عناوين تبقى مغلقة
SEC-02وجود قائمة السماحاستعادتها من الحزمة: بدونها يتوقف الموقع كله
NET-01اسم المضيف يشير إلى هذا الخادمتصحيح سجل DNS؛ يجب أن يُحلّ الاسم من الخادم نفسه أيضًا

UPG · التحديث​

المعرّفما يُتحقق منهأول إجراء
UPG-01الهدف تثبيت فعليتوجيه التحديث إلى مجلد التثبيت، لا إلى الحزمة
UPG-02التحديث نحو إصدار أحدثاستخدام أحدث حزمة؛ يُرفض الرجوع إلى إصدار أقدم
UPG-03خدمة المصادقة لا تُخفَّض أبدًالا شيء يُفعل
UPG-04النسخ الاحتياطي قبل التحديثتحرير مساحة؛ لم يتغيّر شيء
UPG-05استبدال ملفات الحزمةتصحيح المساحة أو الصلاحيات ثم إعادة التشغيل
UPG-06دمج الإعداداتقراءة الرسالة؛ ثم تشغيل التشخيص
UPG-07تحديث إعدادات HTTPSإن كنت عدّلتها يدويًا، انقل إليها تغييرات الإصدار الجديد

انظر التحديثات والنسخ الاحتياطية للعودة إلى الإصدار السابق.

الاتصال بالدعم​

أرفق بطلبك:

  • المعرّفات التي ظهرت بـ FAIL أو WARN في التشخيص؛
  • الإصدار المثبّت (ملف VERSION)؛
  • سجل التشغيل المعني، في install/logs/.

لا ترسل أبدًا .env ولا install-summary.txt: فهما يحتويان على أسرار.

آخر تحديث في