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

أخطاء مفتاح الترخيص

مشاكل مفتاح الترخيص هي المشكلة الأكثر شيوعًا عند تشغيل خادم RedM جديد. فيما يلي الأخطاء النموذجية وحلولها:

"Invalid license key" أو "Could not authenticate"

عدم ظهور الخادم في المتصفح

إذا كان خادمك يعمل ولكن اللاعبين لا يمكنهم العثور عليه في متصفح خوادم RedM:

قائمة التحقق

1. انتظر 5 دقائق على الأقل. بعد التشغيل، يحتاج الخادم وقتًا للتسجيل في قائمة خوادم Cfx.re الرئيسية. قد تستغرق الخوادم الجديدة عدة دقائق للظهور.
2. تحقق من صلاحية مفتاح الترخيص. لن يتم إدراج الخادم بدون مفتاح ترخيص صالح. تحقق من وحدة تحكم الخادم بحثًا عن أخطاء متعلقة بالترخيص.
3. تحقق من تكوين نقاط النهاية. تأكد من أن endpoint_add_tcp وendpoint_add_udp في server.cfg يستخدمان المنفذ الصحيح:

   endpoint_add_tcp "0.0.0.0:30120"
   endpoint_add_udp "0.0.0.0:30120"

   يجب أن يتطابق المنفذ مع المنفذ المعيّن في GPanel.
4. تحقق من إعدادات "sv_master1" أو الإدراج. تأكد من أنك لم تضبط الخادم عن طريق الخطأ على عدم إدراج نفسه. يجب ألا يكون هناك sv_master1 "" في التكوين الخاص بك (هذا يعطل التسجيل في القائمة الرئيسية).
5. تحقق من أن الخادم يعمل فعلاً. تحقق من وحدة تحكم GPanel. إذا تعطل الخادم أو توقف، فلن يظهر في المتصفح.
6. جرّب الاتصال المباشر. حتى لو لم يكن الخادم في المتصفح، يجب أن يعمل الاتصال المباشر. اطلب من اللاعب الضغط على F8 في RedM وكتابة:

   connect YOUR_SERVER_IP:PORT

فشل تحميل الموارد

أخطاء الموارد شائعة عند إضافة نصوص برمجية أو أطر عمل جديدة إلى خادمك. فيما يلي المشاكل الأكثر تكرارًا:

"Could not find resource [resource_name]"

• مجلد المورد غير موجود في دليل resources/، أو أنه في الموقع الخطأ.
• اسم المجلد لا يتطابق مع الاسم المستخدم في ensure. أسماء الموارد حساسة لحالة الأحرف.
• الحل: تحقق من وجود مجلد المورد وأن الاسم في server.cfg يتطابق تمامًا. استخدم مدير ملفات GPanel أو SFTP للتحقق.

"Failed to load resource [resource_name]: manifest error"

• ملف fxmanifest.lua أو __resource.lua الخاص بالمورد يحتوي على خطأ في الصيغة.
• البيان يشير إلى ملفات غير موجودة في مجلد المورد.
• الحل: افتح ملف البيان وتحقق من الأخطاء المطبعية أو الفواصل المفقودة أو الإشارات إلى ملفات غير موجودة. تحقق من وحدة تحكم الخادم لرقم السطر المحدد للخطأ.

"Error loading script [filename]: [error details]"

• ملف Lua أو C# أو JavaScript داخل المورد يحتوي على خطأ في الصيغة أو خطأ وقت التشغيل.
• الحل: اقرأ رسالة الخطأ الكاملة في وحدة التحكم. ستتضمن اسم الملف ورقم السطر. الأسباب الشائعة تشمل:
  • تبعيات مفقودة (مورد آخر يجب تحميله أولاً)
  • مورد قديم غير متوافق مع إصدار خادم RedM الحالي
  • قيم تكوين غير صحيحة في ملف تكوين المورد

مشاكل ترتيب تحميل الموارد

يتم تحميل الموارد في server.cfg بالترتيب الذي تظهر به. إذا كان مورد يعتمد على آخر (مثل vorp_inventory يعتمد على vorp_core)، يجب إدراج التبعية أولاً:

# Correct order - dependencies first
ensure oxmysql
ensure vorp_core
ensure vorp_inventory
ensure vorp_stores

# Wrong order - will cause errors
# ensure vorp_inventory   <-- depends on vorp_core
# ensure vorp_core        <-- loaded too late

مشاكل اتصال العملاء

عندما لا يتمكن اللاعبون من الاتصال بخادمك:

"Connection timed out" / "Failed to connect"

"Connection rejected by server"

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

تعطل العميل عند الاتصال

• مورد على الخادم يرسل بيانات خاطئة أو يحتوي على خطأ في نص برمجي من جانب العميل يتسبب في تعطل العميل.
• الحل: عطّل الموارد المضافة مؤخرًا واحدًا تلو الآخر لتحديد المورد المسبب للمشكلة. تحقق من وحدة تحكم الخادم بحثًا عن أخطاء أثناء اتصال العميل.
• تأكد من أن عميل RedM الخاص باللاعب محدّث.

أخطاء "Could not download file"

