RU

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

Как обновить артефакты FXServer

Обновите FXServer и txAdmin на вашем Linux-сервере FiveM: проверка версии, резервное копирование, установка рекомендуемой или конкретной сборки, проверка и откат.

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

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

Артефакты — это файлы сервера FiveM, публикуемые Cfx.re: FXServer и версия txAdmin, которую он включает. Это руководство объясняет, как правильно их обновить, сохранив предыдущую версию, чтобы можно было вернуться к ней несколькими командами.

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

  • Сервер, установленный по руководству Создание сервера FiveM, включая скрипт /home/fivem/update-fxserver.sh и скрипт резервного копирования /usr/local/sbin/backup-fivem.sh
  • SSH-доступ с sudo
  • Время без игроков: на время операции сервер останавливается

Это руководство относится к FiveM для GTA V Legacy, как и руководство по установке. FiveM для GTA V Enhanced использует другой серверный архив.

Когда обновлять

Cfx.re публикует, в частности, два канала:

Канал Применение
recommended Версия, рекомендуемая для рабочего сервера
latest Самая свежая версия, полезная для проверки новой функции или исправления

Согласно политике поддержки Cfx.re, рекомендуемая версия поддерживается до шести недель после выхода следующей, а версия latest — до двух недель после выхода следующей. Старая версия продолжает работать, но больше не поддерживается. К версиям без поддержки старше трёх месяцев больше нельзя подключиться из списка серверов.

Шаг 1: определение версий

Пока сервер запущен, выведите установленную версию:

Терминал
curl -fsS http://127.0.0.1:30120/info.json | grep -oE '"server":"[^"]*"'
sudo grep -E "^version" /home/fivem/server/alpine/opt/cfx-server/citizen/system_resources/monitor/fxmanifest.lua

Первая строка выводит, например, FXServer-master v1.0.0.12345 linux: номер сборки — это последнее число, здесь 12345. Вторая показывает версию txAdmin. Запишите оба значения.

Сравните с опубликованными версиями:

Терминал
curl -fsSL https://changelogs-live.fivem.net/api/changelog/versions/linux/server | grep -oE '"(recommended|latest)":"[0-9]+"'

Если ваша сборка равна recommended, обновление не требуется.

Шаг 2: резервное копирование

Проверьте свободное место на диске, затем запустите резервное копирование:

Терминал
df -h /home
sudo du -sh /home/fivem/server
sudo /usr/local/sbin/backup-fivem.sh
sudo ls -lh /home/fivem/backups

Нужно место для второй копии /home/fivem/server. Запишите дату последнего архива fivem_DATE.tar.gz.

Шаг 3: установка рекомендуемой версии

Остановите сервер, сохраните копию текущей версии, затем запустите скрипт установки:

Терминал
sudo systemctl stop fivem.service
sudo -u fivem rm -rf /home/fivem/server.previous
sudo -u fivem cp -a /home/fivem/server /home/fivem/server.previous
sudo -iu fivem /home/fivem/update-fxserver.sh
sudo systemctl start fivem.service

Скрипт заменяет только /home/fivem/server. Ваши ресурсы, server.cfg и учётные записи txAdmin остаются в /home/fivem/txData.

Установка конкретной сборки

Этот способ нужен для проверки latest или для выбора определённой сборки. Создайте второй скрипт:

Терминал
sudo -iu fivem
nano ~/install-fxserver-build.sh
Терминал
#!/bin/bash
set -euo pipefail

URL="${1:?Укажите ссылку на fx.tar.xz в качестве аргумента}"

