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.
Mehr kommt: Der Agent legt die Grundlage für weitere Features in zukünftigen Updates — wer ihn jetzt installiert, profitiert automatisch.
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.