Homelab 11 : vos fichiers et votre bureautique à la place de Google Drive et Docs

Niveau IntermédiaireTemps estimé 2 hÀ lire avant Homelab 2 : une seule entrée HTTPS pour tous vos servicesUn mot inconnu ? Lexique

Nextcloud garde vos fichiers, les synchronise sur chaque appareil, et y ajoute agendas, contacts et liens de partage. Associé à OnlyOffice, il édite les fichiers Word, Excel et PowerPoint dans le navigateur, à plusieurs en même temps. C'est le remplaçant le plus lourd de cette série, et celui où comprendre le mécanisme fait gagner le plus de temps.

Ouvrir un document fait parler trois acteurs. Votre navigateur obtient la liste des fichiers de Nextcloud mais charge l'éditeur depuis le serveur de documents ; celui-ci va chercher le fichier chez Nextcloud et l'y enregistre. Chaque requête entre eux est signée avec le même secret partagé.

Un peu d'histoire

Nextcloud a été fondé en 2016 par Frank Karlitschek et la plupart des développeurs d'ownCloud, le projet qu'il avait lancé en 2010, après un désaccord sur sa direction. Il couvre fichiers, agendas, contacts et plus encore. Pour les documents modifiés dans le navigateur, il se branche à une suite bureautique comme OnlyOffice, si bien qu'un tableur s'ouvre et s'enregistre sans quitter votre serveur.

1. Nextcloud

Lancez l'image officielle de Nextcloud avec une base PostgreSQL et Redis pour le cache, épinglez la version majeure, et publiez-la par votre proxy HTTPS (Homelab 2). Derrière un proxy, dites à Nextcloud comment on le joint, dans config/config.php :

'trusted_domains' => ['cloud.votredomaine.tld'],
'trusted_proxies' => ['<adresse locale de votre proxy>'],
'overwriteprotocol' => 'https',

Sans overwriteprotocol, Nextcloud se croit servi en HTTP simple et fabrique des liens cassés et des boucles de redirection.

Les tâches de fond : dans Administration → Paramètres de base, choisissez Cron, et lancez-le toutes les cinq minutes depuis l'hôte :

*/5 * * * * docker exec -u www-data nextcloud php -f /var/www/html/cron.php

2. OnlyOffice

Lancez l'image OnlyOffice Document Server, version épinglée, avec un secret partagé pour que seul votre Nextcloud puisse l'utiliser :

environment:
  - JWT_ENABLED=true
  - JWT_SECRET=<une longue valeur aléatoire>

Publiez-le par le proxy sous son propre nom (par exemple office.votredomaine.tld). Dans Nextcloud, installez l'app ONLYOFFICE, puis donnez-lui l'adresse HTTPS du serveur de documents et le même secret.

Pourquoi ça échoue, et où regarder

Le schéma ci-dessus est tout le guide de dépannage. Si l'éditeur reste blanc, votre navigateur ne joint pas l'adresse du serveur de documents. Si l'éditeur s'ouvre mais que le fichier ne se charge ou ne s'enregistre pas, le serveur de documents ne joint pas l'adresse de Nextcloud, ou les secrets diffèrent. Vérifiez chaque flèche depuis l'endroit d'où elle part.

Pièges

À son premier démarrage, le serveur de documents télécharge ses extensions par défaut sur Internet. Si ce téléchargement reste pendu, le serveur tourne en boucle dans son initialisation et ne devient jamais sain. Si le premier démarrage ne finit jamais, regardez d'abord le processus du gestionnaire d'extensions.

Les deux services doivent être en HTTPS si la page l'est : un navigateur refuse de charger un éditeur HTTP dans une page HTTPS, sans message clair.

Ne testez pas le port interne du serveur de documents en HTTPS s'il sert du HTTP simple derrière le proxy : vous n'obtiendrez aucune réponse et soupçonnerez le mauvais composant.

Sources

Utile ? Dites-nous ce qu'il faut mesurer ensuite.