Посібник з усунення поширених несправностей сервера 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_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 у ресурсі має синтаксичну помилку або помилку часу виконання.
- Виправлення: Прочитайте повне повідомлення про помилку в консолі. Воно міститиме назву файлу та номер рядка. Поширені причини:
- Відсутні залежності (інший ресурс, який має бути завантажений першим)
- Застарілий ресурс, не сумісний із поточною версією сервера 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, гравець має ввести правильний пароль. - Ресурс білого списку/списку дозволів: Якщо у вас увімкнено ресурс білого списку, гравець має бути схвалений перед підключенням.
- Бан: Гравця може бути забанено. Перевірте ваш список банів або базу даних щодо його ідентифікаторів.
Клієнт зазнає збою під час підключення
- Ресурс на сервері надсилає некоректні дані або має помилку у скрипті на стороні клієнта, яка призводить до збою клієнта.
- Виправлення: Вимикайте нещодавно додані ресурси по одному, щоб визначити проблемний. Перевірте консоль сервера на наявність помилок під час підключення клієнта.
- Переконайтеся, що клієнт RedM гравця оновлено.
Помилки «Could not download file»
- Сервер намагається надіслати великий файл (напр., потоковий ассет), що перевищує ліміти передачі, або з’єднання нестабільне.
- Виправлення: Зменште розмір потокових ассетів, використовуйте CDN/зовнішній хостинг для великих файлів, якщо це підтримується, або нехай гравець повторить підключення.
Проблеми з базою даних (MySQL / oxmysql)
Більшість рольових фреймворків RedM використовують MySQL для постійного зберігання даних. Найпоширеніший конектор бази даних — oxmysql.
Помилки «Connection Failed»
Якщо 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 |
Сервер бази даних недоступний. Перевірте, чи немає правил брандмауера, що блокують підключення, або чи правильний хост бази даних. |
| «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 зазнає лагів, низької частоти тіків або загалом поганої продуктивності:
Виявлення проблем з продуктивністю
Перевірте консоль сервера на наявність попереджень про продуктивність. Сервери RedM націлені на частоту тіків близько 30-64 тіків на секунду. Ви можете відстежувати це за допомогою:
- Інформаційної панелі txAdmin: Якщо txAdmin доступний, він показує метрики продуктивності сервера в реальному часі.
- Консолі сервера: Стежте за попередженнями «slow tick» або «resource hitch».
- Команди resmon: Введіть
resmon 1у консолі сервера (або консолі F8), щоб увімкнути монітор ресурсів, який показує час CPU на кожен ресурс.
Поширені рішення проблем з продуктивністю
| Проблема | Рішення |
|---|---|
| Висока завантаженість CPU від конкретного ресурсу | Використовуйте resmon 1 для визначення ресурсу. Розгляньте можливість заміни його більш оптимізованою альтернативою або зверніться до розробника ресурсу. |
| Завантажено забагато ресурсів | Кожен ресурс споживає ресурси сервера. Перегляньте ваш список ресурсів і видаліть усі невикористовувані або надлишкові. |
| Вузьке місце у запитах до бази даних | Повільні або неіндексовані запити до бази даних можуть спричиняти підвисання сервера. Перевірте попередження про повільні запити oxmysql у консолі. Додайте індекси до стовпців, до яких часто звертаються. |
| Висока кількість гравців спричиняє лаги | Зменште sv_maxclients до рівня, який може витримати апаратне забезпечення вашого сервера. Розгляньте можливість оновлення вашого хостингового плану для отримання більше ресурсів. |
| Ліміти сутностей OneSync | Забагато заспавнених сутностей (педи, транспортні засоби, об’єкти) можуть погіршувати продуктивність. Використовуйте ресурси, які очищують невикористовувані сутності. |
| Витоки пам’яті | Деякі погано написані ресурси з часом призводять до витоку пам’яті. Відстежуйте використання RAM сервера в GPanel. Регулярні перезапуски сервера (кожні 6-12 годин) можуть пом’якшити це. |
Рекомендовані практики
- Плануйте автоматичні перезапуски кожні 6-12 годин, використовуючи функцію розкладу GPanel або txAdmin, щоб очищати накопичені проблеми з пам’яттю та сутностями.
- Тримайте ресурси оновленими, щоб отримувати вигоду від виправлень продуктивності та оптимізацій.
- Уникайте дублювання функціональності — не запускайте два ресурси, що роблять одне й те саме (напр., дві системи погоди).
- Тестуйте нові ресурси на тестовому сервері (або з низькою кількістю гравців), перш ніж розгортати на вашому основному сервері.
- Регулярно відстежуйте метрики сервера через 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? Створіть заявку до служби підтримки та вкажіть будь-які повідомлення про помилки з консолі вашого сервера. Наша команда допоможе вам діагностувати та вирішити проблему.
