Collegare NAS per Reverse SSH e Docker come archivio autonomo (esempio QNAP)

Di cosa si tratta

Con Reverse SSH, l'utente configura autonomamente una connessione in uscita crittografata (tunnel) verso PaperOffice. Non è necessaria alcuna apertura di porte nel router. PaperOffice AI memorizza quindi i documenti crittografati di un Workspaces sul Suo dispositivo NAS.

Creare l'archivio prima di creare il Workspace. La modalità di archiviazione di un Workspaces è definitiva dopo la creazione.

Passo 1: Preparare NAS (esempio QNAP)

I menu in QTS possono variare leggermente a seconda della versione di QTS.

  1. Creare una propria cartella condivisa, ad esempio paperoffice, non la cartella di PaperOffice Classic o di MariaDB.
  2. Abilitare SSH e SFTP in Pannello di controllo › Servizi di rete e file › Telnet / SSH.
  3. Inserire in "Modifica autorizzazioni di accesso" l'utente NAS con cui effettuare il login. Se questo utente non è presente nell'elenco, NAS rifiuterà la connessione SSH.
  4. Installare Container Station (Docker). È possibile mantenere la cartella condivisa proposta per i container.

Synology: Container Manager, servizio Home utente attivo, utente nel gruppo amministratori. ASUSTOR: Motore Docker. UGREEN: Docker.

Passo 2: Creare l'archivio in PaperOffice AI

  1. Aprire Document AI › Storage Mounts e fare clic su Aggiungi Storage Mount.
  2. I campi con l'asterisco rosso (*) sono obbligatori.
  3. Nome per questo Storage Mount: a scelta libera.
  4. Causale: Usare come BYOS-Storage.
  5. Tipo di connessione: Connetti cartella locale tramite Reverse-SSH.
  6. Il Suo NAS: Selezionare QNAP. L'app suggerirà quindi /share/paperoffice (Synology, ASUSTOR, UGREEN: /volume1/paperoffice).
  7. Utente SSH locale: Il Suo utente sul dispositivo NAS. Deve essere membro del gruppo degli amministratori.
  8. Cartella locale: il percorso completo alla cartella; su QNAP /share/<Name des Freigabeordners>. Senza virgolette, barra rovesciata e * ? [ ]. La cartella e l'utente non possono essere modificati in seguito.
  9. Password di crittografia e Conferma password: almeno 16 caratteri, oppure utilizzare Genera password sicura (simbolo chiave).
  10. Fare clic su Scarica come .txt. Solo dopo è possibile creare l'archivio. Conservare il file in modo sicuro: senza la password non è prevista alcuna recupero.
  11. Inserire la spunta di conferma e salvare.

Passo 3: Selezionare il blocco di configurazione corretto

Dopo il salvataggio, si apre la finestra Configurazione Reverse-SSH con il Suo Alias tunnel. In alto, scelga la variante:

  • NAS con Docker: un blocco che avvia un piccolo contenitore tunnel. La scelta corretta per QNAP con Container Station.
  • NAS senza Docker: blocco 1 una volta tramite SSH, blocco 2 nell'avvio automatico.
  • Linux / macOS e Windows: per computer.

Copi il blocco con Copia configurazione. Per NAS senza Docker, ciascun dei due blocchi dispone di un proprio pulsante.

Passo 4: Accedere al NAS e incollare il blocco

Ad esempio su Windows con PuTTY (le denominazioni possono variare leggermente a seconda della versione):

  1. Inserisca presso Host l'indirizzo IP del Suo NAS nella rete domestica, porta 22, e apra la connessione.
  2. Acceda con l'utente NAS del passo 2. Per la password non verranno visualizzati caratteri. Questo è normale.
  3. Se QNAP mostra un menu della console dopo l'accesso (ad esempio "Console Management"), lo esca per tornare alla riga di comando normale, a seconda della versione di QTS ad esempio con Q e poi Y.
  4. Un clic destro nella finestra incolla il blocco. Dopo ciò prema Invio.

Su Mac: programma Terminale, quindi ssh <Benutzer>@<IP-Adresse des NAS>.

Il blocco va inserito solo in questa finestra al NAS. Il NAS necessita di accesso a Internet: il tunnel viene stabilito dal Suo NAS verso l'esterno, e il contenitore carica all'avvio un piccolo pacchetto Linux.

Passo 5: Testare la connessione

  1. Apra lo spazio di archiviazione sotto Storage Mounts con Modifica.
  2. Clicchi su Test connessione (possibile solo dopo il salvataggio).
  3. Successo: "Tunnel attivo: NAS raggiungibile e cartella scrivibile." Dopo ciò crei il Workspace con Propria archiviazione (BYOS).

Se il test segnala un accesso rifiutato, verifichi l'utente NAS e la lista di accesso dal passo 1. Inserisca quindi nuovamente la configurazione come utente registrato NAS e testi ancora una volta.

Cosa mostra il trace

In Test connessione avvia la traccia PaperOffice con la mappa. In Reverse SSH la destinazione del tunnel è il server di PaperOffice, non il Suo NAS. Le indicazioni geografiche sono nodi di rete su questo percorso, non il luogo di archiviazione dei Suoi file.

Dopo un riavvio

Il container del tunnel si avvia automaticamente dopo ogni riavvio, non appena Docker è in esecuzione. Se la connessione si interrompe, si riconnette dopo 10 secondi. Senza Docker, il blocco 2 nell'avvio automatico provvede alla gestione.

Sicurezza: Il blocco di configurazione contiene una chiave privata

Il blocco contiene una chiave privata e la registra come chiave di accesso per il Suo utente NAS. Chi possiede il blocco può spacciarsi per il Suo tunnel e, laddove il servizio SSH del Suo NAS sia raggiungibile, accedere come utente del Suo NAS. La password di crittografia non si trova nel blocco.

  • Non inserire mai il blocco in chat, assistenti IA, e-mail o ticket di supporto.
  • Il supporto non necessita del blocco. Indicare invece l'errore restituito dal test.

Wenn es doch passiert ist:

  1. Eliminare il messaggio, ove possibile.
  2. Non esiste un pulsante "Rigenera chiave". Durante la modifica la chiave rimane invariata.
  3. Se Workspace non utilizza ancora l'archivio: eliminare il Storage Mount. PaperOffice rimuove la chiave dal server del tunnel; i file sull'NAS restano intatti. Creare nuovamente l'archivio (nuova chiave, nuovo alias del tunnel) con la stessa password di crittografia o una cartella vuota.
  4. Rimuovere la vecchia chiave dall'NAS: nella cartella .ssh dell'utente dell'NAS eliminare la riga in authorized_keys che termina con "PaperOffice" e il vecchio alias del tunnel, nonché il file paperoffice_<alter Tunnel-Alias>. Con Docker: eliminare nell'interfaccia di Docker (QNAP: Container Station) il vecchio container, il cui nome inizia con paperoffice-tunnel-. Senza Docker: eliminare nella stessa cartella .ssh lo script paperoffice_tunnel_<alter Tunnel-Alias>.sh e rimuovere la vecchia voce dall'avvio automatico.
  5. Se un altro Workspace utilizza già l'archivio, non è possibile eliminarlo. Creare in tal caso un ticket nell'app sotto Supporto indicando che la chiave è stata esposta all'esterno. Non inserire il blocco.

Continua