TrueNAS SCALE
NAS Guard Agent installieren
Der NAS Guard Agent läuft als leichtgewichtiger Container auf deinem TrueNAS und verbindet dein NAS mit der App — sicher und ohne Ports ins Internet freizugeben.
Warum den Agent nutzen?
- Echtzeit Push-Alerts — werde sofort benachrichtigt bei NAS-Problemen (degradierte Pools, Disk-Fehler, ausgefallene Dienste).
- Kein Port-Forwarding nötig — der Agent verbindet sich ausgehend mit unserem Push-Service. Dein NAS bleibt hinter der Firewall.
- Datenschutz — es werden nur Alert-Metadaten übertragen. Kein Zugriff auf deine Dateien oder Zugangsdaten.
- Video-Streaming — der Agent bietet direktes File-Streaming und HLS-Remuxing für den integrierten Video-Player, damit du Videos auf deinem NAS ansehen kannst, ohne sie vorher herunterzuladen.
- Widget-Aktualisierung — der Agent pusht Live-Status-Updates an deine Home Screen und Lock Screen Widgets.
Was du brauchst
- TrueNAS SCALE mit aktivierten Apps.
- Ein Server-Profil in der NAS Guard iOS App (TrueNAS URL + API-Key).
Aus der App installieren (empfohlen)
Der einfachste Weg den Agent zu installieren ist direkt aus der NAS Guard App:
- NAS Guard auf iOS öffnen und zu den Server-Einstellungen navigieren.
- Zu Server Monitoring scrollen.
- Storage Pool auswählen und Install Agent tippen.
Erwartetes Ergebnis: Die App installiert den Agent automatisch. Nach wenigen Sekunden zeigt der Status Running.
Nach der Installation führt dich die App durch das Pairing. Details unter Pairing.
Manuelle Installation (fortgeschritten)
Wenn du lieber manuell installierst oder die Konfiguration anpassen möchtest:
- In TrueNAS Apps öffnen → neue Custom App erstellen.
- Edit → Edit App YAML öffnen und folgendes einfügen:
services:
nas-guard-agent:
container_name: nas-guard-agent
environment:
- NASGUARD_PUSH_BASE_URL=https://apn.no-logs.de
- NASGUARD_DATA_DIR=/data
image: registry.git.no-logs.de/hans/nas-guard-agent-images:latest
ports:
- '18080:8080'
pull_policy: always
restart: unless-stopped
volumes:
- /mnt/POOL/apps/nas-guard-agent:/data
Nur diese Zeilen bei Bedarf anpassen:
- Datenpfad:
/mnt/POOL/... durch deinen Dataset-Pfad ersetzen.
- Web UI Port:
18080 ändern, falls der Port schon belegt ist.
Wenn die App läuft, öffne das Agent Web UI unter http://<truenas-ip>:18080/ und fahre mit Pairing fort.