Wiki FiveM
Настройка сервера
Обновлено: 08.07.2026 00:55

Настройка сервера

🕒 Последнее изменение: 08 июля 2026 в 00:55

Данная статья описывает настройку выделенного сервера FiveM: получение лицензии Cfx.re, первый запуск, включение или отключение txAdmin, настройку server.cfg, основные переменные запуска и подключение игроков.

Что такое FiveM

FiveM — это платформа для запуска пользовательских мультиплеерных серверов GTA V. Она позволяет использовать собственные режимы, скрипты, ресурсы, карты, транспорт, роли и расширенную настройку игрового процесса.

Перед началом

Перед запуском сервера подготовьте:

  • лицензионный ключ Cfx.re для FiveM;
  • доступ к панели управления сервером;
  • установленный клиент FiveM на компьютере;
  • IP-адрес и порт сервера из вкладки «Network»;
  • Steam Web API Key, если он требуется вашему серверу или ресурсам.

Получение лицензии FiveM

Каждому серверу FiveM нужен лицензионный ключ Cfx.re.

Ключ задаётся переменной запуска:

FIVEM_LICENSE

Чтобы получить ключ:

  1. Откройте Cfx.re Keymaster.
  2. Войдите в аккаунт Cfx.re.
  3. Создайте новый серверный ключ.
  4. Укажите IP-адрес сервера.
  5. Скопируйте полученный ключ.
  6. Вставьте его в переменную FIVEM_LICENSE во вкладке «Startup».

Внимание: не публикуйте лицензионный ключ. Если ключ был скомпрометирован, отзовите его и создайте новый.

Основные переменные запуска

Главные параметры сервера задаются во вкладке «Startup».

Переменная Назначение
FIVEM_LICENSE Лицензионный ключ Cfx.re.
MAX_PLAYERS Максимальное количество игроков.
SERVER_HOSTNAME Название сервера в браузере FiveM.
FIVEM_VERSION Версия артефакта FiveM для установки.
STEAM_WEBAPIKEY Steam Web API Key или значение none.
TXADMIN_ENABLE Включение или отключение txAdmin.
TXHOST_TXA_PORT Порт веб-панели txAdmin.
TXHOST_GAME_NAME Тип сервера: fivem или redm.
TXHOST_DATA_PATH Каталог данных txAdmin.

Первый запуск сервера

  1. Откройте сервер в панели управления.
  2. Перейдите во вкладку «Startup».
  3. Укажите FIVEM_LICENSE.
  4. Проверьте MAX_PLAYERS и SERVER_HOSTNAME.
  5. Выберите, нужен ли txAdmin.
  6. Перейдите во вкладку «Console».
  7. Запустите сервер.

Во время установки сервер скачивает файлы FiveM, базовые ресурсы и создаёт начальный server.cfg, если он ещё не существует.

Включение txAdmin

txAdmin включается переменной:

TXADMIN_ENABLE=1

Если txAdmin включён, сервер запускается в режиме настройки через txAdmin.

Порт txAdmin задаётся переменной:

TXHOST_TXA_PORT

Формат адреса txAdmin:

http://IP:TXHOST_TXA_PORT

PIN-код для первого входа обычно отображается в консоли при запуске.

Отключение txAdmin

Если txAdmin не нужен, используйте:

TXADMIN_ENABLE=0

В этом режиме сервер запускается напрямую с выполнением:

+exec server.cfg

Это удобно, если вы хотите управлять сервером через обычный server.cfg и файловый менеджер.

Настройка txAdmin при первом запуске

  1. Запустите сервер с включённым TXADMIN_ENABLE=1.
  2. Откройте адрес txAdmin в браузере.
  3. Введите PIN-код из консоли.
  4. Создайте администратора txAdmin.
  5. Выберите рецепт или шаблон сервера.
  6. Укажите лицензионный ключ Cfx.re, если мастер настройки попросит его повторно.
  7. Дождитесь завершения развёртывания файлов.

Внимание: сохраните логин и пароль администратора txAdmin. При потере доступа может потребоваться сброс профиля txAdmin.

server.cfg

server.cfg — основной конфигурационный файл FiveM при запуске без txAdmin или при ручной настройке сервера.

В текущем egg часть значений автоматически подставляется в server.cfg:

endpoint_add_tcp
endpoint_add_udp
sv_hostname
set sv_licenseKey
set steam_webApiKey
sv_maxclients

Эти параметры связаны с переменными запуска и портом сервера.

Основные параметры server.cfg

Параметр Назначение
endpoint_add_tcp TCP-адрес и порт сервера.
endpoint_add_udp UDP-адрес и порт сервера.
sv_hostname Название сервера.
sv_licenseKey Лицензионный ключ Cfx.re.
steam_webApiKey Steam Web API Key.
sv_maxclients Максимальное количество игроков.
sets sv_projectName Название проекта в браузере серверов.
sets sv_projectDesc Описание проекта в браузере серверов.
sv_endpointprivacy Настройка приватности endpoint-данных.

Минимальный пример server.cfg

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

sv_hostname "My FiveM Server"
sets sv_projectName "My RP Server"
sets sv_projectDesc "Custom FiveM server"


set sv_licenseKey "cfxk_YOUR_KEY_HERE"
set steam_webApiKey "none"


sv_maxclients 48
sv_endpointprivacy true


ensure mapmanager
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure chat

