Esempio ipotetico: Mina modifica un piano di progetto in ONLYOFFICE da una cartella di Nextcloud. L'editor si apre e accetta le modifiche, ma in seguito Nextcloud segnala "Impossibile salvare il documento". Questo esempio è puramente illustrativo e non rappresenta un test reale. In questa situazione, è consigliabile mantenere aperto l'editor, conservare una copia locale del lavoro non salvato e verificare se ONLYOFFICE Docs riesce a raggiungere direttamente la funzione di callback di salvataggio di Nextcloud. Successivamente, utilizzare i log per distinguere un errore di instradamento della callback da un problema di archiviazione o di autorizzazioni di Nextcloud.
Non chiudere o aggiornare l'editor finché contiene ancora modifiche non salvate da Nextcloud. Se l'editor rimane reattivo, utilizza l'opzione "Scarica come" per conservare una copia di ripristino locale. Annota l'ora e il nome del file relativi al salvataggio non riuscito, in modo che l'amministratore possa confrontarli con i log.
Prova a salvare un piccolo file DOCX in una cartella standard di Nextcloud. Se il salvataggio va a buon fine, concentrati sui permessi del file originale, sullo stato di condivisione, sullo spazio di archiviazione o sul formato. Se tutti i file non vengono salvati correttamente, inizia a controllare la route di callback condivisa e lo stato di salute del server.
ONLYOFFICE Docs invia una richiesta POST all'URL di callback fornito dal connettore Nextcloud. Nextcloud recupera quindi il file modificato e aggiorna la versione memorizzata. L'editor può aprirsi normalmente, ma il salvataggio potrebbe non riuscire se Document Server non è in grado di inviare la risposta a Nextcloud.
Riproduci il problema con un file di prova, quindi confronta i log di DocService e Nextcloud in quel momento. Su Linux, i log di ONLYOFFICE si trovano in /var/log/onlyoffice/documentserver/; in Docker, controlla i log del container o la directory dei log montata. Il file di log predefinito di Nextcloud si trova nextcloud.lognella sua directory dei dati, a meno che log_typeo logfilenon la modifichino.
In Nextcloud, apri Impostazioni > Amministrazione > ONLYOFFICE . Verifica che l'indirizzo pubblico di ONLYOFFICE Docs sia l'URL che i browser degli utenti dovrebbero caricare. Se i due server non riescono a comunicare tra loro tramite i rispettivi indirizzi pubblici, imposta i campi interni documentati: Indirizzo di ONLYOFFICE Docs per le richieste interne dal server e Indirizzo del server per le richieste interne da ONLYOFFICE Docs . Il primo deve funzionare da Nextcloud al server dei documenti; il secondo deve funzionare dal server dei documenti a Nextcloud.
Nella configurazione ipotetica di Mina, la callback utilizza http://cloud.example.come reindirizza a HTTPS. Configura direttamente l'indirizzo HTTPS finale, quindi assicurati che DNS, regole del firewall e attendibilità del certificato consentano a Document Server di raggiungerlo. Il proxy dovrebbe inoltrare la callback a Nextcloud senza reindirizzarne lo schema, il nome host o il percorso. Il nome host di esempio non è valido per installazioni reali.
Il controllo di connessione di ONLYOFFICE può aiutare a verificare gli indirizzi di servizio configurati:
sudo -u www-data php occ onlyoffice:documentserver --checkEseguilo dalla directory di Nextcloud con l'account del server web appropriato. Un controllo positivo non dimostra che la callback POST funzioni. Nemmeno una richiesta HEAD manuale o una pagina del browser sullo stesso hostname costituiscono una prova.
Se la callback raggiunge Nextcloud ma il file non viene ancora aggiornato, controlla il log di Nextcloud per la richiesta corrispondente. Verifica che l'utente disponga dei permessi di modifica, che il mount di archiviazione sia disponibile, che l'account non abbia superato la quota e che il volume dati abbia spazio libero e inode. Se il problema riguarda un file condiviso, verifica se un altro utente o client di sincronizzazione lo sta modificando contemporaneamente, quindi esegui un test con una copia in una cartella privata.
Il blocco transazionale dei file di Nextcloud coordina le operazioni di scrittura; non disabilitarlo come soluzione rapida. Se i log indicano errori di blocco o del database, verificare il backend di blocco e il servizio Redis o Valkey. Non eliminare oc_file_locksrighe o file di blocco, poiché ciò potrebbe interrompere le operazioni di scrittura in corso.
Se un test su una cartella standard funziona ma un file archiviato esternamente non funziona, verifica la disponibilità e la modalità di autenticazione del punto di montaggio. ONLYOFFICE documenta le limitazioni per alcune modalità di archiviazione esterna; evita di modificare le credenziali finché non hai isolato il punto di montaggio.
Dopo aver modificato un'impostazione, apporta una modifica specifica a un piccolo documento di prova, attendi il completamento del salvataggio, quindi chiudilo e riaprilo da Nextcloud. Verifica che la modifica sia stata salvata correttamente e che i log corrispondenti non mostrino reindirizzamenti, errori di connessione o eccezioni di archiviazione.
Se il test ha esito positivo ma l'originale continua a non funzionare, verifica i permessi, il montaggio esterno o le modifiche simultanee. Se tutti i callback falliscono, conserva la copia locale e inoltra il problema fornendo timestamp, stato HTTP, versioni e log anonimizzati. Oscura JWT, cookie, URL firmati e nomi di file personali.
Questi passaggi affrontano le cause comuni di callback, routing e archiviazione di un errore di salvataggio. La soluzione esatta dipende dal primo punto di errore nei log; un controllo di connessione riuscito da solo non può certificare l'intero flusso di lavoro di salvataggio.
Documentazione verificata il 9 ottobre 2026. I campi del connettore e le destinazioni dei log possono variare a seconda della versione dell'app installata e della configurazione di distribuzione.
Abilita la funzione "Revisioni permanenti" per tutti gli utenti in un singolo documento ONLYOFFICE, verifica che le modifiche vengano registrate e comprendi i limiti di questa impostazione.
Verifica se Nginx, la rete Docker o un servizio interno di ONLYOFFICE stanno restituendo un errore 502, quindi controlla il server upstream corretto ed esegui un controllo di integrità.
Diagnostica gli errori di salvataggio di ONLYOFFICE controllando il percorso di callback di Nextcloud, i reindirizzamenti del proxy e i log di archiviazione, quindi verifica che il file modificato sia stato salvato correttamente.
Individua la causa dei crash di memoria di ONLYOFFICE, controlla i limiti di Docker, dimensiona correttamente la RAM del VPS, aggiungi lo swap in modo sicuro e verifica che i documenti si aprano e si salvino.
Distinguete i problemi di download del browser dagli errori di conversione lato server e utilizzate il registro o il controllo di accesso appropriato per far funzionare l'esportazione in PDF.
Abbina il segreto JWT utilizzato da ONLYOFFICE Docs e Nextcloud, applicalo in modo sicuro alle installazioni Docker o Linux e verifica la connessione senza compromettere l'autenticazione.
Installa ONLYOFFICE Workspace Community su Ubuntu 24.04 utilizzando lo script Docker ufficiale, verifica i requisiti del server, salta la configurazione della posta elettronica se necessario e verifica la sicurezza del portale.
Configura i segreti JWT corrispondenti per ONLYOFFICE Docs e il suo connettore, con passaggi sicuri per pacchetti Linux, implementazioni Docker e verifica.
Personalizza l'editor integrato di ONLYOFFICE Docs con il logo e i colori della tua azienda tramite un file di tema personalizzato e la configurazione dell'editor. Consulta i limiti di edizione e i controlli di distribuzione.
Tieni traccia delle modifiche in Writer, conserva un file sorgente ODT modificabile e controlla il file DOCX esportato in Word prima di condividerlo.
