Backup completo de FiveM y base de datos: rutina automatizada

Crea la carpeta raíz de los backups y dos subdirectorios separados — uno para los archivos del servidor, otro para los dumps de la base:

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

El permiso 750 garantiza que sólo el usuario fivem y el grupo leen el contenido. Backup de base contiene credenciales y datos de jugador — no puede quedar en 755.

Crea un usuario MySQL dedicado para backups con permiso sólo de lectura. Nunca uses el usuario root ni el del framework en el script de backup:

sudo mysql -u root -p

Dentro del prompt de MySQL:

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

Este conjunto mínimo de privilegios es lo que mysqldump necesita para producir un dump completo y consistente.

Guarda la contraseña en un archivo de configuración leído sólo por el dueño — así no aparece en ps aux cuando el script corre:

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

Con este archivo en su lugar, cualquier comando mysql o mysqldump ejecutado como usuario fivem autentica automáticamente, sin necesidad de pasar -p en línea de comando.

Crea el 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

Pega el contenido:

#!/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))"

Cambia fivem_framework por el nombre real de tu base. Las flags --single-transaction y --quick son lo que hace el dump seguro con servidor en producción: la primera garantiza consistencia en InnoDB sin lock, la segunda evita cargar la tabla entera en RAM.

Dale permiso de ejecución y córrelo una vez manualmente para validar:

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

Deberías ver una línea tipo Backup OK: /var/backups/fivem/database/fivem_framework-20260529-143022.sql.gz (87M). Si aparece error de “access denied”, revisa el ~/.my.cnf y los grants del paso anterior.

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

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

Contenido:

#!/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))"

Ajusta SOURCE_DIR a la ruta real donde está tu server.cfg y la carpeta resources. El --warning=no-file-changed suprime el ruido de archivos modificados durante la lectura — es esperado en servidor activo.

Permiso y prueba:

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

Para un servidor con 4 GB de resources, espera algo entre 1 GB y 2 GB en el archivo final (gzip nivel por defecto).

Abre el crontab del usuario fivem:

sudo -u fivem crontab -e

Agrega:

# Backup de la base — todos los días a las 04:30
30 4 * * * /home/fivem/scripts/backup-db.sh >> /var/log/fivem-backup.log 2>&1

# Backup de los archivos — cada lunes a las 05:00
0 5 * * 1 /home/fivem/scripts/backup-files.sh >> /var/log/fivem-backup.log 2>&1

Crea el archivo de log y ajusta el dueño para evitar error de permiso en la primera ejecución:

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

Verifica que el cron registró:

sudo -u fivem crontab -l

Los horarios sugeridos (04:30 y 05:00) suelen ser los de menor presencia en servidores hispanohablantes. Ajusta al pico inverso de tu servidor.