Установка сервера FiveM (GTA 5) на Ubuntu 24.04
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" # Ресурсы, которые запускаются вместе с сервером ensure mapmanager ensure chat ensure spawnmanager ensure sessionmanager ensure basic-gamemode ensure hardcap ensure rconlog # Запретить посторонние программы, работающие через 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 ВАШ_КЛЮЧ
Это официальный образец с пояснениями на русском. Название, описание и значок сервера в списке задаются теперь не в файле, а на портале portal.cfx.re, в карточке сервера; прежние строки sv_hostname, sets sv_projectName и sets sv_projectDesc объявлены устаревшими. Все строки разобраны в статье Настройка сервера 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.
Что дальше
- Настройка сервера FiveM (server.cfg, ресурсы, права)
- База данных для сервера FiveM (MariaDB и oxmysql) — нужна почти любому ролевому набору
- Обновление и резервные копии сервера FiveM
Что не проверено
Лицензионный ключ и вход в 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:
- VPS/VDS серверы — для небольших и средних проектов
- Выделенные серверы — для высоконагруженных проектов