Водич за решавање проблеми за чести проблеми со RedM сервери вклучувајќи грешки со лиценцен клуч, видливост во прелистувачот на сервери, неуспеси на ресурси, клиентски конекции, проблеми со бази на податоци и оптимизација на перформанси. За почетни упатства за поставување, погледнете го нашиот Водич за поставување на RedM сервер.
Грешки со лиценцен клуч
Проблемите со лиценцен клуч се најчестиот проблем при стартување на нов RedM сервер. Еве ги типичните грешки и нивните решенија:
„Invalid license key“ или „Could not authenticate“
| Причина | Решение |
|---|---|
| Лиценцниот клуч е погрешно внесен или има дополнителни празни места | Копирајте го клучот директно од Keymaster. Отстранете ги сите празни места на почетокот/крајот од стартната променлива CFX_LICENSE во GPanel или линијата sv_licenseKey во server.cfg. |
| Несовпаѓање на IP адреса | Клучот е регистриран на различно IP од вистинското IP на вашиот сервер. Одете на Keymaster, проверете го регистрираното IP и ажурирајте го да се совпаѓа со IP на вашиот сервер прикажано во GPanel. |
| Клучот е поставен и во GPanel и во server.cfg со различни вредности | Осигурете се дека клучот е конзистентен. Најдобро е да го поставите во GPanel стартната променлива и да го оставите egg да се справи со пренесувањето на серверот. Отстранете или искоментирајте го sv_licenseKey од server.cfg ако GPanel се справува со тоа. |
| Проблем со Cfx.re сметка или отповикан клуч | Најавете се на Keymaster и проверете дали клучот е сè уште активен. Генерирајте нов клуч ако стариот е избришан или истечен. |
| Keymaster услугата е привремено недостапна | Проверете ја Cfx.re статусната страница за прекини. Почекајте и обидете се повторно подоцна. |
Важно: Ако неодамна добивте нов сервер или IP на вашиот сервер се промени (на пр. по миграција на нод), мора да го ажурирате IP во Keymaster или да генерирате нов лиценцен клуч. Стариот клуч нема да работи на различно IP.
Серверот не се појавува во прелистувачот
Ако вашиот сервер работи но играчите не можат да го пронајдат во RedM прелистувачот на сервери:
Список за проверка
- Почекајте најмалку 5 минути. По стартувањето, на серверот му е потребно време за да се регистрира со Cfx.re master серверската листа. Новите сервери може да потраат неколку минути за да се појават.
- Проверете дали лиценцниот клуч е валиден. Серверот нема да биде наведен без работен лиценцен клуч. Проверете ја серверската конзола за грешки поврзани со лиценца.
- Проверете ја конфигурацијата на крајните точки. Осигурете се дека
endpoint_add_tcpиendpoint_add_udpвоserver.cfgго користат точниот порт:
Портот мора да се совпаѓа со оној доделен во GPanel.endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" - Проверете за „sv_master1“ или поставки за листирање. Осигурете се дека случајно не сте го поставиле серверот да не се листира себеси. Не треба да има
sv_master1 ""во вашата конфигурација (ова ја оневозможува регистрацијата на master листата). - Проверете дали серверот навистина работи. Проверете ја GPanel конзолата. Ако серверот се срушил или запрел, нема да се појави во прелистувачот.
- Обидете се со директно поврзување. Дури и ако серверот не е во прелистувачот, директното поврзување треба да работи. Нека играчот притисне F8 во RedM и внесе:
connect YOUR_SERVER_IP:PORT
Совет: Можете да проверите дали вашиот сервер е достапен користејќи го Cfx.re пребарувањето на сервери. Обидете се да навигирате до
http://YOUR_SERVER_IP:PORT/info.json во веб-прелистувач. Ако серверот работи и е достапен, тој ќе врати JSON одговор со информации за серверот.
Неуспеси при вчитување ресурси
Грешките со ресурси се чести при додавање нови скрипти или фрејмворци на вашиот сервер. Еве ги најчестите проблеми:
„Could not find resource [resource_name]“
- Папката на ресурсот не постои во директориумот
resources/, или е на погрешна локација. - Името на папката не се совпаѓа со името употребено во
ensure. Имињата на ресурси се чувствителни на големи/мали букви. - Поправка: Проверете дали папката на ресурсот постои и дали името во
server.cfgсе совпаѓа точно. Користете GPanel file manager или 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“
| Причина | Решение |
|---|---|
| Серверот не работи | Проверете ја GPanel конзолата за да потврдите дека серверот е онлајн и не е срушен. |
| Погрешно IP или порт | Проверете дали играчот го користи точното IP и порт од GPanel. Погледнете Како да го пронајдете IP и портот на вашиот сервер. |
| Погрешна конфигурација на крајна точка | Осигурете се дека endpoint_add_tcp и endpoint_add_udp во server.cfg го користат портот 0.0.0.0:PORT каде PORT се совпаѓа со GPanel. |
| Серверот е полн | Проверете дали е достигнат sv_maxclients. Зголемете ја вредноста ако вашиот хостинг план дозволува. |
„Connection rejected by server“
- Серверска лозинка: Ако е поставен
sv_password, играчот мора да ја внесе точната лозинка. - Whitelist/allowlist ресурс: Ако имате овозможено whitelist ресурс, играчот мора да биде одобрен пред поврзување.
- Бан: Играчот можеби е баниран. Проверете ја вашата бан листа или база на податоци за неговите идентификатори.
Клиентот се руши при поврзување
- Ресурс на серверот испраќа лоши податоци или има грешка во скрипта на клиентска страна што го руши клиентот.
- Поправка: Оневозможувајте ги неодамна додадените ресурси еден по еден за да го идентификувате проблематичниот. Проверете ја серверската конзола за грешки за време на клиентското поврзување.
- Осигурете се дека RedM клиентот на играчот е ажуриран.
Грешки „Could not download file“
- Серверот се обидува да испрати голема датотека (на пр. streaming средство) што ги надминува лимитите за пренос или конекцијата е нестабилна.
- Поправка: Намалете ја големината на стримуваните средства, користете 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"| Грешка | Решение |
|---|---|
ECONNREFUSED или „Connection refused“ |
MySQL серверот не работи, host/портот е погрешен, или MySQL серверот не прифаќа надворешни конекции. Проверете го host, портот и дали вашиот сервер за бази на податоци е онлајн. |
ER_ACCESS_DENIED_ERROR |
Погрешно корисничко име или лозинка во connection string. Проверете двапати ги акредитивите во вашиот панел за хостирање бази на податоци. |
ER_BAD_DB_ERROR |
Името на базата на податоци не постои. Прво креирајте ја базата на податоци преку вашиот панел за управување со бази на податоци (phpMyAdmin, итн.). |
ETIMEDOUT |
Серверот за бази на податоци е недостапен. Проверете дали има firewall правила што ја блокираат конекцијата, или дали host на базата на податоци е точен. |
| „Too many connections“ | Базата на податоци го достигнала својот максимален лимит на конекции. Ова може да се случи ако ресурсите не ги затвораат правилно конекциите, или ако лимитот е премногу низок. Рестартирајте го серверот и проверете ја вашата MySQL поставка max_connections. |
Совет: Ако вашиот RedM сервер и MySQL база на податоци се на иста машина, користете
localhost или 127.0.0.1 како host. Ако се на различни сервери, користете ја IP адресата на серверот за бази на податоци и осигурете се дека MySQL корисникот има привилегии за далечинско поврзување.
Недостасувачки табели или грешки во шемата
Ролеплеј фрејмворците често бараат табели на бази на податоци да бидат поставени пред да можат да функционираат:
- Проверете ја документацијата или GitHub репозиториумот на фрејмворкот за SQL увозни датотеки (често именувани
database.sql,schema.sqlили слично). - Увезете ја SQL датотеката во вашата база на податоци користејќи phpMyAdmin или MySQL клиент.
- Некои фрејмворци автоматски креираат табели при првото стартување. Осигурете се дека корисникот на базата на податоци има привилегии
CREATE TABLE.
Проблеми со перформанси
Ако вашиот RedM сервер доживува лаг, низок tick rate или генерално слаби перформанси:
Идентификување на проблеми со перформанси
Проверете ја серверската конзола за предупредувања за перформанси. RedM серверите целат tick rate од околу 30-64 тикови во секунда. Можете да го следите ова со:
- txAdmin контролна табла: Ако txAdmin е достапен, прикажува метрики за перформанси на серверот во реално време.
- Серверска конзола: Внимавајте на предупредувања „slow tick“ или „resource hitch“.
- resmon команда: Внесете
resmon 1во серверската конзола (или F8 конзолата) за да го овозможите мониторот на ресурси, кој прикажува CPU време по ресурс.
Чести решенија за перформанси
| Проблем | Решение |
|---|---|
| Висока употреба на CPU од специфичен ресурс | Користете resmon 1 за да го идентификувате ресурсот. Размислете да го замените со пооптимизирана алтернатива, или контактирајте го развивачот на ресурсот. |
| Премногу вчитани ресурси | Секој ресурс троши серверски ресурси. Прегледајте ја вашата листа на ресурси и отстранете ги оние што не се користат или се вишок. |
| Тесно грло во барањата на базата на податоци | Бавни или неиндексирани барања на базата на податоци може да предизвикаат застои на серверот. Проверете ги предупредувањата за бавни барања на oxmysql во конзолата. Додадете индекси на колоните што често се прашуваат. |
| Висок број играчи предизвикува лаг | Намалете го sv_maxclients на ниво што вашиот серверски хардвер може да го поднесе. Размислете за надградба на вашиот хостинг план за повеќе ресурси. |
| OneSync лимити на ентитети | Премногу спаунирани ентитети (peds, возила, објекти) може да ги влошат перформансите. Користете ресурси што ги чистат неискористените ентитети. |
| Протекувања на меморија | Некои лошо кодирани ресурси протекуваат меморија со текот на времето. Следете ја употребата на серверската RAM во GPanel. Редовните рестарти на серверот (на секои 6-12 часа) можат да го ублажат ова. |
Препорачани практики
- Закажете автоматски рестарти на секои 6-12 часа користејќи ја функцијата за распоред на GPanel или txAdmin за да ги исчистите акумулираните проблеми со меморија и ентитети.
- Чувајте ги ресурсите ажурирани за да имате корист од поправки и оптимизации на перформанси.
- Избегнувајте дуплирана функционалност — не извршувајте два ресурси што прават иста работа (на пр. два временски системи).
- Тестирајте нови ресурси на staging сервер (или со низок број играчи) пред распоредување на вашиот главен сервер.
- Следете ги серверските метрики редовно преку GPanel или txAdmin за да ги фатите проблемите рано.
Забелешка: Ако постојано доживувате проблеми со перформанси и покрај оптимизацијата, на вашиот сервер можеби му е потребен хостинг план од повисок ранг со повеќе CPU и RAM ресурси. Контактирајте го нашиот тим за поддршка за да разговарате за опции за надградба.
Општи совети за решавање проблеми
- Секогаш читајте ја серверската конзолна излезна порака. Речиси секоја грешка вклучува порака во конзолата што ви кажува што тргнало наопаку и каде.
- Рестартирајте го серверот по промени во конфигурацијата. Повеќето промени во
server.cfgбараат целосен рестарт на серверот за да стапат во сила. - Оневозможувајте ги ресурсите еден по еден за да ги изолирате проблемите. Искоментирајте ги
ensureлиниите воserver.cfgсо#. - Чувајте резервни копии на работните конфигурации пред правење промени. Преземете ги вашиот
server.cfgи база на податоци пред поголеми ажурирања. - Проверете ги Cfx.re форумите и документацијата на docs.fivem.net за официјална документација што се однесува и на FiveM и на RedM.
- Проверете ја компатибилноста на ресурсите со вашата верзија на серверот. Ресурсите изградени за постари верзии можеби нема да работат со тековните RedM builds.
Поврзани статии
- Водич за поставување на RedM сервер — Лиценцни клучеви, конфигурација на server.cfg, управување со ресурси и поврзување.
- Како да го пронајдете IP и портот на вашиот сервер
- Како да прикачувате датотеки преку SFTP
- Започнување со вашиот нов сервер
Потребна помош?
Сè уште доживувате проблеми со вашиот RedM сервер? Отворете тикет за поддршка и вклучете ги сите пораки за грешка од вашата серверска конзола. Нашиот тим ќе ви помогне да го дијагностицирате и решите проблемот.
