🚀 Przeprowadzka dojrzałej instancji Nextcloud na świeży serwer (z Bash i Ansible)

🌐 Także w: English · Deutsch · Français · Español · Italiano · Português · Nederlands
(Ten artykuł to logiczna kontynuacja opisanego tutaj skryptu backupu: Backup Nextcloud jak zawodowiec – zautomatyzowany w Bashu. Oba wpisy idą w parze i razem tworzą pełny workflow migracji i disaster recovery.)
Po kilku latach prowadzenia wiernej instancji Nextcloud — z niezliczonymi plikami użytkowników, kalendarzami, kontaktami i dziwacznymi folderami współdzielonymi — przyszedł czas na upgrade. Stary serwer zaczynał pokazywać oznaki wieku, a nowa, błyszcząca maszyna została przygotowana z Ansible na czysty start.
Zamiast bawić się w ręczne eksporty, chwiejne webowe GUI czy wtyczki backupu w przeglądarce, postawiłem na zwięzły i skuteczny skrypt w Bashu, który obsłuży całą migrację. Pozwolił mi przenieść cały stack Nextcloud (pliki core, dane użytkowników i bazę danych) na nowy serwer — powtarzalnie i z minimalnym downtime.
🧠 Co robi ten skrypt
- Łagodnie zatrzymuje usługi na serwerze docelowym, żeby uniknąć problemów z blokadami plików albo konfliktami.
- Synchronizuje pliki aplikacji Nextcloud (bez katalogu
data/). - Przenosi dane użytkowników osobno do nowej ścieżki docelowej.
- Przywraca bazę danych z lokalnego dumpa za pomocą
scpimysql. - Poprawia właściciela/uprawnienia dla dostępu serwera WWW.
- Restartuje PHP i usługi WWW, gdy wszystko jest na miejscu.
- Potwierdza zakończenie końcowym komunikatem statusu.
📁 Uwagi o strukturze katalogów
W ramach migracji przenieśliśmy też katalog data/ do osobnej lokalizacji poza web rootem Apache. To czystsze i bezpieczniejsze podejście niż trzymanie danych użytkowników w głównym katalogu instalacji Nextcloud (jak to było wcześniej).
Skrypt uwzględnia tę zmianę: przenosi folder data/ osobno i umieszcza go w nowej, zewnętrznej lokalizacji na serwerze docelowym.
⚙️ Skrypt migracji
⚠️ Ten skrypt usuwa i nadpisuje dane na serwerze docelowym. Najpierw zrób backup, wypróbuj go na systemie testowym i dostosuj każdą ścieżkę do swojego środowiska.
#!/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"
🎉 Na koniec
Migracja produkcyjnej instancji Nextcloud, która działa od lat — z prawdziwymi danymi i prawdziwymi użytkownikami — może onieśmielać. Ale przy uporządkowanym podejściu i porządnej automatyzacji wcale nie musi. Dzięki temu skryptowi i czystemu środowisku docelowemu opartemu na Ansible cały proces zajął mniej niż 30 minut i nie wymagał żadnych ręcznych poprawek. Nerdzi, radujcie się.
Jeśli planujesz własną migrację Nextcloud, zwłaszcza przy dużych ilościach danych i wymaganiu zerowego błędu ludzkiego, wypróbuj to podejście — i dopasuj je do stylu swojej infrastruktury.
