Come installare ONLYOFFICE Docs Enterprise con Docker Compose

ONLYOFFICE Docs Enterprise può essere eseguito come distribuzione Docker Compose utilizzando il Docker-DocumentServerrepository ufficiale. Il punto chiave è iniziare con il file Compose specifico per Enterprise, quindi impostare l'archiviazione persistente, un segreto JWT stabile e il file di licenza prima di considerare il server pronto per la produzione. Questo installa Docs, il servizio di modifica online; non installa il portale ONLYOFFICE Workspace completo.

I passaggi seguenti sono stati verificati confrontandoli con la guida Docker Enterprise di ONLYOFFICE e con il repository ufficiale il 6 ottobre 2026. Il ramo predefinito del repository può cambiare, quindi per un server a lungo termine, è consigliabile scaricare una release o un tag approvato e conservare tale versione insieme alle note di implementazione.

Elenco rapido dei requisiti

La guida Enterprise di ONLYOFFICE elenca i requisiti di hosting. Le esigenze di capacità aumentano con il numero di utenti simultanei, la complessità dei documenti e le integrazioni, quindi è consigliabile considerare i requisiti di base del fornitore come un punto di partenza piuttosto che come una garanzia di dimensionamento.

1. Installa Docker Compose e scarica i file di distribuzione ufficiali

Se Docker Engine è già installato su Debian o Ubuntu dal repository dei pacchetti di Docker, installa il plugin Compose con:

sudo apt-get update
sudo apt-get install docker-compose-plugin
docker compose version

Per altre distribuzioni Linux, seguire le istruzioni di installazione di Docker per tale distribuzione. Il plugin attuale utilizza il comando con spazi docker compose; il vecchio comando standalone docker-composeè mantenuto per compatibilità con le versioni precedenti e non è il percorso utilizzato dal comando Enterprise di ONLYOFFICE mostrato qui.

Clona il repository di ONLYOFFICE e accedi alla sua directory. Se la tua politica di gestione delle modifiche richiede una versione fissa, controlla il tag di rilascio approvato dopo la clonazione e prima di modificare i file:

git clone https://github.com/ONLYOFFICE/Docker-DocumentServer.git
cd Docker-DocumentServer
# Optional: select the approved release tag for your deployment
git checkout <release-tag>

Conferma che la revisione estratta contenga docker-compose.enterprise.yml. Non sostituire docker-compose.yml, che è il file Compose della Community Edition in questo repository.

2. Preparare i segreti, l'archiviazione dei dati e la licenza

Prima del primo avvio, ispeziona il file docker-compose.enterprise.yml. Nel file ufficiale corrente, l'applicazione e il servizio PostgreSQL utilizzano una password di esempio per il database e le righe JWT sono commentate. Sostituisci la password di esempio con un valore sicuro sia nell'impostazione dell'applicazione DB_PWDche in quella di PostgreSQL POSTGRES_PASSWORD. Devono corrispondere. Decommenta o aggiungi JWT_ENABLED=truee imposta un JWT univoco e lungo JWT_SECRET. Mantieni lo stesso JWT segreto per l'applicazione o il connettore che si integrerà con la documentazione.

Genera segreti anziché riutilizzare una password di accesso. Ad esempio, esegui openssl rand -hex 32e posiziona l'output in un file di ambiente privato, quindi fai riferimento ad esso dal file Compose come ${JWT_SECRET}e ${DB_PASSWORD}. Proteggi il file di ambiente dagli altri utenti dell'host e non caricarlo su Git. La configurazione chiave è concettualmente:

# In a private .env file beside the Compose file
JWT_SECRET=replace_with_a_long_random_value
DB_PASSWORD=replace_with_a_different_long_random_value

Aggiorna entrambe le voci della password del database in modo che facciano riferimento a ${DB_PASSWORD}e imposta le voci dell'ambiente del server su JWT_ENABLED=truee JWT_SECRET=${JWT_SECRET}. Il file Compose upstream definisce già i suoi servizi interni PostgreSQL, RabbitMQ e Redis; mantieni insieme i nomi dei servizi correlati e le dipendenze se lo personalizzi.

Rendi persistenti i dati importanti dell'applicazione sull'host. Nel onlyoffice-documentserverservizio, sostituisci le voci di volume anonimo per /var/www/onlyoffice/Datae /var/log/onlyofficecon mount di tipo bind come:

volumes:
  - ./data:/var/www/onlyoffice/Data
  - ./logs:/var/log/onlyoffice

Mantieni le altre voci di volume e il volume PostgreSQL denominato definito nel file ufficiale, a meno che tu non abbia un valido motivo per modificarli. Crea le directory host e copia la licenza ricevuta nella directory dei dati montata:

mkdir -p data logs
cp /secure/path/license.lic data/license.lic

Assicurati che il container possa leggere la licenza e scrivere nei percorsi dati e log. I requisiti di proprietà dei file possono dipendere dall'immagine e dall'host; se riscontri errori di autorizzazione, controlla l'utente del container in esecuzione e le istruzioni ufficiali del repository anziché applicare autorizzazioni generiche. Mantieni la licenza e i segreti al di fuori delle directory web pubbliche e dei sistemi di controllo versione.

3. Convalidare e avviare i servizi aziendali

Dalla directory del repository, convalida la configurazione di Compose, quindi avvia lo stack Enterprise:

docker compose -f docker-compose.enterprise.yml config
docker compose -f docker-compose.enterprise.yml up -d

