Как создать свой сервер FiveM с txAdmin
Полное руководство по установке сервера FiveM на VPS или выделенном сервере Linux с txAdmin: лицензионный ключ Cfx.re, сервис systemd, брандмауэр, база данных MariaDB, обновления и резервное копирование.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
Это руководство объясняет, как установить сервер FiveM (FXServer) на вашем VPS или выделенном Linux-сервере, настроить его с помощью txAdmin, веб-интерфейса администрирования, и запустить как сервис от имени выделенного пользователя.
Заказать сервер
Для размещения вашего сервера FiveM HostMyServers предлагает несколько вариантов. Серверу с фреймворком для ролевой игры (roleplay) и большим количеством ресурсов нужны быстрый процессор и достаточный объём памяти.
- Performance VPS - Выделенные ресурсы и быстрые процессоры, идеально для FiveM
- NVMe VPS - Для небольшого сервера или тестового сервера
- Эко выделенные серверы - Для серверов с большим количеством игроков
- Выделенные серверы Performance - Максимальная производительность
Предварительные требования
- 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_.
- Войдите на портал Cfx.re под своей учётной записью.
- Откройте страницу ключей регистрации сервера.
- Нажмите кнопку +, заполните запрашиваемые сведения (название, слоган, описание и язык сервера), затем нажмите Generate Key.
- Скопируйте ключ с помощью 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Мастер настройки
- Введите PIN-код, затем нажмите Link Account и войдите под своей учётной записью Cfx.re.
- Задайте пароль администратора txAdmin.
- Укажите название вашего сервера.
- Выберите Popular Recipes, затем шаблон. Для простого сервера возьмите базовый шаблон Cfx.re (FiveM Basic Server, иногда отображается как CFX Default FiveM).
- Оставьте предложенную папку назначения, затем перейдите к Recipe Deployer.
- Вставьте ключ
cfxk_, укажите данные базы данных, если шаблон её требует, затем нажмите Run Recipe. - По окончании развёртывания нажмите 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 mariadbCREATE 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 не отвечает.
Подключение к серверу
- Запустите FiveM.
- Откройте консоль клавишей
F8. - Введите:
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 -deletesudo 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-туннель, который не зависит от правила брандмауэра