Lier NAS à Reverse SSH et Docker en tant que stockage dédié (exemple QNAP)

De quoi s'agit-il

Avec Reverse SSH, vous établissez vous-même une connexion sortante chiffrée (tunnel) vers PaperOffice. Une ouverture de port dans le routeur n'est pas nécessaire. PaperOffice AI stocke ensuite les documents chiffrés d'un Workspaces sur votre NAS.

Créez le stockage avant de créer le Workspace. Le mode de stockage d'un Workspaces est définitif après sa création.

Étape 1 : Préparation de NAS (exemple QNAP)

Les menus de QTS peuvent légèrement varier selon la version de QTS.

  1. Créez un dossier de partage dédié, par exemple paperoffice, et non le dossier de PaperOffice Classic ou celui de MariaDB.
  2. Autorisez SSH et SFTP dans Panneau de configuration › Services réseau et fichiers › Telnet / SSH.
  3. Dans « Modifier les autorisations d'accès », saisissez l'utilisateur NAS avec lequel vous souhaitez vous connecter. S'il manque dans cette liste, le NAS rejettera la connexion SSH.
  4. Installez Container Station (Docker). Vous pouvez conserver le dossier de partage proposé pour les conteneurs.

Synology : Container Manager, service Domicile utilisateur activé, utilisateur dans le groupe administrators. ASUSTOR : Moteur Docker. UGREEN : Docker.

Étape 2 : Création du stockage dans PaperOffice AI

  1. Ouvrez Document AI › Storage Mounts et cliquez sur Ajouter Storage Mount.
  2. Les champs avec une étoile rouge (*) sont obligatoires.
  3. Nom pour ce Storage Mount: au choix.
  4. Référence de paiement: Utiliser comme BYOS-Storage.
  5. Type de connexion: Connecter un dossier local via Reverse-SSH.
  6. Votre NAS: Sélectionnez QNAP. L'application proposera ensuite /share/paperoffice (Synology, ASUSTOR, UGREEN : /volume1/paperoffice).
  7. Utilisateur SSH local: Votre utilisateur sur le NAS. Il doit être membre des administrateurs.
  8. Dossier local: le chemin complet vers le dossier, sur QNAP /share/<Name des Freigabeordners>. Sans guillemets, sans antislash et sans * ? [ ]. Le dossier et l'utilisateur ne peuvent plus être modifiés par la suite.
  9. Mot de passe de chiffrement et Confirmer le mot de passe: au moins 16 caractères, ou Générer un mot de passe sécurisé (icône de clé).
  10. Cliquez sur Télécharger au format .txt. Seul après cela, le stockage peut être créé. Conservez le fichier en toute sécurité : sans mot de passe, aucune récupération n'est possible.
  11. Cochez la case de confirmation et enregistrez.

Étape 3 : Choisissez le bon bloc d'installation

Après l'enregistrement, la fenêtre Configuration Reverse-SSH s'ouvre avec votre Alias de tunnel. En haut, sélectionnez la variante :

  • NAS avec Docker: un bloc qui démarre un petit conteneur de tunnel. Le choix approprié pour QNAP avec Container Station.
  • NAS sans Docker: Bloc 1 une fois via SSH, Bloc 2 dans le démarrage automatique.
  • Linux / macOS et Windows: pour les ordinateurs.

Copiez le bloc avec Copier la configuration. Pour NAS sans Docker, chaque bloc dispose de son propre bouton.

Étape 4 : Connectez-vous au NAS et insérez le bloc

Sous Windows, par exemple avec PuTTY (les appellations peuvent varier légèrement selon la version) :

  1. Saisissez l'adresse IP de votre NAS dans le réseau local sous « Host », le port 22, et ouvrez la connexion.
  2. Connectez-vous avec l'utilisateur NAS de l'étape 2. Lors de la saisie du mot de passe, aucun caractère ne s'affiche. C'est normal.
  3. Si QNAP affiche un menu de console après la connexion (par exemple « Console Management »), quittez-le pour accéder à l'invite de commande normale, selon la version de QTS, par exemple avec Q puis Y.
  4. Un clic droit dans la fenêtre insère le bloc. Appuyez ensuite sur Entrée.

