Risoluzione dei problemi per ONLYOFFICE Docs su Docker

Q:Voglio installare il server basato su Docker sul mio server locale. Come posso farlo?

A:L'ultima versione del server online basato su Docker è disponibile su Docker hub. Seleziona ONLYOFFICE Docs e segui le istruzioni per l'installazione.

Q:Quale sistema devo avere per installare la soluzione server e utilizzarla con successo?

A:I requisiti di sistema sono:

• CPU: dual core 2 GHz o migliore
• RAM: 4 GB o più
• HDD: almeno 20 GB di spazio libero
• SWAP: almeno 4 GB, ma dipende dal sistema operativo host. Più è meglio
• OS: amd64/arm64 qualsiasi versione supportata dal team Docker

Q:Ho installato una delle versioni del server utilizzando il servizio Docker, ma ho alcuni problemi relativi al server DNS o alla risoluzione del nome. Cosa potrebbe essere sbagliato?

A:Docker specifica i server DNS di Google per impostazione predefinita, e il server tenta di contattarli ogni volta che effettua alcune richieste di rete. Se il tuo ONLYOFFICE Docs non avrà accesso a Internet, ti consigliamo di cambiare l'indirizzo DNS predefinito di Docker con l'indirizzo del tuo server DNS locale. Per farlo, vai al file /etc/default/docker e cambia l'indirizzo IP nella seguente riga con l'indirizzo IP di un server DNS nella tua rete locale:

docker_OPTS="--dns 8.8.8.8"

Per i sistemi operativi basati su RPM come CentOS, il file di configurazione può essere trovato qui: /etc/docker/daemon.json

Q:Gli editor di documenti si aprono e l'interfaccia appare, ma il documento stesso non si carica, mostrando continuamente il progresso di caricamento. Cosa posso fare?

A:Il motivo potrebbe essere che il computer deve essere in grado di indirizzare se stesso utilizzando l'accesso loopback di Internet, cioè deve essere accessibile dall'esterno per se stesso. Per abilitare ciò, modifica le iptables per avere i reindirizzamenti come questo:

iptables -t nat -A PREROUTING -d <public_ip> -j DNAT --to-destination <local_ip> iptables -t nat -A POSTROUTING -s <local_ip> -j SNAT --to-source <public_ip>

Q:L'autenticazione JWT fallisce dopo aver integrato ONLYOFFICE Docs con la mia piattaforma. Come posso risolvere questo problema?

A:Verifica che il segreto JWT configurato in ONLYOFFICE Docs corrisponda esattamente al segreto configurato nelle impostazioni del connettore della tua piattaforma. Controlla anche che il nome dell'intestazione JWT corrisponda (il predefinito è "Authorization"). Errori comuni:

• Spazi iniziali o finali nel valore del segreto.
• Utilizzo del segreto casuale predefinito invece di impostarne uno personalizzato. Controlla il tuo segreto con:

  sudo docker exec <CONTAINER_ID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json services.CoAuthoring.secret.session.string

Q:ONLYOFFICE Docs utilizza molta memoria. È normale?

A:L'uso della memoria cresce con il numero di documenti aperti e utenti contemporanei. Per un server con alcune decine di utenti attivi, un uso di RAM tra 2 e 4 GB è normale. Se l'uso della memoria è insolitamente alto, controlla i documenti bloccati o dimenticati in /var/lib/onlyoffice/documentserver/App_Data/cache/files/forgotten/.

Q:Il container continua a riavviarsi. Cosa dovrei fare?

A:Controlla i log del container per l'errore specifico:

sudo docker logs <CONTAINER_ID>

Cause comuni includono:

• Memoria insufficiente (il container richiede almeno 4 GB di RAM).
• La porta 80 è già in uso da un'altra applicazione. Interrompi l'altra applicazione o cambia la porta di ONLYOFFICE Docs.
• Fallimento nell'inizializzazione del database. Se stai usando un database esterno, verifica che i parametri di connessione siano corretti.

Q:La conversione dei documenti fallisce (ad esempio, aprendo file DOC, XLS o PPT viene mostrato un errore). Cosa posso fare?

A:Controlla il log del convertitore per errori eseguendo il seguente comando:

sudo docker exec <CONTAINER_ID> cat /var/log/onlyoffice/documentserver/converter/out.log

Cause comuni includono spazio su disco insufficiente e font mancanti.

Q:Si è verificata una perdita di dati quando si è arrestato ONLYOFFICE Docs. Come prevenire la perdita di dati?

A:A causa delle caratteristiche operative, ONLYOFFICE Docs salva un documento solo dopo che è stato chiuso da tutti gli utenti che lo hanno modificato. Per evitare la perdita di dati, devi disconnettere forzatamente gli utenti di ONLYOFFICE Docs quando è necessario arrestare ONLYOFFICE Docs in caso di aggiornamento dell'applicazione, riavvio del server, ecc. Per farlo, esegui il seguente script sul server dove è installato ONLYOFFICE Docs:

sudo docker exec <CONTAINER> documentserver-prepare4shutdown.sh

Q:Ho aggiunto un tema personalizzato all'interfaccia o aggiornato i file di lingua del mio editor (corretto alcune traduzioni) ma il server mostra ancora i valori precedenti invece di quelli corretti. Come posso resettare la cache per tutti gli utenti contemporaneamente?

A:Cancella forzatamente la cache eseguendo il seguente comando:

sudo docker exec <CONTAINER_ID> documentserver-flush-cache.sh

La cache dovrebbe essere resettata per tutti gli utenti del server.

Q:Vedo un avviso "Licenza scaduta". Cosa dovrei fare?

A:Il tuo file license.lic è scaduto. Contatta sales@onlyoffice.com per rinnovare la tua licenza. Dopo aver ricevuto il nuovo file, sostituisci il vecchio file license.lic nella directory dei dati e riavvia ONLYOFFICE Docs.

Q:Non riesco ad accedere al Pannello di Amministrazione. Cosa dovrei fare?

A:Se non hai ancora configurato il Pannello di Amministrazione, segui la guida alla configurazione del Pannello di Amministrazione. Se hai dimenticato la tua password di amministratore, elimina l'elemento passwordHash da runtime.json e riavvia — verrà generato un nuovo codice di bootstrap.