RU

Игровые серверы

Как создать свой сервер FiveM с txAdmin

Полное руководство по установке сервера FiveM на VPS или выделенном сервере Linux с txAdmin: лицензионный ключ Cfx.re, сервис systemd, брандмауэр, база данных MariaDB, обновления и резервное копирование.

9 мин чтения, обновлено 18 ноября 2026 г.

На этой странице

Ваши значения

Укажите их один раз, и команды в руководстве обновятся.

Это руководство объясняет, как установить сервер FiveM (FXServer) на вашем VPS или выделенном Linux-сервере, настроить его с помощью txAdmin, веб-интерфейса администрирования, и запустить как сервис от имени выделенного пользователя.

Заказать сервер

Для размещения вашего сервера FiveM HostMyServers предлагает несколько вариантов. Серверу с фреймворком для ролевой игры (roleplay) и большим количеством ресурсов нужны быстрый процессор и достаточный объём памяти.

Предварительные требования

  • SSH-доступ как root или пользователь с правами sudo
  • 64-разрядная система Linux x86_64 (Debian 12/13 или Ubuntu 22.04/24.04), процессоры ARM не поддерживаются
  • Активный брандмауэр: nftables, iptables или ufw (используйте только один инструмент одновременно)
  • Учётная запись Cfx.re для создания лицензионного ключа сервера
  • Легальная копия GTA V у каждого игрока
  • Порты 30120 TCP и UDP доступны, а порт 40120 TCP (txAdmin) доступен только с вашего IP-адреса

Требуемая конфигурация

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

Назначение CPU RAM Хранилище
Базовый или тестовый сервер 2 быстрых ядра 4 ГБ 20 ГБ SSD
Фреймворк для roleplay, до 48 игроков 4 быстрых ядра 8 ГБ 40 ГБ SSD NVMe
Нагруженный сервер, много ресурсов 6 ядер или больше 16 ГБ и более 80 ГБ SSD NVMe

Обновление системы

Терминал
sudo apt update && sudo apt upgrade -y

Установка зависимостей

В документации txAdmin сервер запускается в screen, а xz-utils позволяет распаковать архив:

Терминал
sudo apt install -y curl tar xz-utils screen ca-certificates

Создание выделенного пользователя

Сервер никогда не должен работать от имени root. Создайте выделенного пользователя:

Терминал
sudo adduser --disabled-password --gecos "" fivem

Используемые порты

Порт Протокол Назначение Доступ
30120 TCP и UDP Игра (подключение игроков и информация о сервере) Публичный
40120 TCP Веб-интерфейс txAdmin Только ваш IP-адрес
3306 TCP MariaDB, если вы её установите Только локально, не открывайте его

Настройка брандмауэра

Откройте игровой порт и ограничьте доступ к txAdmin вашим фиксированным IP-адресом: замените ВАШ_IP. Если у вас нет фиксированного адреса, не создавайте разрешающее правило для ВАШ_IP и используйте SSH-туннель, описанный ниже.

С UFW

После включения UFW по умолчанию отклоняет входящие соединения. Убедитесь, что он активен, с помощью команды sudo ufw status.

Терминал
sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
sudo ufw allow from ВАШ_IP to any port 40120 proto tcp
sudo ufw reload

С iptables

Последнее правило блокирует txAdmin для всех остальных адресов, но не мешает работе локального SSH-туннеля:

Терминал
sudo iptables -A INPUT -p tcp --dport 30120 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 30120 -j ACCEPT
sudo iptables -A INPUT -p tcp -s ВАШ_IP --dport 40120 -j ACCEPT
sudo iptables -A INPUT ! -i lo -p tcp --dport 40120 -j DROP
sudo iptables-save | sudo tee /etc/iptables/rules.v4

Сохранение правил после перезагрузки требует пакета iptables-persistent.

С nftables

Эти команды используют таблицу inet filter и цепочку input, присутствующие по умолчанию в /etc/nftables.conf в Debian.

Терминал
sudo nft add rule inet filter input tcp dport 30120 accept
sudo nft add rule inet filter input udp dport 30120 accept
sudo nft add rule inet filter input ip saddr ВАШ_IP tcp dport 40120 accept
sudo nft add rule inet filter input iifname != "lo" tcp dport 40120 drop
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.conf

Создание лицензионного ключа Cfx.re

