Commencer en 3 étapes

Nous décrivons ici comment installer Collabora Online sur votre serveur et comment l'intégrer dans votre Nextcloud à l'aide de l'image docker conçue par Nextcloud et Collabora.

Conditions requises

Les dépendances suivantes sont nécessaires pour l'installation :

1. Un hébergeur capable de supporter un conteneur Docker
2. Un sous-domaine ou un second domaine sur lequel le serveur Collabora Online peut tourner.
3. Un serveur Apache avec certains modules activés (instructions NGINX dans un article de blog ici)
4. Un certificat SSL valide pour le domaine sur lequel Collabora Online doit fonctionner
5. Un certificat SSL valide pour votre Nextcloud

Note : Ce guide ne couvre PAS les certificats auto-signés. Si vous utilisez un certificat auto-signé, à vous de le faire fonctionner ;-)

1. Installez le serveur Collabora Online

Les étapes suivantes permettent de télécharger le docker Collabora Online. Veillez à remplacer "cloud.nextcloud.com" par l'hôte sur lequel tourne votre propre Nextcloud. Assurez-vous également de compléter tous les points dans l'url avec des doubles barres obliques (\), puisque cette chaîne sera interprétée comme une expression régulière (et votre bash " mange " la première barre oblique inverse.) Si vous voulez utiliser le conteneur docker avec plusieurs Nextcloud, vous devrez plutôt utiliser 'domain=cloud\\.nextcloud\\.com\|second\\.nexcloud\\.com' (Tous les hôtes sont séparés par \|.)

                docker pull collabora/code
                docker run -t -d -p 127.0.0.1:9980:9980 -e 'domain=cloud\\.nextcloud\\.com' --restart always --cap-add MKNOD collabora/code
			

Vous pouvez également sélectionner les dictionnaires que vous souhaitez utiliser :

                docker run -t -d -p 127.0.0.1:9980:9980 -e 'domain=cloud\\.nextcloud\\.com' -e 'dictionaries=de en es ..' --restart always --cap-add MKNOD collabora/code
            

De cette façon, vous n'êtes pas limité à l'allemand, l'anglais, l'italien, le français et l'espagnol.

Cela devrait suffire. Une fois que vous avez terminé, le serveur écoutera sur "localhost:9980". Il ne nous reste plus qu'à configurer le reverse proxy Apache installé localement.

2. Installez le reverse proxy Apache

Sur une version récente d'Ubuntu ou de Debian, vous pouvez le faire en utilisant :

1. apt-get install apache2
2. a2enmod proxy
3. a2enmod proxy_wstunnel
4. a2enmod proxy_http
5. a2enmod ssl

Ensuite, configurez un VirtualHost correctement pour que le trafic soit relayé par proxy. Pour des raisons de sécurité, nous recommandons d'utiliser un sous-domaine tel que office.nextcloud.com au lieu de le faire fonctionner sur le même domaine. Un exemple de configuration peut être trouvé ci-dessous :

				
<VirtualHost *:443>
ServerName office.nextcloud.com:443

# SSL configuration, you may want to take the easy route instead and use Lets Encrypt!
SSLEngine on
SSLCertificateFile /path/to/signed_certificate
SSLCertificateChainFile /path/to/intermediate_certificate
SSLCertificateKeyFile /path/to/private/key
SSLProtocol             all -SSLv2 -SSLv3
SSLCipherSuite ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE-RSA-AES256-SHA256:DHE-RSA-AES256-SHA:ECDHE-ECDSA-DES-CBC3-SHA:ECDHE-RSA-DES-CBC3-SHA:EDH-RSA-DES-CBC3-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:AES256-SHA:DES-CBC3-SHA:!DSS
SSLHonorCipherOrder     on

# Encoded slashes need to be allowed
AllowEncodedSlashes NoDecode

# Container uses a unique non-signed certificate
SSLProxyEngine On
SSLProxyVerify None
SSLProxyCheckPeerCN Off
SSLProxyCheckPeerName Off

# keep the host
ProxyPreserveHost On

# static html, js, images, etc. served from loolwsd
# loleaflet is the client part of LibreOffice Online
ProxyPass           /loleaflet https://127.0.0.1:9980/loleaflet retry=0
ProxyPassReverse    /loleaflet https://127.0.0.1:9980/loleaflet

