Ръководство за отстраняване на проблеми за често срещани проблеми с 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 сървърите. Новите сървъри може да отнемат няколко минути, за да се появят.
- Проверете дали лицензният ключ е валиден. Сървърът няма да бъде в списъка без работещ лицензен ключ. Проверете конзолата на сървъра за грешки, свързани с лиценза.
- Проверете конфигурацията на endpoint. Уверете се, че
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 ""във вашата конфигурация (това деактивира регистрацията в главния списък). - Проверете дали сървърът наистина работи. Проверете конзолата на 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 или SFTP за проверка.
"Failed to load resource [resource_name]: manifest error"
- Файлът
fxmanifest.luaили__resource.luaна ресурса има синтактична грешка. - Манифестът препраща към файлове, които не съществуват в папката на ресурса.
- Поправка: Отворете манифестния файл и проверете за печатни грешки, липсващи запетаи или препратки към несъществуващи файлове. Проверете конзолата на сървъра за конкретния номер на ред на грешката.
"Error loading script [filename]: [error details]"
- Lua, C# или JavaScript файл в ресурса има синтактична или runtime грешка.
- Поправка: Прочетете пълното съобщение за грешка в конзолата. То ще включва името на файла и номера на реда. Често срещаните причини включват:
- Липсващи зависимости (друг ресурс, който трябва да бъде зареден първи)
- Остарял ресурс, несъвместим с текущата версия на 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 | Уверете се, че 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 сървърът не работи, хостът/портът е грешен или MySQL сървърът не приема външни връзки. Проверете хоста, порта и дали вашият сървър за бази данни е онлайн. |
ER_ACCESS_DENIED_ERROR |
Грешно потребителско име или парола в низа за връзка. Проверете двукратно идентификационните данни в панела за хостинг на вашата база данни. |
ER_BAD_DB_ERROR |
Името на базата данни не съществува. Първо създайте базата данни чрез вашия панел за управление на бази данни (phpMyAdmin и др.). |
ETIMEDOUT |
Сървърът за бази данни е недостъпен. Проверете дали има firewall правила, които блокират връзката, или дали хостът на базата данни е правилен. |
| "Too many connections" | Базата данни е достигнала максималния си лимит на връзки. Това може да се случи, ако ресурсите не затварят правилно връзките или ако лимитът е твърде нисък. Рестартирайте сървъра и проверете настройката max_connections на MySQL. |
Съвет: Ако вашият RedM сървър и MySQL база данни са на една и съща машина, използвайте
localhost или 127.0.0.1 като хост. Ако са на различни сървъри, използвайте IP адреса на сървъра за бази данни и се уверете, че MySQL потребителят има привилегии за отдалечена връзка.
Липсващи таблици или грешки в схемата
Ролеплей фреймуърците често изискват таблици в базата данни да бъдат настроени, преди да могат да функционират:
- Проверете документацията на фреймуърка или GitHub хранилището за SQL импортни файлове (често наречени
database.sql,schema.sqlили подобни). - Импортирайте SQL файла във вашата база данни с помощта на phpMyAdmin или MySQL клиент.
- Някои фреймуърци автоматично създават таблици при първото стартиране. Уверете се, че потребителят на базата данни има привилегии
CREATE TABLE.
Проблеми с производителността
Ако вашият RedM сървър изпитва lag, ниска tick rate или обща лоша производителност:
Идентифициране на проблеми с производителността
Проверете конзолата на сървъра за предупреждения за производителност. RedM сървърите целят tick rate от около 30-64 тика в секунда. Можете да наблюдавате това с:
- txAdmin дашборд: Ако txAdmin е наличен, той показва метрики за производителност на сървъра в реално време.
- Конзола на сървъра: Следете за предупреждения "slow tick" или "resource hitch".
- команда resmon: Въведете
resmon 1в конзолата на сървъра (или F8 конзолата), за да активирате монитора на ресурси, който показва CPU време за всеки ресурс.
Често срещани решения за производителност
| Проблем | Решение |
|---|---|
| Висока CPU употреба от конкретен ресурс | Използвайте resmon 1, за да идентифицирате ресурса. Помислете за замяната му с по-оптимизирана алтернатива или се свържете с разработчика на ресурса. |
| Твърде много заредени ресурси | Всеки ресурс консумира сървърни ресурси. Прегледайте вашия списък с ресурси и премахнете тези, които не се използват или са излишни. |
| Тясно място при заявки към базата данни | Бавните или неиндексирани заявки към базата данни могат да причинят забавяния на сървъра. Проверете предупрежденията за бавни заявки на oxmysql в конзолата. Добавете индекси към често запитваните колони. |
| Висок брой играчи, причиняващ lag | Намалете 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 билдове.
Свързани статии
- Ръководство за настройка на RedM сървър — Лицензни ключове, конфигурация на server.cfg, управление на ресурси и свързване.
- Как да намерите IP адреса и порта на вашия сървър
- Как да качвате файлове чрез SFTP
- Първи стъпки с вашия нов сървър
Нуждаете се от помощ?
Все още изпитвате проблеми с вашия RedM сървър? Отворете тикет за поддръжка и включете всякакви съобщения за грешки от конзолата на вашия сървър. Нашият екип ще ви помогне да диагностицирате и разрешите проблема.
