Resolução de problemas no Windows. ONLYOFFICE Docs

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

Se você estiver enfrentando um problema que não está coberto 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

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

A:Devido à característica operacional, o ONLYOFFICE Docs salva um documento somente 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

Esta possibilidade está disponível a partir da versão 4.2 do ONLYOFFICE Docs

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

Desconectar os usuários pode demorar (até 5 minutos).

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

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

Memória insuficiente (recomenda-se pelo menos 4 GB de RAM).
A porta 80 já está em uso por outro aplicativo. Pare 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.

Q:A autenticação JWT falha após integrar o ONLYOFFICE Docs com minha plataforma. Como posso corrigir isso?

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

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

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

Espaços à frente ou atrás no valor do segredo.
Uso do segredo aleatório padrão em vez de definir um personalizado.

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

A:Verifique o log do conversor para erros:

%ProgramFiles%\ONLYOFFICE\DocumentServer\Log\

Causas comuns incluem espaço em disco insuficiente e fontes ausentes.

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

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

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

Problemas na Enterprise e Developer Edition

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

A: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 antigo arquivo license.lic no diretório de dados e reinicie o ONLYOFFICE Docs.

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

A: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 de runtime.json e reinicie — um novo código de inicialização será gerado.