Il primo comando verifica che Compose sia in grado di analizzare il file e risolvere le sue variabili. Può stampare i segreti risolti, quindi eseguilo in un terminale privato e non incollare il suo output nei log pubblici o nei thread di supporto. Il secondo comando crea o avvia i servizi descritti nel file Enterprise. La definizione ufficiale include il Document Server e le sue dipendenze PostgreSQL, RabbitMQ e Redis.

Verifica lo stato del servizio e i messaggi recenti:

docker compose -f docker-compose.enterprise.yml ps
docker compose -f docker-compose.enterprise.yml logs --tail=100 onlyoffice-documentserver

Cerca container che rimangono in uno stato di riavvio o non integro, errori di autenticazione del database, messaggi di licenza mancanti o errori di autorizzazione. Un servizio contrassegnato come "Attivo" è una prova utile che il relativo processo container è in esecuzione; tuttavia, non è sufficiente a dimostrare che la modifica tramite browser o un'integrazione esterna funzionino correttamente.

4. Metti il ​​servizio dietro HTTPS e limita l'accesso

Per una distribuzione in produzione, punta un nome DNS, ad esempio, docs.example.comal server e fornisci HTTPS utilizzando il metodo di certificato che utilizzi: un proxy inverso affidabile o la configurazione del certificato documentata da ONLYOFFICE. Aggiorna il nome host di esempio nei comandi e nelle impostazioni di integrazione con il tuo nome. Non esporre un endpoint dell'editor HTTP semplice a Internet pubblico per l'uso di routine.

Il file Compose ufficiale di Enterprise pubblica le porte 80 e 443 per il Document Server. Il suo database, Redis e i servizi RabbitMQ sono dipendenze interne e non devono essere esposti alla rete pubblica. Verificare il firewall e qualsiasi gruppo di sicurezza cloud in modo che solo il traffico in entrata necessario raggiunga l'host. Se un altro reverse proxy possiede già le porte 80 e 443, modificare la mappatura delle porte di Compose in modo che utilizzi una porta specifica dell'host o una porta non utilizzata e configurare il proxy per inoltrare le richieste a tale endpoint locale; il proxy deve supportare il traffico WebSocket utilizzato per la modifica dei documenti.

HTTPS e JWT proteggono cose diverse. HTTPS crittografa il traffico tra client e server. JWT convalida le richieste scambiate tra Docs e la piattaforma connessa. Mantieni JWT abilitato e configura esattamente lo stesso segreto nel connettore o nella piattaforma. Non disattivare JWT solo per superare un test di integrazione; correggi invece il segreto, l'intestazione o l'URL non corrispondenti.

5. Verifica il servizio, quindi testa un'integrazione

Il file Compose ufficiale definisce un controllo di integrità http://localhost:8000/info/info.jsonall'interno del contenitore Document Server. Verifica che il servizio sia integro con docker compose ... ps. Puoi anche utilizzare il browser per aprire l'hostname HTTPS pubblico. Una pagina di benvenuto di Docs in esecuzione indica che il servizio web risponde, ma non verifica i callback dei documenti dalla tua piattaforma di archiviazione.

Per completare il controllo, connettiti a una piattaforma compatibile utilizzando l'URL pubblico di Docs e lo stesso segreto JWT. Apri un file DOCX di prova, apporta una piccola modifica, salvalo e riaprilo dalla piattaforma. Questo verifica che la piattaforma possa raggiungere Docs e che Docs possa restituire le modifiche salvate al servizio di archiviazione. Se la pagina si carica ma non si apre l'editor, controlla la console del browser, la configurazione del proxy WebSocket, l'accordo JWT e i log del server. Utilizza un documento di prova temporaneo e non inserire materiale sensibile durante la configurazione iniziale.

Note operative e di risoluzione dei problemi

• Licenza non rilevata: verificare che license.licsia effettivamente montata nella directory host in /var/www/onlyoffice/Data, quindi controllare i log del container.
• Errori JWT: confronta il segreto del server e del connettore, l'intestazione e l'URL. Mantieni il segreto stabile anche dopo i riavvii.
• Problemi all'avvio del database: verificare che la password del database corrisponda sia nell'ambiente PostgreSQL che in quello del server dei documenti.
• I dati scompaiono dopo la ricreazione: verificare che il file Enterprise Compose utilizzi ancora il mount di bind per i dati e mantenga il volume PostgreSQL denominato. Eseguire un backup di entrambi prima degli aggiornamenti.
• L'editor si apre ma non riesce a salvare: verificare che l'URL di callback della piattaforma sia raggiungibile dal contenitore Docs e che il proxy gestisca le connessioni WebSocket.

Utilizza il percorso di aggiornamento specifico per Enterprise e consulta le note di rilascio prima di modificare le versioni dell'immagine. Evita questa docker compose down -vopzione a meno che tu non intenda rimuovere i volumi gestiti da Compose; tale opzione può eliminare il volume dati PostgreSQL denominato. Esegui il backup della directory dei dati, dei log (se necessario) e del database prima di un aggiornamento.

Riferimenti ufficiali

Per dettagli specifici sulla versione, consultare la guida all'installazione di Docker Enterprise di ONLYOFFICE , le relative istruzioni per l'attivazione della licenza e il file Compose ufficiale di Enterprise . Il file README del repository documenta il comando Compose e i parametri del container. La guida all'installazione del plugin Compose di Docker riguarda l'installazione su Linux; se Docker non è installato, seguire le istruzioni di Docker Engine per la propria distribuzione.