Обновление и резервные копии сервера FiveM

Материал из ARK-HOSTER.RU | Документация хостинга
Перейти к навигации Перейти к поиску

Сервер FiveM обновляется часто, а устаревшую сборку игроки рано или поздно перестают видеть в списке. В статье — как обновить сервер за пару минут, не задев свои настройки, и как настроить ежедневную копию ресурсов, настроек и базы данных с проверкой восстановления. Сервер установлен по статье Установка сервера FiveM (GTA 5) на Ubuntu 24.04, база — по статье База данных для сервера FiveM (MariaDB и oxmysql). Проверено 17 ноября 2026 года на Ubuntu 24.04.4.

Что нужно сохранять

Что Сохранять? Почему
~/FXServer/server-data Да Ресурсы и server.cfg — весь ваш сервер
~/FXServer/server/txData Да Панель txAdmin: администраторы, баны, расписание, журналы
База данных fivem Да Игроки, деньги, имущество
~/FXServer/server-data/cache Нет Временные файлы, создаются заново
~/FXServer/server/alpine, run.sh Нет Программа сервера, скачивается заново

1. Скрипт копирования

sudo nano /usr/local/bin/fivem-backup.sh
#!/bin/bash
# Копия сервера FiveM: файлы сервера, данные txAdmin и база данных
D=/var/backups/fivem
N=$(date +%F_%H%M)
mkdir -p $D
tar -czf $D/fivem-files-$N.tar.gz -C /home/fivem/FXServer --exclude='server-data/cache' server-data server/txData
mariadb-dump --single-transaction fivem | gzip > $D/fivem-db-$N.sql.gz
find $D -name "fivem-*" -mtime +7 -delete
ls -lh $D | tail -n 3

Скрипт складывает в /var/backups/fivem два файла: архив с файлами и выгрузку базы. Копии старше семи дней он удаляет сам. Ключ --single-transaction снимает базу без остановки сервера: игроки ничего не заметят. Если базы у сервера нет, строку с mariadb-dump уберите.

sudo chmod +x /usr/local/bin/fivem-backup.sh
sudo /usr/local/bin/fivem-backup.sh
sudo tar -tzf $(ls -t /var/backups/fivem/fivem-files-*.tar.gz | head -n 1) | grep -E "^(server-data/server.cfg|server/txData/|server-data/resources/)$"
echo '30 4 * * * root /usr/local/bin/fivem-backup.sh > /dev/null' | sudo tee /etc/cron.d/fivem-backup

Что видно на снимке:

  • первая команда создала оба файла;
  • вторая заглянула в архив: в нём есть и server.cfg, и ресурсы, и данные txAdmin;
  • третья поставила копирование в расписание — каждый день в 04:30.

На снимке сервер только что установлен, поэтому архив занимает 1,3 МБ. У ролевого сервера с машинами и картами он легко вырастает до десятков гигабайт — а хранится семь копий. Следите за местом командой df -h /; если диск заполняется, уменьшите срок хранения (число после -mtime) или возьмите тариф с диском побольше.

Копия на том же VDS спасает от ошибки — удалённого ресурса, испорченной базы, неудачного обновления. От потери самого сервера она не спасёт: раз в несколько дней забирайте свежие файлы на свой компьютер или в облачное хранилище:

scp root@203.0.113.10:/var/backups/fivem/fivem-*-2026-11-17_* .

2. Восстановление базы

Копия, которую ни разу не пробовали восстановить, — не копия. Проверка: в базе есть таблица, её удаляют и возвращают из выгрузки.

zcat $(ls -t /var/backups/fivem/fivem-db-*.sql.gz | head -n 1) | sudo mariadb fivem

На снимке таблица test_players удалена первой командой (список таблиц пуст), вторая команда загрузила последнюю выгрузку, третья показывает: таблица и запись в ней на месте.