Каждому серверу нужен бесплатный лицензионный ключ, начинающийся с cfxk_.

  1. Войдите на портал Cfx.re под своей учётной записью.
  2. Откройте страницу ключей регистрации сервера.
  3. Нажмите кнопку +, заполните запрашиваемые сведения (название, слоган, описание и язык сервера), затем нажмите Generate Key.
  4. Скопируйте ключ с помощью Copy Key и сохраните его для этапа настройки.

Установка FXServer

Войдите как пользователь fivem и создайте папку данных txAdmin:

Терминал
sudo -iu fivem
mkdir -p ~/txData

Создайте скрипт, загружающий рекомендуемую версию FXServer. Он также будет использоваться для обновлений:

Терминал
nano ~/update-fxserver.sh
Терминал
#!/bin/bash
set -euo pipefail

API="https://changelogs-live.fivem.net/api/changelog/versions/linux/server"
URL=$(curl -fsSL "$API" | grep -o '"recommended_download":"[^"]*"' | cut -d'"' -f4)
[ -n "$URL" ] || { echo "Адрес загрузки не найден" >&2; exit 1; }

TMP=$(mktemp -d "$HOME/fxserver.XXXXXX")
trap 'rm -rf "$TMP"' EXIT

curl -fL -o "$TMP/fx.tar.xz" "$URL"
tar -xJf "$TMP/fx.tar.xz" -C "$TMP"
rm -f "$TMP/fx.tar.xz"

