Backup completo do FiveM e banco de dados: rotina automatizada

Crie a pasta raiz dos backups e dois subdiretórios separados — um pros arquivos do servidor, outro pros dumps do banco:

sudo mkdir -p /var/backups/fivem/{files,database}
sudo chown -R fivem:fivem /var/backups/fivem
sudo chmod 750 /var/backups/fivem

A permissão 750 garante que só o usuário fivem e o grupo lêem o conteúdo. Backup de banco contém credenciais e dados de jogador — não pode ficar 755.

Crie um usuário MySQL dedicado pra backups com permissão apenas de leitura. Nunca use o usuário root nem o do framework no script de backup:

sudo mysql -u root -p

Dentro do prompt do MySQL:

CREATE USER 'fivem_backup'@'localhost' IDENTIFIED BY 'SENHA_FORTE_AQUI';
GRANT SELECT, LOCK TABLES, SHOW VIEW, EVENT, TRIGGER ON *.* TO 'fivem_backup'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Esse conjunto mínimo de privilégios é o que mysqldump precisa pra produzir um dump completo e consistente.

Guarde a senha num arquivo de configuração lido só pelo dono — assim ela não aparece em ps aux quando o script roda:

sudo -u fivem tee /home/fivem/.my.cnf > /dev/null <<EOF
[client]
user=fivem_backup
password=SENHA_FORTE_AQUI
EOF
sudo chmod 600 /home/fivem/.my.cnf

Com esse arquivo no lugar, qualquer comando mysql ou mysqldump rodado como usuário fivem autentica automaticamente, sem precisar passar -p em linha de comando.

Crie o script /home/fivem/scripts/backup-db.sh:

sudo -u fivem mkdir -p /home/fivem/scripts
sudo -u fivem nano /home/fivem/scripts/backup-db.sh

Cole o conteúdo:

#!/bin/bash
set -euo pipefail

DB_NAME="fivem_framework"
BACKUP_DIR="/var/backups/fivem/database"
TIMESTAMP=$(date +%Y%m%d-%H%M%S)
OUTPUT="${BACKUP_DIR}/${DB_NAME}-${TIMESTAMP}.sql.gz"
RETENTION_DAYS=14

mysqldump \
  --single-transaction \
  --quick \
  --routines \
  --triggers \
  --events \
  --default-character-set=utf8mb4 \
  "${DB_NAME}" | gzip -9 > "${OUTPUT}"

find "${BACKUP_DIR}" -name "*.sql.gz" -mtime +${RETENTION_DAYS} -delete

echo "[$(date)] Backup OK: ${OUTPUT} ($(du -h "${OUTPUT}" | cut -f1))"

Troque fivem_framework pelo nome real do seu banco. As flags --single-transaction e --quick são o que torna o dump seguro com servidor em produção: a primeira garante consistência em InnoDB sem lock, a segunda evita carregar tabela inteira na RAM.

Dê permissão de execução e rode uma vez manualmente pra validar:

sudo chmod +x /home/fivem/scripts/backup-db.sh
sudo -u fivem /home/fivem/scripts/backup-db.sh

Você deve ver uma linha tipo Backup OK: /var/backups/fivem/database/fivem_framework-20260529-143022.sql.gz (87M). Se aparecer erro de “access denied”, revise o ~/.my.cnf e os grants do passo anterior.

Crie /home/fivem/scripts/backup-files.sh:

sudo -u fivem nano /home/fivem/scripts/backup-files.sh

Conteúdo:

#!/bin/bash
set -euo pipefail

SOURCE_DIR="/home/fivem/server-data"
BACKUP_DIR="/var/backups/fivem/files"
TIMESTAMP=$(date +%Y%m%d-%H%M%S)
OUTPUT="${BACKUP_DIR}/fivem-files-${TIMESTAMP}.tar.gz"
RETENTION_DAYS=30

tar \
  --exclude='*/cache' \
  --exclude='*/logs' \
  --exclude='*/tmp' \
  --exclude='*.log' \
  --warning=no-file-changed \
  -czf "${OUTPUT}" \
  -C "$(dirname "${SOURCE_DIR}")" \
  "$(basename "${SOURCE_DIR}")"

find "${BACKUP_DIR}" -name "*.tar.gz" -mtime +${RETENTION_DAYS} -delete

echo "[$(date)] Backup OK: ${OUTPUT} ($(du -h "${OUTPUT}" | cut -f1))"

Ajuste SOURCE_DIR pro caminho real onde fica seu server.cfg e a pasta resources. O --warning=no-file-changed suprime o ruído de arquivos modificados durante a leitura — é esperado em servidor ativo.

Permissão e teste:

sudo chmod +x /home/fivem/scripts/backup-files.sh
sudo -u fivem /home/fivem/scripts/backup-files.sh

Pra um servidor com 4 GB de resources, espere algo entre 1 GB e 2 GB no arquivo final (gzip nível padrão).

Abra o crontab do usuário fivem:

sudo -u fivem crontab -e

Adicione:

# Backup do banco — todo dia às 04:30
30 4 * * * /home/fivem/scripts/backup-db.sh >> /var/log/fivem-backup.log 2>&1

# Backup dos arquivos — toda segunda às 05:00
0 5 * * 1 /home/fivem/scripts/backup-files.sh >> /var/log/fivem-backup.log 2>&1

Crie o arquivo de log e ajuste dono pra evitar erro de permissão na primeira execução:

sudo touch /var/log/fivem-backup.log
sudo chown fivem:fivem /var/log/fivem-backup.log

Verifique se o cron registrou:

sudo -u fivem crontab -l

Os horários sugeridos (04:30 e 05:00) costumam ser os de menor presença em servidores brasileiros. Ajuste pra o pico inverso do seu servidor.