Это руководство описывает решения наиболее распространённых проблем сервера FiveM — проблемы доступа к TXAdmin, ошибки лицензионного ключа CFX, сбои подключения к базе данных, краши сервера, проблемы подключения игроков и незагружающиеся ресурсы. Для первоначальной настройки сервера см. Руководство по настройке сервера FiveM.

TXAdmin не загружается или недоступен

• Убедитесь, что сервер запущен в GPanel — TXAdmin запускается только когда процесс сервера FiveM активен.
• Проверьте в консоли GPanel URL и порт TXAdmin. Порт TXAdmin отличается от игрового порта.
• Убедитесь, что вы используете http://, а не https:// — TXAdmin по умолчанию не использует SSL.
• Если TXAdmin работал раньше, но перестал загружаться, попробуйте перезапустить сервер из GPanel.
• Очистите кэш браузера или попробуйте окно в режиме инкогнито/приватного просмотра.

Ошибки лицензионного ключа CFX

Ошибки подключения к базе данных

Дополнительные шаги по устранению неполадок с базой данных:

• Если вы используете oxmysql, убедитесь, что ресурс oxmysql находится в папке resources/ и что строка ensure oxmysql присутствует в server.cfg перед любыми ресурсами, которым требуется база данных.
• Если ваш пароль содержит специальные символы, такие как @, # или %, выполните их URL-кодирование в строке подключения (например, @ становится %40).
• Проверьте строку подключения на отсутствие или наличие лишних символов — даже один неуместный символ вызовет сбой.

Сервер крашится при запуске

• Проверьте консоль 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 совпадают. Несоответствие будет препятствовать подключениям.

Ресурсы не загружаются

• Проверьте, что папка ресурса находится внутри каталога resources/ (или соответствующей подпапки).
• Убедитесь, что имя папки точно совпадает со строкой ensure в server.cfg (с учётом регистра).
• Каждый ресурс должен содержать действительный fxmanifest.lua (или более старый __resource.lua). Если этот файл отсутствует, ресурс не загрузится.
• Проверьте консоль TXAdmin или GPanel на наличие сообщений об ошибках, связанных с ресурсом. Распространённые ошибки включают отсутствующие зависимости или синтаксические ошибки Lua.
• Если ресурсу требуется фреймворк (ESX, QBCore), убедитесь, что фреймворк загружается перед ресурсом в server.cfg.
• Если ресурсу требуется база данных, убедитесь, что ваш ресурс MySQL (oxmysql, mysql-async) загружен и подключение к базе данных работает.

Проблемы с производительностью сервера

• Откройте TXAdmin и проверьте Dashboard на наличие метрик производительности (время тика, количество игроков, использование памяти).
• Здоровый сервер FiveM должен поддерживать время тика сервера (также называемое «hitch») ниже 20 мс. Постоянные всплески выше этого значения указывают на то, что какой-то ресурс использует слишком много процессорного времени.
• Используйте страницу Resources в TXAdmin, чтобы определить, какие ресурсы потребляют больше всего серверного времени.
• Удалите или замените плохо оптимизированные ресурсы. Бесплатные ресурсы из неизвестных источников часто являются причиной проблем с производительностью.
• Уменьшите количество загруженных ресурсов, если достигаются лимиты памяти или процессора вашего тарифного плана сервера.

Получение помощи

Если вы попробовали приведённые выше решения и всё ещё испытываете проблемы:

1. Скопируйте полное сообщение об ошибке из консоли GPanel или лога TXAdmin.
2. Запишите, какие шаги по устранению неполадок вы уже попробовали.
3. Откройте тикет в поддержку на https://legionhosting.net/submitticket.php с этой информацией. Наша команда поможет вам как можно быстрее.

Похожие статьи

• Руководство по настройке сервера FiveM
• Настройка ресурсов, скриптов и базы данных FiveM
• Как найти IP и порт вашего сервера
• Руководство по запуску сервера