Connecter Nextcloud à CODE Docker : Configuration et compromis

Connectez Nextcloud à Collabora CODE en exécutant l' collabora/codeimage officielle, en limitant son port à celui de l'hôte, en acheminant un sous-domaine HTTPS Office via un proxy inverse compatible WebSocket, puis en configurant cette URL publique dans l'intégration Collabora de Nextcloud. Un délai de dix minutes est envisageable uniquement si Docker, le DNS, TLS et le proxy sont déjà configurés.

Choisissez d'abord le service bureautique adapté. Depuis octobre 2026, Nextcloud distingue Nextcloud Office, basé sur EuroOffice, de Collabora Online. CODE étant l'édition développement de Collabora Online, utilisez l'intégration Collabora et non le connecteur EuroOffice. L'application CODE intégrée est la plus rapide pour un usage personnel, mais Nextcloud la décrit comme plus lente et manquant de fonctionnalités avancées de mise à l'échelle. Un conteneur séparé est plus facile à gérer indépendamment, mais implique davantage de tâches liées aux proxys et aux mises à jour. CODE convient à un usage personnel et aux tests ; choisissez un déploiement Collabora Online avec support technique lorsqu'une entreprise a besoin d'une assistance en production.

Avant de commencer : le parcours en dix minutes

Disposez d'une adresse HTTPS Nextcloud fonctionnelle, d'un nom d'hôte distinct pour votre bureau avec un certificat TLS valide et d'un accès Docker sur le serveur CODE. Configurez le nom d'hôte du bureau pour qu'il pointe vers un proxy inverse capable de rediriger le trafic vers le conteneur. Les navigateurs des utilisateurs et le serveur Nextcloud doivent pouvoir accéder à l'URL du bureau.

Si le DNS ou TLS n'est pas prêt, n'exposez pas le port 9980 publiquement comme raccourci. Configurez-le en boucle locale et terminez d'abord la configuration du proxy.

1. Démarrez le conteneur Docker CODE

Remplacez le nom d'hôte Nextcloud d'exemple par l'origine HTTPS exacte utilisée par les utilisateurs pour se connecter. Ce aliasgroup1paramètre limite les serveurs WOPI (le service de fichiers qui fournit les documents à l'éditeur) autorisés à se connecter. N'utilisez pas de caractère générique pour masquer une connexion ayant échoué.

docker pull collabora/code

docker run -t -d --name collabora-code -p 127.0.0.1:9980:9980 -e 'aliasgroup1=https://cloud.example.com:443' --restart unless-stopped --cap-add MKNOD collabora/code

L'utilisation de cette liaison permet de 127.0.0.1garder le port privé tant qu'un proxy situé sur le même hôte peut y accéder. Si votre proxy se trouve ailleurs, autorisez uniquement ce proxy de confiance à se connecter au port 9980.

Vérifiez que le conteneur a démarré et que son point de terminaison de découverte répond localement :

docker ps --filter name=collabora-code
docker logs --tail=50 collabora-code
curl -kfsS -o /dev/null -w 'Discovery HTTP %{http_code}\n' https://127.0.0.1:9980/hosting/discovery

-kContourne la validation du certificat uniquement pour cette vérification locale auto-signée ; ne corrige pas un certificat public invalide.

2. Placez le nom d'hôte du bureau public derrière un serveur HTTPS.

Servez https://office.example.comles requêtes depuis votre proxy inverse doté d'un certificat valide et acheminez-les vers CODE. La documentation de Collabora relative aux proxys couvre les ressources de l'éditeur, la découverte/les fonctionnalités /cool/et le transfert WebSocket. Sans mise à jour WebSocket, la page peut se charger même si l'éditeur est inaccessible.

Utilisez la configuration existante de votre logiciel proxy. S'il termine la connexion TLS avant le chiffrement, suivez les paramètres TLS du serveur d'arrière-plan ; ne désactivez pas globalement la vérification des certificats.

3. Connectez l'intégration Collabora à Nextcloud

Dans Nextcloud, activez ou installez l'application d'intégration Collabora disponible pour votre version. Ouvrez ensuite la zone d'administration d'Office et saisissez l'URL publique de Collabora https://office.example.com. Dans la documentation actuelle, ce paramètre est intitulé « Serveur Collabora Online » ; la terminologie et les intitulés des applications peuvent varier selon la version, notamment depuis l'ajout de l'option Euro-Office dans Nextcloud. Sélectionnez Collabora Online pour ce serveur CODE. N'indiquez pas l'adresse du conteneur, https://127.0.0.1:9980sauf si Nextcloud est installé sur le même hôte et que cette adresse correspond également au point de terminaison du service configuré. Dans la configuration de proxy recommandée, utilisez le nom d'hôte public d'Office.

Enregistrez les paramètres et exécutez la vérification de connexion intégrée si votre version en propose une. En cas d'échec, comparez l'origine Nextcloud exacte aliasgroup1, assurez-vous que Nextcloud et le navigateur peuvent résoudre et accéder au nom d'hôte du bureau, et consultez les journaux du proxy inverse pour détecter les chemins refusés ou les erreurs WebSocket.

4. Vérifiez les modifications, puis indiquez si le code convient.

Ouvrez un petit document de test dans Nextcloud et vérifiez qu'il s'ouvre dans l'éditeur du navigateur, accepte les modifications, s'enregistre et se rouvre avec les modifications intactes. Effectuez le test depuis un compte utilisateur standard ainsi que depuis un compte administrateur. Un test de découverte fonctionnel confirme à lui seul que CODE répond ; il ne prouve pas que l'autorisation WOPI, les WebSockets proxy et les opérations d'enregistrement des documents fonctionnent correctement.

Pour un serveur personnel ou une petite équipe, CODE Docker isole l'éditeur de la pile PHP de Nextcloud. Vous gérez également le proxy, les redémarrages, les vérifications de compatibilité et les mises à jour d'images. L'application CODE intégrée est plus simple, mais elle partage l'hôte et offre moins de fonctionnalités de mise à l'échelle. Pour une organisation qui dépend d'une utilisation quotidienne, il est préférable d'envisager un service Collabora Online avec support technique plutôt que de considérer CODE comme une solution de production garantie.

Lorsque vous êtes prêt à mettre à jour CODE, récupérez la nouvelle image et recréez le conteneur avec les mêmes options. Consultez les notes de version et testez l'ouverture et l'enregistrement des documents avant de mettre à jour un service essentiel aux utilisateurs ; l' latestétiquette peut être déplacée. Épinglez une version d'image spécifique lorsque les déploiements reproductibles sont importants.

Vérification

La configuration fonctionne correctement lorsque le nom d'hôte du bureau public présente un certificat valide, que la vérification de connexion Nextcloud réussit et qu'un document de test s'ouvre, s'enregistre et se rouvre dans l'éditeur. Si la page d'accueil du bureau se charge mais que l'édition se bloque, vérifiez la redirection WebSocket. Si Nextcloud indique que l'hôte n'est pas autorisé, corrigez-le aliasgroup1pour qu'il corresponde à l'origine Nextcloud réelle. Si CODE répond localement mais pas depuis les navigateurs des utilisateurs, vérifiez le DNS public, le routage du pare-feu et le proxy inverse.

Références : Exemple d’installation Docker de Nextcloud ; Options d’installation de Nextcloud Office ; Configuration de Nextcloud Collabora ; Paramètres du proxy inverse Collabora ; Détails de l’image Docker officielle CODE ; Options d’été de Nextcloud Hub 26 pour Office .