Corrigir problemas de tempo limite de conexão do aplicativo ONLYOFFICE Mobile em um servidor auto-hospedado

Você insere o seu servidor próprio no ONLYOFFICE Documents, toca em Avançar e o aplicativo fica carregando até exibir uma mensagem de tempo limite de conexão. A mesma conta pode funcionar normalmente em um navegador de computador, o que faz parecer que o problema é um bug do aplicativo. Na prática, o tempo limite geralmente significa que o telefone não consegue acessar o URL exato do serviço que você inseriu, o URL aponta para o componente errado do ONLYOFFICE ou alguma camada de rede está bloqueando a solicitação.

Comece por identificar o que o seu servidor realmente oferece. O aplicativo móvel Documents conecta-se a um portal ONLYOFFICE, como o DocSpace ou o Workspace, ou a uma nuvem de terceiros compatível, como o Nextcloud, o ownCloud ou outro serviço WebDAV. O ONLYOFFICE Docs, também chamado de Servidor de Documentos, é o serviço de edição que funciona com uma plataforma de armazenamento; não é automaticamente a mesma coisa que um portal de usuário ou uma conta de arquivo WebDAV. As visões gerais do ONLYOFFICE Documents para Android e iOS descrevem os tipos de conta compatíveis.

1. Confirme qual endereço o aplicativo móvel deve usar.

Não cole o URL do servidor de documentos em todos os campos de conexão. Se seus arquivos estiverem armazenados em um portal DocSpace ou Workspace auto-hospedado, use o endereço público desse portal e faça login com a conta do portal. Se seus arquivos estiverem no Nextcloud ou ownCloud, escolha esse serviço no aplicativo e insira o endereço WebDAV do servidor de armazenamento com as credenciais da conta. Para um serviço WebDAV genérico, selecione a opção "Outro WebDAV" do aplicativo, quando disponível.

Para Nextcloud e ownCloud, o URL pode incluir um caminho além do domínio. Copie o endereço WebDAV exibido nas configurações da conta na nuvem, em vez de tentar adivinhar um caminho a partir de um tutorial antigo. O guia de conexão móvel do ONLYOFFICE fornece um exemplo para Nextcloud e orienta os usuários a colar o URL completo, incluindo o protocolo. As instruções do aplicativo para Android também indicam que é necessário fornecer o URL de conexão, o login e a senha para o armazenamento WebDAV. Consulte o guia de integração oficial do Nextcloud ou o guia de integração do ownCloud para obter o fluxo de conexão atual.

  • Use o URL do portal para uma conta do portal, não o endereço do serviço do editor.
  • Utilize o URL WebDAV completo para Nextcloud, ownCloud ou outra conta WebDAV.
  • Inclua https://ou http://faça exatamente como configurado no servidor.
  • Não adicione um sufixo não verificado, como /webdavou /remote.php/dav; copie o URL WebDAV exibido pelo servidor.

2. Teste o mesmo endereço fora do aplicativo.

No celular, abra o endereço em um navegador móvel. Para um URL de portal, o resultado esperado é uma página de login ou um redirecionamento para o portal. Para um endpoint WebDAV, o navegador pode exibir uma solicitação de login, uma resposta de autorização ou um erro simples em vez de um site normal; o importante é que ele responda prontamente e que o navegador não informe que o host não foi encontrado ou acessado.

Repita o teste uma vez via Wi-Fi e outra via dados móveis. Se funcionar apenas em uma das redes, o aplicativo provavelmente não é o primeiro lugar a ser verificado. Verifique o roteador, a VPN, o filtro de DNS, as restrições da operadora de celular ou a política de firewall na rede com problemas. Se falhar em ambas, confirme se o nome do host é resolvido publicamente e se o proxy reverso ou o firewall encaminha o tráfego HTTPS do serviço para o servidor correto.

Um servidor acessível apenas por meio de um endereço privado, como este, 192.168.x.xnormalmente ficará indisponível quando o telefone estiver fora da rede local, a menos que o dispositivo esteja conectado por meio de uma VPN ou outra configuração segura de acesso remoto. Não exponha um serviço interno à internet pública apenas para testar o aplicativo; utilize o método de acesso remoto aprovado pela organização.

3. Verifique o URL, os redirecionamentos e o proxy reverso.

Compare o endereço no aplicativo com o endereço que funciona no navegador, caractere por caractere. Procure por um subdiretório ausente, um nome de host antigo, uma porta incorreta, um caminho final copiado de outro serviço ou um redirecionamento para um nome de host interno que o telefone não consegue resolver. Se o seu servidor estiver atrás de um proxy reverso, a URL pública deve direcionar para o aplicativo correto, e o esquema de encaminhamento e as informações do host devem ser consistentes com o endereço HTTPS acessado pelos usuários.

Quando um portal ou serviço WebDAV é publicado em um subdiretório, verifique se o proxy preserva o caminho necessário e encaminha as solicitações para esse aplicativo. Uma URL raiz que exibe uma página de boas-vindas do proxy reverso apenas comprova que o servidor web respondeu; não comprova que o portal ou endpoint WebDAV do aplicativo está roteado corretamente. Se possível, teste a URL exata copiada para o aplicativo móvel, em vez de apenas a página inicial do domínio.

