Esecuzione di ONLYOFFICE Apps in Docker

Introduzione

ONLYOFFICE Apps è un hub di documenti in cui puoi collegare utenti e documenti in un unico posto per favorire la collaborazione.

Questa guida ti mostrerà come eseguire ONLYOFFICE Apps sulla tua macchina utilizzando Docker.

note

Questa guida distribuisce una build di sviluppo/test di ONLYOFFICE Apps e non è destinata all'uso in produzione. Questa build funziona solo tramite HTTP semplice, viene fornita senza servizi di identità/OAuth ed esegue un set ridotto di funzionalità. Per le distribuzioni in produzione, utilizza la versione di produzione di ONLYOFFICE Apps.

Panoramica

A differenza della distribuzione standard con più container, questa build esegue tutti i servizi di ONLYOFFICE Apps all'interno di un unico container anziché in container separati per ogni servizio. Lo stack completo è composto dai seguenti container:

Container	Ruolo
onlyoffice-apps	Tutti i servizi di ONLYOFFICE Apps (consolidati)
onlyoffice-document-server	Document Server (editor)
onlyoffice-mysql-server	Database MySQL
onlyoffice-opensearch	OpenSearch

Rispetto alla distribuzione standard con più container, questa build presenta le seguenti differenze:

• Tutti i servizi di ONLYOFFICE Apps sono consolidati in un unico container.
• Ricerca semplificata.
• Nessuna generazione di miniature.
• Solo HTTP, nessun supporto TLS/HTTPS predefinito.
• Nessun servizio di identità/OAuth.

Requisiti di sistema

• CPU: almeno 6 core (consigliati 8 core)
• RAM: almeno 12 GB (consigliati 16 GB)
• HDD: almeno 40 GB di spazio libero
• SO: distribuzione Linux amd64 con versione del kernel 3.10 o successiva
• Requisiti aggiuntivi:
  • almeno 6 GB di swap
  • Docker Engine con il plugin Compose (comando docker compose)

Clonazione del repository

Clona il repository DocSpace-buildtools utilizzando il seguente comando:

git clone https://github.com/ONLYOFFICE/DocSpace-buildtools.git

Una volta clonato il repository, spostati nella directory Compose:

cd DocSpace-buildtools/install/docker/community

Esecuzione delle immagini predefinite

Per avviare ONLYOFFICE Apps in modalità detached utilizzando le immagini predefinite, esegui il seguente comando:

docker compose up -d

Una volta avviati i container, apri un browser e inserisci http://localhost o http://your-ip-address nella barra degli indirizzi per accedere a ONLYOFFICE Apps.

Creazione delle immagini dal codice sorgente

Utilizza questa opzione se desideri creare personalmente le immagini di ONLYOFFICE Apps o testare le modifiche di un branch specifico.

Crea e avvia i container utilizzando il seguente comando:

docker compose up -d --build

note

Per impostazione predefinita, le immagini vengono create dal branch master. Per creare da un altro branch, specifica l'argomento di build GIT_BRANCH: GIT_BRANCH=your-branch docker compose up -d --build.

Una volta completata la build e avviati i container, apri http://localhost o http://your-ip-address nel tuo browser per accedere a ONLYOFFICE Apps.

Esecuzione con SSL

ONLYOFFICE Apps supporta sia i certificati Let's Encrypt sia i certificati SSL personalizzati.

Utilizzo di un certificato Let's Encrypt

Per eseguire ONLYOFFICE Apps con un certificato Let's Encrypt, esegui il seguente comando specificando il tuo dominio, la tua email e l'URL dello spazio di lavoro:

SSL_MODE="letsencrypt" \
SSL_DOMAIN="example.com,portal.example.com,api.example.com" \
SSL_EMAIL="admin@example.com" \
APP_URL_PORTAL="https://example.com/" \
docker compose \
  -f docker-compose.yml \
  -f ssl.yml \
  up -d

Vengono utilizzati i seguenti parametri:

• SSL_MODE – la modalità del certificato SSL.
• SSL_DOMAIN – uno o più domini separati da virgole.
• SSL_EMAIL – l'indirizzo email utilizzato per la registrazione a Let's Encrypt.
• APP_URL_PORTAL – l'URL HTTPS pubblico del tuo spazio di lavoro.

Utilizzo di un certificato personalizzato o di una CA privata

Se utilizzi un certificato autofirmato o un certificato emesso da un'autorità di certificazione (CA) privata, anche ONLYOFFICE Document Server deve considerare attendibile questo certificato.

Rimuovi il commento dal seguente volume nel file docker-compose.yml:

services:
   onlyoffice-document-server:
     volumes:
       - ${CERTIFICATE_PATH}:/var/www/onlyoffice/Data/certs/extra-ca-certs.pem

Quindi specifica il percorso del certificato sull'host ed esegui il seguente comando:

SSL_MODE="custom" \
SSL_DOMAIN="example.com" \
SSL_CERT_PATH="/etc/nginx/certs/fullchain.crt" \
SSL_KEY_PATH="/etc/nginx/certs/private.key" \
CERTIFICATE_PATH="./config/nginx/certs/fullchain.crt" \
APP_URL_PORTAL="https://example.com/" \
docker compose \
  -f docker-compose.yml \
  -f ssl.yml \
  up -d

note

CERTIFICATE_PATH deve puntare al file del certificato sull'host Docker, non al percorso all'interno del container. Questa opzione è in genere necessaria solo per i certificati autofirmati o emessi da una CA privata. I certificati emessi da CA pubbliche (ad esempio Let's Encrypt, DigiCert o GoDaddy) di solito non richiedono questa configurazione aggiuntiva.

Vengono utilizzati i seguenti parametri:

• SSL_MODE – la modalità del certificato SSL (custom).
• SSL_DOMAIN – il nome di dominio dello spazio di lavoro.
• SSL_CERT_PATH – il percorso del certificato SSL.
• SSL_KEY_PATH – il percorso della chiave privata.
• APP_URL_PORTAL – l'URL HTTPS pubblico del tuo spazio di lavoro.

note

Per impostazione predefinita, la configurazione ssl.yml monta la directory locale ./config/nginx/certs in /etc/nginx/certs all'interno del container.

Una volta avviati i container, apri l'indirizzo del tuo spazio di lavoro, ad esempio https://example.com/, in un browser per accedere a ONLYOFFICE Apps.