מדריך זה מכסה פתרונות לבעיות ה-FiveM הנפוצות ביותר — בעיות גישה ל-TXAdmin, שגיאות מפתח רישיון CFX, כשלי חיבור למסד נתונים, קריסות שרת, בעיות חיבור שחקנים ומשאבים שלא נטענים. להגדרת שרת ראשונית, ראה את מדריך הגדרת שרת FiveM.
טיפ כללי לפתרון בעיות: תמיד בדוק תחילה את פלט קונסול GPanel ויומני TXAdmin. רוב השגיאות מפיקות הודעה ברורה שמצביעה על הגורם.
TXAdmin לא נטען או לא נגיש
- וודא שהשרת פועל ב-GPanel — TXAdmin מתחיל לפעול רק כאשר תהליך שרת FiveM פעיל.
- בדוק בקונסול GPanel את כתובת ה-URL והפורט של 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. המניפסט חייב להיות ישירות בתוך תיקיית המשאב: resources/my-resource/fxmanifest.lua.
בעיות ביצועי שרת
- פתח את TXAdmin ובדוק את ה-Dashboard למדדי ביצועים (זמן טיק, מספר שחקנים, שימוש בזיכרון).
- שרת FiveM תקין צריך לשמור על זמן טיק שרת (הנקרא גם "hitch") מתחת ל-20ms. קפיצות עקביות מעל לכך מצביעות על כך שמשאב משתמש ביותר מדי זמן עיבוד.
- השתמש בדף Resources ב-TXAdmin כדי לזהות אילו משאבים צורכים את מרבית זמן השרת.
- הסר או החלף משאבים שאינם מותאמים היטב. משאבים חינמיים ממקורות לא ידועים הם לעיתים קרובות הגורם לבעיות ביצועים.
- הפחת את מספר המשאבים הטעונים אם מגבלות הזיכרון או ה-CPU של תוכנית השרת שלך מגיעות לתקרה.
קבלת עזרה
אם ניסית את הפתרונות לעיל ואתה עדיין חווה בעיות:
- העתק את הודעת השגיאה המלאה מקונסול GPanel או יומן TXAdmin.
- ציין אילו שלבי פתרון בעיות כבר ניסית.
- פתח פנייה לתמיכה בכתובת https://legionhosting.net/submitticket.php עם מידע זה. הצוות שלנו יסייע לך בהקדם האפשרי.