Sur Mac : ouvrez le programme Terminal, puis ssh <Benutzer>@<IP-Adresse des NAS>.

Le bloc doit être inséré uniquement dans cette fenêtre du NAS. Le NAS nécessite un accès Internet : le tunnel est établi depuis votre NAS vers l'extérieur, et le conteneur télécharge un petit paquet Linux au démarrage.

Étape 5 : Tester la connexion

  1. Ouvrez le stockage sous Storage Mounts avec Modifier.
  2. Cliquez sur Tester la connexion (possible uniquement après l'enregistrement).
  3. Succès : « Tunnel actif : NAS accessible et dossier en écriture. » Ensuite, créez le Workspace avec Propre stockage (BYOS).

Si le test signale une connexion refusée, vérifiez l'utilisateur NAS et la liste d'accès de l'étape 1. Réinsérez ensuite la configuration en tant qu'utilisateur NAS enregistré et testez à nouveau.

Ce que montre le trace

Tester la connexion dans la vue d'ensemble lance la trace PaperOffice avec une carte. Pour Reverse SSH, l'objectif du tunnel est le serveur de PaperOffice, et non votre NAS. Les indications de localisation correspondent à des nœuds réseau sur ce chemin, et non à l'emplacement de vos fichiers.

Après un redémarrage

Le conteneur du tunnel redémarre automatiquement après chaque redémarrage dès que Docker est en cours d'exécution. Si la connexion est interrompue, il se reconnecte au bout de 10 secondes. Sans Docker, le bloc 2 dans le démarrage automatique s'en charge.

Sécurité : Le bloc d'installation contient une clé privée

Le bloc contient une clé privée et l'enregistre en tant que clé d'identification pour votre utilisateur NAS. Quiconque possède ce bloc peut se faire passer pour votre tunnel et, là où le service SSH de votre NAS est accessible, se connecter en tant que votre utilisateur NAS. Votre mot de passe de chiffrement ne figure pas dans le bloc.

  • Ne collez jamais ce bloc dans des chats, des assistants IA, des e-mails ou des tickets de support.
  • Le Support n'a pas besoin du bloc. Indiquez plutôt le message d'erreur du test.

Wenn es doch passiert ist:

  1. Supprimez le message si possible.
  2. Il n'existe pas de bouton « Régénérer la clé ». Lors de l'édition, la clé reste identique.
  3. Si aucun Workspace n'utilise encore le stockage : supprimez le Storage Mount. PaperOffice retire ainsi la clé du serveur du tunnel ; les fichiers sur le NAS restent intacts. Recréez le stockage (nouvelle clé, nouveau nom d'alias du tunnel) avec le même mot de passe de chiffrement ou un dossier vide.
  4. Supprimez l'ancienne clé sur le NAS : dans le dossier .ssh de votre utilisateur NAS, supprimez la ligne dans authorized_keys qui se termine par « PaperOffice » et l'ancien nom d'alias du tunnel, ainsi que le fichier paperoffice_<alter Tunnel-Alias>. Avec Docker : supprimez dans votre interface Docker (QNAP : Container Station) l'ancien conteneur dont le nom commence par paperoffice-tunnel-. Sans Docker : supprimez dans le même dossier .ssh le script paperoffice_tunnel_<alter Tunnel-Alias>.sh et retirez l'ancienne entrée du démarrage automatique.
  5. Si un Workspace utilise déjà le stockage, il ne peut pas être supprimé. Créez alors un ticket dans l'application sous Support et indiquez que la clé a été exposée. Ne collez pas le bloc dans ce cas.

Suite