Exploiter Paperless-ngx avec peu d’espace de stockage : externaliser les documents vers un service cloud

Paperless-ngx stocke ses documents dans un répertoire local, et ce répertoire grandit à chaque scan. Pourtant, Paperless n’a guère besoin des fichiers au quotidien : la recherche interroge la base de données, la liste affiche des aperçus, et le fichier proprement dit n’est lu qu’à son ouverture. J’ai donc testé s’il était possible de déplacer le stockage vers un service cloud. L’outil utilisé est Rclone, avec lequel les utilisateurs de Plex montent depuis des années des collections multimédias entières depuis le cloud.

Le résultat : cela fonctionne dans les deux sens, et la configuration ne nécessite désormais plus que trois commandes. Cet article résume les résultats du test et explique comment mettre en place vous-même cette configuration. Les détails techniques sont traités dans des articles distincts liés à la fin : propagation des mounts Docker, particularités d’AppArmor, authentification à deux facteurs et méthodologie de mesure.

Le principe : le Hot Storage reste local, le Cold Storage est dans le cloud

Dans Paperless, c’est précisément le nom du répertoire qui prête à confusion : archive/ n’est pas du Cold Storage, mais contient la version PDF/A fournie à chaque affichage. Malgré son nom, elle fait partie du Hot Storage. Les originaux rarement nécessaires sous originals/ constituent le véritable Cold Storage. Si vous souhaitez économiser au maximum, désactivez complètement la copie d’archive avec PAPERLESS_ARCHIVE_FILE_GENERATION=never ; la recherche en texte intégral n’en est pas affectée, car le texte se trouve dans la base de données.

Paperless-ngx ne propose d’ailleurs aucune connexion cloud intégrée, ni S3 ni django-storages. Un mount de système de fichiers via Rclone est actuellement la seule solution, et il fonctionne avec chacun des plus de 70 services pris en charge par Rclone. Proton Drive a été mon choix de test en raison du chiffrement de bout en bout ; un stockage compatible S3 est l’alternative la plus robuste.

Ce que le test a montré

Testé avec une instance Paperless isolée, 40 PDF de test générés (13.9 MB) et un compte Proton dédié :

Les besoins de stockage local sont ainsi découplés de la taille des archives : la collection peut grandir, pas le disque.

Comment l’installer

La configuration complète est disponible sous forme de modèle sur GitHub : pfstr/paperless-cloud-storage. Sur le serveur :

git clone https://github.com/pfstr/paperless-cloud-storage.git
cd paperless-cloud-storage
sudo ./setup.sh      # einmalig, bereitet den Host vor (einziger Root-Schritt)
./wizard.sh          # geführt: Anbieter wählen, Zugangsdaten, Rundlauf-Test

L’assistant demande le service cloud (Proton, S3, Backblaze B2, WebDAV, SFTP ou « Not in the list » pour tout autre service Rclone), vérifie la connexion au moyen d’un véritable test d’envoi et de téléchargement, puis démarre le conteneur de stockage. Ensuite :

• Nouvelle installation : docker compose -f paperless.yml up -d, terminé.
• Instance Paperless existante : la base de données et les paramètres restent intacts ; le guide RETROFIT.md décrit l’envoi des documents existants et la modification nécessaire de votre fichier Compose.

J’ai volontairement renoncé à une interface web. L’interface graphique web de Rclone a d’abord été utilisée, mais les tunnels SSH, CORS et les mounts éphémères la rendaient pire que la ligne de commande qu’elle était censée remplacer. Trois questions dans le terminal sont plus rapides.

Pour que le mount reste stable au quotidien

Le modèle prend en charge quatre points que vous devez également considérer pour votre propre configuration :

1. propagation: rslave sur le media bind mount du conteneur Paperless, sans quoi le conteneur ne survivra pas au redémarrage du mount. Détails et problème AppArmor sous-jacent : Mount Rclone dans un conteneur Docker.
2. Arrêter Paperless lorsque le mount est absent. Sinon, il écrit les documents dans un répertoire local vide, et le mount qui revient les recouvre de manière invisible. Un script watchdog est fourni avec le modèle.
3. Un compte capable de se connecter sans surveillance. Avec Proton, cela signifie enregistrer la clé TOTP dans la configuration Rclone. Pourquoi cela ne dévalorise pas l’authentification à deux facteurs et quelle est la situation globale de Proton sous Linux : Proton Drive sous Linux.
4. Désactiver les tâches de lecture complète planifiées (PAPERLESS_SANITY_TASK_CRON=disable), car la vérification d’intégrité lirait sinon régulièrement l’ensemble du contenu depuis le cloud.

Ce que vous devez évaluer avant de l’utiliser

Un document fraîchement ajouté ne se trouve que quelques secondes dans le cache local, jusqu’à la fin de l’envoi. Si la machine tombe en panne précisément durant cette fenêtre, le fichier est perdu. La limite du cache est souple et peut être nettement dépassée pendant de courtes périodes lors de pics d’accès. De plus, le backend Proton de Rclone est officiellement en bêta ; il a montré des symptômes de limitation lors d’appels API rapides. Comme des données de long terme issues d’une utilisation continue font encore défaut, le modèle est indiqué comme expérimental.

La façon dont les mesures ont été obtenues, les pannes simulées et les moyens de tester sérieusement une telle configuration sont décrits dans l’article méthodologique : Tester les mounts cloud avec des PDF générés.

Conclusion

Utiliser Paperless-ngx sur un petit disque avec un stockage cloud est réalisable et adapté au quotidien : près de deux secondes à la première ouverture, puis la vitesse du cache ; la recherche et l’interface restent indépendantes du cloud, et la configuration se rétablit elle-même après des pannes. Si vous souhaitez seulement économiser quelques gigaoctets sur un serveur normalement dimensionné, vous devriez toutefois faire le calcul : dans mon cas, l’ensemble du stockage occupait 71 MB, contre plusieurs gigaoctets pour le système d’exploitation. Le gain ne réside pas dans l’espace immédiatement économisé, mais dans le fait que le stock peut grandir sans que le disque doive grandir avec lui.