Risoluzione dei problemi per ONLYOFFICE Docs su Linux

Prima di contattare il supporto: raccolta delle informazioni diagnostiche

Se stai riscontrando un problema non trattato di seguito, raccogli le seguenti informazioni prima di contattare il supporto 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

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

A: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 in cui 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

Q:Si è verificata una perdita di dati quando ho fermato ONLYOFFICE Docs. Come posso 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, è necessario disconnettere forzatamente gli utenti di ONLYOFFICE Docs quando è necessario fermare 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.

Q: Ho aggiunto un tema personalizzato all'interfaccia o aggiornato i file di lingua dell'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: 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 va bene, ma la cosa principale è che deve essere lo stesso in tutti i posti), e riavvia NGINX:

sudo service nginx reload

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

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

A:Controlla lo stato dei servizi e rivedi eventuali messaggi di errore:

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, oppure riconfigura ONLYOFFICE Docs per utilizzare una porta diversa.
Controlla i log per messaggi di errore più specifici: /var/log/onlyoffice/documentserver/

Q:Autenticazione JWT fallisce dopo l'integrazione di 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 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.
Utilizzo del segreto casuale predefinito invece di impostarne uno personalizzato.

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

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

Q:ONLYOFFICE Docs utilizza molta memoria. È normale?

A:L'utilizzo della memoria scala con il numero di documenti aperti e utenti concorrenti. Per un server con poche decine di utenti attivi, un utilizzo di 2–4 GB di RAM è normale. Se l'utilizzo della memoria è insolitamente alto, controlla la presenza di documenti bloccati o dimenticati in /var/lib/onlyoffice/documentserver/App_Data/cache/files/forgotten/.

Problemi con le edizioni Enterprise e Developer

Q:Vedo un avviso "Licenza scaduta". Cosa devo 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 devo fare?

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