الوثائق 9.6.24

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

حدد الخادم والإصدار والوقت والخطأ بدقة. احذف الأسرار من السجلات.

لا توجد بيانات من الجسر#

تحقق من أن الاتصال غير موقوف في بطاقة Tosun Connect، ومن عدم وجود set tosun_db_bridge_manual "1" دون tosun_db_bridge_enabled "1"، ومن أن المرآة القديمة (ts.panelMirror.enabled) معطلة؛ ثم راجع oxmysql والإطار والبنية وآخر اتصال. حزمة tosun-ac الأقدم من 9.6.14 ما زالت تحتاج set tosun_db_bridge_enabled "1" في server.cfg حتى تثبيت الحزمة الجديدة. النتائج صفحات من الحقول المدعومة وليست نسخة كاملة من القاعدة.

هل الحماية مضمونة؟#

لا. تقلل فحوص الخادم والرموز المحدودة مخاطر معينة. حدّث الموارد وراجع الاكتشافات الخاطئة واحمِ حسابات الإدارة وجدّد المفاتيح المكشوفة. التشفير لا يمنع تحليل كود العميل.

حدد أول مرحلة فاشلة#

ميّز الدخول والدفع والتنزيل والتشغيل واللوحة والجسر والموقع. سجل أول خطوة فاشلة والنتيجة المتوقعة وآخر وقت عمل طبيعي.

دوّن الإصدار والتغييرات والحساب المتأثر وقارن وقت اللوحة ووحدة التحكم. اختبر تغييرًا واحدًا. قبل تكرار دفع أو تغيير مال غامض افحص الفاتورة أو الرصيد.

راجع التنزيل والتشغيل#

التنزيل يفحص حق الخدمة والوصول للخادم وصلاحية إدارته. استخدم منطقة التنزيل الخاصة بك فقط.

اختر الحساب والخادم واقرأ ملاحظة الصلاحية أو الفوترة.
أبقِ اسم tosun-ac وفك الحزمة بالكامل ولا تخلط الإصدارات.
راجع الاعتماديات والترتيب وأصلح أول خطأ دون نقل الترخيص إلى العميل.
أرسل الإصدار والمعرّف والخطأ المنقّح للدعم، ولا تنشر الحزمة.

الخدمات المعلّقة ومعلومات الدعم#

قد ينتظر الموقع في الطابور؛ لا تكرره. التفعيل وHTTPS منفصلان. النطاق يحتاج توجيهًا وTXT. الجسر مفعّل افتراضيًا (دون سطر إضافي في server.cfg) ويحتاج صلاحية في اللوحة وoxmysql ومخططًا مدعومًا. لا يستجيب إذا أُوقف الاتصال من بطاقة Tosun Connect، أو إذا غاب set tosun_db_bridge_enabled "1" في الوضع اليدوي (tosun_db_bridge_manual)، أو إذا كانت المرآة الكاملة القديمة مفعّلة (ts.panelMirror.enabled = true في configs/anticheat_config.lua)؛ في الحالة الأخيرة يبقى الجسر متوقفًا كي تستمر المرآة في العمل. الحزم الأقدم من 9.6.14 ما زالت تحتاج set tosun_db_bridge_enabled "1" حتى تُثبَّت الحزمة الجديدة.

الجسر ليس متصفح SQL شاملًا؛ الرد الفارغ أو غير المدعوم لا يثبت قاعدة فارغة. بعد عشر دقائق أعد 2FA باستخدام QR ومفتاح جديدين؛ افحص ساعة الهاتف وحساب التطبيق عند رفض الرمز.

للدعم: المعرّف والإصدار والإطار والخطوات والتوقع والخطأ والتاريخ والمنطقة الزمنية والتغييرات. أزل الترخيص والرموز وQR والرموز الاحتياطية والبنكية وبيانات اللاعبين غير الضرورية.

اعزل مشكلة المتصفح دون فقد الأدلة#

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

