Wirklich letzter Blog
Anleitungen und Notizen zu Homelab, Linux und Netzwerk.
Nextcloud Backup mit Borg
Ein automatisches Backup deiner Nextcloud Daten mit Borg erstellen
Vorbereitung
Abschnitt betitelt „Vorbereitung“- SSH muss in der StorageBox aktivert sein.
- BorgBackup muss auf dem Server installiert sein
apt install -y borgbackup - Username, URL liegen und Passwort liegen bereit
SSH Key erstellen und bei Hetzner hinterlegen
Abschnitt betitelt „SSH Key erstellen und bei Hetzner hinterlegen“Für die Kommunikation über SSH wird am besten ein SSH-Key verwendet. Der kann mit ssh-keygen erstellt werden. Dieser muss dann bei Hetzner in die SSH-Umgebung der StorageBox kopiert werden.
cat ~/.ssh/id_rsa.pub | ssh -p23 uXXXXX@uXXXXX.your-storagebox.de install-ssh-keyBackup Repo anlegen
Abschnitt betitelt „Backup Repo anlegen“Backup Repo anlegen:
borg init --encryption=repokey --remote-path=borg-1.2 ssh://XXXXX@XXXXX.your-storagebox.de:23/./nextcloud-backupBackup Script
Abschnitt betitelt „Backup Script“Das Backup Script wird unter /root/backup.sh erstellt. Mittels nano /root/backup.sh" kann die Datei erstellt werden und das Script eingefügt werden. Angepasst werden müssen die Parameter: BORG_PASSPHRASE,backupDiscMount,dbUser,dbPassword, ggf. der Name der Datenbank, Speicherort der Nextcloud-Daten.
Das Script muss noch ausführbar gemacht werden chmod +x /root/backup.sh und in cron zur automatischen Ausführung hinterlegt werden.
crontab -e0 2 * * * /root/backup.sh > /dev/null 2>&1Das Script wird jeden Tag um 02 Uhr ausgeführt.
#!/bin/bash##################################### Beispieldaten:### logDirectory="/backup_logs/"### backupDiscMount="/backup/"### localBackupDir="/backup/temp"##################################export BORG_PASSPHRASE='XXXXX'export BORG_UNKNOWN_UNENCRYPTED_REPO_ACCESS_IS_OK=yesexport BORG_RELOCATED_REPO_ACCESS_IS_OK=yesstartTime=$(date +%s)currentDate=$(date --date @"$startTime" +"%Y%m%d_%H%M%S")currentDateReadable=$(date --date @"$startTime" +"%d.%m.%Y - %H:%M:%S")logDirectory="/root/BorgLog"logFile="${logDirectory}/${currentDate}.log"backupDiscMount="ssh://xxxxx@xxxxx.your-storagebox.de:23/./"localBackupDir="/root/"borgRepository="${backupDiscMount}/nextcloud-backup"borgBackupDirs="/etc/ /mnt/nextcloud-data/ /root/ /var/www/nextcloud/ $localBackupDir/"nextcloudFileDir='/var/www/nextcloud'webserverServiceName='nginx'webserverUser='www-data'nextcloudDatabase='nextcloud'dbUser='root'dbPassword='XXXXX'fileNameBackupDb='nextcloud-db.sql'if [ ! -d "${logDirectory}" ]then mkdir -p "${logDirectory}"fierrorecho() { cat <<< "$@" 1>&2; }exec > >(tee -i "${logFile}")exec 2>&1if [ "$(id -u)" != "0" ]then errorecho "ERROR: This script has to be run as root!" exit 1fiif [ ! -d "${localBackupDir}" ]then errorecho "ERROR: The local backup directory ${localBackupDir} does not exist!" exit 1fiecho -e "\n###### Start des Backups: ${currentDateReadable} ######\n"echo -e "Daten werden zusammengestellt"dpkg --get-selections > "${localBackupDir}/software.list"sudo -u "${webserverUser}" php ${nextcloudFileDir}/occ maintenance:mode --onecho "nginx wird gestoppt"systemctl stop "${webserverServiceName}"echo "Datenbanksicherung wird erstellt"mysqldump --single-transaction --routines -h localhost -u "${dbUser}" -p"${dbPassword}" "${nextcloudDatabase}" > "${localBackupDir}/${fileNameBackupDb}"echo -e "\nBackup mit borgbackup"borg create -C zstd,15 --stats \ $borgRepository::"${currentDate}" \ $localBackupDir \ $borgBackupDirsechoecho "nginx wird gestartet"systemctl start "${webserverServiceName}"sudo -u "${webserverUser}" php ${nextcloudFileDir}/occ maintenance:mode --offrm "${localBackupDir}"/software.listrm -r "${localBackupDir}/${fileNameBackupDb}"borg prune --progress --stats $borgRepository --keep-within=7d --keep-weekly=4 --keep-monthly=6endTime=$(date +%s)endDateReadable=$(date --date @"$endTime" +"%d.%m.%Y - %H:%M:%S")duration=$((endTime-startTime))durationSec=$((duration % 60))durationMin=$(((duration / 60) % 60))durationHour=$((duration / 3600))durationReadable=$(printf "%02d Stunden %02d Minuten %02d Sekunden" $durationHour $durationMin $durationSec)echo -e "\n###### Ende des Backups: ${endDateReadable} (${durationReadable}) ######\n"#mail -s "Nextcloud-Backup beendet" <email@example.com> < "${logFile}"Disaster Recovery
Abschnitt betitelt „Disaster Recovery“Nachdem das Backup erstellt wurde muss auch die Recovery getestet werden. Die neue VM für Nextcloud wurde erstellt und mit dem Script von c-rieger installiert.
1) Vorbereitung, Backup in der neue VM mouten
Abschnitt betitelt „1) Vorbereitung, Backup in der neue VM mouten“Deinen SSH-Schlüssel erstellen und zu Hetzner übertragen.
Backups auflisten
borg list ssh://xxxx@xxxx.your-storagebox.de:23/./nextcloud-backupBackups mit dem gewählten Datum mounten
borg mount ssh://xxxx@xxxx.your-storagebox.de:23/./nextcloud-backup::20230104_103705 /mnt/restoreAls Erstes sollten die Nextcloud-Daten wieder an den originalen Ort kopiert werden. Die Wiederherstellung der Daten wird lange dauern! Hat man noch Einstellungen an mysql, redis oder SSL-Zerts vorgenommen/erstellt, müssen diese auch wiederhergestellt werden. Daher sollte der “/etc/” Ordner mit gesichert werden.
2) Daten migrieren
Abschnitt betitelt „2) Daten migrieren“mv /var/www/nextcloud /var/www/nextcloud_backuprsync -av /mnt/restore/var/www /var/rsync -av /mnt/restore/mnt/nextcloud-data/ /mnt/nextcloud-data3) Datenbank recovern
Abschnitt betitelt „3) Datenbank recovern“MySQL Dump zurückspielen. Der DUMP liegt unter “/mnt/restore/root”. Die alte Datenbank muss gelöscht werde und eine neue, leere, erstellt werden. Die Rechte müssen für den Benutzer nochmals angepasst werden. Hat sich der Benutzer geändert, muss dieser im mysql-Befehl angepasst werden.
mysql -u root -pDROP DATABASE nextcloud;CREATE DATABASE nextcloud;exitmysql -u root -p nextcloud < /mnt/restore/root/nextcloud-db.sqlmysql -u root -pGRANT ALL PRIVILEGES on nextcloud.* to ncdbuser@localhost; FLUSH privileges; quit;4) Abschluss
Abschnitt betitelt „4) Abschluss“Backups umounten
borg umount /mnt/restore/Dienste starten
systemctl restart nginx redis mysqlTroubleshooting
Abschnitt betitelt „Troubleshooting“Permission Fehler
Abschnitt betitelt „Permission Fehler“nano /root/permission.shchmod +x /root/permission.sh#!/bin/bashfind /var/www/ -type f -print0 | xargs -0 chmod 0640find /var/www/ -type d -print0 | xargs -0 chmod 0750chmod ug+x /var/www/nextcloud/apps/notify_push/bin/x86_64/notify_pushchmod -R 775 /var/www/letsencryptchmod -R 770 /etc/letsencryptchown -R www-data:www-data /var/www /etc/letsencryptchown -R www-data:www-data /var/nc_datachmod 0644 /var/www/nextcloud/.htaccesschmod 0644 /var/www/nextcloud/.user.iniexit 0DB-Root Passwort
Abschnitt betitelt „DB-Root Passwort“Durch die Neuinstallation der Nextcloud, wurde durch das Script ein neues root-Passwort vergeben.
Pfade prüfen
Abschnitt betitelt „Pfade prüfen“Durch die Script Installation müssen die Pfade in Nginx und in der Nextcloud-Konfiguration geprüft werden. Eventuell hat sich das Datenverzeichnis geändert.
DB Passwort prüfen
Abschnitt betitelt „DB Passwort prüfen“Durch die Installation mit dem Script, muss das DB-Passwort und DB-User unter: /var/www/nextcloud/config/config.php angepasst werden.
Wartungsmodus ausschalten
Abschnitt betitelt „Wartungsmodus ausschalten“sudo -u www-data php /var/www/nextcloud/occ maintenance:mode –off
Dienste Neustarten
Abschnitt betitelt „Dienste Neustarten“systemctl restart mysql.service systemctl restart php8.1-fpm.service systemctl restart redis-server.service systemctl restart nginx.service