Se o aplicativo reportar um tempo limite excedido, mas o navegador carregar a página de login rapidamente, verifique os registros de acesso e erro do proxy no momento de uma nova tentativa de conexão. Uma resposta 502 ou 504 indica um tempo limite excedido no servidor ou no proxy; um código 404 geralmente sugere uma incompatibilidade de caminho ou roteamento; um código 401 ou 403 indica que o endpoint respondeu, mas a autenticação ou o acesso foi negado. Esses códigos de status ajudam a restringir a investigação, mas o significado pode variar dependendo do proxy e do software em nuvem que estão à frente do ONLYOFFICE.

4. Valide o HTTPS e a cadeia de certificados.

Os sistemas operacionais móveis validam os certificados do servidor. Um certificado expirado, emitido para um nome de host diferente, ausente de um certificado intermediário ou assinado por uma autoridade na qual o dispositivo não confia pode impedir uma conexão segura. Abra o endereço HTTPS exato no telefone e verifique se há algum aviso de certificado no navegador. Verifique também se a data e a hora do dispositivo estão corretas, pois um relógio incorreto pode fazer com que um certificado válido pareça expirado ou ainda não válido.

Use um certificado emitido para o nome de host público e instale a cadeia de certificados completa no proxy ou servidor voltado para a internet. A documentação do ONLYOFFICE descreve a configuração de HTTPS para o Servidor de Documentos; o certificado deve corresponder à URL usada pelos clientes. Evite desativar a verificação de certificado como uma solução permanente. O ONLYOFFICE descreve essa opção como insegura em sua documentação de integração, e uma conexão que funciona somente após ignorar as verificações de certificado ainda precisa de uma configuração de certificado correta.

5. Separe um problema de login no aplicativo de um problema de conexão com o editor.

Um usuário pode fazer login com sucesso em um portal e ainda assim ter problemas para abrir um documento. Essas são conexões separadas. O aplicativo precisa primeiro acessar o servidor de armazenamento ou o portal. Ao abrir um arquivo, a integração também pode envolver o Servidor de Documentos. Portanto, um login móvel bem-sucedido não comprova que o serviço de edição consegue acessar o servidor de armazenamento, ou que o servidor de armazenamento consegue acessar o editor.

Se o erro de tempo limite ocorrer somente após a abertura de um arquivo, peça ao administrador para testar a integração no servidor. Os guias do ONLYOFFICE para Nextcloud e ownCloud explicam que instalações em redes restritas podem precisar de endereços IP internos configurados para solicitações do servidor de armazenamento para o ONLYOFFICE Docs e do ONLYOFFICE Docs de volta para o serviço de armazenamento. Os endereços IP públicos podem funcionar em um navegador de celular, enquanto o tráfego de servidor para servidor ainda apresentar falhas.

Para um administrador, verifique se ambos os serviços resolvem os nomes de host configurados um do outro, se as regras de firewall permitem o tráfego necessário e se o conector usa o mesmo segredo JWT configurado para o Servidor de Documentos quando o JWT está habilitado. Não altere o segredo nem desabilite o JWT por tentativa e erro; primeiro compare os valores configurados usando o guia de integração oficial da sua plataforma de nuvem.

6. Verifique novamente as credenciais e o estado do aplicativo.

Após confirmar a acessibilidade e os certificados, verifique o nome de usuário e a senha na interface web do mesmo portal ou conta de armazenamento. Um endpoint WebDAV pode exigir as credenciais reais da conta ou uma senha de aplicativo, dependendo da política de autenticação do servidor. Se a autenticação multifator estiver habilitada, siga as instruções para esse servidor; não presuma que a senha de login web padrão seja aceita por todas as implementações de WebDAV.

Atualize o ONLYOFFICE Documents pela loja de aplicativos oficial, feche e abra o aplicativo novamente e tente adicionar a conta mais uma vez. Se a conta foi salva anteriormente com um endereço incorreto, remova essa conexão salva e crie uma nova com o URL verificado. Isso não exclui arquivos no servidor: desconectar uma conta na nuvem no aplicativo móvel remove a entrada da conexão local, não o conteúdo do armazenamento remoto. Antes de reinstalar o aplicativo ou limpar seus dados, certifique-se de que todos os documentos locais não sincronizados estejam salvos ou com backup.

7. Verifique o servidor somente depois de descartar causas mais simples.

Se o URL público exato expirar em vários dispositivos e redes, a falha provavelmente está no servidor ou em seu caminho de rede. Confirme se o portal, o serviço de armazenamento, o proxy reverso e o servidor de documentos estão em execução. Para instalações do Docker, um administrador pode inspecionar o status do contêiner e os logs recentes com comandos como:

docker compose ps
docker compose logs --tail=100 <service-name>

Use os nomes de serviço reais do arquivo Compose da implantação; os nomes variam entre instalações. Verifique se há reinicializações repetidas, falhas de DNS, erros de conexão com servidores upstream, esgotamento de recursos ou problemas de renovação de certificado. Evite reiniciar todos os componentes antes de capturar os logs, pois uma reinicialização pode remover evidências úteis da falha.

