/** Prüft die Adresse: https ist Pflicht, http nur für Geräte im eigenen Netz (private oder lokale Adresse). Gibt eine Fehlermeldung oder null zurück. */
/** Prüft die Adresse: https ist Pflicht, http nur für Geräte im eigenen Netz (private oder lokale Adresse). Gibt eine Fehlermeldung oder null zurück. */
functionnasbk_url_error(string$url):?string
{
if($url==='')return'Bitte die Adresse (Domain oder IP) des WebDAV-Servers eintragen.';
$p=parse_url($url);
if($p===false||empty($p['host'])||empty($p['scheme']))return'Die Adresse ist ungültig (Beispiel: nas.meinedomain.de).';
if(isset($p['user'])||isset($p['pass'])||isset($p['query'])||isset($p['fragment']))return'Die Adresse darf keine Zugangsdaten, Parameter oder Anker enthalten. Benutzer und Passwort kommen in die eigenen Felder.';
$scheme=strtolower($p['scheme']);
if(!in_array($scheme,['http','https'],true))return'Es sind nur Adressen mit https:// (oder im eigenen Netz http://) erlaubt.';
if(!$local)return'Über das Internet ist nur HTTPS erlaubt, sonst würden Passwort und Backup unverschlüsselt übertragen. HTTP geht nur mit einer Adresse im eigenen Netz.';
}
returnnull;
}
/** Fehler der gesamten Einstellung oder null, wenn alles Nötige da ist. */
functionnasbk_config_error(array$cfg):?string
{
if($e=nasbk_url_error($cfg['url']))return$e;
if($cfg['user']===''||$cfg['password']==='')return'Bitte Benutzer und Passwort des NAS eintragen.';
foreach(explode('/',$cfg['folder'])as$seg){
if($seg==='.'||$seg==='..')return'Der Ordnername ist ungültig.';
}
returnnull;
}
/** Adresse eines Ordners/einer Datei auf dem Server (Ordnersegmente werden einzeln kodiert). */
?' Tipp: Hat die NAS ein selbst erstelltes Zertifikat, schalte die Zertifikatsprüfung in den Einstellungen aus (weniger sicher) oder installiere ein Zertifikat von Let’s Encrypt.':'';
return"{$what}: keine Verbindung ({$e}).{$hint}";
}
returnmatch(true){
$c===401=>"{$what}: Anmeldung abgelehnt. Benutzer oder Passwort stimmen nicht (bei Synology: Benutzer braucht Zugriff auf WebDAV und den Ordner).",
$c===403=>"{$what}: Zugriff verweigert (HTTP 403). Der Benutzer darf dort nicht schreiben.",
$c===404=>"{$what}: Pfad nicht gefunden (HTTP 404). Bei Synology lautet die Adresse https://<nas>:5006/<Name des freigegebenen Ordners>.",
$c===405=>"{$what}: Der Server erlaubt diese Aktion nicht (HTTP 405).",
$c===507=>"{$what}: Auf der NAS ist kein Speicherplatz mehr frei (HTTP 507).",
default=>"{$what}: unerwartete Antwort des Servers (HTTP {$c}).",
};
}
/** Legt den Ordner (auch verschachtelt) an; vorhandene Ordner sind in Ordnung. Freigaben (oberste Ebene) der NAS müssen schon existieren. */
return$exists()?null:'Ordner anlegen: Der Zielordner „'.$cfg['folder'].'“ existiert nicht und konnte nicht angelegt werden. Lege ihn auf der NAS an oder prüfe den Pfad (er beginnt mit dem Namen des freigegebenen Ordners).';
}
/** Liest die Dateien im Ordner. @return array{ok:bool,items:array<int,array{name:string,size:int,modified:string}>,error:string} */
return"Hochladen: Die Datei auf der NAS ist unvollständig ({$remote} statt {$size} Bytes) und wurde wieder gelöscht.";
}
returnnull;
}
/** Löscht Sicherungen nach den beiden Regeln „älter als X Tage“ und „mehr als Y Stück“ (0 = Regel aus). @return array{deleted:string[],error:string} */
if(!@mkdir($tmp.'/out',0700,true))return['ok'=>false,'error'=>'Der Zwischenordner für das Backup konnte nicht angelegt werden.'];
$options=['with_database'=>$cfg['with_database'],'with_files'=>$cfg['with_files'],'exclude'=>$cfg['excludes'],'verify'=>false];// das Plugin prüft selbst (ohne Eintrag in die Prüfliste der Backup-Seite)
// „Wichtigste Dateien“: Daten, die sich nicht neu herunterladen lassen (Uploads, Plugins, Konfiguration, Logo/Branding)
if(empty($check['ok'])){nasbk_rmtree($tmp);return['ok'=>false,'error'=>'Das erzeugte Backup ist nicht in Ordnung: '.implode(' ',(array)($check['errors']??[]))];}
}else{
$z=newZipArchive();
if($z->open($res['path'])!==true||$z->numFiles<1){nasbk_rmtree($tmp);return['ok'=>false,'error'=>'Das erzeugte Backup lässt sich nicht öffnen oder ist leer.'];}
@send_mail($to,'DeskHub: NAS-Backup fehlgeschlagen','<p>Das automatische Backup auf die NAS ist fehlgeschlagen:</p><p><strong>'.e($message).'</strong></p><p>Details und Einstellungen: Adminportal → NAS-Backup.</p>');
}
}
}
/** Führt ein Backup samt Upload und Aufbewahrung aus. @return array{ok:bool,message:string} */
$note=in_array($del['code'],[200,204],true)?'':' Die Testdatei konnte nicht wieder gelöscht werden (Löschrecht prüfen, sonst bleiben alte Sicherungen liegen).';
return['ok'=>true,'message'=>'Verbindung in Ordnung: Der Ordner „'.($cfg['folder']?:'/').'“ ist erreichbar und beschreibbar.'.$note];
}
/** Wird alle ~5 Minuten vom Plugin-Takt aufgerufen: kopiert neue Backups des Servers auf die NAS und startet ein eigenes Backup, wenn es laut Zeitplan fällig ist. */
if(!$err&&empty($post['db'])&&empty($post['files'])&&!empty($post['own_schedule']))$err='Für den eigenen Zeitplan bitte mindestens „Datenbank“ oder „Dateien“ auswählen.';
if($expected!==null&&filesize($tmp)!==$expected){@unlink($tmp);return['ok'=>false,'message'=>'Herunterladen: Die Datei ist unvollständig angekommen. Bitte erneut versuchen.'];}
if(empty($check['ok'])){@unlink($tmp);return['ok'=>false,'message'=>'Die Sicherung von der NAS ist nicht in Ordnung: '.implode(' ',(array)($check['errors']??[]))];}
if(!@rename($tmp,$target)){@unlink($tmp);return['ok'=>false,'message'=>'Die Datei konnte nicht in den Backup-Ordner verschoben werden.'];}
if(!$remote['ok']){$r['badges'][]='<span class="bk-badge" title="'.e('Die NAS ließ sich nicht abfragen: '.$remote['error']).'">☁ unbekannt</span>';continue;}
$r['badges'][]=$same?'<span class="bk-badge ok" title="Diese Sicherung liegt vollständig auf der NAS">☁ auf NAS</span>':'<span class="bk-badge bad" title="Die Datei auf der NAS hat eine andere Größe">☁ unvollständig</span>';
if(!$same)$r['actions']=nasbk_action_form('upload','☁ Erneut auf NAS',['file'=>$r['name']],'','secondary','',$url).($r['actions']??'');
}else{
$r['badges'][]='<span class="bk-badge" title="Noch nicht auf der NAS (wird automatisch kopiert, sobald das Backup geprüft ist)">nur hier</span>';
$r['actions']=nasbk_action_form('upload','☁ Auf NAS',['file'=>$r['name']],'','secondary','',$url).($r['actions']??'');
'badges'=>['<span class="bk-badge ok" title="Liegt nur auf der NAS">☁ nur auf NAS</span>'],
'actions'=>nasbk_action_form('fetch','⬇ Auf Server holen',['file'=>$it['name']],'Diese Sicherung von der NAS auf den Server laden? Danach kannst du sie hier wiederherstellen.','secondary','',$url)
.nasbk_action_form('delete_remote','🗑',['file'=>$it['name']],'Diese Sicherung von der NAS löschen?','secondary','border-color:var(--danger);color:var(--danger)',$url),
<p class="muted">Kopiert die Backups dieses Servers (Zeitplan und Knopf der Seite „Backup“) automatisch auf deine Synology NAS oder einen anderen WebDAV-Server und kann zusätzlich eigene Backups nach Zeitplan erstellen.</p>
<?php if ($message): ?><div class="flash success"><?= e($message) ?></div><?php endif; ?>
<?php if ($error): ?><div class="flash error"><?= e($error) ?></div><?php endif; ?>
<div class="card nb-card">
<h3>Status</h3>
<?php if ($running): ?>
<p style="margin:0"><strong style="color:#b45309">⏳ Ein Backup läuft gerade …</strong> <span class="muted" style="font-size:.85rem">Die Seite lädt sich von selbst neu.</span></p>
<?php elseif ($lastRun === ''): ?>
<p class="muted" style="margin:0">Noch kein Vorgang gelaufen.</p>
<?php if (!$cfg['enabled']): ?><p class="muted" style="margin:8px 0 0;font-size:.85rem">Das NAS-Backup ist ausgeschaltet.</p>
<?php elseif ($remote !== null && !$remote['ok']): ?><p style="margin:8px 0 0;font-size:.85rem;color:#b91c1c">✗ NAS nicht erreichbar: <?= e($remote['error']) ?></p>
<?php elseif ($remote !== null): ?><p class="muted" style="margin:8px 0 0;font-size:.85rem">✓ NAS erreichbar · <?= count($remote['items']) ?> Sicherung(en) dort<?= $cfg['mirror'] ? ' · neue Backups des Servers werden automatisch kopiert' : '' ?></p><?php endif; ?>
</div>
<div class="card nb-card">
<h3>Backups</h3>
<?php if (!$rows): ?>
<p class="muted" style="margin:0">Noch keine Backups. Sie entstehen auf der Seite „Backup“ (Zeitplan oder „Backup jetzt erstellen“) und werden dann hierher kopiert.</p>
<?php if ($b['local'] && !$same && $remote !== null && $remote['ok']) echo nasbk_action_form('upload', '☁ Auf NAS', ['file' => $b['name']]); ?>
<?php if (!$b['local']) echo nasbk_action_form('fetch', '⬇ Auf Server holen', ['file' => $b['name']], 'Diese Sicherung von der NAS auf den Server laden? Danach kannst du sie auf der Seite „Backup“ wiederherstellen.') . nasbk_action_form('delete_remote', '🗑', ['file' => $b['name']], 'Diese Sicherung von der NAS löschen?', 'secondary', 'border-color:var(--danger);color:var(--danger)'); ?>
</div></td>
</tr>
<?php endforeach; ?>
</tbody>
</table>
<p class="nb-hint">Wiederherstellen und Löschen auf dem Server machst du auf der Seite „Backup“. Sicherungen, die nur auf der NAS liegen, holst du hier zuerst auf den Server.</p>
<p class="nb-hint">Von außen erreichbar: Domain oder DynDNS, zum Beispiel <code>meine-nas.synology.me</code>. Dein Server läuft nicht in deinem Netz, die NAS muss also aus dem Internet erreichbar sein.</p></div></div>
<p class="nb-hint">Am besten ein eigener NAS-Benutzer, der nur auf den Backup-Ordner zugreifen darf. Das Passwort wird verschlüsselt gespeichert.</p></div></div>
<p class="nb-hint">Ohne HTTPS ist nur eine Adresse im eigenen Netz erlaubt, sonst würden Passwort und Backup unverschlüsselt durchs Internet gehen.</p></div></div>
<p class="nb-hint">Beginnt mit dem Namen des freigegebenen Ordners, zum Beispiel <code>/usbshare2/Geschichten/</code>. Unterordner legt das Plugin an, die Freigabe selbst muss es auf der NAS schon geben.</p></div></div>
<div><label class="nb-radio" style="margin:0"><input type="checkbox" name="verify_tls" value="1" <?= $cfg['verify_tls'] ? 'checked' : '' ?>> Zertifikat der NAS prüfen (empfohlen)</label>
<p class="nb-hint">Nur abschalten, wenn die NAS ein selbst erstelltes Zertifikat hat. Dann ist die Verbindung nicht mehr gegen Mithören und Fälschung geschützt. Besser: kostenloses Zertifikat von Let’s Encrypt in der NAS einrichten.</p></div></div>
<span><strong>Jedes Backup von DeskHub automatisch auf die NAS kopieren</strong><br><span class="nb-hint">Gilt für den Zeitplan der Seite „Backup“, für manuelle Backups und für Backups vor Updates. Die Kopie läuft nach dem Backup im Hintergrund und bremst es nicht. Auf der Seite „Backup“ siehst du bei jeder Sicherung, ob sie auf der NAS liegt, kannst Sicherungen auf die NAS legen und Sicherungen, die nur dort liegen, auf den Server holen und wiederherstellen.</span></span></label>
</div>
<div class="card nb-card">
<h3>📦 Backup-Inhalt <span class="muted" style="font-size:.8rem;font-weight:400">(für die eigenen Backups des Plugins)</span></h3>
<p class="nb-hint" style="margin:0 0 6px">Datenbank und Dateien werden in <strong>ein einziges ZIP-Archiv</strong> (<code>backup_DATUM_UHRZEIT.zip</code>) gepackt und auf die NAS hochgeladen. Das Archiv lässt sich auf der Seite „Backup“ wiederherstellen.</p>
<div class="nb-row"><label class="nb-l">Was soll gesichert werden?</label>
<p class="nb-hint">Ein Pfad pro Zeile, relativ zum DeskHub-Hauptordner. Beispiel: <code>uploads/2020</code> oder <code>app_downloads</code>.</p></div></div>
<span><strong>Das Plugin erstellt zusätzlich eigene Backups nach diesem Zeitplan</strong><br><span class="nb-hint">Nur nötig, wenn du auf der Seite „Backup“ keinen Zeitplan nutzt oder die NAS häufiger sichern soll. Diese Backups liegen nur auf der NAS, nicht auf dem Server.</span></span></label>
<p class="nb-hint">Gilt für tägliche, wöchentliche und monatliche Backups (Serverzeit). Bei stündlichen und mehrstündigen Intervallen wird die Uhrzeit ignoriert.<br>Der Zeitplan läuft mit, sobald jemand im Adminportal aktiv ist oder ein Cronjob DeskHub aufruft.</p></div></div>
</div>
<div class="card nb-card">
<h3>🗑 Aufbewahrung & Bereinigung</h3>
<p class="nb-hint" style="margin:0 0 6px">Beide Regeln gelten gleichzeitig – ein Backup wird gelöscht, sobald <em>eine</em> davon zutrifft. Es werden nur Dateien gelöscht, die dieses Plugin selbst angelegt hat (<code>backup_….zip</code>), eigene Dateien im Ordner bleiben unberührt.</p>
<p class="nb-hint">Es werden maximal so viele <code>backup_*.zip</code>-Dateien auf der NAS behalten. Überschüssige werden – älteste zuerst – gelöscht. <strong>0 = deaktiviert.</strong></p></div></div>
<p class="nb-hint">Speichere zuerst. Der Verbindungstest legt den Ordner an, schreibt eine kleine Testdatei und löscht sie wieder. „Eigenes Backup jetzt starten“ erzeugt ein Backup mit den Einstellungen oben, lädt es hoch und läuft im Hintergrund. Die vorhandenen Backups des Servers verwaltest du auf der Seite „Backup“.</p>
"description":"Kopiert die Backups des Servers (Zeitplan und Knopf der Seite Backup) automatisch per WebDAV auf eine Synology NAS oder einen anderen WebDAV-Server. Mit eigener Seite im Adminportal: Verbindung, Backup-Liste (auf dem Server / auf der NAS), Aufbewahrung nach Alter und Anzahl, optional eigener Zeitplan mit Inhalt und Ausschlüssen, Verbindungstest und Fehlermeldung per E-Mail.",
// Einstellungen und Liste: als Reiter „Synology NAS Backup“ unter „Backup“ (kein eigener Menüpunkt), nur für Administratoren
// (die Berechtigung kennt nur der Admin). Ältere DeskHub-Versionen ohne Reiter zeigen die Seite als normalen Menüpunkt.
plugin_register_menu('Synology NAS Backup','einstellungen','manage_nas_backup','backup');
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.