Vai al contenuto principale

Collabora Online

Distribuzione e configurazione di Collabora Online come servizio Docker Compose opzionale.

📋 Prerequisiti​

⚠️ Per attivare l'integrazione con Collabora Online, assicurarsi innanzitutto che la configurazione del reverse proxy sia attiva.

⚡ Attivazione​

Seguire i passaggi riportati di seguito per attivare Collabora Online con il reverse proxy Nginx.

Configurazione di Nginx​

In ./config/nginx/nginx.conf, rimuovere il commento dall'inclusione di Collabora Online alla fine del file:

include collabora.conf;

In ./config/nginx/docker-compose.nginx.yaml, verificare che la configurazione di Collabora Online sia montata nel container Nginx:

services:
  nginx:
    volumes:
      - ./collabora.conf:/etc/nginx/collabora.conf

Configurazione di Docker Compose​

In docker-compose.yaml, rimuovere il commento dai file Docker Compose necessari:

include:
  - ./config/nginx/docker-compose.nginx.yaml
  - ./config/collabora/docker-compose.collabora.yaml

Se si utilizza HTTPS tramite il reverse proxy Nginx, modificare il file ./config/collabora/docker-compose.collabora.yaml e impostare l'opzione ssl.termination su true:

services:
  collabora:
    environment:
      extra_params: >-
        --o:ssl.termination=true

Configurazione di Sync-in​

In environment.yaml, attivare l'integrazione con Collabora Online:

server:
  # Facoltativo per ora; obbligatorio nella prossima versione principale
  publicUrl: 'https://sync-in.domain.com'
applications:
  files:
    editors:
      collabora:
        # Attiva l'integrazione
        enabled: true
informazioni

Eseguire docker compose up -d && docker compose restart nginx sync_in per applicare le modifiche.

🌐 Accesso​

Sync-in e Collabora Online vengono eseguiti in container Docker e comunicano tramite il reverse proxy Nginx.

Se si configura server.publicUrl, impostarlo sull'indirizzo esatto utilizzato per accedere a Sync-in, includendo l'eventuale porta non standard. Ad esempio, con un mapping di porta Nginx 8060:80, utilizzare http://your-server:8060. Questo URL deve essere raggiungibile sia dal browser sia dal container Collabora Online. Se omesso, Sync-in utilizza come soluzione di compatibilità l'origine della richiesta inoltrata da Nginx. Per motivi di sicurezza, server.publicUrl diventerà obbligatorio nella prossima versione principale: gli endpoint degli editor verranno così creati da un'origine attendibile controllata dall'amministratore anziché dalle intestazioni della richiesta.

avvertenza

Accedere a Sync-in tramite http://localhost o http://127.0.0.1 impedirà il corretto funzionamento di Collabora Online: i documenti non potranno essere visualizzati né modificati.