Guia de resolução de problemas no Windows para o ONLYOFFICE Docs

Antes de contatar o suporte: coletando informações de diagnóstico

Se você estiver enfrentando um comportamento inesperado ou erro no sistema que não esteja coberto pelos tópicos abaixo, por favor, reúna as seguintes informações de diagnóstico antes de abrir um chamado com o suporte técnico da ONLYOFFICE:

Diretório de logs do sistema: %ProgramFiles%\ONLYOFFICE\DocumentServer\Log\
Versão exata instalada: Verifique o número da build acessando a seção Programas e Recursos dentro do Painel de Controle do Windows.

Problemas de uso e operação

Pergunta: Ocorreu perda de dados ao interromper o ONLYOFFICE Docs. Como posso evitar que isso aconteça?

Resposta: Devido às suas características arquiteturais de salvamento, o ONLYOFFICE Docs consolida e grava um documento em disco somente após ele ter sido fechado por todos os usuários que o estavam editando simultaneamente. Para evitar qualquer perda de dados, você deve desconectar forçadamente os usuários ativos quando precisar parar o serviço (seja para uma atualização do aplicativo, manutenção programada ou reinicialização do servidor).

Para fazer isso com segurança, execute o seguinte script de encerramento no terminal do servidor Windows onde a suíte está instalada:

%ProgramFiles%\ONLYOFFICE\DocumentServer\bin\documentserver-prepare4shutdown.bat

Nota de Operação: A execução do script de preparação e a desconexão total dos usuários do banco de dados podem demorar um tempo considerável para serem concluídas (até 5 minutos). Recurso disponível a partir da versão 4.2 do ONLYOFFICE Docs.

Pergunta: Os serviços do ONLYOFFICE Docs falham ao iniciar no Windows Server. O que devo fazer?

Resposta: Abra o gerenciador de Serviços do Windows (execute o comando services.msc) e verifique o status de execução dos serviços essenciais ds-docservice e ds-converter. Se algum deles estiver parado, tente iniciá-lo manualmente. As causas mais comuns para essa falha de inicialização incluem:

Memória RAM insuficiente: É altamente recomendado que o servidor possua no mínimo 4 GB de memória RAM dedicada para a aplicação.
Conflito de portas de rede: A porta padrão 80 pode já estar em uso por outro aplicativo web (como o IIS). Interrompa o serviço concorrente ou reinstale o ONLYOFFICE Docs definindo uma nova porta de escuta através do comando:
```
onlyoffice-documentserver.exe /DS_PORT=<NUMERO_DA_PORTA>
```
Erros internos específicos: Inspecione detalhadamente os arquivos de log gerados no diretório %ProgramFiles%\ONLYOFFICE\DocumentServer\Log\ para identificar falhas de permissão ou de banco de dados.

Pergunta: A autenticação e validação do token JWT falha após a integração. Como corrigir isso?

Resposta: Verifique se a chave secreta (secret) do JWT configurada no ONLYOFFICE Docs corresponde de forma exata ao segredo definido nas configurações do conector da sua plataforma de destino (Nextcloud, ownCloud, Moodle, etc.). Certifique-se também de que o nome do cabeçalho HTTP seja idêntico (o padrão de mercado é "Authorization").

Para auditar e verificar o seu segredo configurado no servidor Windows, abra o seguinte arquivo de configuração em um editor de texto:

%ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json

Localize o valor exato contido na string de parâmetro services.CoAuthoring.secret.session.string. Os erros mais comuns nesta etapa são:

Presença de espaços em branco invisíveis (antes ou depois) no valor do segredo copiado.
Manter o uso do segredo aleatório padrão gerado na instalação em vez de definir uma chave personalizada idêntica em ambas as pontas.

Pergunta: A conversão de documentos falha ao tentar abrir arquivos legados (como DOC, XLS ou PPT). O que pode ser?

Resposta: Acesse o diretório de logs do motor de conversão para analisar as mensagens de erro detalhadas:

%ProgramFiles%\ONLYOFFICE\DocumentServer\Log\

Geralmente, as falhas de processamento do conversor ocorrem devido a espaço em disco insuficiente na partição do sistema ou pela ausência de fontes tipográficas essenciais exigidas pelo documento original.

Pergunta: O consumo de memória RAM do ONLYOFFICE Docs está muito alto. Isso é considerado normal?

Resposta: O uso de memória do servidor escala de forma diretamente proporcional ao volume de documentos abertos simultaneamente e à quantidade de usuários ativos na sessão de coedição. Para um ambiente corporativo com algumas dezenas de conexões concorrentes, um consumo entre 2 GB e 4 GB de RAM é perfeitamente normal. Se o consumo estiver anormalmente elevado sem usuários ativos, verifique a existência de instâncias de arquivos presas ou corrompidas na pasta de cache de arquivos esquecidos:

%ProgramData%\ONLYOFFICE\DocumentServer\App_Data\cache\files\forgotten\

Problemas na Enterprise e Developer Edition

Pergunta: O editor exibe uma mensagem de alerta informando "Licença expirada". O que devo fazer?

Resposta: Esse comportamento indica que o período de validade do seu arquivo de registro license.lic chegou ao fim. Para regularizar a sua operação ou renovar o período de uso, entre em contato diretamente com a nossa equipe comercial através do e-mail sales@onlyoffice.com. Assim que receber o novo arquivo atualizado, substitua o arquivo license.lic antigo contido no diretório de dados da aplicação e reinicie os serviços do ONLYOFFICE Docs.

Pergunta: Não consigo obter acesso ao Painel de Administração. Como proceder?

Resposta: Caso você esteja tentando o primeiro acesso e ainda não tenha configurado o ambiente, siga detalhadamente as instruções do nosso guia de configuração do Painel de Administração. Se você já configurou o painel, mas perdeu ou esqueceu a sua senha master de administrador, acesse o servidor, exclua a entrada correspondente ao parâmetro passwordHash de dentro do arquivo runtime.json e reinicie a aplicação — um novo código de autenticação inicial será gerado automaticamente para o seu primeiro login.