يغطي هذا الدليل حلول أكثر مشاكل سيرفر FiveM شيوعاً — مشاكل الوصول إلى TXAdmin، أخطاء مفتاح ترخيص CFX، فشل اتصال قاعدة البيانات، تعطل السيرفر، مشاكل اتصال اللاعبين، وعدم تحميل الموارد. للإعداد الأولي للسيرفر، انظر دليل إعداد سيرفر FiveM.
نصيحة عامة لاستكشاف الأخطاء: تحقق دائماً من مخرجات وحدة تحكم GPanel وسجلات TXAdmin أولاً. معظم الأخطاء تنتج رسالة واضحة تشير إلى السبب.
TXAdmin لا يتم تحميله أو لا يمكن الوصول إليه
- تحقق من أن السيرفر يعمل في GPanel — TXAdmin يبدأ فقط عندما تكون عملية سيرفر FiveM نشطة.
- تحقق من وحدة تحكم GPanel للعثور على رابط ومنفذ TXAdmin. منفذ TXAdmin مختلف عن منفذ اللعبة.
- تأكد من استخدام
http://وليسhttps://— TXAdmin لا يستخدم SSL بشكل افتراضي. - إذا كان TXAdmin يعمل سابقاً لكنه توقف عن التحميل، حاول إعادة تشغيل السيرفر من GPanel.
- امسح ذاكرة التخزين المؤقت للمتصفح أو جرب نافذة تصفح خاص/متخفي.
فقدت كلمة مرور TXAdmin؟ إذا لم تتمكن من تسجيل الدخول، قد تحتاج إلى حذف بيانات ملف تعريف TXAdmin وإعادة تشغيل معالج الإعداد. تحقق من تبويب Files في GPanel للعثور على مجلد بيانات TXAdmin وقم بإزالة ملفات التعريف الخاصة به، ثم أعد تشغيل السيرفر.
أخطاء مفتاح ترخيص CFX
| رسالة الخطأ | السبب | الحل |
|---|---|---|
Invalid license key |
تم نسخ المفتاح بشكل خاطئ أو يوجد مسافات زائدة | اذهب إلى Keymaster، تأكد من أن المفتاح نشط، وأعد نسخه بعناية. الصقه في كل من متغير Startup في GPanel و sv_licenseKey في server.cfg. |
License key already in use |
المفتاح مسجل لعنوان IP سيرفر مختلف | يمكن استخدام كل مفتاح على سيرفر واحد فقط في كل مرة. ألغِ المفتاح القديم على Keymaster وأنشئ مفتاحاً جديداً بعنوان IP سيرفرك الحالي. |
Unable to verify license key |
سيرفرات مصادقة Cfx.re غير متاحة مؤقتاً | انتظر بضع دقائق وأعد تشغيل السيرفر. تحقق من status.cfx.re لمعرفة حالات الانقطاع. |
نصيحة: تأكد من أن المفتاح مُعيَّن في كلا المكانين: متغير Startup في GPanel وفي
server.cfg (sv_licenseKey). حسب تهيئتك، قد يقرأ السيرفر من أحدهما أو الآخر.
أخطاء اتصال قاعدة البيانات
| رسالة الخطأ | السبب | الحل |
|---|---|---|
Connection refused أو ETIMEDOUT |
عنوان مضيف أو منفذ قاعدة البيانات خاطئ | تحقق مرة أخرى من عنوان مضيف قاعدة البيانات والمنفذ من تبويب Databases في GPanel. لا تستخدم localhost أو 127.0.0.1. |
Access denied |
اسم مستخدم أو كلمة مرور خاطئة | انسخ بيانات الاعتماد مباشرة من GPanel لتجنب الأخطاء المطبعية. كلمات المرور حساسة لحالة الأحرف. |
Unknown database |
اسم قاعدة البيانات لا يتطابق | تأكد من أن اسم قاعدة البيانات في سلسلة الاتصال يتطابق تماماً مع ما هو معروض في GPanel. |
خطوات إضافية لاستكشاف أخطاء قاعدة البيانات:
- إذا كنت تستخدم oxmysql، تأكد من وجود مورد
oxmysqlفي مجلدresources/وأنensure oxmysqlيظهر في server.cfg قبل أي موارد تتطلب قاعدة بيانات. - إذا كانت كلمة المرور تحتوي على أحرف خاصة مثل
@أو#أو%، قم بترميزها بصيغة URL في سلسلة الاتصال (مثلاً@تصبح%40). - تحقق من سلسلة الاتصال للبحث عن أحرف مفقودة أو زائدة — حتى حرف واحد في غير مكانه سيسبب فشل الاتصال.
لا تستخدم localhost. سيرفر قاعدة البيانات منفصل عن سيرفر اللعبة. استخدم دائماً عنوان المضيف الكامل الموضح في تبويب Databases في GPanel.
تعطل السيرفر عند بدء التشغيل
- تحقق من وحدة تحكم GPanel بحثاً عن رسائل الخطأ. الأسباب الشائعة تشمل ملف
server.cfgمفقود أو مُهيأ بشكل خاطئ، أو مفتاح ترخيص CFX غير صالح، أو مورد معطل. - حاول تعطيل الموارد المخصصة عن طريق تحويلها إلى تعليقات في server.cfg (أضف
#قبل كل سطرensure) وأعد التشغيل. أعد إضافتها واحداً تلو الآخر لتحديد المورد المسبب للمشكلة. - تأكد من أن المنافذ في
endpoint_add_tcpوendpoint_add_udpتتطابق مع المنفذ المعين لك في GPanel.
# Comment out resources to isolate the problem
#ensure suspicious-resource
#ensure another-resource
# Keep core resources enabled
ensure mapmanager
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure chat
البحث الثنائي عن الموارد المعطلة: إذا كان لديك موارد كثيرة، قم بتحويل نصفها إلى تعليقات دفعة واحدة بدلاً من واحد تلو الآخر. هذا يضيق نطاق المشكلة بشكل أسرع بكثير.
اللاعبون لا يستطيعون الاتصال
- تأكد من أن السيرفر يظهر بحالة Running في GPanel.
- تحقق من عنوان IP والمنفذ — يجب على اللاعبين استخدام منفذ اللعبة، وليس منفذ TXAdmin.
- تحقق من أن
sv_maxclientsليس مضبوطاً على 0 أو رقم منخفض بشكل غير معقول. - إذا كنت تستخدم كلمة مرور للسيرفر (
sv_passwordفي server.cfg)، تأكد من أن اللاعبين يعرفونها. - يجب أن يكون عميل FiveM مثبتاً لدى اللاعبين — لا يمكنهم الاتصال باستخدام مشغل GTA V العادي.
- تحقق من تبويب Network في GPanel وتأكد من أن المنافذ في
endpoint_add_tcpوendpoint_add_udpمتطابقة. عدم التطابق سيمنع الاتصالات.
السيرفر لا يظهر في المتصفح؟ قد تستغرق السيرفرات الجديدة من 5 إلى 15 دقيقة للظهور في قائمة سيرفرات FiveM. استخدم الاتصال المباشر (
IP:PORT) في هذه الأثناء. تحقق أيضاً من أن sv_licenseKey صالح.
الموارد لا يتم تحميلها
- تحقق من أن مجلد المورد موجود داخل مجلد
resources/(أو مجلد فرعي مناسب). - تحقق من أن اسم المجلد يتطابق مع سطر
ensureفي server.cfg تماماً (حساس لحالة الأحرف). - يجب أن يحتوي كل مورد على ملف
fxmanifest.luaصالح (أو الملف الأقدم__resource.lua). إذا كان هذا الملف مفقوداً، لن يتم تحميل المورد. - تحقق من وحدة تحكم TXAdmin أو GPanel بحثاً عن رسائل خطأ متعلقة بالمورد. الأخطاء الشائعة تشمل تبعيات مفقودة أو أخطاء في صياغة Lua.
- إذا كان المورد يتطلب إطار عمل (ESX، QBCore)، تأكد من تحميل إطار العمل قبل المورد في server.cfg.
- إذا كان المورد يتطلب قاعدة بيانات، تأكد من أن مورد MySQL (oxmysql، mysql-async) محمّل واتصال قاعدة البيانات يعمل.
تحقق من هيكل المجلدات. خطأ شائع هو رفع مورد والحصول على مجلد متداخل مزدوج مثل
resources/my-resource/my-resource/fxmanifest.lua. يجب أن يكون ملف manifest مباشرة داخل مجلد المورد: resources/my-resource/fxmanifest.lua.
مشاكل أداء السيرفر
- افتح TXAdmin وتحقق من Dashboard لمقاييس الأداء (وقت التكة، عدد اللاعبين، استخدام الذاكرة).
- يجب أن يحافظ سيرفر FiveM السليم على وقت تكة (يُسمى أيضاً "hitch") أقل من 20 مللي ثانية. الارتفاعات المستمرة فوق هذا الحد تشير إلى أن مورداً ما يستهلك وقت معالجة كثيراً.
- استخدم صفحة Resources في TXAdmin لتحديد الموارد التي تستهلك أكبر وقت من السيرفر.
- أزل أو استبدل الموارد غير المحسّنة. الموارد المجانية من مصادر غير معروفة غالباً ما تكون سبب مشاكل الأداء.
- قلل عدد الموارد المحملة إذا كانت حدود الذاكرة أو المعالج في خطتك قد وصلت إلى الحد الأقصى.
الحصول على المساعدة
إذا جربت الحلول أعلاه ولا تزال تواجه مشاكل:
- انسخ رسالة الخطأ الكاملة من وحدة تحكم GPanel أو سجل TXAdmin.
- دوّن خطوات استكشاف الأخطاء التي جربتها بالفعل.
- افتح تذكرة دعم على https://legionhosting.net/submitticket.php مع هذه المعلومات. سيساعدك فريقنا في أسرع وقت ممكن.
