Risoluzione dei problemi per ONLYOFFICE Docs su Linux

Prima di contattare il supporto: raccolta di informazioni diagnostiche

Se stai riscontrando un problema non trattato di seguito, raccogli le seguenti informazioni prima di contattare il supporto di ONLYOFFICE:

Directory dei log: /var/log/onlyoffice/documentserver/
Versione del pacchetto: dpkg -l | grep onlyoffice (Debian/Ubuntu) o rpm -qa | grep onlyoffice (CentOS)
Versione del sistema operativo: cat /etc/os-release

Problemi di compilazione

D:Ho clonato il codice, ma trovo solo cartelle vuote, non c'è codice sorgente.

R:Il repository include submoduli. Si consiglia di clonare il repository eseguendo il seguente comando:

git clone --recursive https://github.com/ONLYOFFICE/DocumentServer.git

Nel caso tu abbia clonato il repository utilizzando il comando:

git clone https://github.com/ONLYOFFICE/DocumentServer.git

puoi aggiornare i submoduli nel seguente modo:

Vai nella directory DocumentServer:
```
cd DocumentServer
```
Esegui il seguente comando:
```
git submodule update --init --recursive
```

Problemi di utilizzo

D:Si è verificata una perdita di dati quando ho arrestato ONLYOFFICE Docs. Come posso evitare la perdita di dati?

R:A causa della caratteristica operativa, 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 hai bisogno di 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 documentserver-prepare4shutdown.sh

L'esecuzione dello script può richiedere molto tempo (fino a 5 minuti) poiché attende che tutti gli utenti si disconnettano.

D: Ho aggiunto un tema di interfaccia personalizzato 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?

R: Segui i passaggi per resettare la cache:

Trova i file /etc/nginx/includes/ds-docservice.conf e /etc/nginx/includes/ds-spellchecker.conf. Deve esserci il valore di data e ora di build. Cambia questi valori con altri (qualsiasi valore andrà bene, ma l'importante è che sia lo stesso in tutti i posti), e riavvia NGINX:

sudo service nginx reload

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

D:I servizi di ONLYOFFICE Docs non si avviano. Cosa devo fare?

R:Controlla lo stato dei servizi e verifica eventuali errori:

sudo systemctl status ds-docservice sudo systemctl status ds-converter

Se uno dei servizi si è fermato, prova a riavviarlo:

sudo systemctl restart ds-docservice

Cause comuni includono:

Memoria insufficiente (si raccomandano almeno 4 GB di RAM).
La porta 80 è già in uso da un'altra applicazione. Identifica il processo in conflitto con sudo ss -tlnp | grep :80 e fermalo, o riconfigura ONLYOFFICE Docs per utilizzare una porta diversa.
Controlla i log per messaggi di errore più specifici: /var/log/onlyoffice/documentserver/

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

R: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 valore predefinito è "Authorization"). Per controllare il tuo segreto attuale, leggi direttamente il file di configurazione:

cat /etc/onlyoffice/documentserver/local.json

Cerca il valore in services.CoAuthoring.secret.session.string. Errori comuni:

Spazi iniziali o finali nel valore del segreto.
Utilizzare il segreto casuale predefinito invece di impostarne uno personalizzato.

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

R:Controlla il log del convertitore per errori:

cat /var/log/onlyoffice/documentserver/converter/out.log

Cause comuni includono spazio su disco insufficiente e font mancanti.

D:ONLYOFFICE Docs utilizza molta memoria. È normale?

R:L'uso della memoria si adatta al numero di documenti aperti e utenti contemporanei. Per un server con alcune decine di utenti attivi, un uso di 2–4 GB di RAM è normale. Se l'uso della memoria è inaspettatamente alto, controlla documenti bloccati o dimenticati in /var/lib/onlyoffice/documentserver/App_Data/cache/files/forgotten/.

Problemi dell'edizione Enterprise e Developer

D:Vedo un avviso "Licenza scaduta". Cosa devo fare?

R: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.

D:Non riesco ad accedere al Pannello di Amministrazione. Cosa devo fare?

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