В конце этого руководства твой сервер RedM будет работать на выбранной тобой серверной версии от Cfx.re: рекомендуемой, самой новой или на конкретном номере сборки. Ты будешь знать, какие файлы обновление заменяет, а какие остаются. Кроме того, ты узнаешь, как откатиться, если какой-то ресурс не работает с новой сборкой.

Требования

  • Сервер RedM в твоей клиентской панели. Переустановить сервер может только его владелец.
  • Немного времени, когда никто не играет. Во время обновления сервер останавливается.

Как устроена серверная версия

Cfx.re публикует сервер для RedM в виде артефакта с номером сборки. В списке версий Cfx.re среди прочего указаны рекомендуемая сборка (recommended) и самая новая сборка (latest). Сами файлы находятся на странице артефактов Cfx.re.

Согласно проекту txAdmin, txAdmin является частью сервера. Значит, вместе с артефактом ты обновляешь и txAdmin. Какая версия txAdmin относится к какой сборке, тоже указано в списке версий.

Твой сервер загружает артефакт только при установке. Обычный перезапуск не загружает новую версию.

Как узнать текущую версию

Открой Files & worlds → Файлы, а в нём файл .gsh-cfx-installed в корневой папке. Строка artifact= содержит адрес установленного артефакта. Число перед дефисом в пути и есть номер сборки. Запиши его перед обновлением. При следующей установке файл будет перезаписан.

Выбор версии

  1. Открой Game settings → Переменные сервера.
  2. Введи в поле «Версия артефакта Cfx.re» одно из этих значений:
    • recommended для сборки, рекомендуемой Cfx.re. Это значение по умолчанию.
    • latest для самой новой сборки.
    • Номер сборки, например записанное число, чтобы остаться на определённой сборке.
  3. Сохрани изменение.

Если номер сборки не найден на странице артефактов, сервер установит рекомендуемую сборку. В этом случае во время установки в консоли появится Requested version … unavailable; using recommended.

Выполнение обновления

  1. Создай резервную копию в разделе Backups & recovery. Панель и сама создаёт копию перед переустановкой, но со своей копией ты точно знаешь, какое это состояние.
  2. Нажми Переустановить на панели управления сервером.
  3. Подтверди переустановку. Если панель запросит имя твоего сервера, введи его.
  4. Дождись окончания установки. Обычно это занимает несколько минут.
  5. Запусти сервер и проверь в консоли или в «Live Console» txAdmin, что сервер запускается без ошибок.

Что сохраняется при обновлении

Установка полностью заменяет папку alpine с файлами сервера. Сохраняется следующее:

  • Папка txData с твоей настройкой txAdmin, твоими админами и папкой сервера, созданной при настройке.
  • Собственные ресурсы в папке resources. Из стандартного пакета Cfx.re добавляются только те файлы, которых там ещё нет.
  • Существующий server.cfg в корневой папке. Установка лишь закомментирует в нём ресурсы, которые FXServer больше не включает, например sessionmanager, и только если ты не установил их сам.

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

Если какой-то ресурс не работает с новой сборкой, снова введи записанный номер сборки в поле «Версия артефакта Cfx.re» и выполни переустановку. Если это не поможет, восстанови резервную копию в разделе Backups & recovery. Cfx.re указывает в списке версий в support_policy дату окончания поддержки для старых сборок. Поэтому не оставайся на старой сборке надолго.

Частые ошибки

Проблема Причина и решение
После перезапуска версия не изменилась Перезапуск не загружает новую версию. Выполни Переустановить.
Вместо твоей сборки установлена рекомендуемая Такого номера сборки нет на странице артефактов. Проверь число и вводи только цифры.
Установка прерывается с Cfx.re returned no valid Linux artifact URL Cfx.re не предоставил действительный адрес. Попробуй позже или выбери recommended.
Установка сообщает Incomplete Cfx.re artifact Загрузка была неполной. Запусти установку заново.
Переустановить недоступно Переустанавливать сервер может только его владелец. Войди под этой учётной записью.
Ресурс не запускается после обновления Прочитай строку с ошибкой в консоли. При необходимости вернись к записанному номеру сборки.

Следующие шаги

Как настроить админов, время перезапусков и allowlist в txAdmin, описано в руководстве Админы и перезапуски в txAdmin. Слоты и локации ты найдёшь на странице покупки сервера RedM.