Erste Schritte
Setup-Checkliste
Bitte diese Schritte in Reihenfolge durchführen. Jeder Schritt hat ein Erwartetes Ergebnis, damit du das Setup verifizieren kannst (wichtig für App-Store Review).
0) Voraussetzungen
- iPhone und Agent müssen
https://apn.no-logs.de erreichen können.
- Das Agent Web UI muss vom iPhone-Browser erreichbar sein.
Hinweis: Wenn Hostnames im Container nicht auflösbar sind (z.B. manche .local Setups), nutze eine IP-Adresse oder einen DNS-Namen, der im Container auflösbar ist.
1) TrueNAS API-Key erstellen
- In der TrueNAS UI einen API-Key erstellen.
- API-Key kopieren und sicher aufbewahren.
Erwartetes Ergebnis: Du hast einen TrueNAS API-Key, den du gleich in der iOS App einfügst.
2) Server-Profil in der iOS App anlegen
- NAS Guard auf iOS öffnen.
- Server-Profil mit TrueNAS URL und API-Key anlegen.
Erwartetes Ergebnis: Das Server-Profil ist gespeichert und auswählbar.
3) Agent installieren
- In der iOS App zu den Server-Einstellungen navigieren und zu Server Monitoring scrollen.
- Storage Pool auswählen und Install Agent tippen.
Erwartetes Ergebnis: Der Agent wird automatisch installiert und zeigt nach wenigen Sekunden den Status Running.
Alternativ kannst du den Agent auch manuell installieren, wenn du die Konfiguration anpassen möchtest.
4) Pairing-Code in iOS erzeugen
- In NAS Guard iOS dein Server-Profil öffnen.
- Agent Pairing-Code erzeugen.
Erwartetes Ergebnis: Die iOS App zeigt einen Pairing-Code und eine Ablaufzeit.
5) Pairing-Code im Agent Web UI eingeben
- Agent Web UI im Browser öffnen.
- Pairing-Code eingeben und Pair drücken.
- iOS App kurz geöffnet lassen, damit sie die TrueNAS-Konfiguration hochladen kann.
Erwartetes Ergebnis: Der Agent zeigt „paired“ und startet die Verbindung zu TrueNAS.
6) TLS / Zertifikat-Pinning (TOFU)
Wenn dein TrueNAS ein selbstsigniertes Zertifikat nutzt, kann der Agent den Zertifikat-Fingerprint "pinnen" (Trust On First Use). Siehe TLS / Zertifikat-Pin.
7) Dateien browsen (optional)
Nach der Verbindung kannst du das TrueNAS-Dateisystem aus der App browsen. Tippe auf ein Dataset oder einen Pool, um hineinzunavigieren. Dateien können per QuickLook vorgeschaut und Videos über den Agent gestreamt werden. Siehe File Browser.
8) Widget hinzufügen (optional)
Home Screen oder Lock Screen lange drücken, + tippen, nach NAS Guard suchen und Widget-Größe wählen. Widgets werden automatisch über den Agent aktualisiert. Siehe Widgets.