Перед восстановлением базы на рабочем сервере остановите его — sudo systemctl stop fivem, после — запустите. Чтобы вернуть не последнюю копию, а конкретную, укажите её файл: zcat /var/backups/fivem/fivem-db-2026-11-17_0430.sql.gz | sudo mariadb fivem.

3. Восстановление файлов

Один ресурс или файл — достать из архива во временную папку и скопировать на место:

mkdir /tmp/restore
sudo tar -xzf /var/backups/fivem/fivem-files-2026-11-17_0430.tar.gz -C /tmp/restore server-data/server.cfg
sudo cp /tmp/restore/server-data/server.cfg /home/fivem/FXServer/server-data/server.cfg
sudo chown fivem:fivem /home/fivem/FXServer/server-data/server.cfg

Весь сервер целиком — на остановленном сервере:

sudo systemctl stop fivem
sudo tar -xzf /var/backups/fivem/fivem-files-2026-11-17_0430.tar.gz -C /home/fivem/FXServer
sudo chown -R fivem:fivem /home/fivem/FXServer
sudo systemctl start fivem

Так же сервер переносится на другой VDS: установите на новом сервер FiveM и MariaDB по статьям, скопируйте туда оба файла копии и восстановите. Лицензионный ключ привязан к IP-адресу — на portal.cfx.re выпустите новый для нового адреса.

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

Программа сервера лежит отдельно от ваших данных, поэтому обновление — это замена каталога alpine и файла run.sh. Папка txData рядом с ними остаётся нетронутой.

sudo /usr/local/bin/fivem-backup.sh
sudo systemctl stop fivem
sudo -iu fivem
cd ~/FXServer/server
rm -rf alpine run.sh
U=$(curl -s https://changelogs-live.fivem.net/api/changelog/versions/linux/server | jq -r .recommended_download); echo $U
curl -sL -C - --retry 5 --retry-all-errors -o fx.tar.xz $U; xz -t fx.tar.xz && tar xJf fx.tar.xz && rm fx.tar.xz
ls
exit
sudo systemctl start fivem
systemctl is-active fivem

Команда ls показывает три имени: новые alpine и run.sh и прежнюю txData. Номер сборки виден в адресе загрузки (на снимке — 38435) и в первой строке консоли txAdmin.

Несколько правил:

  • берите рекомендованную сборку (recommended_download). Самая свежая (latest_download) выходит гораздо чаще и бывает с ошибками;
  • обновляйтесь раз в месяц-два и тогда, когда txAdmin показывает предупреждение об устаревшей сборке;
  • если после обновления перестал работать ресурс — проверьте, нет ли обновления у него самого. Вернуть прежнюю сборку можно тем же способом, подставив в переменную U её адрес со страницы загрузок FiveM;
  • после обновления удалять папку cache обычно не нужно. Если ресурсы ведут себя странно — остановите сервер и удалите ~/FXServer/server-data/cache.

Что не проверено

Проверены на тестовом сервере: скрипт копирования, состав архива, расписание, восстановление базы из выгрузки, восстановление одного файла и всего сервера из архива (файлы совпали с исходными, служба запустилась), обновление программы сервера с сохранением txData. Перенос на другой VDS описан, но не проверялся; всё выполнялось на сервере без лицензионного ключа и без игроков.

Если что-то пошло не так

Что видите Причина и решение
«Unexpected end of input» при обновлении Архив скачан не полностью. Повторите команду загрузки — она докачает файл
После обновления txAdmin просит PIN заново Удалена папка txData. Верните её из архива: server/txData
«mariadb-dump: Got error … Access denied» Скрипт запущен не от root. Запускайте через sudo
Копии не появляются по расписанию Проверьте файл /etc/cron.d/fivem-backup: в нём одна строка, в конце — перевод строки; имя файла без точки
«No space left on device» Диск заполнен копиями. Уменьшите срок хранения или перейдите на тариф с большим диском
После восстановления сервер не запускается У файлов не тот владелец: sudo chown -R fivem:fivem /home/fivem/FXServer

Для размещения ваших проектов рекомендуем услуги ARK-HOSTER.RU: