Как обновить артефакты FXServer
Обновите FXServer и txAdmin на вашем Linux-сервере FiveM: проверка версии, резервное копирование, установка рекомендуемой или конкретной сборки, проверка и откат.
На этой странице
Артефакты — это файлы сервера 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-utilsNo 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/serverResource 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) может помешать подключению: обновите сервер.