Especificamente para o Servidor de Documentos, a central de ajuda oficial documenta uma /info/página que os administradores podem usar para verificar o serviço quando ele estiver habilitado e acessível. Trata-se de um diagnóstico para o Servidor de Documentos, não um substituto para testar o portal ou o endereço WebDAV inserido no aplicativo móvel. Consulte as instruções da ONLYOFFICE para a página de informações do Servidor de Documentos .

Verifique a correção pelo telefone.

Execute as verificações nesta ordem: abra o portal exato ou o URL WebDAV no navegador do telefone; repita o processo em Wi-Fi e dados móveis; adicione a conta no ONLYOFFICE Documents com o tipo de serviço correspondente; faça login; navegue até uma pasta; e abra um pequeno documento de teste. Se a navegação funcionar, mas a edição não, investigue a integração do ONLYOFFICE Docs no servidor. Se o navegador e o aplicativo apresentarem erro de tempo limite, continue com as verificações de DNS, firewall, proxy e servidor, em vez de alterar a senha repetidamente.

Um resultado positivo é um login estável e a listagem de pastas na rede em que você pretende trabalhar. Teste abrir e salvar um arquivo não crítico antes de confiar na configuração para documentos importantes. Se o problema persistir, forneça ao administrador o tipo exato de URL (portal, WebDAV ou Servidor de Documentos), o sistema operacional do telefone, a rede utilizada, o registro de data e hora e qualquer entrada de log de status HTTP ou proxy. Não envie senhas, tokens de acesso ou conteúdo de documentos em uma solicitação de suporte.

Deixar um comentário

O que é o Microsoft Access? Como funcionam suas ferramentas de banco de dados?

O que é o Microsoft Access? Como funcionam suas ferramentas de banco de dados?

O Microsoft Access é um aplicativo de banco de dados para Windows que permite armazenar registros relacionados, criar consultas, elaborar formulários de entrada de dados e gerar relatórios. Saiba como ele funciona e quando é adequado para você.

Alterar a altura e a largura das linhas de grade no Word 2010

Alterar a altura e a largura das linhas de grade no Word 2010

Aprenda como ajustar a altura e a largura das linhas de grade no Word 2010, alterar a frequência das linhas visíveis e definir o espaçamento horizontal e vertical da grade de desenho subjacente.

Importação e exportação do Office Outlook 2010: Mova dados com um arquivo PST

Importação e exportação do Office Outlook 2010: Mova dados com um arquivo PST

Aprenda como importar um arquivo PST para o Outlook 2010 ou exportar emails, contatos, calendário e tarefas. Siga os menus corretos e evite pastas ausentes ou duplicadas.

Recupere a senha de um arquivo PST do Outlook com o Nucleus Kernel

Recupere a senha de um arquivo PST do Outlook com o Nucleus Kernel

Recupere uma senha esquecida de um arquivo PST do Outlook seguindo os passos atuais do Kernel, incluindo como identificar o arquivo correto, fazer um backup e verificar as limitações da ferramenta.

Como inserir uma página da web em um slide do PowerPoint

Como inserir uma página da web em um slide do PowerPoint

Use o suplemento LiveWeb para inserir um site em um slide do PowerPoint, definir seu tamanho e comportamento de atualização e verificar a compatibilidade antes da apresentação.

Contatos do Outlook 2010: Adicionar pessoas e usar a agenda de endereços

Contatos do Outlook 2010: Adicionar pessoas e usar a agenda de endereços

Aprenda como criar e organizar contatos no Outlook 2010, criar um grupo de contatos e selecionar pessoas salvas na Agenda de Endereços ao endereçar um e-mail.

Como criar um campo de hiperlink no Access 2010

Como criar um campo de hiperlink no Access 2010

Crie um campo de Hiperlink no Access 2010 no Modo de Exibição de Design e, em seguida, adicione e teste links para sites, e-mails ou arquivos compartilhados com os detalhes de destino corretos.

Como remover metadados e conteúdo ocultos de um documento do Word

Como remover metadados e conteúdo ocultos de um documento do Word

Use o Inspetor de Documentos do Word para revisar detalhes do autor, comentários, alterações controladas, texto oculto e outros dados antes de compartilhar, e descubra o que a verificação pode não detectar.

Exportar e importar configurações da Faixa de Opções e da Barra de Ferramentas de Acesso Rápido no Office 2010

Exportar e importar configurações da Faixa de Opções e da Barra de Ferramentas de Acesso Rápido no Office 2010

Mova guias personalizadas da Faixa de Opções e comandos da Barra de Ferramentas de Acesso Rápido no Office 2010 com um arquivo .exportedUI e proteja as configurações já existentes no seu computador de destino.

Converter uma planilha do Excel em papel quadriculado imprimível

Converter uma planilha do Excel em papel quadriculado imprimível

Crie papel quadriculado imprimível no Excel ajustando as dimensões das células, definindo uma área de impressão, escolhendo papel A4 e ativando a impressão de linhas de grade no Excel para desktop.