Technical Anshu
Tutorials Blog
Nextcloud + OnlyOffice

Nextcloud avec OnlyOffice Guide d’intégration complet

Votre propre cloud privé où l'équipe peut stocker des fichiers et éditer des documents Word, Excel et PowerPoint ensemble dans le navigateur - pas de licence par utilisateur, vos données sur votre serveur.

By Technical AnshuLinux ServerSelf HostedFull setup
Regardez la vidéo complète - Configuration et intégration de Nextcloud et OnlyOffice, étape par étape

Stockage de fichiers de style Google Drive avec édition de style Office, sur un serveur que vous contrôlez : c'est ce que vous offre Nextcloud plus OnlyOffice. Ce guide couvre le chemin complet : installez les deux serveurs, connectez-les correctement et prouvez la configuration avec une véritable première modification. Regardez la vidéo ci-dessus pour connaître le processus complet à l'écran et utilisez cette page comme liste de contrôle.

How the two servers talk to each other
Your browser opens the fileNextcloud page
Editor loads inside the pageOnlyOffice Docs
Docs server downloads the fileFrom Nextcloud
You type, changes collectInside Docs server
Saved file sent backCallback to Nextcloud
Rule to remember - the two servers must be able to reach each other, not just your browser.
Exemple de flux d'un document du clic à l'enregistrement : chaque étape nécessite que les deux serveurs soient accessibles
1

Ce que vous construisez et pourquoi deux serveurs

Nextcloud stocke vos fichiers et gère les utilisateurs, le partage et la synchronisation - mais à lui seul, il ne peut que prévisualiser les documents, pas vraiment les modifier dans le navigateur. OnlyOffice Docs est le moteur d'édition. Il s'agit d'un programme serveur distinct qui se charge dans la page Nextcloud et effectue l'édition proprement dite des styles Word, Excel et PowerPoint.

Ce projet comporte donc toujours trois parties : installer Nextcloud, installer OnlyOffice Docs, puis les connecter avec l'application de connecteur officielle et une clé secrète partagée. Ignorez les détails de connexion et tout semble installé – mais aucun document ne s’ouvre. C’est à cette étape de couplage que la plupart des configurations échouent, et c’est le cœur de ce guide.

2

Avant de commencer – Serveur, domaine et HTTPS

Décidez d’abord de ces trois choses, car les modifier ultérieurement signifie refaire l’intégration.

  1. Serveur. Un serveur Linux peut exécuter les deux pour une petite équipe. OnlyOffice Docs veut à lui seul au moins 4 Go de RAM, alors donnez 8 Go à une boîte combinée si vous le pouvez. Un guide des tailles séparé est lié dans les pages associées.
  2. Deux adresses. Utilisez un sous-domaine pour chaque service, par exemple cloud.example.com pour Nextcloud et office.example.com pour OnlyOffice. Un serveur partagé avec un proxy inverse devant est très bien.
  3. HTTPS sur les deux. Il ne s'agit pas d'un polissage facultatif. Si Nextcloud est sur HTTPS et que l'éditeur est sur HTTP simple, le navigateur bloque l'éditeur en tant que contenu mixte. Obtenez des certificats (Let's Encrypt est gratuit) avant de connecter les deux.
3

Installer Nextcloud

Installez Nextcloud sur votre serveur Linux avec un serveur Web (Apache ou Nginx), PHP et une vraie base de données - MariaDB ou PostgreSQL pour tout ce qui va au-delà d'un petit test. Créez le compte administrateur, terminez le programme d'installation Web et confirmez que vous pouvez vous connecter, télécharger un fichier et le voir dans l'application Fichiers.

Deux habitudes dès le premier jour : activez les vérifications côté serveur sous Paramètres, Administration, Présentation et effacez tous les avertissements possibles, et notez votre adresse Nextcloud exactement telle que les utilisateurs l'ouvriront - le connecteur a ensuite besoin que cette adresse corresponde.

4

Installer OnlyOffice Docs

La voie officielle et la plus simple est l’image Docker. Une commande de démarrage typique ressemble à ceci (la valeur secrète est expliquée à l'étape suivante - utilisez votre propre valeur aléatoire longue, jamais cet exemple) :

  1. sudo docker run -i -t -d -p 8080:80 -e JWT_ENABLED=true -e JWT_SECRET=YourLongSecretValue --restart=always onlyoffice/documentserver
  2. Attendez une minute qu'il démarre, puis ouvrez http://your-server:8080/healthcheck - il doit répondre true. Rien d'autre n'a d'importance jusqu'à ce que cela soit dit vrai.
  3. Placez-le derrière votre proxy inverse pour qu'il réponde sur son propre sous-domaine HTTPS, par exemple https://office.example.com/, et testez à nouveau le contrôle de santé sur cette adresse.

Ne laissez pas la page d'exemple intégrée activée sur un serveur public ultérieurement : il s'agit d'un outil de test qui ne fait pas partie de votre système bureautique.

5

Connectez-les avec l'application Connector et le secret

C’est sur cette étape que repose toute la configuration. L'application de connecteur réside dans Nextcloud ; le secret prouve aux deux serveurs qu'ils parlent à leur véritable partenaire.

  1. Dans Nextcloud, ouvrez Applications, recherchez ONLYOFFICE et installez l'application de connecteur officielle.
  2. Accédez à Paramètres, Administration, ONLYOFFICE.
  3. Dans Adresse du service d'édition de documents, saisissez votre adresse OnlyOffice, par exemple https://office.example.com/.
  4. Dans Clé secrète, collez exactement le même secret que vous avez fourni au serveur Docs (la valeur JWT_SECRET). Un personnage différent et le jumelage échoue.
  5. Cliquez sur Enregistrer. Nextcloud vérifie maintenant la connexion. Un message de réussite vert signifie que la poignée de main a fonctionné.

Si la sauvegarde échoue, ne réinstallez rien : il s'agit presque toujours du secret, de l'adresse ou d'un serveur incapable d'atteindre l'autre. Le guide en lecture seule et de correction d'erreurs lié ci-dessous couvre ces trois causes dans l'ordre.

6

Le premier montage – Prouvez toute la chaîne

Téléchargez un petit document de test, puis ouvrez-le. Il devrait se charger dans l’éditeur OnlyOffice. Tapez une ligne, attendez quelques secondes, fermez l'onglet et ouvrez à nouveau le fichier - votre ligne doit être là. Téléchargez également le fichier une fois et confirmez que la modification se trouve dans le fichier réel, pas seulement à l'écran.

Testez ensuite comme un vrai utilisateur : partagez le fichier avec un deuxième compte, ouvrez-le depuis les deux comptes en même temps, et regardez apparaître les curseurs de co-édition. Ce n'est que lorsque l'enregistrement, le partage et l'édition conjointe sont réussis que l'intégration est réellement effectuée.

Remarque honnête : l'éditeur enregistre sur Nextcloud lorsque le dernier éditeur ferme le document ou après un court délai d'inactivité, et non à chaque frappe dans le fichier lui-même. Si le serveur Docs est arrêté en cours de session, les derniers instants de travail peuvent être perdus. Maintenez la stabilité du serveur Docs et sauvegardez les deux moitiés comme expliqué dans le guide de sauvegarde.

Regardez le guide vidéo complet

La vidéo montre l'installation complète et l'intégration à l'écran - les deux serveurs, les paramètres du connecteur et la première édition du document.

Watch Full Video
Questions courantes (FAQ)

Nextcloud et OnlyOffice peuvent-ils fonctionner sur le même serveur ?

Oui, pour une équipe à domicile ou dans un petit bureau, un serveur Linux peut exécuter les deux, idéalement avec les deux services sur des sous-domaines distincts derrière un proxy inverse. Donnez à la machine suffisamment de RAM - OnlyOffice Docs veut à lui seul au moins 4 Go - et déplacez le serveur Docs vers sa propre machine lorsque la charge d'édition augmente.

L'utilisation d'OnlyOffice est-elle gratuite avec Nextcloud ?

L'édition communautaire OnlyOffice Docs est gratuite et open source et couvre l'édition normale de documents, de feuilles de calcul et de présentations avec co-édition. Des éditions payantes existent pour les déploiements à grande échelle nécessitant une prise en charge officielle et des fonctionnalités de mise à l'échelle. Pour une petite équipe, l'édition gratuite est le point de départ habituel.

Pourquoi le document ne s'ouvre-t-il pas après avoir tout connecté ?

Presque toujours l'une des trois causes suivantes : la clé secrète du connecteur Nextcloud ne correspond pas exactement au secret du serveur Docs, le serveur Docs ne peut pas atteindre Nextcloud pour télécharger le fichier et renvoyer les modifications, ou l'éditeur est chargé via HTTP simple dans une page HTTPS et le navigateur le bloque. Vérifiez-les dans cet ordre.

Ce guide est basé sur la vidéo Technical Anshu sur l'intégration de Nextcloud et OnlyOffice. Coincé sur une marche ? Demandez dans les commentaires vidéo - vous y obtiendrez une réponse.