(wip) HowtoCollaboraCode
This commit is contained in:
parent
c15b6eb1c7
commit
6fe0c65d8b
|
@ -0,0 +1,151 @@
|
|||
---
|
||||
title: How to Collabora Code
|
||||
---
|
||||
|
||||
Collabora Online Development Edition (CODE) est une suite bureautique utilisable dans son navigateur. Le logiciel est basé sur Libre Office Online (lool)
|
||||
|
||||
## Installation
|
||||
|
||||
Collabora propose des paquets via leur dépôt pour installer le logiciel :
|
||||
|
||||
~~~
|
||||
# echo 'deb https://www.collaboraoffice.com/repos/CollaboraOnline/CODE-debian10 ./' >> /etc/apt/sources.list.d/collabora-code.list
|
||||
# apt-key adv --keyserver http://keyserver.ubuntu.com --recv-keys 0C54D189F4BA284D
|
||||
# apt update
|
||||
|
||||
# apt install loolwsd code-brand collaboraofficebasis6.0-fr collaboraoffice6.0-dict-fr
|
||||
~~~
|
||||
|
||||
Pour les versions de Debian antérieures à Debian 10, tout est expliqué sur [leur site](https://www.collaboraoffice.com/code/linux-packages/)
|
||||
|
||||
|
||||
## Configuration
|
||||
|
||||
Fichiers de configuration :
|
||||
|
||||
~~~
|
||||
/etc/loolwsd/
|
||||
├── loolkitconfig.xcu
|
||||
└── loolwsd.xml
|
||||
~~~
|
||||
|
||||
Le fichier de configuration principal se trouve être `/etc/loolwsd/loolwsd.xml`. Juste après installation, le service loolwsd.service ne fonctionnera pas, car la configuration du service écoute en HTTPS par défaut, mais aucun certificat n'est présent.
|
||||
|
||||
Il est plus simple d'utiliser un serveur web comme [Nginx](HowtoNginx) en reverse proxy en amont pour faire la terminaison SSL avant de transférer le trafic à collabora-code localement, sans HTTPS.
|
||||
|
||||
Pour cela, il faut passer changer les paramètres suivants de la section `<ssl>` :
|
||||
|
||||
* `<enable>` : de *true* à **false**
|
||||
* `<termination>` de *false* à **true**
|
||||
|
||||
|
||||
~~~.xml
|
||||
|
||||
(...)
|
||||
<ssl desc="SSL settings">
|
||||
<enable type="bool" desc="Controls whether SSL encryption is enable (do not disable for production deployment). If default is false, must first be compiled with SSL support to enable." default="true">false</enable>
|
||||
<termination desc="Connection via proxy where loolwsd acts as working via https, but actually uses http." type="bool" default="true">true</termination>
|
||||
|
||||
(...)
|
||||
~~~
|
||||
|
||||
|
||||
|
||||
Côté Nginx, on utilisera le vhost proposé par les [développeurs de collabora code](https://www.collaboraoffice.com/code/nginx-reverse-proxy/) :
|
||||
|
||||
~~~
|
||||
server {
|
||||
listen 443 ssl;
|
||||
server_name collabora.example.org;
|
||||
|
||||
ssl_certificate /etc/letsencrypt/live/collabora00.evolix.org/fullchain.pem;
|
||||
ssl_certificate_key /etc/letsencrypt/live/collabora00.evolix.org/privkey.pem;
|
||||
|
||||
root /var/www/collabora00.evolix.org;
|
||||
|
||||
access_log /var/log/nginx/access.collabora00.evolix.org.log;
|
||||
error_log /var/log/nginx/error.collabora00.evolix.org.log;
|
||||
|
||||
|
||||
# static files
|
||||
location ^~ /loleaflet {
|
||||
proxy_pass http://localhost:9980;
|
||||
proxy_set_header Host $http_host;
|
||||
}
|
||||
|
||||
# WOPI discovery URL
|
||||
location ^~ /hosting/discovery {
|
||||
proxy_pass http://localhost:9980;
|
||||
proxy_set_header Host $http_host;
|
||||
}
|
||||
|
||||
# Capabilities
|
||||
location ^~ /hosting/capabilities {
|
||||
proxy_pass http://localhost:9980;
|
||||
proxy_set_header Host $http_host;
|
||||
}
|
||||
|
||||
# main websocket
|
||||
location ~ ^/lool/(.*)/ws$ {
|
||||
proxy_pass http://localhost:9980;
|
||||
proxy_set_header Upgrade $http_upgrade;
|
||||
proxy_set_header Connection "Upgrade";
|
||||
proxy_set_header Host $http_host;
|
||||
proxy_read_timeout 36000s;
|
||||
}
|
||||
|
||||
# download, presentation and image upload
|
||||
location ~ ^/lool {
|
||||
proxy_pass http://localhost:9980;
|
||||
proxy_set_header Host $http_host;
|
||||
}
|
||||
|
||||
# Admin Console websocket
|
||||
location ^~ /lool/adminws {
|
||||
proxy_pass http://localhost:9980;
|
||||
proxy_set_header Upgrade $http_upgrade;
|
||||
proxy_set_header Connection "Upgrade";
|
||||
proxy_set_header Host $http_host;
|
||||
proxy_read_timeout 36000s;
|
||||
}
|
||||
}
|
||||
~~~
|
||||
|
||||
|
||||
## Utilisation
|
||||
|
||||
#### Avec Nextcloud et le connecteur Collabora
|
||||
|
||||
Dans Nextcloud, il y a une application nommée ["Collabora Online"](https://apps.nextcloud.com/apps/richdocuments) permet de faire connecteur entre l'installation Nextcloud et le service Collabora Code fraîchement installé. Cela permettra de consulter et modifier des fichiers directement depuis l'interface de Nextcloud.
|
||||
|
||||
##### Configuration dans Nextcloud
|
||||
|
||||
##### Configuration dans Collabora Code
|
||||
|
||||
Dans le fichier de configuration `/etc/loolwsd/loolwsd.xml`, il faut autoriser l'adresse de l'instance Nextcloud à travailler avec Collabora.
|
||||
|
||||
Dans la sous-section `<wopi>` de la section `<storage>`, il faut rajouter un élément `<host></host>` qui contient une regex d'hôtes à autoriser
|
||||
|
||||
~~~.xml
|
||||
|
||||
(...)
|
||||
|
||||
<storage desc="Backend storage">
|
||||
<wopi desc="Allow/deny wopi storage. Mutually exclusive with webdav." allow="true">
|
||||
<host desc="Regex pattern of hostname to allow or deny." allow="true">nextcloud.example.net</host>
|
||||
<host desc="Regex pattern of hostname to allow or deny." allow="true">sharedcloud[0-9]{4}.example.org</host>
|
||||
|
||||
(...)
|
||||
~~~
|
||||
|
||||
## Monitoring
|
||||
|
||||
### Nagios
|
||||
|
||||
### Munin
|
||||
|
||||
## Plomberie
|
||||
|
||||
## FAQ
|
||||
|
||||
|
Loading…
Reference in New Issue