لمشكلة عرض فقط، قارن الصفحة في جلسة جديدة وافحص إضافات تحجب السكربتات أو التنقل. تأكد من الدخول إلى الحساب المقصود. إذا أخبر نموذج قديم بانتهاء جلسة الأمان، افتح الصفحة عبر التنقل المعتاد بدل إرساله مرارًا. دوّن ظروف الحساب والمتصفح التي تغيرت أثناء المقارنة.

أبقِ محاولات الدفع وكتابة الاقتصاد خارج المقارنة حتى تعرف النتيجة الأولى. لا تنسخ كوكيز الجلسة أو ترويسات المصادقة في طلب دعم. اذكر إصدار المتصفح وهل غيّرت الجلسة الجديدة النتيجة مع الخطأ والوقت الأصليين. يساعد ذلك في فصل سلوك العرض المحلي عن حالة الخدمة الفعلية.

حضّر إعادة قصيرة بنقطة توقف واضحة#

اختر أقل تسلسل يصل إلى الخطأ بحساب مخول للعمل. مثلًا اختر الخادم وافتح قائمة اللاعبين وسجّل الرد؛ لا تحتاج تعديل أرصدة لإثبات خطأ قراءة. اذكر المتوقع في كل خطوة. لا يمكن للدعم فهم الحالة جيدًا من الرسالة الأخيرة وحدها دون المورد والظروف.

إذا ظهرت المشكلة بعد تحديث محدد أو أثناء إجراء لعب معين، أضف هذا الشرط وقارنه بآخر إعداد يعمل وإصداره. توقف بعد تسجيل أول فشل بدل جمع طلبات وإعادات تشغيل وتغييرات تخفي السبب. إذا كانت الفترة مهمة، اذكرها مع المنطقة الزمنية.

صف ما فحصته والنتائج التي بقيت ثابتة. شارك فقط أسطر وحدة التحكم حول الخطأ، بعد إزالة الأسرار ومعلومات اللاعبين غير المرتبطة. تعطي الإعادة المختصرة حالة قابلة للاختبار وحدًا واضحًا للحكم على الإصلاح. مثال ملموس بسياقه أنفع من سجل طويل دون شرح.

تحقق من الإصلاح أمام العَرَض الأصلي#

بعد الإصلاح المقترح، كرّر القراءة أو سيناريو اللعب الأول في ظروف متقاربة. افحص الرد المباشر وسجل اللوحة أو وحدة التحكم المناسب. اختفاء تنبيه لا يثبت وحده اكتمال تنزيل أو اتصال أو تجهيز موقع أو تأكيد دفع. كتابة النتيجة المتوقعة قبل التغيير تجعل التقييم أوضح.

احفظ الإصدار أو القيم القديمة والجديدة في سجل التغيير. للعب اختبر الإجراء العادي المتأثر وإجراءً قريبًا غير متأثر. للموقع افحص العنوان المقصود وHTTPS. للفوترة استخدم نتيجة الفاتورة الحالية بدل إنشاء سحب اختباري. اذكر أيضًا وقت الفحص والحساب المستخدم.

إذا عاد العَرَض، أبلغ وقت عودته والظروف التي تغيرت بعد التحقق. استعد إعدادًا معروفًا يعمل باستخدام إجراء الاسترداد المجهّز فقط. احتفظ بتاريخ مختصر كي يبدأ التحقيق التالي من ملاحظات مؤكدة بدل التخمينات نفسها. سجّل نتيجة الإصلاح المعروفة والعودة اللاحقة بأوقاتهما المنفصلة دون خلطهما.

جهّز تذكرة دعم باستخدام مثال مجهول مكتمل#

افتح تذكرة جديدة من قسم الدعم في اللوحة؛ يحتاج الحساب إلى صلاحية support.create. املأ الموضوع والفئة والأولوية والرسالة وفق المثال الافتراضي أدناه. اختيرت technical وnormal لمشكلة قراءة قائمة اللاعبين. حدّد الأولوية بحسب الأثر الحقيقي؛ فتعطل شاشة قراءة واحدة ليس توقفاً للخادم كله. تختلف التسميات الظاهرة باختلاف لغة الواجهة، والقيم بين القوسين هي خيارات النموذج الحالية. لا تحتاج التذكرة إلى رخصتك أو كلمة مرورك أو وصول إلى قاعدة البيانات. صف ما شاهدته بدلاً من إرسال جميع الإعدادات.

