UniFi Network Application Docker-Setup mit Update-, Backup- und Restore-Skripten

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-26 19:34:07 +02:00
commit 247f20602b
7 changed files with 280 additions and 0 deletions
@@ -0,0 +1,79 @@
+# UniFi Network Application (Docker)
+
+UniFi Network Application (Controller) mit MongoDB, alle persistenten Daten
+liegen im Projektordner unter `./data/`.
+
+- Image: [linuxserver/unifi-network-application](https://docs.linuxserver.io/images/docker-unifi-network-application/)
+- Datenbank: MongoDB **4.4** (bewusst — die CPU dieses Rechners hat kein AVX,
+  MongoDB 5+ würde nicht starten. Nicht auf ein neueres Mongo-Image wechseln!)
+
+## Erster Start
+
+```bash
+docker-compose up -d
+docker-compose logs -f unifi-network-application   # warten bis der Start durch ist
+```
+
+Danach im Browser: **https://<host-ip>:8443** (selbstsigniertes Zertifikat,
+Warnung einmalig bestätigen). Im Einrichtungs-Assistenten kann auch direkt ein
+vorhandenes Backup (`.unf`) eingespielt werden.
+
+## Wichtig: Inform-Port ist 8082 (nicht 8080!)
+
+Port 8080 ist auf diesem Host bereits belegt, deshalb lauscht der
+Inform-Port für die Geräte-Adoption auf **8082**. Damit Geräte sich melden:
+
+- In der Weboberfläche: *Einstellungen → System → Erweitert →
+  "Inform Host" überschreiben* aktivieren und `<host-ip>:8082` eintragen, **oder**
+- pro Gerät per SSH: `set-inform http://<host-ip>:8082/inform`
+
+## Ports
+
+| Host-Port | Zweck                                    |
+|-----------|------------------------------------------|
+| 8443      | Weboberfläche (HTTPS)                    |
+| 8082      | Inform / Geräte-Adoption (→ 8080 intern) |
+| 3478/udp  | STUN                                     |
+| 10001/udp | Geräte-Discovery                         |
+| 8843      | Gäste-Portal HTTPS (optional)            |
+| 8880      | Gäste-Portal HTTP (optional)             |
+| 6789      | Mobile Speedtest (optional)              |
+
+## Aktualisieren
+
+```bash
+./update.sh
+```
+
+Erstellt zuerst ein Backup, zieht dann die neuesten Images und startet die
+Container neu. Alle Daten bleiben in `./data/` erhalten.
+
+## Backups
+
+```bash
+./backup.sh          # kopiert die UniFi-Autobackups (.unf) nach ./backups/
+./backup.sh --full   # Komplett-Backup von ./data als tar.gz (kurze Downtime)
+```
+
+Autobackups einmalig in der Weboberfläche aktivieren:
+*Einstellungen → System → Backups → Automatische Sicherung*.
+
+## Wiederherstellen
+
+```bash
+./restore.sh backups/unifi-full-backup_<datum>.tar.gz   # Komplett-Restore
+./restore.sh backups/autobackup_<datum>/<datei>.unf     # .unf bereitstellen
+```
+
+`.unf`-Backups werden anschließend in der Weboberfläche eingespielt
+(*Einstellungen → System → Backups → Wiederherstellen*) oder bei einer
+Neuinstallation direkt im Einrichtungs-Assistenten.
+
+## Verzeichnisstruktur
+
+```
+data/mongodb/   MongoDB-Datenbank
+data/unifi/     UniFi-Konfiguration, Logs, Autobackups
+backups/        von backup.sh erstellte Sicherungen
+.env            Zugangsdaten der Datenbank (nicht weitergeben)
+```