Vai al contenuto principale

OnlyOffice

Distribuzione e configurazione di OnlyOffice come servizio Docker Compose opzionale.

📋 Prerequisiti​

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

⚡ Attivazione​

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

Configurazione di Nginx​

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

include onlyoffice.conf;

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

services:
  nginx:
    volumes:
      - ./onlyoffice.conf:/etc/nginx/onlyoffice.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/onlyoffice/docker-compose.onlyoffice.yaml

Configurazione di Sync-in​

In environment.yaml, attivare l'integrazione con OnlyOffice:

server:
  # Facoltativo per ora; obbligatorio nella prossima versione principale
  publicUrl: 'https://sync-in.domain.com'
applications:
  files:
    editors:
      onlyoffice:
        # Attiva l'integrazione
        enabled: true
        # Utilizzare lo stesso segreto definito in docker-compose.yaml
        secret: 'REPLACE_WITH_LONG_RANDOM_ONLYOFFICE_SECRET'

Generare un valore sicuro, quindi verificare che corrisponda a quello definito in ./config/onlyoffice/docker-compose.onlyoffice.yaml:

services:
  onlyoffice:
    environment:
      - 'JWT_SECRET=REPLACE_WITH_LONG_RANDOM_ONLYOFFICE_SECRET'
informazioni

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

🌐 Accesso​

Sync-in e OnlyOffice 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 OnlyOffice. 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 OnlyOffice: i documenti non potranno essere visualizzati né modificati.