Server Sync Dokumentation
Automatische Dateisynchronisierung zwischen zwei Pelican-Servern — uni- und bidirektional, vollständig oder pfadbasiert, mit automatischer Zeitplanung, Schedule-Integration und Subuser-Berechtigungen.
Über Server Sync
Server Sync ist ein proprietäres Plugin für das Pelican Panel von Eranio, das die automatische Dateisynchronisierung zwischen zwei Pelican-Servern ermöglicht. Es eignet sich ideal für Server-Netzwerke, Staging-Umgebungen oder Backup-Szenarien.
Hauptfunktionen
| Funktion | Beschreibung |
|---|---|
| Unidirektionale Synchronisierung | Main → Sub oder Sub → Main |
| Bidirektionale Synchronisierung | Main ↔ Sub, Main hat Priorität bei Konflikten |
| Vollständige Verzeichnissynchronisierung | Gesamtes Serververzeichnis synchronisieren |
| Pfadbasierte Synchronisierung | Nur ausgewählte Pfade synchronisieren |
| Ausschluss-Pfade | Manuell oder per File Browser Dateien/Ordner ausschließen |
| Live-Sync | Dateien synchronisieren, während die Server laufen |
| On-Restart-Sync | Server stoppen, synchronisieren, neu starten |
| Automatische Zeitplanung | Konfigurierbares Sync-Intervall pro Pair |
| Schedule-Integration | Als Task-Typ im Pelican Schedule-System |
| Schedule-Mirroring | Zeitpläne auf den Partner-Server spiegeln |
| Inkrementeller Sync | Nach dem ersten Sync nur geänderte Dateien übertragen |
| Batch-Splitting | Automatische Aufteilung bei großen Datenmengen |
| Subuser-Berechtigungen | Granulare Berechtigungen (Anzeigen, Verwalten, Auslösen) |
| 11 Sprachen | EN, DE, ES, FR, IT, JA, KO, NL, PT-BR, TR, ZH-CN |
| Auto-Update | Automatische Updates über GitHub Releases |
Architektur
Das Plugin arbeitet vollständig innerhalb des Pelican Panels und nutzt die vorhandene Daemon-Infrastruktur:
Admin/Server Panel → SyncService → DaemonFileRepository → Wings Daemon
→ NodeJWTService (Authentifizierung)
Synchronisierungsablauf:
- Dateien auf dem Quell-Server zu einem
.tar.gz-Archiv komprimieren - JWT-Token für authentifizierten Download erstellen (15 Min. gültig)
- Archiv per HTTP Pull auf den Ziel-Server übertragen
- Archiv auf dem Ziel-Server entpacken
- Temporäre Archive auf beiden Servern bereinigen
Datenspeicherung
| Daten | Speicherort |
|---|---|
| Sync-Paare | server_sync_pairs Datenbanktabelle |
| Sync-Protokolle | server_sync_logs Datenbanktabelle |
| Plugin-Einstellungen | server_sync_settings Datenbanktabelle |
| Pro-Server-Limit | servers.server_sync_limit Spalte |
| Temporäre Archive | .server_sync_* Dateien auf den Servern |
Voraussetzungen
- Pelican Panel mit Plugin-Unterstützung
- PHP 8.2 oder neuer
- Datenbankbenutzer mit CREATE TABLE-Berechtigung
- Wings Daemon auf beiden Servern erreichbar
storage/undbootstrap/cache/beschreibbar (Berechtigungen0755)
Anleitungen
Installation & Einrichtung
# Installation & Einrichtung Vollständige Schritt-für-Schritt-Anleitung zur I...
Konfiguration
# Konfiguration Detaillierte Beschreibung aller Konfigurationsoptionen des Se...
Datenbank-Schema
# Datenbank-Schema Übersicht über alle Datenbanktabellen und -spalten des Ser...
Admin-Panel
# Admin-Panel: SyncOverview Die Admin-Seite unter `/admin/server-sync` bietet...
Server-Panel
# Server-Panel: ServerSync Die Server-Seite unter `/server/{server}/server-sy...
Synchronisierungs-Mechanismus
# Synchronisierungs-Mechanismus Detaillierte Beschreibung, wie die Dateisynch...
Schedule-Integration
# Schedule-Integration Server Sync integriert sich direkt in das Pelican Sche...
Berechtigungen & Sicherheit
# Berechtigungen & Sicherheit Übersicht über das Berechtigungssystem des Serv...