Worum es geht
Bei Reverse SSH baut Ihr NAS selbst eine ausgehende, verschlüsselte Verbindung (Tunnel) zu PaperOffice auf. Eine Portfreigabe im Router ist nicht nötig. PaperOffice AI legt die verschlüsselten Dokumente eines Workspaces dann auf Ihrem NAS ab.
Legen Sie den Speicher an, bevor Sie den Workspace erstellen. Der Speichermodus eines Workspaces ist nach dem Erstellen endgültig.
Schritt 1: NAS vorbereiten (Beispiel QNAP)
Die Menüs in QTS sind je nach QTS-Version leicht abweichend.
- Legen Sie einen eigenen Freigabeordner an, zum Beispiel
paperoffice, nicht den Ordner von PaperOffice Classic oder der MariaDB. - Erlauben Sie SSH und SFTP unter Systemsteuerung › Netzwerk- & Dateidienste › Telnet / SSH.
- Tragen Sie dort unter „Zugriffsberechtigung bearbeiten“ den NAS-Benutzer ein, mit dem Sie sich anmelden. Fehlt er in dieser Liste, lehnt das NAS die SSH-Anmeldung ab.
- Installieren Sie Container Station (Docker). Den vorgeschlagenen Freigabeordner für Container können Sie belassen.
Synology: Container Manager, Benutzer-Home-Dienst aktiv, Benutzer in der Gruppe administrators. ASUSTOR: Docker Engine. UGREEN: Docker.
Schritt 2: Speicher in PaperOffice AI anlegen
- Öffnen Sie Document AI › Storage Mounts und klicken Sie auf Storage Mount hinzufügen.
- Felder mit rotem Stern (*) sind Pflichtfelder.
- Name für diesen Storage Mount: frei wählbar.
- Verwendungszweck: Als BYOS-Storage verwenden.
- Verbindungstyp: Lokalen Ordner per Reverse-SSH verbinden.
- Ihr NAS: Wählen Sie QNAP. Die App schlägt dann
/share/paperofficevor (Synology, ASUSTOR, UGREEN:/volume1/paperoffice). - Lokaler SSH-Benutzer: Ihr Benutzer auf dem NAS. Er muss Mitglied der Administratoren sein.
- Lokaler Ordner: der volle Pfad zum Ordner, auf QNAP
/share/<Name des Freigabeordners>. Ohne Anführungszeichen, Backslash und* ? [ ]. Ordner und Benutzer lassen sich später nicht mehr ändern. - Verschlüsselungs-Passwort und Passwort bestätigen: mindestens 16 Zeichen, oder Sicheres Passwort generieren (Schlüssel-Symbol).
- Klicken Sie auf Als .txt herunterladen. Erst danach lässt sich der Speicher anlegen. Bewahren Sie die Datei sicher auf: Ohne Passwort gibt es keine Wiederherstellung.
- Setzen Sie das Häkchen zur Bestätigung und speichern Sie.
Schritt 3: Den richtigen Einrichtungsblock wählen
Nach dem Speichern öffnet sich das Fenster Reverse-SSH-Setup mit Ihrem Tunnel-Alias. Oben wählen Sie die Variante:
- NAS mit Docker: ein Block, der einen kleinen Tunnel-Container startet. Für QNAP mit Container Station die richtige Wahl.
- NAS ohne Docker: Block 1 einmal per SSH, Block 2 in den Autostart.
- Linux / macOS und Windows: für Computer.
Kopieren Sie den Block mit Setup kopieren. Bei NAS ohne Docker hat jeder der beiden Blöcke einen eigenen Knopf.
Schritt 4: Am NAS anmelden und den Block einfügen
Unter Windows zum Beispiel mit PuTTY (Bezeichnungen je nach Version leicht abweichend):
- Tragen Sie bei Host die IP-Adresse Ihres NAS im Heimnetz ein, Port
22, und öffnen Sie die Verbindung. - Melden Sie sich mit dem NAS-Benutzer aus Schritt 2 an. Beim Passwort sehen Sie keine Zeichen. Das ist normal.
- Zeigt QNAP nach der Anmeldung ein Konsolenmenü (zum Beispiel „Console Management“), verlassen Sie es zur normalen Befehlszeile, je nach QTS-Version etwa mit
Qund dannY. - Ein Rechtsklick ins Fenster fügt den Block ein. Drücken Sie danach Enter.
Am Mac: Programm Terminal, dann ssh <Benutzer>@<IP-Adresse des NAS>.
Der Block gehört nur in dieses Fenster am NAS. Das NAS braucht Internetzugang: Der Tunnel wird von Ihrem NAS nach außen aufgebaut, und der Container lädt beim Start ein kleines Linux-Paket.
Schritt 5: Verbindung testen
- Öffnen Sie den Speicher unter Storage Mounts mit Bearbeiten.
- Klicken Sie auf Verbindung testen (erst nach dem Speichern möglich).
- Erfolg: „Tunnel aktiv: NAS erreichbar und Ordner beschreibbar.“ Danach legen Sie den Workspace mit Eigener Speicher (BYOS) an.
Meldet der Test eine abgelehnte Anmeldung, prüfen Sie den NAS-Benutzer und die Zugriffsliste aus Schritt 1. Fügen Sie die Einrichtung dann als der eingetragene NAS-Benutzer erneut ein und testen Sie noch einmal.
Was der Trace zeigt
Verbindung testen in der Übersicht startet den PaperOffice Trace mit Karte. Bei Reverse SSH ist das Ziel der Tunnel-Server von PaperOffice, nicht Ihr NAS. Die Ortsangaben sind Netzknoten auf diesem Weg, nicht der Speicherort Ihrer Dateien.
Nach einem Neustart
Der Tunnel-Container startet nach jedem Neustart automatisch, sobald Docker läuft. Bricht die Verbindung ab, verbindet er sich nach 10 Sekunden neu. Ohne Docker sorgt Block 2 im Autostart dafür.
Sicherheit: Der Einrichtungsblock enthält einen privaten Schlüssel
Der Block enthält einen privaten Schlüssel und trägt ihn als Anmeldeschlüssel für Ihren NAS-Benutzer ein. Wer den Block hat, kann sich als Ihr Tunnel ausgeben und sich, wo der SSH-Dienst Ihres NAS für ihn erreichbar ist, als Ihr NAS-Benutzer anmelden. Ihr Verschlüsselungs-Passwort steht nicht im Block.
- Fügen Sie den Block nie in Chats, KI-Assistenten, E-Mails oder Support-Tickets ein.
- Der Support braucht den Block nicht. Nennen Sie stattdessen die Fehlermeldung des Tests.
Wenn es doch passiert ist:
- Löschen Sie die Nachricht, wo möglich.
- Einen Knopf „Schlüssel neu erzeugen“ gibt es nicht. Beim Bearbeiten bleibt der Schlüssel gleich.
- Nutzt noch kein Workspace den Speicher: Löschen Sie den Storage Mount. PaperOffice entfernt dabei den Schlüssel vom Tunnel-Server; Dateien auf dem NAS bleiben. Legen Sie den Speicher neu an (neuer Schlüssel, neuer Tunnel-Alias), mit demselben Verschlüsselungs-Passwort oder einem leeren Ordner.
- Entfernen Sie auf dem NAS den alten Schlüssel: Im Ordner
.sshIhres NAS-Benutzers die Zeile inauthorized_keys, die mit „PaperOffice“ und dem alten Tunnel-Alias endet, und die Dateipaperoffice_<alter Tunnel-Alias>. Mit Docker: Löschen Sie in Ihrer Docker-Oberfläche (QNAP: Container Station) den alten Container, dessen Name mitpaperoffice-tunnel-beginnt. Ohne Docker: Löschen Sie im selben Ordner.sshdas Skriptpaperoffice_tunnel_<alter Tunnel-Alias>.shund entfernen Sie den alten Eintrag aus dem Autostart. - Nutzt bereits ein Workspace den Speicher, lässt er sich nicht löschen. Erstellen Sie dann in der App unter Support ein Ticket und schreiben Sie, dass der Schlüssel nach außen gelangt ist. Fügen Sie den Block dabei nicht ein.