Exemplo hipotético: Mina edita um plano de projeto no ONLYOFFICE a partir de uma pasta do Nextcloud. O editor abre e aceita as alterações, mas o Nextcloud posteriormente reporta a mensagem "O documento não pôde ser salvo". Este exemplo é ilustrativo e não representa um teste real. Nessa situação, mantenha o editor aberto, preserve uma cópia local do trabalho não salvo e verifique se o ONLYOFFICE Docs consegue acessar diretamente a função de retorno de chamada (callback) do Nextcloud. Em seguida, utilize os logs para distinguir uma falha no roteamento da função de retorno de chamada de um problema de armazenamento ou permissão no Nextcloud.
Não feche nem atualize o editor enquanto ele ainda contiver alterações que o Nextcloud não salvou. Use a opção "Baixar como" do editor para manter uma cópia de recuperação local, caso o editor continue respondendo. Anote a hora e o nome do arquivo em que a falha ocorreu para que o administrador possa comparar os registros.
Teste um pequeno arquivo DOCX em uma pasta padrão do Nextcloud. Se ele for salvo, concentre-se nas permissões do arquivo original, no status de compartilhamento, no armazenamento ou no formato. Se todos os arquivos falharem, comece verificando a rota de retorno de chamada compartilhada e a integridade do servidor.
O ONLYOFFICE Docs envia uma solicitação POST para a URL de retorno fornecida pelo conector Nextcloud. O Nextcloud então recupera o arquivo editado e atualiza sua versão armazenada. O editor pode abrir normalmente, mas falhará ao salvar se o Servidor de Documentos não conseguir enviar a resposta para o Nextcloud.
Reproduza o problema com um arquivo de teste e compare os logs do DocService e do Nextcloud nesse momento. No Linux, os logs do ONLYOFFICE ficam em `/var/logs` /var/log/onlyoffice/documentserver/; no Docker, verifique os logs do contêiner ou o diretório de logs montado. O arquivo de log padrão do Nextcloud fica nextcloud.logno diretório de dados, a menos que `docker-compose up` log_typeou ` docker-compose up` logfileo alterem.
No Nextcloud, acesse Configurações > Administração > ONLYOFFICE . Confirme se o endereço público do ONLYOFFICE Docs é a URL que os navegadores dos usuários devem carregar. Se os dois servidores não conseguirem se comunicar por meio de seus endereços públicos, defina os campos internos documentados: Endereço do ONLYOFFICE Docs para solicitações internas do servidor e Endereço do servidor para solicitações internas do ONLYOFFICE Docs . O primeiro deve funcionar do Nextcloud para o Servidor de Documentos; o segundo deve funcionar do Servidor de Documentos para o Nextcloud.
Na configuração hipotética de Mina, o retorno de chamada usa http://cloud.example.come redireciona para HTTPS. Configure o endereço HTTPS final diretamente e, em seguida, certifique-se de que o DNS, as regras de firewall e a confiança no certificado permitam que o Document Server o acesse. O proxy deve passar o retorno de chamada para o Nextcloud sem redirecionar seu esquema, nome do host ou caminho. O nome do host de exemplo não se aplica a instalações reais.
A verificação de conexão do ONLYOFFICE pode ajudar a verificar os endereços de serviço configurados:
sudo -u www-data php occ onlyoffice:documentserver --checkExecute o comando a partir do diretório do Nextcloud, utilizando a conta de servidor web apropriada. Um teste bem-sucedido não comprova que o POST de retorno de chamada funciona. Uma requisição HEAD manual ou uma página do navegador com o mesmo nome de host também não comprovam o funcionamento.
Se a chamada de retorno chegar ao Nextcloud, mas o arquivo ainda não for atualizado, verifique o log do Nextcloud em busca da solicitação correspondente. Confirme se o usuário tem permissão de edição, se o ponto de montagem do armazenamento está disponível, se a conta não excedeu a cota e se o volume de dados tem espaço livre e inodes. Se o problema afetar um arquivo compartilhado, verifique se outro usuário ou cliente de sincronização está alterando-o ao mesmo tempo e, em seguida, teste com uma cópia em uma pasta privada.
O bloqueio de arquivos transacionais do Nextcloud coordena as gravações; não o desative como uma solução rápida. Se os registros apontarem para erros de bloqueio ou de banco de dados, verifique o backend de bloqueio e o serviço Redis ou Valkey. Não exclua oc_file_lockslinhas nem bloqueie arquivos, pois isso pode interromper gravações em andamento.
Se um teste em uma pasta padrão funcionar, mas um arquivo armazenado externamente falhar, investigue a disponibilidade e o modo de autenticação desse ponto de montagem. O ONLYOFFICE documenta as limitações de alguns modos de armazenamento externo; evite alterar as credenciais até isolar o ponto de montagem.
Após alterar uma configuração, faça uma edição distinta em um pequeno documento de teste, aguarde a conclusão da gravação e, em seguida, feche e abra o documento novamente no Nextcloud. Confirme se a edição persiste e se os registros correspondentes não mostram redirecionamento, falha de conexão ou exceção de armazenamento.
Se o teste for bem-sucedido, mas o original ainda falhar, verifique suas permissões, montagem externa ou edições simultâneas. Se todos os retornos de chamada falharem, preserve a cópia local e reporte o problema com o carimbo de data/hora, status HTTP, versões e logs anonimizados. Redija JWTs, cookies, URLs assinadas e nomes de arquivos pessoais.
Estas etapas abordam as causas comuns de erros de salvamento relacionadas a callbacks, roteamento e armazenamento. A solução exata depende do primeiro ponto de falha registrado nos logs; uma verificação de conexão bem-sucedida por si só não garante o funcionamento correto de todo o fluxo de trabalho de salvamento.
Documentação verificada em 9 de outubro de 2026. Os campos do conector e os destinos de log podem variar de acordo com a versão do aplicativo instalado e a configuração de implantação.
Diagnostique falhas ao salvar no ONLYOFFICE verificando a rota de retorno de chamada do Nextcloud, redirecionamentos de proxy e logs de armazenamento e, em seguida, verifique se o arquivo editado persiste.
Identifique a causa das falhas de memória do ONLYOFFICE, verifique os limites do Docker, dimensione corretamente a RAM do VPS, adicione swap com segurança e verifique se os documentos abrem e são salvos corretamente.
Separe os problemas de download do navegador dos erros de conversão do lado do servidor e use o registro correto ou a verificação de acesso para que a exportação para PDF funcione.
Combine o segredo JWT usado pelo ONLYOFFICE Docs e Nextcloud, aplique-o com segurança em instalações Docker ou Linux e verifique a conexão sem enfraquecer a autenticação.
Instale o ONLYOFFICE Workspace Community no Ubuntu 24.04 com o script oficial do Docker, verifique os requisitos do servidor, ignore a instalação do Mail se necessário e verifique o portal com segurança.
Configure segredos JWT correspondentes para o ONLYOFFICE Docs e seu conector, com etapas seguras para pacotes Linux, implantações Docker e verificação.
Personalize o editor ONLYOFFICE Docs com o logotipo da sua empresa e as cores da interface, utilizando um arquivo de tema personalizado e uma configuração específica do editor. Consulte os limites de edição e as verificações de implantação.
Acompanhe as edições no Writer, preserve uma fonte ODT editável e verifique o arquivo DOCX exportado no Word antes de compartilhá-lo.
Siga o procedimento do SUSE SP7 para ativar o modo FIPS, reinicie com segurança, verifique a política ativa e confirme se o seu requisito de conformidade exige módulos validados.
Compare o YaST e o cryptsetup para um novo volume de dados SLES criptografado, escolha LUKS1 ou LUKS2 e verifique o comportamento de desbloqueio e montagem com segurança.
