Como solucionar problemas do ONLYOFFICE Docs no Docker

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

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

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

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

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

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

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

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

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"). 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

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

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

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

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

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

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

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 bootstrap será gerado.