rm -rf "$HOME/server"
mkdir -p "$HOME/server"
mv "$TMP"/* "$HOME/server/"

echo "Установленная версия: $URL"

Запустите его, затем выйдите из сессии пользователя fivem:

Терминал
chmod +x ~/update-fxserver.sh
~/update-fxserver.sh
ls ~/server
exit

Папка ~/server должна содержать run.sh и alpine. Если вы предпочитаете выбрать версию самостоятельно, архивы перечислены на официальной странице загрузки.

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

Создание файла сервиса

Терминал
sudo nano /etc/systemd/system/fivem.service

Содержимое файла:

Конфигурация
[Unit]
Description=FiveM Server (FXServer + txAdmin)
After=network-online.target mariadb.service
Wants=network-online.target

[Service]
Type=simple
User=fivem
Group=fivem
WorkingDirectory=/home/fivem/txData
Environment=TERM=xterm
Environment=TXHOST_DATA_PATH=/home/fivem/txData
Environment=TXHOST_TXA_PORT=40120
Environment=TXHOST_GAME_NAME=fivem
ExecStartPre=/usr/bin/truncate -s 0 /home/fivem/fxserver.log
ExecStart=/usr/bin/screen -L -Logfile /home/fivem/fxserver.log -DmS fivem /home/fivem/server/run.sh
Restart=always
RestartSec=15
LimitNOFILE=65536

[Install]
WantedBy=multi-user.target

Не передавайте аргумент +exec скрипту run.sh: он помешает запуску txAdmin.

Переменная Назначение
TXHOST_DATA_PATH Папка данных txAdmin, отделённая от файлов FXServer, чтобы сохраняться при обновлениях
TXHOST_TXA_PORT Порт веб-интерфейса (по умолчанию 40120)
TXHOST_GAME_NAME Ограничивает txAdmin шаблонами FiveM

Активация и запуск сервиса

Терминал
sudo systemctl daemon-reload
sudo systemctl enable fivem.service
sudo systemctl start fivem.service

Команды управления

Терминал
# Проверить статус
sudo systemctl status fivem.service

# Остановить сервер
sudo systemctl stop fivem.service

# Перезапустить сервер
sudo systemctl restart fivem.service

# Следить за консолью
sudo tail -f /home/fivem/fxserver.log

Настройка с помощью txAdmin

Доступ к интерфейсу

Самый безопасный способ — SSH-туннель: трафик остаётся зашифрованным, и открывать порт администрирования не нужно. С вашего компьютера:

Терминал
ssh -L 40120:127.0.0.1:40120 ВАШ_ПОЛЬЗОВАТЕЛЬ@IP_СЕРВЕРА

Не закрывайте эту сессию и откройте http://127.0.0.1:40120 в браузере. Если вы разрешили ВАШ_IP в брандмауэре, можно также использовать http://IP_СЕРВЕРА:40120.

Получение PIN-кода

При первом запуске txAdmin выводит 4-значный PIN-код. Подождите примерно пятнадцать секунд, затем выведите его на сервере:

Терминал
sudo grep -a -A2 'PIN below' /home/fivem/fxserver.log

Мастер настройки

  1. Введите PIN-код, затем нажмите Link Account и войдите под своей учётной записью Cfx.re.
  2. Задайте пароль администратора txAdmin.
  3. Укажите название вашего сервера.
  4. Выберите Popular Recipes, затем шаблон. Для простого сервера возьмите базовый шаблон Cfx.re (FiveM Basic Server, иногда отображается как CFX Default FiveM).
  5. Оставьте предложенную папку назначения, затем перейдите к Recipe Deployer.
  6. Вставьте ключ cfxk_, укажите данные базы данных, если шаблон её требует, затем нажмите Run Recipe.
  7. По окончании развёртывания нажмите Save & Run Server.

Файлы сервера создаются во вложенной папке /home/fivem/txData, имя которой заканчивается на .base. Точный путь указывает txAdmin.

База данных MariaDB (при необходимости)

Базовому шаблону база данных не нужна. Она требуется таким фреймворкам, как ESX Legacy или Qbox, а oxmysql, ресурс, с помощью которого они к ней подключаются, рекомендует MariaDB. Установите её до запуска развёртывания:

Терминал
sudo apt install -y mariadb-server
sudo systemctl enable --now mariadb

Сгенерируйте пароль без специальных символов, так как он будет помещён в адрес подключения:

Терминал
openssl rand -hex 16

Создайте базу данных и её пользователя, заменив GENERATED_PASSWORD этим паролем:

Терминал
sudo mariadb
SQL
CREATE DATABASE fivem CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'fivem'@'localhost' IDENTIFIED BY 'GENERATED_PASSWORD';
GRANT ALL PRIVILEGES ON fivem.* TO 'fivem'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Затем при развёртывании в txAdmin укажите:

Поле Значение
Хост 127.0.0.1
Порт 3306
Пользователь fivem
Пароль Сгенерированный пароль
База данных fivem

txAdmin записывает подключение в server.cfg в следующем виде:

Текст
set mysql_connection_string "mysql://fivem:GENERATED_PASSWORD@127.0.0.1/fivem?charset=utf8mb4"

Проверка сервера

Убедитесь, что порты прослушиваются:

Терминал
sudo ss -tulpn | grep -E ':(30120|40120)\b'

С вашего компьютера этот адрес должен возвращать информацию о сервере в формате JSON:

Текст
http://IP_СЕРВЕРА:30120/info.json

Также убедитесь, подключившись не с ВАШ_IP, что http://IP_СЕРВЕРА:40120 не отвечает.

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

  1. Запустите FiveM.
  2. Откройте консоль клавишей F8.
  3. Введите: connect IP_СЕРВЕРА:30120

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

Администрирование

Основное управление осуществляется через txAdmin:

Меню Назначение
Live Console Консоль сервера в реальном времени
CFG Editor Редактирование server.cfg
Resources Список ресурсов и управление ими
Players Игроки, предупреждения и баны
Admins Учётные записи администраторов и права
Settings Настройки, включая расписание перезапусков (Restart Schedule)
Master Actions Действия, доступные только основной учётной записи

В игре откройте консоль клавишей F8 и введите tx, чтобы открыть меню txAdmin.

Несколько полезных настроек server.cfg, которые можно изменить в CFG Editor:

Текст
sv_maxclients 48
sv_endpointPrivacy true
Параметр Описание
sv_maxclients Максимальное количество игроков в зависимости от вашей подписки
sv_endpointPrivacy Скрывает IP-адреса игроков в публичной информации

Cfx.re указывает, что название и описание сервера теперь управляются через портал. Оставьте rcon_password незаданным: так RCON останется отключённым, а его заменит Live Console.

Обновление сервера

Скрипт устанавливает последнюю рекомендуемую версию, не затрагивая txData:

Терминал
sudo systemctl stop fivem.service
sudo -iu fivem /home/fivem/update-fxserver.sh
sudo systemctl start fivem.service

Перед каждым обновлением делайте резервную копию.

Автоматическое резервное копирование

txData содержит ваши ресурсы, server.cfg и учётные записи txAdmin. Поэтому резервные копии содержат секретные данные: храните их в закрытом доступе.

Скрипт резервного копирования

Терминал
sudo nano /usr/local/sbin/backup-fivem.sh

Оставьте DB_NAME пустым, если не используете MariaDB:

Терминал
#!/bin/bash
set -euo pipefail
umask 027

BACKUP_DIR="/home/fivem/backups"
DB_NAME="fivem"
DATE=$(date +%Y-%m-%d_%H-%M-%S)

install -d -o fivem -g fivem -m 750 "$BACKUP_DIR"

# Файлы сервера и txAdmin, без кешей
tar --exclude='*/cache' -czf "$BACKUP_DIR/fivem_$DATE.tar.gz" -C /home/fivem txData