• يحاول الخادم إرسال ملف كبير (مثل أصل بث) يتجاوز حدود النقل أو أن الاتصال غير مستقر.
• الحل: قلّل حجم الأصول المبثوثة، أو استخدم CDN/استضافة خارجية للملفات الكبيرة إذا كان ذلك مدعومًا، أو اطلب من اللاعب إعادة محاولة الاتصال.

مشاكل قاعدة البيانات (MySQL / oxmysql)

تستخدم معظم أطر عمل لعب الأدوار في RedM قاعدة بيانات MySQL لتخزين البيانات بشكل دائم. أكثر موصّلات قواعد البيانات شيوعًا هو oxmysql.

أخطاء فشل الاتصال

إذا فشل oxmysql (أو موصّل MySQL آخر) في الاتصال، تحقق مما يلي:

# Typical oxmysql connection string in server.cfg
set mysql_connection_string "mysql://user:password@host:3306/database_name?charset=utf8mb4"

جداول مفقودة أو أخطاء في المخطط

غالبًا ما تتطلب أطر عمل لعب الأدوار إعداد جداول قاعدة البيانات قبل أن تتمكن من العمل:

1. تحقق من وثائق إطار العمل أو مستودع GitHub بحثًا عن ملفات استيراد SQL (غالبًا تسمى database.sql أو schema.sql أو ما شابه).
2. استورد ملف SQL إلى قاعدة البيانات باستخدام phpMyAdmin أو عميل MySQL.
3. بعض أطر العمل تنشئ الجداول تلقائيًا عند التشغيل الأول. تأكد من أن مستخدم قاعدة البيانات لديه صلاحيات CREATE TABLE.

مشاكل الأداء

إذا كان خادم RedM الخاص بك يعاني من تأخر أو معدل تحديث منخفض أو أداء ضعيف بشكل عام:

تحديد مشاكل الأداء

تحقق من وحدة تحكم الخادم بحثًا عن تحذيرات الأداء. تستهدف خوادم RedM معدل تحديث يتراوح بين 30-64 تحديثًا في الثانية. يمكنك مراقبة ذلك باستخدام:

• لوحة تحكم txAdmin: إذا كان txAdmin متاحًا، فإنه يعرض مقاييس أداء الخادم في الوقت الفعلي.
• وحدة تحكم الخادم: راقب تحذيرات "slow tick" أو "resource hitch".
• أمر resmon: اكتب resmon 1 في وحدة تحكم الخادم (أو وحدة تحكم F8) لتفعيل مراقب الموارد، الذي يعرض وقت المعالج لكل مورد.

حلول الأداء الشائعة

الممارسات الموصى بها

• جدوِل إعادة تشغيل تلقائية كل 6-12 ساعة باستخدام ميزة الجدولة في GPanel أو txAdmin لمسح مشاكل الذاكرة والكيانات المتراكمة.
• حافظ على تحديث الموارد للاستفادة من إصلاحات الأداء والتحسينات.
• تجنب الوظائف المكررة — لا تشغّل موردين يقومان بنفس الشيء (مثل نظامين للطقس).
• اختبر الموارد الجديدة على خادم تجريبي (أو مع عدد قليل من اللاعبين) قبل نشرها على خادمك الرئيسي.
• راقب مقاييس الخادم بانتظام من خلال GPanel أو txAdmin لاكتشاف المشاكل مبكرًا.

نصائح عامة لاستكشاف الأخطاء وإصلاحها

1. اقرأ دائمًا مخرجات وحدة تحكم الخادم. تقريبًا كل خطأ يتضمن رسالة في وحدة التحكم تخبرك بما حدث خطأ وأين.
2. أعد تشغيل الخادم بعد تغييرات التكوين. معظم التغييرات على server.cfg تتطلب إعادة تشغيل كاملة للخادم لتطبيقها.
3. عطّل الموارد واحدًا تلو الآخر لعزل المشاكل. علّق على أسطر ensure في server.cfg باستخدام #.
4. احتفظ بنسخ احتياطية من التكوينات العاملة قبل إجراء تغييرات. قم بتنزيل ملف server.cfg وقاعدة البيانات قبل التحديثات الكبرى.
5. تحقق من منتديات ووثائق Cfx.re على docs.fivem.net للاطلاع على الوثائق الرسمية التي تنطبق على كل من FiveM وRedM.
6. تحقق من توافق الموارد مع إصدار خادمك. الموارد المبنية لإصدارات أقدم قد لا تعمل مع إصدارات RedM الحالية.

مقالات ذات صلة

• دليل إعداد خادم RedM — مفاتيح الترخيص وتكوين server.cfg وإدارة الموارد والاتصال.
• كيفية العثور على عنوان IP ومنفذ خادمك
• كيفية رفع الملفات عبر SFTP
• البدء مع خادمك الجديد

هل تحتاج مساعدة؟

لا تزال تواجه مشاكل مع خادم RedM الخاص بك؟ افتح تذكرة دعم وأرفق أي رسائل خطأ من وحدة تحكم خادمك. سيساعدك فريقنا في تشخيص المشكلة وحلها.