Установка сервера FiveM (GTA 5) на Ubuntu 24.04

Материал из ARK-HOSTER.RU | Документация хостинга
Версия от 06:44, 17 ноября 2026; Maintenance script (обсуждение | вклад) (Статья исправлена по результатам проверки: образец server.cfg приведён к текущему стандартному набору ресурсов)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)
Перейти к навигации Перейти к поиску

FiveM — платформа для своих серверов GTA 5: ролевые проекты (RP), гонки, свои режимы игры и правила. С 2026 года это единственная платформа сетевой игры для GTA 5, которую разрешает издатель: проекты RAGE Multiplayer и alt:V закрыты. В статье — установка сервера FiveM на VDS с Ubuntu 24.04: сам сервер, панель управления txAdmin, лицензионный ключ, запуск как службы. Все команды проверены 17 ноября 2026 года на Ubuntu 24.04.4, снимки экрана сняты с настоящего сервера.

Что понадобится

  • VDS с Ubuntu 24.04: от 2 ядер и 4 ГБ памяти для небольшого сервера; для ролевого проекта с десятками ресурсов и игроков — 4–6 ядер и 8–16 ГБ. Серверу важна скорость ядра. Подберите тариф VDS; для крупного проекта — выделенный сервер.
  • Диск — от 20 ГБ: сам сервер занимает около 300 МБ, основное место уходит под ресурсы (машины, карты, одежду).
  • Учётная запись Cfx.re — бесплатная, регистрируется на forum.cfx.re. Она нужна дважды: чтобы получить лицензионный ключ сервера и чтобы войти в панель txAdmin. Без неё сервер не запустится.
  • Игрокам — лицензионная GTA 5 и программа FiveM.

В статье — обычный сервер FiveM (его ещё называют Legacy). Для переизданной GTA 5 Enhanced у FiveM отдельная сборка сервера в раннем доступе, часть настроек у неё другая.

Разработчики FiveM предупреждают, что сборка сервера для Linux поддерживается по остаточному принципу, а основной считается сборка для Windows. На практике Linux-сервер работает стабильно и используется большинством проектов; если какой-то ресурс требует Windows, его автор пишет об этом.

1. Подготовка

sudo apt update
sudo apt install -y xz-utils git curl jq tmux
sudo useradd -m -s /bin/bash fivem
sudo -iu fivem

Сервер будет работать от имени отдельного пользователя fivem; дальнейшие команды — в его сеансе.

2. Установка сервера

