Установка FiveM-сервера с нуля

MAATRIX GAMES

Если ты открыл эту статью, значит уже решил, что будущий RP-проект живёт на FiveM, и теперь нужен не обзор платформы, а конкретные шаги: что скачать, куда положить, что вписать в конфиг и как сделать так, чтобы сервер вообще появился в списке серверов. Пройдём путь с абсолютного нуля — от пустой папки на VPS до сервера, к которому можно подключиться из клиента FiveM и увидеть в браузере CFX.

Где на самом деле лежат серверные файлы

Первая и самая частая ошибка новичка — искать серверное приложение там же, где клиент, то есть на fivem.net. Клиентский лаунчер и серверный рантайм (FXServer) — разные продукты с разной судьбой обновлений. Актуальные сборки сервера публикуются как артефакты на runtime.fivem.net — это прямое хранилище билдов, на которое ссылается и человекочитаемая страница fivem.net/builds, если тебе удобнее выбирать сборку глазами, а не по ссылке из терминала.

На странице артефактов три канала:

• recommended — стабильный, проверенный временем билд, разумный выбор для первого сервера и вообще для любого прод-проекта;
• latest — самая свежая сборка, может тащить непротестированные баги;
• optimal — компромисс между свежестью и стабильностью, но тоже не для боевого RP с деньгами игроков в базе.

Для Linux берёшь архив вида fx.tar.xz, для Windows — zip-архив с FXServer.exe внутри. Дальше два параллельных пути — Linux VPS и Windows-сервер — разберём оба, потому что панели хостинга нередко дают именно Windows-инстанс под RP-проекты с готовыми MySQL-сервисами.

Установка на Linux: распаковка и структура папок

На Linux-VPS (Debian/Ubuntu — самый предсказуемый выбор под FiveM) создаём рабочую директорию и разворачиваем скачанный архив:

mkdir -p ~/fivem-server
cd ~/fivem-server
curl -LO <ссылка_на_fx.tar.xz_с_runtime.fivem.net>
tar xf fx.tar.xz

Ссылку на конкретный архив всегда бери свежую со страницы артефактов на момент установки — версии в билдах меняются постоянно, а зафиксированная в тексте статьи ссылка устареет уже через одно-два обновления. После распаковки в папке появляются run.sh, набор системных .so/бинарников рантайма и папка alpine/citizen — их не трогаем руками, это внутренняя кухня FXServer.

Рядом кладём базовый набор ресурсов из официального репозитория cfx-server-data — без него сервер стартует «голым», без чата, спавн-менеджера и карты сессий:

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

Установка на Windows: FXServer.exe и структура

На Windows всё аналогично по смыслу, но пути и файлы другие. Распаковываешь скачанный zip в отдельную папку, например C:\fivem-server, и получаешь FXServer.exe плюс run.cmd — стартовый батник, который удобнее голого exe, потому что сам подставляет нужные флаги окружения.

Рядом клонируешь тот же cfx-server-data — через Git for Windows либо просто скачиваешь ZIP репозитория с GitHub и распаковываешь как server-data рядом с FXServer.exe, если Git ставить не хочется. Структура на выходе должна быть одинаковой что на Linux, что на Windows: рядом друг с другом лежат папка с рантаймом и папка server-data с ресурсами и будущим server.cfg.

Пишем server.cfg с нуля

Официальный server-data даёт server.cfg как шаблон-заготовку, но проще понять, что происходит, если собрать минимальный конфиг руками и потом дополнять его. Создай (или отредактируй) файл server.cfg внутри server-data:

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

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

sv_licenseKey "СЮДА_ЛИЦЕНЗИОННЫЙ_КЛЮЧ"

exec permissions.cfg

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

Разбор по строкам:

• sv_hostname — имя, которое видят игроки в браузере серверов, ^2/^7 — цветовые коды текста FiveM (зелёный, белый);
• sv_maxclients — лимит слотов, для чистого фрирома без RP-нагрузки 32 достаточно для старта;
• endpoint_add_tcp/endpoint_add_udp — обязательная пара строк на порт 30120 (порт по умолчанию), обе должны указывать один и тот же порт и совпадать между собой — рассинхрон TCP/UDP портов даёт сервер, который вроде запущен, но не отвечает клиентам;
• sv_licenseKey — без этой строки сервер откажется стартовать, о ней отдельно ниже.

Лицензионный ключ и первая активация в браузере CFX

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

Дальше — момент, который путает многих на первом запуске: когда стартуешь сервер впервые (особенно если используешь встроенный веб-мастер настройки, а не голый +exec server.cfg), консоль или веб-интерфейс выдаёт одноразовую ссылку вида cfx.re/join/XXXXXXX. Её нужно открыть в браузере под тем же аккаунтом Cfx.re — это и есть шаг активации, который связывает конкретный процесс сервера с твоим аккаунтом и разрешает ему регистрироваться в общем списке серверов. Пропустишь этот шаг — сервер будет технически работать и принимать прямые подключения, но не появится в публичном браузере серверов.

Учти: ключ в Keymaster жёстко привязан к IP. Сменишь VPS или адрес — обнови привязку в кабинете, иначе получишь ошибку валидации лицензии при следующем старте.

Первый запуск и проверка подключения

На Linux из папки с рантаймом:

cd ~/fivem-server
./run.sh +exec server-data/server.cfg

На Windows — двойной клик по run.cmd или из консоли:

cd C:\fivem-server
FXServer.exe +exec server-data\server.cfg

В консоли должна пройти инициализация ресурсов из ensure-списка без красных ошибок, а в конце — строка о том, что сервер слушает порт 30120. Если видишь ошибку про sv_licenseKey — вернись к предыдущему шагу и перепроверь и сам ключ, и привязку IP в Keymaster.

Проверить, что сервер реально принимает подключения, проще всего напрямую, не дожидаясь появления в общем списке: открой консоль клиента FiveM (~ или F8) и введи:

connect IP_сервера:30120

Если зашёл — база рабочая. Появление в самом браузере серверов CFX может занять несколько минут после активации по cfx.re/join, это нормально: список подтягивается не мгновенно. Если сервера нет в браузере дольше 10–15 минут при прошедшей активации — почти всегда дело в портах или в sv_master1, это отдельная и довольно частая проблема, разобранная в статье про сервер, не отображающийся в браузере FiveM.

Что дальше: от голого сервера к RP-проекту

То, что запустилось на этом шаге — чистый минимальный сервер без фреймворка, экономики и ролей: подходящая база для теста, но не для полноценного RP. Дальше типичный путь такой:

1. Определиться с фреймворком — сравнение архитектуры, экономики и производительности ESX и QBCore есть в отдельном разборе фреймворков для FiveM;
2. Накатить кастомные ресурсы и скрипты поверх базового server-data — как правильно ставить их без конфликтов зависимостей, разобрано в статье про установку кастомных скриптов на FiveM;
3. Для продакшена стоит добавить автозапуск, панель управления txAdmin и настройку firewall — этот прод-слой выходит за рамки установки с нуля и разобран в более широком гайде по поднятию FiveM-сервера.

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