اسم الخادم والمرجع في المثال لا يمثلان سجلات عملاء حقيقية. حدّد الخادم المتأثر بوضوح في تذكرتك الخاصة المصرح بها، وأخفِ البيانات اللازمة إذا نشرت النص لاحقاً في قناة عامة. تتضمن الرسالة خطوات إعادة الحالة ونقطة توقف: لم يُغيّر رصيد ولم تُنشأ مهمة جديدة. يتحقق النموذج من خمسة أحرف على الأقل للموضوع وعشرة للرسالة؛ يكفي عنوان قصير وشرح مفيد. أضف الملاحظات اللاحقة إلى التذكرة نفسها. أرسل الأسطر المرتبطة بالمشكلة بعد إزالة البيانات الحساسة، بدلاً من وحدة التحكم كاملة أو تفريغ SQL أو ملفات تعريف الارتباط. اختيار الأولوية لا يضمن مدة محددة للرد.

الموضوع: طلب قائمة اللاعبين لا يكتمل
الفئة: تقنية (technical)
الأولوية: عادية (normal)
الرسالة:
الخادم: TEST-SERVER — مجهول في هذا المثال
الإصدار / framework: 9.6.3 / QBCore — قيم افتراضية
الوقت: 2026-09-26 14:03 UTC
الخطوات: اخترت الخادم وفتحت قائمة اللاعبين مرة واحدة.
المتوقع: اكتمال الصفحة الأولى للاعبين بنجاح.
المشاهد: pending ثم انتهاء مهلة الشبكة.
المرجع: TEST-REQUEST — ليس معرّف طلب حقيقياً
الفحوص: بدأ resource وتتوفر صلاحية القراءة المطلوبة.
نقطة التوقف: لم أبدأ مهمة جديدة أو أغيّر الرصيد.
أُزيلت الأسرار وملفات تعريف الارتباط و_csrf ومعرّفات اللاعبين.

اختر الخطوة التالية وحد التوقف بحسب العَرَض#

يساعد هذا التسلسل على إيجاد أول خطوة فاشلة، وليس إصلاحاً آلياً أو قاعدة لإعادة كل طلب. إن لم تُفتح قائمة اللاعبين، افحص HTTP أولاً: يشير 401 إلى الجلسة، و419 إلى قيمة أمان النموذج، و403 إلى صلاحيات الحساب أو الخدمة، و429 إلى السعة أو الانتظار. إذا ظهر سجل واحد فارغاً فتحقق من الشخصية وبنية البيانات المدعومة. قد تتشابه الأعراض وتختلف أسبابها؛ فصفحة فارغة اكتملت بنجاح وطلب مرفوض حدثان مختلفان. احتفظ بالأدلة الحالية قبل اختيار الفرع، وسجّل الحالة التي رأيتها بالفعل.

إذا كانت كتابة اقتصادية معلّقة أو نتيجة دفع غير مؤكدة، اختر التوقف: افحص الطلب الموجود والفاتورة والحالة الحالية قبل بدء عملية أخرى. إذا لم يبدأ resource فارجع إلى التثبيت وأول خطأ في وحدة التحكم؛ وإذا وُسمت حركة مشروعة فراجع التكامل ومدة الإذن المحدودة. لا توقف جميع الحمايات كحل مؤقت. إذا كان الموقع نشطاً لكن HTTPS لا يعمل فافحص مرحلة النطاق والشهادة كلّاً على حدة. تغير الساعة أو الشاشة المحلية لا يعني اكتمال العملية على الخادم. اشرح للدعم الملاحظة التي حددت الفرع، ولا تصف نتيجة مجهولة بأنها ناجحة. فرّق بوضوح بين الانتظار ورفض الصلاحية والنتيجة المكتملة الفارغة.