Внимание: порт в endpoint_add_tcp и endpoint_add_udp должен совпадать с игровым портом, выделенным серверу во вкладке «Network».

Название сервера

Название сервера задаётся переменной:

SERVER_HOSTNAME

В server.cfg это соответствует:

sv_hostname "My FiveM Server"

Если название не меняется после редактирования файла, проверьте значение SERVER_HOSTNAME во вкладке «Startup».

Максимальное количество игроков

Лимит игроков задаётся переменной:

MAX_PLAYERS

В server.cfg это соответствует:

sv_maxclients 48

Текущие правила egg ограничивают значение диапазоном, заданным в переменной MAX_PLAYERS.

Steam Web API Key

Steam Web API Key задаётся переменной:

STEAM_WEBAPIKEY

Если Steam-интеграция не нужна, можно оставить:

none

Если ваши ресурсы требуют Steam-идентификацию, укажите действительный Steam Web API Key.

Версия FiveM

Версия артефакта FiveM задаётся переменной:

FIVEM_VERSION

Допустимые практичные значения:

recommended
latest
конкретный build id

Если указана неверная версия, установщик переключится на recommended.

Пользовательская ссылка загрузки

Переменная DOWNLOAD_URL используется только установочным скриптом и обычно скрыта.

Она нужна только в том случае, если требуется принудительно скачать конкретный архив FiveM.

В большинстве случаев оставляйте её пустой.

Тип сервера FiveM или RedM

Переменная:

TXHOST_GAME_NAME

может принимать значения:

fivem
redm

Установочный скрипт автоматически сопоставляет:

fivem → gta5
redm → rdr3

и записывает нужный gamename в server.cfg.

Подключение к серверу

Игроки могут подключиться через браузер серверов FiveM или напрямую по IP и порту.

Прямое подключение

  1. Запустите клиент FiveM.
  2. Откройте консоль клавишей F8.
  3. Введите команду подключения.
connect IP:PORT

Пример:

connect 123.123.123.123:30120

Подключение через браузер серверов

  1. Откройте FiveM.
  2. Перейдите в браузер серверов.
  3. Найдите сервер по названию.
  4. Выберите сервер.
  5. Нажмите Connect.

Новый сервер может появиться в браузере не сразу. Используйте прямое подключение, пока сервер индексируется.

Управление сервером через txAdmin

Если txAdmin включён, он предоставляет веб-интерфейс для управления сервером.

Раздел Назначение
Dashboard Общее состояние сервера, игроки и показатели работы.
Players Просмотр игроков, кик, бан и история подключений.
Live Console Выполнение серверных команд в реальном времени.
Resources Запуск, остановка и перезапуск ресурсов.
Server Log Просмотр логов сервера.
CFG Editor Редактирование конфигурационных файлов.
Scheduled Restarts Настройка автоматических перезапусков.

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

Проверьте:

  • указан действительный FIVEM_LICENSE;
  • порт сервера совпадает с endpoint_add_tcp и endpoint_add_udp;
  • указана корректная версия FIVEM_VERSION;
  • артефакт FiveM успешно скачался и распаковался;
  • в server.cfg нет ошибок синтаксиса;
  • ресурсы, указанные через ensure, существуют.

Сервер не отображается в браузере FiveM

Проверьте:

  • сервер полностью запущен;
  • после запуска прошло несколько минут;
  • FIVEM_LICENSE действителен;
  • порт сервера доступен;
  • sv_hostname задан корректно;
  • в консоли нет ошибок подключения к Cfx.re.

Игроки не могут подключиться

Проверьте:

  • игрок использует правильный IP и порт;
  • игровой порт выделен серверу во вкладке «Network»;
  • в server.cfg указаны правильные endpoint_add_tcp и endpoint_add_udp;
  • сервер не заполнен по MAX_PLAYERS;
  • ресурсы сервера не вызывают ошибку при подключении.

Настройки не применяются

Проверьте:

  • если txAdmin включён, настройки могут управляться через профиль txAdmin;
  • если txAdmin выключен, сервер запускается через +exec server.cfg;
  • значения SERVER_HOSTNAME, MAX_PLAYERS, FIVEM_LICENSE и STEAM_WEBAPIKEY могут перезаписываться из переменных запуска;
  • после изменения конфигурации сервер был перезапущен.

Рекомендации

  • храните FIVEM_LICENSE в секрете;
  • используйте txAdmin, если хотите управлять сервером через веб-интерфейс;
  • отключите txAdmin, если хотите полностью контролировать запуск через server.cfg;
  • проверяйте порт сервера во вкладке «Network» перед изменением endpoint_add_tcp и endpoint_add_udp;
  • не используйте latest на стабильном сервере без необходимости;
  • перед изменением ресурсов и конфигурации создавайте резервную копию;
  • при проблемах сначала проверяйте консоль и последние строки лога.

Файлы и параметры, которые рекомендуется проверять при настройке:

server.cfg
resources/
logs/
txData/
FIVEM_LICENSE
MAX_PLAYERS
SERVER_HOSTNAME
STEAM_WEBAPIKEY
TXADMIN_ENABLE
TXHOST_TXA_PORT
TXHOST_GAME_NAME
Информация

После завершения платежа выбранная вами сумма будет зачислена на ваш баланс, что позволит вам продлить ваши услуги или разместить новые заказы.

Сколько вы хотите добавить?