case "$URL" in
  https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/*/fx.tar.xz) ;;
  *) echo "Адрес отклонён: ожидается официальный архив для Linux" >&2; exit 1 ;;
esac

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"

[ -x "$TMP/run.sh" ] && [ -d "$TMP/alpine" ] || { echo "Архив неполный" >&2; exit 1; }

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

echo "Установленная версия: $URL"
Терминал
chmod +x ~/install-fxserver-build.sh
exit

Затем получите нужный адрес. Для latest:

Терминал
curl -fsSL https://changelogs-live.fivem.net/api/changelog/versions/linux/server | grep -oE '"latest_download":"[^"]*"' | cut -d'"' -f4

Для другой сборки скопируйте адрес её файла fx.tar.xz из официального списка сборок для Linux. После резервного копирования из шага 2 установите её, заменив FX_TAR_XZ_URL:

Терминал
sudo systemctl stop fivem.service
sudo -u fivem rm -rf /home/fivem/server.previous
sudo -u fivem cp -a /home/fivem/server /home/fivem/server.previous
sudo -iu fivem /home/fivem/install-fxserver-build.sh 'FX_TAR_XZ_URL'
sudo systemctl start fivem.service

Шаг 4: проверка сервера

Подождите около минуты, затем проверьте сервис, порты и новую версию:

Терминал
sudo systemctl is-active fivem.service
sudo ss -tulpn | grep -E ':(30120|40120)\b'
curl -fsS http://127.0.0.1:30120/info.json | grep -oE '"server":"[^"]*"'

Сервис должен ответить active, оба порта должны прослушиваться, а номер сборки должен измениться. Затем найдите ошибки запуска:

Терминал
sudo grep -a -E "Could not (find|start) dependency|Couldn't (find|start) resource|can't run|Failed to load script|SCRIPT ERROR" /home/fivem/fxserver.log

Эта команда не должна выводить ничего нового по сравнению с обычным. Если вы используете базу данных, проверьте также подключение:

Терминал
sudo grep -a 'Database server connection established' /home/fivem/fxserver.log

Наконец, подключитесь к игре и проверьте основные функции: вход персонажа, инвентарь, транспорт, команды администрирования.

Храните /home/fivem/server.previous несколько дней. Когда всё стабильно, освободите место:

Терминал
sudo -u fivem rm -rf /home/fivem/server.previous

Возврат к предыдущей версии

Верните сохранённую папку на место:

Терминал
sudo systemctl stop fivem.service
sudo -u fivem rm -rf /home/fivem/server.failed
sudo -u fivem mv /home/fivem/server /home/fivem/server.failed
sudo -u fivem mv /home/fivem/server.previous /home/fivem/server
sudo systemctl start fivem.service

Проверьте версию командой из шага 1, затем посмотрите консоль:

Терминал
sudo tail -n 50 /home/fivem/fxserver.log

Если txAdmin отказывается запускаться после отката

Новая версия txAdmin могла преобразовать свою базу игроков. Тогда старая версия останавливается с таким сообщением:

Текст
Your players database is on v5, and this txAdmin supports up to v4.

Восстановите txData из архива шага 2, заменив DATE:

Терминал
sudo systemctl stop fivem.service
sudo mv /home/fivem/txData /home/fivem/txData.failed
sudo -u fivem tar -xzf /home/fivem/backups/fivem_DATE.tar.gz -C /home/fivem
sudo systemctl start fivem.service

Действия, выполненные в txAdmin после этой резервной копии, например баны, будут потеряны. Восстанавливать MariaDB не нужно: обновление FXServer не изменяет вашу базу данных. Удалите /home/fivem/txData.failed, когда проверите сервер.

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

Адрес загрузки не найден

Скрипт не получил от Cfx.re пригодного ответа. Проверьте доступ:

Терминал
curl -fsSI https://changelogs-live.fivem.net/api/changelog/versions/linux/server

Если команда завершается ошибкой, проверьте исходящее соединение и DNS сервера, затем повторите попытку позже.

curl: (22) The requested URL returned error: 404

Адрес архива неполный или ошибочный. Скопируйте его целиком, с номером сборки, её идентификатором и fx.tar.xz.

tar (child): xz: Cannot exec: No such file or directory

Отсутствует пакет, распаковывающий архив:

Терминал
sudo apt install -y xz-utils

No space left on device

Диск заполнен. Найдите, что занимает место, командой sudo bash -c 'du -sh /home/fivem/*', затем удалите старые папки server.failed и txData.failed или перенесите архивы за пределы сервера. Удалите также любую временную папку /home/fivem/fxserver.*, оставшуюся после обрыва.

Сервис активен, но порты не прослушиваются

Посмотрите консоль и проверьте права:

Терминал
sudo tail -n 100 /home/fivem/fxserver.log
sudo ls -l /home/fivem/server/run.sh
sudo chown -R fivem:fivem /home/fivem/server

Resource can't run после обновления

Сообщение Resource 'name' can't run:, за которым следует server needs to be 12345 or higher, означает, что ресурсу нужна более новая сборка. Установите эту сборку или более старую версию ресурса. Если ресурс раньше работал, а теперь не работает по другой причине, следуйте руководству Диагностика сбоев и тормозов сервера FiveM или вернитесь к предыдущей версии на время исправления.

Предупреждение end-of-support или end-of-life

Сообщение показывается игрокам и администратору, когда артефакты слишком старые. Серое предупреждение (end-of-support) оставляет сервер доступным. Красное предупреждение (end-of-life) может помешать подключению: обновите сервер.