Pular para o conteúdo principal

Como solucionar problemas do ONLYOFFICE Docs no Docker

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:

  • Logs do contêiner:

    sudo docker logs <CONTAINER_ID>

  • Versão do contêiner:

    sudo docker inspect --format='{{.Config.Image}}' <CONTAINER_ID>

  • Lista de volumes montados:

    sudo docker inspect --format='{{range .Mounts}}{{.Source}} -> {{.Destination}}{{"\n"}}{{end}}' <CONTAINER_ID>

  • Sistema operacional do host e versão do Docker:

    uname -a && docker --version

Instalação e requisitos do sistema​

P: Quero instalar o servidor baseado em Docker no meu servidor local. Como posso fazer isso?

R: O servidor de escritório online mais recente baseado em Docker está disponível no Docker hub. Por favor, selecione ONLYOFFICE Docs e siga as instruções de instalação.

P: Qual sistema eu preciso ter para instalar a solução de servidor e usá-la com sucesso?

R: Os requisitos do sistema são:

  • CPU: dual core 2 GHz ou melhor
  • RAM: 4 GB ou mais
  • HDD: pelo menos 20 GB de espaço livre
  • SWAP: pelo menos 4 GB, mas depende do sistema operacional do host. Mais é melhor
  • OS: amd64/arm64 qualquer versão suportada pela equipe Docker

Rede e DNS​

P: Instalei uma das versões do servidor usando o serviço Docker, mas estou tendo alguns problemas relacionados ao servidor DNS ou resolução de nome própria. O que pode estar errado?

R: O Docker especifica os servidores DNS do Google por padrão, e o servidor tenta contatá-los toda vez que faz algumas solicitações de rede. Se o seu ONLYOFFICE Docs não tiver acesso à Internet, recomendamos que você altere o endereço DNS padrão do Docker para o endereço do seu servidor DNS local. Para fazer isso, vá para o arquivo /etc/default/docker e altere o endereço IP na seguinte linha para o endereço IP de um servidor DNS na sua rede local:

docker_OPTS="--dns 8.8.8.8"

Para sistemas operacionais baseados em RPM como o CentOS, o arquivo de configuração pode estar localizado aqui: /etc/docker/daemon.json

P: Os editores de documentos abrem e a interface aparece, mas o documento em si não carrega, mostrando continuamente o progresso de carregamento. O que posso fazer?

R: A razão pode ser que o computador deve ser capaz de se endereçar usando o acesso de loopback da Internet, ou seja, deve ser acessível de fora para si mesmo. Para habilitar isso, edite o iptables para ter os redirecionamentos como este:

iptables -t nat -A PREROUTING -d <public_ip> -j DNAT --to-destination <local_ip>
iptables -t nat -A POSTROUTING -s <local_ip> -j SNAT --to-source <public_ip>

Não se esqueça de substituir os endereços public_ip e local_ip pelos endereços IP reais.

Autenticação e segurança​

P: A autenticação JWT falha após integrar o ONLYOFFICE Docs com minha plataforma. Como posso 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. Também verifique se o nome do cabeçalho JWT corresponde (o padrão é "Authorization"). 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. Verifique seu segredo com:

    sudo docker exec <CONTAINER_ID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json services.CoAuthoring.secret.session.string

Desempenho e uso de recursos​

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

R: 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 se há documentos presos ou esquecidos em /var/lib/onlyoffice/documentserver/App_Data/cache/files/forgotten/.

P: O contêiner continua reiniciando. O que devo fazer?

R: Verifique os logs do contêiner para o erro específico:

sudo docker logs <CONTAINER_ID>

Causas comuns incluem:

  • Memória insuficiente (o contêiner requer pelo menos 4 GB de RAM).
  • A porta 80 já está em uso por outra aplicação. Pare a outra aplicação ou altere a porta do ONLYOFFICE Docs.
  • Falha na inicialização do banco de dados. Se você estiver usando um banco de dados externo, verifique se os parâmetros de conexão estão corretos.

Manipulação de documentos​

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

R: Verifique o log do conversor para erros executando o seguinte comando:

sudo docker exec <CONTAINER_ID> cat /var/log/onlyoffice/documentserver/converter/out.log

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

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 depois que o documento foi fechado por todos os usuários que o editaram. Para evitar a 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 fazer isso, execute o seguinte script no servidor onde o ONLYOFFICE Docs está instalado:

sudo docker exec <CONTAINER> documentserver-prepare4shutdown.sh
observação

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

Cache e personalização​

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

R: Limpe forçadamente o cache executando o seguinte comando:

sudo docker exec <CONTAINER_ID> documentserver-flush-cache.sh

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

observação

Por favor, note que para a instalação do Docker, todas as ações devem ser realizadas dentro do contêiner.

Problemas com 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 antigo arquivo license.lic 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 de runtime.json e reinicie — um novo código de bootstrap será gerado.