Овој водич опфаќа решенија за најчестите проблеми со 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 со овие информации. Нашиот тим ќе ви помогне што е можно побрзо.
