Como solucionar problemas do ONLYOFFICE Docs no Linux

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

Se você está enfrentando um problema que não está coberto abaixo, reúna as seguintes informações antes de contatar o suporte da ONLYOFFICE:

Diretório de logs: /var/log/onlyoffice/documentserver/;
Versão do pacote: dpkg -l | grep onlyoffice (Debian/Ubuntu) ou rpm -qa | grep onlyoffice (CentOS);
Versão do sistema operacional: cat /etc/os-release.

Problemas de compilação

Q: Clonei o código, mas encontrei apenas pastas vazias, não há código fonte.

A: O repositório inclui submódulos. Recomenda-se clonar o repositório executando o seguinte comando:

git clone --recursive https://github.com/ONLYOFFICE/DocumentServer.git

Caso você tenha clonado o repositório usando o comando:

git clone https://github.com/ONLYOFFICE/DocumentServer.git

você pode atualizar os submódulos da seguinte maneira:

Vá para o diretório DocumentServer:
```
cd DocumentServer
```
Execute o seguinte comando:
```
git submodule update --init --recursive
```

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 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:

sudo documentserver-prepare4shutdown.sh

A execução do script pode demorar (até 5 minutos) pois ele aguarda todos os usuários se desconectarem.

Q: Adicionei um tema de interface personalizado ou atualizei meus arquivos de idioma do editor (corrigi algumas traduções), mas o servidor ainda mostra os valores anteriores em vez dos corretos. Como posso redefinir o cache para todos os usuários ao mesmo tempo?

A: Por favor, siga os passos para redefinir o cache:

Encontre os arquivos /etc/nginx/includes/ds-docservice.conf e /etc/nginx/includes/ds-spellchecker.conf. Deve haver o valor de data e hora de compilação. Altere esses valores para algum outro (qualquer valor serve, mas o principal é que deve ser o mesmo em todos os lugares), e reinicie o NGINX:

sudo service nginx reload

O cache deve ser redefinido para todos os usuários do servidor.

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

A: Verifique o status dos serviços e revise qualquer saída de erro:

sudo systemctl status ds-docservice
sudo systemctl status ds-converter

Se algum dos serviços parou, tente reiniciá-lo:

sudo systemctl restart ds-docservice

Causas comuns incluem:

Memória insuficiente (recomenda-se pelo menos 4 GB de RAM);
A porta 80 já está em uso por outro aplicativo. Identifique o processo conflitante com sudo ss -tlnp | grep :80 e pare-o, ou reconfigure o ONLYOFFICE Docs para usar uma porta diferente;
Verifique os logs para mensagens de erro mais específicas: /var/log/onlyoffice/documentserver/.

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 de sua plataforma. Também verifique se o nome do cabeçalho JWT corresponde (o padrão é "Authorization"). Para verificar seu segredo atual, leia o arquivo de configuração diretamente:

cat /etc/onlyoffice/documentserver/local.json

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

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

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

A: Verifique o log do conversor para erros:

cat /var/log/onlyoffice/documentserver/converter/out.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 escala 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 travados ou esquecidos em /var/lib/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.