mkdir -p ~/FXServer/server && cd ~/FXServer/server
U=$(curl -s https://changelogs-live.fivem.net/api/changelog/versions/linux/server | jq -r .recommended_download); echo $U
curl -sL -C - --retry 5 --retry-all-errors -o fx.tar.xz $U; xz -t fx.tar.xz && tar xJf fx.tar.xz && rm fx.tar.xz
git clone -q --depth 1 https://github.com/citizenfx/cfx-server-data.git ~/FXServer/server-data
ls ~/FXServer/server ~/FXServer/server-data/resources

Что делают команды:

  • вторая спрашивает у FiveM адрес рекомендованной сборки сервера. Ссылки на конкретные сборки из старых инструкций устаревают за несколько недель;
  • третья скачивает архив (около 70 МБ), проверяет его целостность и распаковывает. Если она ответила «Unexpected end of input», загрузка оборвалась — повторите команду, она докачает файл;
  • четвёртая скачивает набор стандартных ресурсов.

Получилось два каталога, и разделены они не случайно:

Каталог Что в нём
~/FXServer/server Программа сервера. При обновлении заменяется целиком
~/FXServer/server-data Ваш сервер: ресурсы и файл настроек server.cfg. При обновлении не трогается

3. Лицензионный ключ

1. Откройте в браузере https://portal.cfx.re и войдите под учётной записью Cfx.re.

2. Перейдите в раздел регистрации серверов (Server Registration Keys) и создайте новый ключ: укажите название сервера и IP-адрес VDS.

3. Скопируйте ключ — он понадобится на шаге 5.

Ключ бесплатный. Он привязан к вашей учётной записи: никому его не передавайте и не выкладывайте вместе с настройками.

Без ключа сервер не работает — вот что он отвечает со строкой-заглушкой вместо ключа:

Сервер нашёл 20 ресурсов, попытался проверить ключ и остановился: «Could not authenticate server license key».

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

cd ~/FXServer/server-data
bash ~/FXServer/server/run.sh

Запущенный без параметров, сервер включает txAdmin — панель управления, встроенную в FiveM. В рамке — адрес панели и одноразовый код PIN (на снимке он скрыт). Откройте в браузере http://203.0.113.10:40120/, подставив адрес своего VDS:

1. Введите PIN из консоли и нажмите «Link Account».

2. Войдите под учётной записью Cfx.re — она станет главным администратором панели. Затем txAdmin попросит придумать запасной пароль.

3. Дальше откроется мастер настройки: название сервера, способ установки и лицензионный ключ. Для начала выберите «Existing Server Data», укажите каталог /home/fivem/FXServer/server-data и файл server.cfg из следующего шага. Готовые наборы для ролевых серверов (рецепты) можно развернуть позже.

Остановить сервер в консоли — Ctrl+C.

5. Файл настроек server.cfg

nano ~/FXServer/server-data/server.cfg
# Адрес и порт сервера. Меняйте только порт
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# Чат, встроенный в сервер
set resources_useSystemChat true

# Ресурсы, которые запускаются вместе с сервером
ensure mapmanager
ensure chat
ensure spawnmanager
ensure basic-gamemode
ensure hardcap

# Запретить посторонние программы, работающие через ScriptHook
sv_scriptHookAllowed 0

# Администраторы: все команды, кроме остановки сервера
add_ace group.admin command allow
add_ace group.admin command.quit deny
add_principal identifier.fivem:1 group.admin

# OneSync - современная синхронизация игроков, нужна большинству ресурсов
set onesync on

# Число мест
sv_maxclients 48

# Лицензионный ключ сервера с portal.cfx.re
sv_licenseKey ВАШ_КЛЮЧ

Файл составлен по официальным образцам — из документации FiveM и из набора рецептов txAdmin, с пояснениями на русском. Название, описание, язык, метки и значок сервера в списке задаются теперь не в файле, а на портале portal.cfx.re, в карточке сервера; прежние строки sv_hostname, sets sv_projectName, sets sv_projectDesc в файле больше не действуют. В старых инструкциях в списке ресурсов есть ещё sessionmanager и rconlog — в текущем стандартном наборе их нет, эти строки не нужны. Все строки разобраны в статье Настройка сервера FiveM (server.cfg, ресурсы, права).

6. Запуск как служба

Создайте скрипт запуска и выйдите из сеанса пользователя fivem:

printf '#!/bin/bash\ncd /home/fivem/FXServer/server-data\nexec bash /home/fivem/FXServer/server/run.sh\n' > ~/FXServer/start.sh; chmod +x ~/FXServer/start.sh
exit
sudo nano /etc/systemd/system/fivem.service
[Unit]
Description=FiveM server (FXServer with txAdmin)
After=network-online.target
Wants=network-online.target

[Service]
Type=forking
User=fivem
WorkingDirectory=/home/fivem/FXServer/server-data
ExecStart=/usr/bin/tmux -L fivem new-session -d -s fivem /home/fivem/FXServer/start.sh
ExecStop=/usr/bin/tmux -L fivem send-keys -t fivem C-c
ExecStop=/bin/sh -c 'while tmux -L fivem has-session -t fivem 2>/dev/null; do sleep 1; done'
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now fivem
systemctl is-active fivem
sudo ss -lntp | grep 40120 | awk '{print $4}'
sudo -u fivem tmux -L fivem capture-pane -p -t fivem | grep -E "txAdmin v|All ready|public-ip" | cut -c1-70

Служба запускает txAdmin, а уже он запускает и перезапускает игровой сервер. Панель слушает порт 40120; последняя команда показывает строки из консоли сервера, не открывая её.

Команда Что делает
sudo -u fivem tmux -L fivem attach -t fivem Открыть консоль: в ней виден PIN и сообщения сервера. Выход без остановки — Ctrl+B, затем D
sudo systemctl restart fivem Перезапустить txAdmin вместе с сервером
sudo systemctl stop fivem, sudo systemctl start fivem Остановить и запустить

Сам игровой сервер удобнее перезапускать кнопками в панели txAdmin — служба при этом продолжает работать.

7. Порты

Если на VDS включён файрвол, откройте порты:

sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
sudo ufw allow 40120/tcp
Порт Зачем
30120, TCP и UDP Сама игра. Нужны оба протокола
40120, TCP Панель txAdmin. Если управляете всегда с одного адреса, откройте порт только ему: sudo ufw allow from 198.51.100.7 to any port 40120 proto tcp

Игроки подключаются через программу FiveM: находят сервер в списке по названию или нажимают F8 и вводят connect 203.0.113.10:30120.

Что дальше

Что не проверено

Лицензионный ключ и вход в txAdmin привязаны к учётной записи Cfx.re владельца сервера, поэтому проверка остановилась там, где они требуются. Проверены: загрузка и установка, запуск txAdmin и его страница в браузере, поведение сервера без ключа, служба, порты. Не проверены: мастер настройки txAdmin после входа, запуск игрового сервера с настоящим ключом и вход игрока.

Если что-то пошло не так

Что видите Причина и решение
«Unexpected end of input» при распаковке Архив скачан не полностью. Повторите третью команду шага 2
«This server does not have a license key specified», «Could not authenticate server license key» В server.cfg нет ключа или он неверен — шаги 3 и 5. Ключ должен быть выдан на IP-адрес этого VDS
Страница txAdmin не открывается Закрыт порт 40120/tcp или служба не запущена
PIN не подходит Он одноразовый и меняется при каждом запуске — возьмите свежий из консоли
«Failed to start resource», ресурсы не найдены Сервер запущен не из каталога server-data
Игроки не могут подключиться Закрыт порт 30120 — нужны и TCP, и UDP

Для размещения ваших проектов рекомендуем услуги ARK-HOSTER.RU: