Exemple illustratif : Imaginez une petite équipe dont les fichiers Nextcloud sont hébergés à l’adresse https://cloud.example.com. Son administrateur souhaite un serveur Collabora Online Development Edition (CODE) distinct à l’adresse https://office.example.com. Il s’agit d’une configuration hypothétique servant à expliquer les étapes, et non d’un compte rendu d’installation réelle. Remplacez les deux noms d’hôtes de l’exemple par des domaines que vous contrôlez.
CODE s'exécute comme un service distinct de Nextcloud. Docker lance le service Collabora ; un proxy inverse TLS le publie ; et l'intégration Nextcloud Office assure la connexion entre les deux. Votre navigateur doit pouvoir accéder à l'URL publique de votre compte Office, et les serveurs doivent pouvoir accéder aux points de terminaison Nextcloud et Collabora correspondants. Le manuel d'installation actuel de Nextcloud Office décrit Docker comme une option de déploiement et précise qu'un serveur dédié nécessite généralement un proxy inverse.
Avant de commencer
Par exemple, supposons qu'un hôte Linux puisse exécuter Docker, que Nextcloud fonctionne déjà via HTTPS et que les enregistrements DNS des deux noms d'hôte pointent vers les serveurs appropriés. Obtenez un certificat TLS valide pour cet office.example.comhôte. Prévoyez d'exposer le service Collabora via ce nom d'hôte, plutôt que d'ouvrir directement son port Docker sur Internet.
- Vérifiez que l'hôte CODE peut résoudre et se connecter à
cloud.example.com.
- Vérifiez que les navigateurs peuvent accéder
https://office.example.comau protocole HTTPS.
- Choisissez si le proxy inverse s'exécute sur l'hôte Docker ou ailleurs. Un proxy sur le même hôte peut utiliser un port de conteneur publié en boucle locale ; un proxy dans un autre conteneur nécessite un réseau Docker partagé accessible ou une autre route privée.
- Avant toute utilisation en production, veuillez consulter la documentation actuelle de CODE et de Nextcloud afin de vérifier la compatibilité et les exigences relatives aux proxys. CODE est l'édition de développement ; les équipes nécessitant une stabilité et un support technique officiels sont invitées à envisager une offre Collabora Online prise en charge.
Les commandes ci-dessous utilisent le collabora/codenom d'image officiel et une seule origine Nextcloud. Les exemples ne spécifient pas d'étiquette de version ; il appartient donc à l'administrateur de définir une politique de versionnage et de mise à jour, plutôt que de les considérer latestcomme une stratégie de contrôle des modifications en production.
1. Configurez le nom d'hôte du bureau pour qu'il pointe vers votre serveur.
Créez un enregistrement DNS de type A ou AAAA office.example.compointant vers l'hôte ou l'équilibreur de charge hébergeant Collabora. Configurez le proxy inverse pour qu'il termine les requêtes HTTPS avec un certificat valide pour ce nom et qu'il redirige les chemins d'accès de l'application Collabora ainsi que le trafic WebSocket vers le conteneur CODE. La documentation officielle de Collabora relative au proxy inverse fournit des exemples spécifiques ; consultez la section correspondante à votre logiciel proxy et à votre version actuelle de CODE.
Ne copiez pas aveuglément un extrait de code proxy générique. Le proxy doit prendre en charge les mises à jour WebSocket, conserver les informations d'hôte et de protocole de redirection requises, et transmettre les routes Collabora telles que ` /browser<router> `, /hosting/discovery`<router>` et ` <router> /cool`. Les directives exactes diffèrent selon qu'il s'agisse d'Apache, NGINX, Traefik ou d'autres passerelles. Si le proxy s'exécute sur l'hôte Docker, la redirection vers ` 127.0.0.1:9980<router>` est une cible privée courante. S'il s'agit d'un conteneur distinct, cette adresse de bouclage fait référence au conteneur proxy lui-même, et non à l'hôte CODE.
2. Démarrez le conteneur Docker CODE
Sur l'hôte Docker, téléchargez et démarrez le conteneur. Dans cet exemple, le port est lié à l'interface de bouclage (loopback) afin qu'il ne soit pas directement exposé sur toutes les interfaces réseau de l'hôte.
docker pull collabora/code
docker run -d --name collabora -p 127.0.0.1:9980:9980 -e 'aliasgroup1=https://cloud.example.com:443' --restart always --cap-add MKNOD collabora/code
Cette aliasgroup1valeur autorise l'origine Nextcloud qui doit utiliser ce service CODE. Veillez à ce que le schéma et le nom d'hôte correspondent à l'URL d'accès à Nextcloud ; spécifiez un port non standard si le service Nextcloud public en utilise un. Si plusieurs instances Nextcloud doivent utiliser le service, configurez les groupes d'hôtes autorisés supplémentaires conformément à la documentation de l'image CODE, plutôt que d'autoriser un grand nombre d'hôtes.
Cette commande suppose que le proxy inverse se trouve sur la même machine et redirige vers le port de bouclage. Si vous utilisez Docker Compose, un proxy conteneurisé ou un proxy distant, configurez soigneusement le réseau et l'exposition des ports. Évitez d'exposer publiquement le port 9980 uniquement pour établir une connexion proxy ; utilisez un réseau Docker privé, une règle de pare-feu ou tout autre chemin d'accès restreint. Pour connaître les options actuelles de l'image Docker CODE, consultez le guide Docker CODE de Collabora .
3. Configurez le proxy inverse et vérifiez le code.
Une fois le proxy configuré, rechargez-le en utilisant la méthode propre à votre logiciel et vérifiez sa configuration avant d'appliquer les modifications. Ensuite, demandez le point de terminaison de découverte public depuis une machine pouvant accéder au domaine :
curl -fsS https://office.example.com/hosting/discovery | head
Une réponse positive doit contenir des informations de découverte XML et non une page d'erreur de proxy. Ce contrôle confirme que l'URL publique atteint un point de terminaison Collabora ; il ne prouve pas pour autant que l'autorisation Nextcloud, les WebSockets ou l'édition de documents fonctionnent. En cas d'échec du point de terminaison, examinez également le conteneur.
docker ps --filter name=collabora
docker logs --tail=100 collabora
Dans cette configuration hypothétique, un refus de connexion à l'URL publique indique en premier lieu un problème de DNS, de TLS, de pare-feu ou de routage proxy. Une réponse 502 signifie généralement que le proxy ne peut pas atteindre le serveur en amont configuré pour le conteneur. Si la découverte fonctionne mais que l'éditeur échoue ensuite lors du chargement, vérifiez le transfert WebSocket et si le proxy signale une erreur de mise à niveau ou une erreur en amont.
4. Connectez Nextcloud à Collabora
Dans Nextcloud, ouvrez la section Applications et installez ou activez l'intégration Office proposée pour votre version. Le nom de l'application peut être « Nextcloud Office » ou « Collabora Online », selon la version et le catalogue d'applications installées. Ouvrez ensuite les paramètres d'administration d'Office et saisissez :
https://office.example.com
Enregistrez les paramètres et vérifiez l'état de la connexion. La documentation de configuration Office de Nextcloud indique que ce champ correspond à l'URL et au port du serveur Collabora et recommande l'utilisation du protocole HTTPS. Utilisez l'URL publique de Collabora accessible par les navigateurs. Dans les installations avec DNS fractionné, NAT ou réseau segmenté, Nextcloud peut également nécessiter une route interne vers ce service ; consultez les options de connexion avancées de votre version d'application plutôt que de supposer que le DNS public fonctionne depuis le serveur.
Dans cet exemple, Nextcloud considère cloud.example.coml'hôte WOPI comme autorisé, et les navigateurs des utilisateurs ouvrent l'éditeur depuis cet office.example.comhôte. Si votre page d'administration Nextcloud propose une liste blanche pour les requêtes WOPI, limitez-la aux adresses des serveurs Collabora attendus après avoir vérifié leur exactitude sur votre réseau. Nextcloud recommande de limiter les requêtes WOPI aux hôtes Collabora attendus ; n'ajoutez pas de plages d'adresses trop larges sans raison réseau précise.
5. Testez avec un document d'exemple
Connectez-vous en tant qu'utilisateur Nextcloud habituel, créez un court document texte ou ouvrez un fichier de test temporaire, puis sélectionnez l'éditeur de navigateur. Vérifiez que la barre d'outils de l'éditeur s'affiche, effectuez une modification mineure, attendez l'indicateur d'enregistrement, fermez le fichier et rouvrez-le pour vérifier que la modification a bien été enregistrée. Si votre installation prend en charge l'édition simultanée, ouvrez le même fichier de test dans une seconde session utilisateur et vérifiez que la présence et les modifications sont bien mises à jour.
Ces vérifications permettent de distinguer les principales couches : la requête de découverte teste le routage public ; l’état de Nextcloud teste la connexion au serveur configuré ; l’ouverture de l’éditeur teste l’accès au navigateur et l’échange WOPI ; et la réouverture du fichier teste le chemin d’enregistrement. N’utilisez pas de document important pour le premier test. CODE est une version de développement ; par conséquent, un test réussi ne remplace pas l’évaluation de la disponibilité, de la capacité des ressources, des sauvegardes et des besoins de support de votre organisation.
Problèmes courants et points à vérifier
Nextcloud signale que le serveur est inaccessible.
Vérifiez l'URL Office : assurez-vous qu'elle ne comporte pas de faute de frappe, que la chaîne de certificats est valide et que le schéma HTTPS est correct. Testez l'URL de découverte depuis un navigateur et depuis l'hôte Nextcloud. Si la résolution DNS publique diffère au sein du réseau du serveur, configurez une route interne appropriée ou utilisez les paramètres d'URL serveur avancés pris en charge par votre connecteur.
La page s'ouvre, mais l'éditeur de documents se bloque.
Examinez les journaux d'accès et d'erreurs du proxy inverse afin de détecter les échecs de mise à niveau WebSocket. Vérifiez que le proxy transmet bien les routes Collabora actuelles et maintient ouvertes les connexions WebSocket persistantes. Les outils de développement du navigateur peuvent indiquer si la requête WebSocket est rejetée, redirigée vers HTTP ou bloquée par une erreur de certificat.
Collabora rejette l'hébergeur Nextcloud
Comparez l'origine Nextcloud réelle (schéma, nom d'hôte et port) avec le groupe d'alias configuré. Une incohérence entre une URL publique, un nom d'hôte interne et une règle de réécriture de proxy peut entraîner des échecs d'autorisation ou de WOPI. Ajoutez uniquement le nom d'hôte Nextcloud souhaité à la configuration autorisée.
Le code démarre puis s'arrête ou devient défectueux.
Vérifiez docker logs collaboral'espace disque et la mémoire disponibles, les permissions du conteneur et la configuration requise pour l'image déployée. Évitez de copier des options telles que le mode privilégié à partir d'exemples non pertinents, sauf si les instructions officielles actuelles de votre environnement le préconisent.
Mises à jour et maintenance opérationnelle
Maintenez l'image du conteneur à jour pour des raisons de sécurité et de compatibilité, mais planifiez et testez les mises à niveau au lieu de déployer une nouvelle image non vérifiée pendant les heures de travail. Notez la version utilisée, consultez les notes de version pertinentes et conservez une procédure de restauration. Revoyez la configuration du proxy après toute modification importante de Collabora ou Nextcloud, car les exigences relatives aux points de terminaison et aux WebSockets peuvent évoluer. Surveillez également la mémoire, le processeur, le stockage et les journaux du conteneur de l'hôte à mesure que le nombre d'éditeurs actifs augmente.
Pour l'équipe hypothétique, l'installation est prête à être utilisée de façon limitée uniquement après que le point de terminaison de découverte a répondu, que Nextcloud a confirmé la connexion, que le document d'exemple s'est ouvert dans un navigateur et que les modifications enregistrées sont restées intactes après réouverture. Si l'une de ces vérifications échoue, il convient de résoudre le problème à cet endroit avant d'inviter les utilisateurs à se servir du service.
Références officielles
Documentation révisée le 6 octobre 2026. Le manuel stable de Nextcloud était étiqueté version 35 lors de la vérification ; le guide Docker lié est la version 28, utilisez-le donc comme exemple d'installation et vérifiez la syntaxe du proxy par rapport au guide Collabora et aux versions que vous utilisez réellement.