# База данных
if [ -n "$DB_NAME" ]; then
    mariadb-dump --single-transaction "$DB_NAME" | gzip > "$BACKUP_DIR/fivem_db_$DATE.sql.gz"
fi

chown fivem:fivem "$BACKUP_DIR"/fivem_*"$DATE"*

# Удаление резервных копий старше 7 дней
find "$BACKUP_DIR" -name "fivem_*.gz" -mtime +7 -delete
Терминал
sudo chmod 750 /usr/local/sbin/backup-fivem.sh
sudo /usr/local/sbin/backup-fivem.sh
sudo ls -lh /home/fivem/backups

Планирование резервного копирования

Терминал
sudo nano /etc/cron.d/fivem-backup
Текст
# Резервное копирование каждую ночь в 5:30
30 5 * * * root /usr/local/sbin/backup-fivem.sh

Регулярно копируйте эти архивы за пределы сервера.

Восстановление из резервной копии

Терминал
sudo systemctl stop fivem.service
sudo mv /home/fivem/txData /home/fivem/txData.old
sudo -u fivem tar -xzf /home/fivem/backups/fivem_DATE.tar.gz -C /home/fivem
zcat /home/fivem/backups/fivem_db_DATE.sql.gz | sudo mariadb fivem
sudo systemctl start fivem.service

Замените DATE датой архива и пропустите строку zcat, если не используете базу данных.

При возникновении проблем

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

  • Проверьте сервис: sudo journalctl -u fivem.service -n 50
  • Проверьте консоль: sudo tail -n 100 /home/fivem/fxserver.log
  • Проверьте, что архитектура действительно x86_64: uname -m
  • Проверьте права: sudo chown -R fivem:fivem /home/fivem

Failed to start HTTP server, port 40120 is already in use

Порт уже использует другой экземпляр txAdmin. Определите его:

Терминал
sudo ss -ltnp | grep ':40120'

Если вы запускали run.sh вручную, остановите этот процесс перед запуском сервиса.

PIN-код не найден

Код отображается только до тех пор, пока не существует ни одного администратора. Перезапустите сервис, подождите несколько секунд, затем снова выполните команду grep. Если учётная запись уже существует, войдите с её помощью.

Если вы потеряли пароль основной учётной записи, остановите сервис, переименуйте /home/fivem/txData/admins.json, затем запустите сервис снова: txAdmin снова предложит создать администратора.

No license key was specified

Ключ отсутствует или неверен. Проверьте строку sv_licenseKey в CFG Editor или сгенерируйте ключ заново на портале Cfx.re.

Сервер не появляется в списке

  • Проверьте прямое подключение с помощью connect IP_СЕРВЕРА:30120
  • Проверьте, что http://IP_СЕРВЕРА:30120/info.json отвечает
  • Проверьте, что порт 30120 открыт по TCP и по UDP
  • Проверьте, что строка sv_master1 "" в server.cfg закомментирована символом #
  • Подождите до 8 минут после запуска

Сервер остаётся ограничен 48 игроками

Нужны подписка Element Club Argentum или выше, актуальная версия сервера, а также подходящее значение sv_maxclients и перезапуск.

Ошибка подключения к базе данных

  • ECONNREFUSED: проверьте, что MariaDB работает, с помощью sudo systemctl status mariadb и укажите 127.0.0.1 в качестве хоста
  • Access denied: проверьте пользователя, пароль и имя базы данных
  • Если пароль содержит специальные символы, замените его значением, сгенерированным командой openssl rand -hex 16

Нет доступа к txAdmin

  • Проверьте, что сервис работает, а порт 40120 прослушивается
  • Проверьте, что ваш публичный IP-адрес по-прежнему соответствует ВАШ_IP
  • Используйте SSH-туннель, который не зависит от правила брандмауэра