NAS per Reverse SSH en Docker als eigen opslag koppelen (voorbeeld QNAP)

Waar gaat het over

Bij Reverse SSH bouwt u NAS zelf een uitgaande, versleutelde verbinding (tunnel) op naar PaperOffice. Een poortdoorverwijzing in de router is niet nodig. PaperOffice AI bewaart de versleutelde documenten van een Workspaces vervolgens op uw NAS.

Maak de opslag aan voordat u de Workspace maakt. De opslagmodus van een Workspaces is na het aanmaken definitief.

Stap 1: NAS voorbereiden (voorbeeld QNAP)

De menu's in QTS wijken per QTS-versie licht af.

  1. Maak een eigen gedeelde map aan, bijvoorbeeld paperoffice, niet de map van PaperOffice Classic of de MariaDB.
  2. Sta SSH en SFTP toe onder Configuratiescherm › Netwerk- & servicediensten › Telnet / SSH.
  3. Voer daar onder 'Toegangsrechten bewerken' de NAS-gebruiker in waarmee u zich aanmeldt. Ontbreekt deze in deze lijst, dan weigert het NAS de SSH-aanmelding.
  4. Installeer Container Station (Docker). De voorgestelde gedeelde map voor containers kunt u laten staan.

Synology: Container Manager, gebruikers-homeservice actief, gebruiker in de groep administrators. ASUSTOR: Docker Engine. UGREEN: Docker.

Stap 2: Opslag in PaperOffice AI aanmaken

  1. Open Document AI › Storage Mounts en klik op Storage Mount toevoegen.
  2. Velden met een rode ster (*) zijn verplichte velden.
  3. Naam voor deze Storage Mount: vrij kiesbaar.
  4. Betalingskenmerk: Gebruiken als BYOS-Storage.
  5. Verbindingstype: Lokale map verbinden via Reverse-SSH.
  6. Uw NAS: Kies QNAP. De app stelt vervolgens /share/paperoffice voor (Synology, ASUSTOR, UGREEN: /volume1/paperoffice).
  7. Lokale SSH-gebruiker: uw gebruiker op de NAS. Deze moet lid zijn van de beheerders.
  8. Lokale map: het volledige pad naar de map, op QNAP /share/<Name des Freigabeordners>. Zonder aanhalingstekens, backslash en * ? [ ]. Map en gebruiker kunnen achteraf niet meer worden gewijzigd.
  9. Encryptie Wachtwoord en Wachtwoord bevestigen: minimaal 16 tekens, of Veilig wachtwoord genereren (sleutelsymbool).
  10. Klik op Downloaden als .txt. Pas daarna kan de opslag worden aangemaakt. Bewaar het bestand veilig: zonder wachtwoord is er geen herstel mogelijk.
  11. Zet het selectievakje voor bevestiging en sla op.

Stap 3: De juiste configuratieblok kiezen

Na het opslaan wordt het venster Reverse-SSH-installatie geopend met uw Tunnel-alias. Bovenaan kiest u de variant:

  • NAS met Docker: een blok dat een kleine tunnelcontainer start. Voor QNAP met Container Station is dit de juiste keuze.
  • NAS zonder Docker: blok 1 één keer via SSH, blok 2 in het autostart.
  • Linux / macOS en Windows: voor computers.

Kopieer het blok met Kopieer instellingen. Bij NAS zonder Docker heeft elk van de twee blokken een eigen knop.

Stap 4: Aanmelden bij het NAS en het blok invoegen

Onder Windows bijvoorbeeld met PuTTY (aanduidingen kunnen per versie licht afwijken):

  1. Voer bij Host het IP-adres van uw NAS in het thuisnetwerk in, poort 22, en open de verbinding.
  2. Meld u aan met de NAS-gebruiker uit stap 2. Bij het wachtwoord ziet u geen tekens. Dit is normaal.
  3. Toont QNAP na het aanmelden een consolemenu (bijvoorbeeld „Console Management“), verlaat dit naar de normale opdrachtregel, afhankelijk van de QTS-versie bijvoorbeeld met Q en vervolgens Y.
  4. Een rechtermuisklik in het venster voegt het blok in. Druk daarna op Enter.

Op de Mac: programma Terminal, vervolgens ssh <Benutzer>@<IP-Adresse des NAS>.

Het blok hoort alleen in dit venster bij het NAS. Het NAS heeft internettoegang nodig: de tunnel wordt vanuit uw NAS naar buiten opgebouwd, en de container laadt bij het starten een klein Linux-pakket.

Stap 5: Verbinding testen

  1. Open het opslagmedium onder Storage Mounts met Bewerken.
  2. Klik op Verbinding testen (eerst mogelijk na het opslaan).
  3. Succes: „Tunnel actief: NAS bereikbaar en map beschrijfbaar.“ Leg daarna de Workspace aan met Eigen Opslag (BYOS).

Meldt de test een geweigerde aanmelding, controleer dan de NAS-gebruiker en de toegangslijst uit stap 1. Voeg de inrichting vervolgens opnieuw in als de ingeschreven NAS-gebruiker en test nogmaals.

Wat de trace toont

Verbinding testen start in het overzicht de PaperOffice Trace met kaart. Bij Reverse SSH is het doel van de tunnel-server van PaperOffice, niet uw NAS. De locatiegegevens zijn netwerkknopen op deze route, niet de opslaglocatie van uw bestanden.

Na een herstart

De tunnel-container start na elke herstart automatisch zodra Docker draait. Breekt de verbinding af, dan maakt hij zich na 10 seconden opnieuw verbonden. Zonder Docker zorgt blok 2 in het autostartproces ervoor.

Beveiliging: Het inrichtingsblok bevat een privésleutel

Het blok bevat een privésleutel en draagt deze als aanmeldingssleutel voor uw NAS-gebruiker in. Wie het blok heeft, kan zich als uw tunnel uitgeven en, waar de SSH-dienst van uw NAS voor hem bereikbaar is, zich als uw NAS-gebruiker aanmelden. Uw versleutelingswachtwoord staat niet in het blok.

  • Voeg het blok nooit toe aan chats, AI-assistenten, e-mails of supporttickets.
  • De ondersteuning heeft het blok niet nodig. Vermeld in plaats daarvan de foutmelding van de test.

Wenn es doch passiert ist:

  1. Verwijder de bericht, waar mogelijk.
  2. Er is geen knop "Sleutel opnieuw genereren". Bij het bewerken blijft de sleutel gelijk.
  3. Gebruikt nog geen Workspace het opslag: verwijder de Storage Mount. PaperOffice verwijdert daarbij de sleutel van de tunnel-server; bestanden op de NAS blijven bewaard. Maak het opslag opnieuw aan (nieuwe sleutel, nieuwe tunnel-alias), met hetzelfde versleutelingswachtwoord of een lege map.
  4. Verwijder op de NAS de oude sleutel: in de map .ssh van uw NAS-gebruiker de regel in authorized_keys die eindigt met "PaperOffice" en de oude tunnel-alias, en het bestand paperoffice_<alter Tunnel-Alias>. Met Docker: verwijder in uw Docker-interface (QNAP: Container Station) de oude container, waarvan de naam begint met paperoffice-tunnel-. Zonder Docker: verwijder in dezelfde map .ssh het script paperoffice_tunnel_<alter Tunnel-Alias>.sh en verwijder de oude invoer uit het autostartproces.
  5. Gebruikt reeds een Workspace het opslag, dan kan deze niet worden verwijderd. Maak in de app onder Support dan een ticket aan en vermeld dat de sleutel naar buiten is gelekt. Voeg het blok daarbij niet toe.

Doorgaan