Comment installer Collabora Online CODE avec Docker et Nextcloud

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.

Laisser un commentaire

Comment cocher une case dans Word : 2 façons de créer une liste de contrôle

Comment cocher une case dans Word : 2 façons de créer une liste de contrôle

Découvrez comment ajouter des puces imprimables ou des cases à cocher interactives dans Word sous Windows, Mac et sur le Web, ainsi que comment remplacer le X par défaut par une coche.

Comment habiller le texte autour des images dans Word : 3 méthodes faciles

Comment habiller le texte autour des images dans Word : 3 méthodes faciles

Dans Word, pour habiller le texte, utilisez les options de mise en page, le format d'image ou le menu contextuel (clic droit), puis choisissez une mise en page d'image et contrôlez son déplacement par rapport au texte.

Comment imprimer une enveloppe : 2 méthodes simples dans Word et Google Docs

Comment imprimer une enveloppe : 2 méthodes simples dans Word et Google Docs

Imprimez une enveloppe dans Word ou utilisez un module complémentaire de publipostage pour Google Docs. Assurez-vous que le format du papier est adapté, insérez correctement l'enveloppe et vérifiez l'alignement avant d'imprimer le lot.

Comment ouvrir l'éditeur VBA dans Excel (Windows et Mac)

Comment ouvrir l'éditeur VBA dans Excel (Windows et Mac)

Ouvrez l'éditeur VBA d'Excel avec Alt+F11 ou accédez à Développeur > Visual Basic. Découvrez comment utiliser Développeur, Excel pour Mac et enregistrer des macros dans un format qui conserve le code VBA.

Comment indenter dans Word : 4 méthodes fiables pour formater les paragraphes

Comment indenter dans Word : 4 méthodes fiables pour formater les paragraphes

Apprenez à ajouter des retraits de première ligne, des retraits suspendus, des retraits à gauche et à droite dans Word à l'aide de la touche Tabulation, de la règle, des paramètres de paragraphe et des commandes de mise en page Web.

5 solutions efficaces pour résoudre le problème d'Outlook bloqué sur « Tentative de connexion »

5 solutions efficaces pour résoudre le problème d'Outlook bloqué sur « Tentative de connexion »

Utilisez cinq vérifications pratiques de connexion Outlook pour déterminer si Exchange, votre réseau, les compléments ou un profil Outlook sont à l'origine du message « Tentative de connexion ».

Comment insérer une feuille de calcul provenant d'un autre classeur dans Excel

Comment insérer une feuille de calcul provenant d'un autre classeur dans Excel

Copiez ou déplacez une feuille de calcul Excel dans un autre classeur, choisissez sa position et vérifiez les formules, les graphiques et la mise en forme après le transfert.

Comment faire pivoter du texte dans Excel avec des préréglages ou un angle personnalisé

Comment faire pivoter du texte dans Excel avec des préréglages ou un angle personnalisé

Utilisez le menu Orientation d'Excel pour incliner le texte des cellules vers le haut, vers le bas ou en diagonale, définir un angle précis et conserver la lisibilité des titres. Inclut les notes pour ordinateur et Web.

Comment utiliser la fonction Somme automatique dans Excel : méthodes rapides pour totaliser les lignes et les colonnes

Comment utiliser la fonction Somme automatique dans Excel : méthodes rapides pour totaliser les lignes et les colonnes

Utilisez la fonction Somme automatique d'Excel pour totaliser une ligne ou une colonne, vérifier la plage suggérée, reporter les totaux adjacents ou insérer la formule SOMME à l'aide d'un raccourci clavier.

Comment créer une nouvelle feuille Excel avec la même mise en forme

Comment créer une nouvelle feuille Excel avec la même mise en forme

Dupliquez une feuille de calcul pour conserver sa mise en forme, sa disposition et ses formules, puis effacez uniquement les données si vous avez besoin d'un modèle vierge. Procédure pour Excel (ordinateur de bureau, Mac et navigateur web).