Pular para o conteúdo principal

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 problema que não esteja coberto pelos tópicos abaixo, reúna as seguintes informações antes de contatar o suporte da ONLYOFFICE:

Windows:

  • Diretório de logs: %ProgramFiles%\ONLYOFFICE\DocumentServer\Log\
  • Versão instalada: verifique em Programas e Recursos no Painel de Controle

Problemas de uso​

P: Ocorreu perda de dados ao parar o ONLYOFFICE Docs. Como evitar a perda de dados?

R: Devido à característica operacional, o ONLYOFFICE Docs salva um documento apenas após ele ter sido fechado por todos os usuários que o editaram. Para evitar perda de dados, você deve desconectar forçadamente os usuários do ONLYOFFICE Docs quando precisar parar o ONLYOFFICE Docs em casos de atualização do aplicativo, reinicialização do servidor, etc. Para isso, execute o seguinte script no servidor onde o ONLYOFFICE Docs está instalado:

%ProgramFiles%\ONLYOFFICE\DocumentServer\bin\documentserver-prepare4shutdown.bat
observação

A execução do script pode demorar bastante (até 5 minutos).

P: Os serviços do ONLYOFFICE Docs falham ao iniciar. O que devo fazer?

R: Abra o painel de Serviços (services.msc) e verifique o status de ds-docservice e ds-converter. Se algum deles estiver parado, tente iniciá-lo manualmente. As causas mais comuns incluem:

  • Memória insuficiente (recomenda-se no mínimo 4 GB de RAM).

  • A porta 80 já está em uso por outro aplicativo. Interrompa o outro aplicativo ou reinstale o ONLYOFFICE Docs usando uma porta diferente:

    onlyoffice-documentserver.exe /DS_PORT=<PORT_NUMBER>

  • Verifique os logs em %ProgramFiles%\ONLYOFFICE\DocumentServer\Log\ para mensagens de erro mais específicas.

P: A autenticação JWT falha após a integração do ONLYOFFICE Docs com minha plataforma. Como corrigir isso?

R: Verifique se o segredo JWT configurado no ONLYOFFICE Docs corresponde exatamente ao segredo configurado nas configurações do conector da sua plataforma. Verifique também se o nome do cabeçalho JWT é o mesmo (o padrão é "Authorization"). Para verificar o seu segredo atual, abra o seguinte arquivo em um editor de texto:

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

Localize o valor em services.CoAuthoring.secret.session.string. Erros comuns:

  • Espaços no início ou no final do valor do segredo.
  • Usar o segredo aleatório padrão em vez de definir um personalizado.

P: A conversão de documentos falha (por exemplo, ao abrir arquivos DOC, XLS ou PPT é exibido um erro). O que posso fazer?

R: Verifique se há erros no log do conversor:

%ProgramFiles%\ONLYOFFICE\DocumentServer\Log\

As causas mais comuns incluem espaço em disco insuficiente e fontes ausentes.

P: O ONLYOFFICE Docs usa muita memória. Isso é normal?

R: O uso de memória aumenta com o número de documentos abertos e de usuários simultâneos. Para um servidor com algumas dezenas de usuários ativos, um uso de 2–4 GB de RAM é normal. Se o uso de memória estiver inesperadamente alto, verifique se há documentos presos ou esquecidos em:

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

Problemas na Enterprise e Developer Edition​

P: Vejo um aviso de "Licença expirada". O que devo fazer?

R: Seu arquivo license.lic expirou. Entre em contato com sales@onlyoffice.com para renovar sua licença. Após receber o novo arquivo, substitua o arquivo license.lic antigo no diretório de dados e reinicie o ONLYOFFICE Docs.

P: Não consigo acessar o Painel de Administração. O que devo fazer?

R: Se você ainda não configurou o Painel de Administração, siga o guia de configuração do Painel de Administração. Se você esqueceu sua senha de administrador, exclua a entrada passwordHash do arquivo runtime.json e reinicie — um novo código de inicialização será gerado.