Как поднять сервер FiveM (GTA V): пошаговая инструкция

MAATRIX GAMES

Если ты искал, как поставить FiveM-сервер, и первым делом полез в Steam искать «серверное приложение» — сразу забудь, там его нет и не будет. FiveM живёт отдельной жизнью от Steam-версии GTA V, и первая грабля новичка — как раз попытка найти серверный билд не там, где он лежит. Разберём процесс так, как его стоит делать с самого начала: с правильного источника файлов, рабочего server.cfg, лицензии Cfx.re и панели txAdmin, которая избавит от боли с ручным редактированием конфигов на каждый чих.

Системные требования: сколько ресурсов реально нужно

FiveM не такой прожорливый, как полноценный MMO-бэкенд, но и не игрушка на 512 МБ — сервер держит на себе Lua/JS-скрипты ресурсов, синхронизацию сущностей между игроками и (если у тебя RP-проект) базу данных с десятками таблиц.

Стартовая точка — 4 ГБ RAM, это минимум, ниже которого даже голый сервер без ресурсов начинает подтормаживать при 10+ игроках. Дальше ориентируйся по нагрузке:

Это ориентир, не результат бенчмарка на конкретном железе — реальное потребление сильно зависит от того, сколько тиков в секунду отрабатывают твои ресурсы и насколько криво написаны скрипты (плохо оптимизированный Lua-луп на Citizen.Wait(0) посадит любой сервер быстрее, чем нехватка RAM). Диск бери SSD/NVMe: карты, стриминг-ресурсы и MySQL-база под нагрузкой от медленного диска ощутимо тормозят. ОС — Debian или Ubuntu LTS, под них проще всего найти актуальные гайды и готовые скрипты для ESX/QBCore.

Скачиваем серверный билд — и почему это не Steam-приложение

Ключевой момент, который путает почти всех новичков: клиент FiveM (то, что ставят игроки поверх легальной копии GTA V) и серверный билд FXServer — это два разных продукта. Клиент действительно качается с fivem.net и работает поверх игры из Steam/Epic/Rockstar Launcher, но серверу сама игра вообще не нужна — он не запускает GTA V, а раздаёт игровую логику и синхронизирует состояние мира между подключёнными клиентами.

Серверные билды публикуются на fivem.net/builds (артефакты рантайма). Там нужно выбрать канал Linux (для Windows-хостинга список отдельный) и взять сборку из ветки recommended — не latest/optimal, если не готов ловить свежие баги на проде. Дальше на VPS:

mkdir -p ~/fxserver
cd ~/fxserver
curl -LO <ссылка_на_архив_с_fivem.net_builds>
tar xf fx.tar.xz

Точную ссылку на архив всегда бери со страницы builds на момент установки — билды выходят регулярно, и захардкоженная в статье ссылка устареет уже через пару недель. После распаковки в папке появится run.sh (или FXServer.exe/run.cmd на Windows) и набор системных файлов рантайма — их руками не трогаем.

Базовый ресурс сервера: cfx-server-data

Голого рантайма мало — нужна база ресурсов и шаблон конфига. Официальный стартовый набор лежит в репозитории cfx-server-data:

cd ~/fxserver
git clone https://github.com/citizenfx/cfx-server-data.git server-data
cd server-data

Внутри — папка resources/[game] с базовыми компонентами (mapmanager, chat, spawnmanager, sessionmanager, basic-gamemode, hardcap, rconlog) и шаблон server.cfg, от которого удобнее отталкиваться, чем писать конфиг с нуля. Если планируешь ESX или QBCore — их устанавливают поверх этой же структуры отдельными ресурсами и своим набором SQL-таблиц, но это уже тема отдельного гайда, здесь не растягиваем: с базовой установки framework встанет за 15–20 минут по документации самого фреймворка.

Настройка server.cfg: hostname, порт, слоты, лицензия

Открывай server-data/server.cfg и правь под себя. Минимальный рабочий набор строк:

sv_hostname "^2Мой сервер ^7| FiveM RP"
sv_maxclients 32

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

sv_licenseKey "ЗДЕСЬ_ТВОЙ_КЛЮЧ"

set steam_webApiKey "не обязателен, если не используешь Steam-идентификацию"

