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

Illustrazione: un uomo con un portatile su una terrazza al tramonto, una chiesa in lontananza

🌐 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

  1. Ferma in modo ordinato i servizi sul server di destinazione per evitare lock sui file o conflitti.
  2. Sincronizza i file dell’applicazione Nextcloud (esclusa la directory data/).
  3. Trasferisce i dati degli utenti separatamente nel loro nuovo percorso di destinazione.
  4. Ripristina il database da un dump locale usando scp e mysql.
  5. Sistema proprietari e permessi per l’accesso del web server.
  6. Riavvia PHP e i servizi web quando tutto è al suo posto.
  7. 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.

Alcuni testi e immagini di questo sito sono creati con l’aiuto dell’IA o generati dall’IA. Dettagli