Diagnose
Fehlerbehebung
App zeigt „Nicht verbunden"
- Erreichbarkeit prüfen:
curl http://<host-ip>:18080/health
- Sicherstellen, dass das iPhone im selben Netz wie der Docker-Host ist (oder per VPN).
- URL in Einstellungen → Agent-Verbindung mit Schema und Port eintragen (z. B.
http://192.168.1.20:18080).
App meldet „Ungültiger API-Schlüssel"
Der X-API-Key-Header passt nicht zum DOCKERGUARD_API_KEY des Agents. Wert erneut einfügen und Verbinden antippen.
Container-Aktionen schlagen fehl
- Der Docker-Socket muss im Agent schreibbar gemountet sein (das
:ro entfernen).
- Das Control Pack muss in der iOS-App aktiv sein.
- Agent-Logs prüfen:
docker logs docker-guard-agent
Keine Hintergrund-Benachrichtigungen
- iOS begrenzt Background-Fetches. Das Intervall in der App ist nur ein Vorschlag — der tatsächliche Zeitplan liegt bei iOS.
- Benachrichtigungen müssen in iOS-Einstellungen → Docker Guard erlaubt sein.
- Force-Quit der App deaktiviert Background-Fetches.
Lokaler Netzwerkzugriff
iOS fragt beim ersten Verbindungsversuch zum Agent nach Erlaubnis für lokales Netzwerk. Wurde „Nicht erlauben" gewählt, lässt sich das unter iOS-Einstellungen → Docker Guard → Lokales Netzwerk zurücksetzen.