exec permissions.cfg

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

По умолчанию FiveM слушает порт 30120, и TCP, и UDP — это единственный порт, который обязателен для самой игры (порт txAdmin — отдельная история, ниже). Если поднимаешь несколько серверов на одном VPS, для каждого следующего сдвигай порт (30121, 30122…) и меняй обе строки endpoint_add_* синхронно.

Лицензионный ключ Cfx.re — обязательный шаг, без него сервер просто откажется стартовать. Получить его можно на keymaster.fivem.net, авторизовавшись тем же аккаунтом Cfx.re, что привязан к клиенту FiveM: создаёшь новый сервер в кабинете, привязываешь к нему IP (или домен) и получаешь строку ключа, которая идёт в sv_licenseKey. Ключ жёстко привязан к серверу в кабинете Keymaster — если сменишь VPS и IP, обнови привязку там же, иначе сервер перестанет валидироваться.

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

Запускать голый run.sh +exec server.cfg можно, но проще сразу поднять txAdmin — веб-панель управления, которая идёт в комплекте с современными билдами FXServer и берёт на себя рестарты, бэкапы, мониторинг ресурсов и права модераторов без ручного редактирования конфигов через SSH при каждой мелочи.

cd ~/fxserver
./run.sh

Запуск без параметров поднимает txAdmin на порту 40120 — заходишь в браузере на http://IP_сервера:40120, проходишь мастер первичной настройки: он попросит логин администратора, путь к server-data (или сам склонирует cfx-server-data), лицензионный ключ и параметры сервера. Дальше сервером можно управлять прямо из панели: смотреть консоль, ставить ресурсы, банить игроков, настраивать плановые рестарты.

Если хочешь запускать сервер сразу с готовым конфигом в обход мастера — используй ./run.sh +exec server.cfg из папки с server-data, но тогда управление ресурсами и правами придётся вести руками через файлы, а не через GUI.

Установка ресурса и проверка подключения

Добавить ресурс — значит положить его папку в resources/ и подключить строкой в конфиге. Например, для простого приветственного скрипта или готового мода с GitHub:

cd ~/fxserver/server-data/resources
git clone <ссылка_на_репозиторий_ресурса> my-resource

И в server.cfg:

ensure my-resource

После ensure ресурс подхватится либо сразу (если добавил до старта), либо командой refresh + ensure my-resource в консоли txAdmin/rcon без полного рестарта сервера — удобно на живом проекте, когда не хочется дропать всех игроков ради одного скрипта.

Проверить, что сервер вообще виден — самый простой способ: подключиться напрямую по connect IP:30120 из консоли клиента FiveM (открывается по ~/F8 в самом клиенте). Если сервер приватный или ещё не в браузере, это быстрее, чем ждать индексацию в общем списке.

Проброс портов и автозапуск через systemd

На VPS с публичным IP и без дополнительного firewall перед сервером порты обычно уже доступны снаружи, но проверить стоит всегда — открой минимум:

• 30120 TCP+UDP — игровой трафик, обязателен;
• 40120 TCP — веб-панель txAdmin, доступ к ней желательно ограничить конкретными IP или спрятать за VPN — это полноценная админка со всеми правами на сервер.

На Ubuntu с ufw:

sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
sudo ufw allow from твой.ip.админа to any port 40120

Автозапуск при перезагрузке VPS делаем через systemd-юнит — принцип тот же, что мы разбирали в статье про автозапуск сервера ARK: Survival Evolved, только с другим исполняемым файлом:

[Unit]
Description=FiveM FXServer
After=network.target

[Service]
Type=simple
User=fivem
WorkingDirectory=/home/fivem/fxserver/server-data
ExecStart=/home/fivem/fxserver/run.sh +exec server.cfg
Restart=on-failure
RestartSec=5
LimitNOFILE=8192

[Install]
WantedBy=multi-user.target

Сохрани как /etc/systemd/system/fxserver.service, затем:

sudo systemctl daemon-reload
sudo systemctl enable --now fxserver
sudo systemctl status fxserver

Логи после этого удобно смотреть через journalctl -u fxserver -f, не копаясь в файлах вручную.

Частые вопросы