# WOPI discovery URL
ProxyPass           /hosting/discovery https://127.0.0.1:9980/hosting/discovery retry=0
ProxyPassReverse    /hosting/discovery https://127.0.0.1:9980/hosting/discovery

# Main websocket
ProxyPassMatch "/lool/(.*)/ws$" wss://127.0.0.1:9980/lool/$1/ws nocanon

# Admin Console websocket
ProxyPass   /lool/adminws wss://127.0.0.1:9980/lool/adminws

# Download as, Fullscreen presentation and Image upload operations
ProxyPass           /lool https://127.0.0.1:9980/lool
ProxyPassReverse    /lool https://127.0.0.1:9980/lool

# Endpoint with information about availability of various features
ProxyPass           /hosting/capabilities https://127.0.0.1:9980/hosting/capabilities retry=0
ProxyPassReverse    /hosting/capabilities https://127.0.0.1:9980/hosting/capabilities
</VirtualHost>
			

Après avoir effectué cette configuration, redémarrez votre apache en utilisant /etc/init.d/apache2 restart.

3. Configurez l'application dans Nextcloud

1. Allez dans la section Apps et choisissez "Office & text".
2. Installez "Collabora Online app"
3. Admin -> Collabora Online -> Spécifiez le serveur que vous avez installé précédemment (par exemple "https://office.nextcloud.com")

Félicitations, votre Nextcloud dispose maintenant d'une version intégrée de Collabora Online Office !

---

Mises à jour

De nouvelles versions de cette image docker sont publiées périodiquement avec des mises à jour de sécurité et des fonctionnalités. Nous vous tiendrons bien sûr au courant quand cela se produira ! Voici comment passer à une nouvelle version :

• récupérer une nouvelle image docker :
  docker pull collabora/code
• lister les images docker :
  docker ps
  à partir du résultat, vous pouvez obtenir l'ID du conteneur de votre image docker Collabora Online.
• arrêter et supprimer l'image docker Collabora Online :
  docker stop CONTAINER_ID
docker rm CONTAINER_ID
• démarrere la nouvelle image :
  docker run -t -d -p 127.0.0.1:9980:9980 -e 'domain=cloud\\.nextcloud\\.com' --restart always --cap-add MKNOD collabora/code

Profitez-en bien !

---

Résolution de problèmes

Quelques problèmes courants :

• Problème : Impossible de configurer l'URL dans le panneau d'administration.
  Ceci est très probablement dû au fait que l'application Documents est activée. Désactivez-la et vous pouvez définir l'URL.
• Problème : Erreurs de connexion lors de l'ouverture de documents.
  Vérifiez le journal des erreurs du docker (logs docker ID-de-votre-instance). Si le journal indique quelque chose comme :
  Aucun hôte WOPI acceptable ne correspond à l'hôte cible [VOTRE DOMAINE NEXTCLOUD] dans la configuration.
Hôte WOPI non autorisé. Veuillez réessayer plus tard et informer votre administrateur si le problème persiste.
  Il se peut que vous ayez démarré le conteneur du docker avec la mauvaise URL. Vérifiez bien que vous l'avez démarré avec l'URL de votre serveur Nextcloud, et non avec le serveur sur lequel Collabora Online fonctionne.
• Problème : Erreurs liées aux autorisations de connexion.
  Il est possible que votre pare-feu bloque les connexions. Essayez de démarrer le docker après avoir démarré le pare-feu, il apportera des modifications à vos iptables pour permettre à Collabora Online de fonctionner.
• Problème : Nous sommes désolés, erreur de connexion imprévue. Veuillez réessayer plus tard.
  L'application Collabora Online ne fonctionne pas pour le moment si vous ne l'activez que pour certains groupes. Retirez le filtre de groupe dans la section App.
• Problème : Collabora Online ne parvient pas à gérer mes 100 utilisateurs.
  Cette image docker est conçue pour un usage domestique avec un nombre limité d'utilisateurs et de documents ouverts. Si vous avez besoin d'une solution plus étendue, envisagez un abonnement de support pour une expérience de bureautique en ligne fiable et adaptée aux entreprises.
• Problème : Collabora Online ne fonctionne pas avec la fonction de chiffrement.
  Cette fonction n'est actuellement pas pris en charge.

Vous trouverez d'autres questions et réponses dans le fil de discussion sur les forums. Vous pouvez poster un nouveau sujet dans la catégorie Collabora si vous n'y trouvez pas de réponse à vos questions !