🚀 Trasferire un’istanza Nextcloud cresciuta negli anni su un server nuovo (con Bash e Ansible)

🌐 Anche in: English · Deutsch · Français · Español · Português · Nederlands · Polski
(Questo articolo è il seguito logico dello script di backup descritto qui: Backup di Nextcloud da professionista – automatizzato con Bash. I due post vanno di pari passo per completare l’intero workflow di migrazione e disaster recovery.)
Dopo diversi anni passati a far girare una fidata istanza Nextcloud — con innumerevoli file degli utenti, calendari, contatti e cartelle condivise un po’ strambe — era arrivato il momento di un upgrade. Il vecchio server mostrava i segni dell’età, e una macchina nuova di zecca era stata preparata con Ansible per ripartire puliti.
Invece di pasticciare con esportazioni manuali, GUI web traballanti o plugin di backup via browser, ho scelto uno script Bash snello e cattivo per gestire l’intera migrazione. Mi ha permesso di spostare tutto lo stack Nextcloud (file core, dati degli utenti e database) sul nuovo server — in modo riproducibile e con un downtime minimo.
🧠 Cosa fa questo script
- Ferma in modo ordinato i servizi sul server di destinazione per evitare lock sui file o conflitti.
- Sincronizza i file dell’applicazione Nextcloud (esclusa la directory
data/). - Trasferisce i dati degli utenti separatamente nel loro nuovo percorso di destinazione.
- Ripristina il database da un dump locale usando
scpemysql. - Sistema proprietari e permessi per l’accesso del web server.
- Riavvia PHP e i servizi web quando tutto è al suo posto.
- Conferma il completamento con un messaggio di stato finale.
📁 Note sulla struttura delle directory
Nell’ambito della migrazione abbiamo anche spostato la directory data/ in una posizione dedicata fuori dalla web root di Apache. È un approccio più pulito e più sicuro rispetto ad avere i dati degli utenti dentro la directory principale dell’installazione Nextcloud (com’era prima).
Lo script tiene conto di questo cambiamento trasferendo la cartella data/ separatamente e mettendola nella sua nuova posizione esterna sul server di destinazione.
⚙️ Lo script di migrazione
⚠️ Questo script cancella e sovrascrive dati sul server di destinazione. Fai prima un backup, provalo su un sistema di test e adatta ogni percorso al tuo ambiente.
#!/bin/bash
# === CONFIGURATION ===
REMOTE_USER="root"
REMOTE_HOST="your.remote.ip"
REMOTE_SSH_PORT=22
SSH_KEY="$HOME/.ssh/id_rsa"
BACKUP_DIR="/data/backup/nextcloud/instance-a"
REMOTE_NEXTCLOUD_DIR="/var/www/html/nextcloud"
REMOTE_DATA_DIR="/data"
DB_NAME="your.db.name"
DB_USER="your.user"
DB_PASS="********" # 🔐 Password removed for security
WWW_USER="www-data"
SSH_CMD="ssh -i $SSH_KEY -p $REMOTE_SSH_PORT -o LogLevel=ERROR $REMOTE_USER@$REMOTE_HOST"
echo "🛑 [1/7] Stopping remote web and PHP services ..."
$SSH_CMD "systemctl stop apache2 2>/dev/null || systemctl stop httpd 2>/dev/null"
$SSH_CMD "systemctl stop php8.2-fpm 2>/dev/null || true"
echo "📤 [2/7] Transferring Nextcloud files (excluding data/) to remote server ..."
rsync -a --delete --exclude "data/" \
-e "ssh -i $SSH_KEY -p $REMOTE_SSH_PORT -o LogLevel=ERROR" \
"$BACKUP_DIR/nextcloud/" "$REMOTE_USER@$REMOTE_HOST:$REMOTE_NEXTCLOUD_DIR/"
echo "📤 [3/7] Transferring user data (nextcloud/data/) to remote /data ..."
rsync -a --delete \
-e "ssh -i $SSH_KEY -p $REMOTE_SSH_PORT -o LogLevel=ERROR" \
"$BACKUP_DIR/nextcloud/data/" "$REMOTE_USER@$REMOTE_HOST:$REMOTE_DATA_DIR/"
echo "🛢️ [4/7] Transferring and restoring database dump ..."
scp -i "$SSH_KEY" -P $REMOTE_SSH_PORT "$BACKUP_DIR/db.sql" "$REMOTE_USER@$REMOTE_HOST:/tmp/db.sql"
$SSH_CMD "mysql -u '$DB_USER' -p'********' '$DB_NAME' < /tmp/db.sql && rm /tmp/db.sql"
echo "🔒 [5/7] Setting remote file permissions ..."
$SSH_CMD "chown -R '$WWW_USER:$WWW_USER' '$REMOTE_NEXTCLOUD_DIR'"
$SSH_CMD "chown -R '$WWW_USER:$WWW_USER' '$REMOTE_DATA_DIR'"
echo "🚀 [6/7] Starting remote services ..."
$SSH_CMD "systemctl start php8.2-fpm 2>/dev/null || true"
$SSH_CMD "systemctl start apache2 2>/dev/null || systemctl start httpd 2>/dev/null"
echo "✅ [7/7] Remote restore complete. Please verify your Nextcloud instance at: https://$REMOTE_HOST"
🎉 Considerazioni finali
Migrare un’istanza Nextcloud in produzione che esiste da anni — con dati veri e utenti veri — può intimidire. Ma con un approccio strutturato e un’automazione fatta bene, non deve per forza essere così. Grazie a questo script e a un ambiente di destinazione pulito basato su Ansible, l’intero processo ha richiesto meno di 30 minuti e nessun ritocco manuale. Nerd in festa.
Se stai pianificando la tua migrazione di Nextcloud, soprattutto con grandi volumi di dati e la necessità di zero errori umani, prova questo approccio — e adattalo al tuo stile di infrastruttura.
