Como corrigir o erro "Conexão recusada" no aplicativo ownCloud Mobile

A mensagem "Conexão recusada" no aplicativo móvel ownCloud geralmente indica um problema de conectividade antes mesmo da autenticação começar: o telefone alcançou um endereço, mas nada aceitou a conexão no ponto de extremidade de rede solicitado. A redação exata pode variar de acordo com a versão do Android ou iOS, portanto, considere a mensagem como um sintoma e não como um diagnóstico.

Cenário meramente ilustrativo: imagine uma pequena empresa de design chamada Northstar Studio. Seus funcionários normalmente se conectam https://cloud.example.com/owncloudpelo aplicativo móvel ownCloud. Após uma alteração no proxy reverso, vários telefones exibem a mensagem "Conexão recusada". A interface web do ownCloud ainda funciona no laptop de um administrador dentro do escritório, mas não quando se utiliza dados móveis. Este cenário fictício será usado ao longo deste guia para mostrar como as etapas de solução de problemas se encaixam; não se trata de um relato de uma implantação real ou resultado de teste.

Tela ilustrativa da conta móvel do ownCloud mostrando o endereço do servidor https://cloud.example.com/owncloud e uma mensagem de "Conexão recusada".
Comece com o endereço exato do servidor que o aplicativo móvel está tentando acessar. Uma recusa ocorre antes que um login bem-sucedido no ownCloud possa ser realizado.

Primeiro, separe a mensagem "conexão recusada" dos erros de login.

Não comece redefinindo a senha do usuário. Uma senha incorreta, um token expirado ou um problema de OAuth ocorrem depois que o cliente consegue se comunicar com o servidor. Uma conexão TCP recusada geralmente está associada a um host ou porta incorretos, um servidor web ou proxy inativo, uma regra de firewall ou um serviço que escuta apenas em uma interface interna.

A documentação atual do ownCloud para dispositivos móveis confirma que os aplicativos são configurados com a URL do servidor ownCloud. A documentação do WebDAV do ownCloud também indica que os aplicativos móveis devem usar a URL base e a pasta, como por exemplo example.com/owncloud, `/usercloud/webdav/`, em vez de inserir manualmente um endpoint WebDAV. Consulte a documentação de acesso WebDAV do ownCloud .

1. Verifique o URL no aplicativo móvel.

No exemplo do Northstar, a URL esperada é https://cloud.example.com/owncloud. Verifique todos os quatro componentes: esquema, nome do host, porta (opcional) e caminho. Erros comuns incluem usar http://quando o serviço público só escuta em HTTPS, omitir uma porta não padrão, usar um nome de host interno que não pode ser resolvido fora do escritório ou inserir um endpoint DAV em vez da URL base do ownCloud.

A documentação do Android informa que o aplicativo testa a conexão após a inserção do URL do servidor e das credenciais, e recomenda um servidor com SSL habilitado para que a conexão possa usar HTTPS. A documentação do iOS verifica de forma semelhante o URL do servidor, o método de autenticação e o certificado TLS ao adicionar uma conta. Consulte o guia de conexão do ownCloud para Android e o guia de conta do ownCloud para iOS .

Navegador móvel ilustrativo mostrando cloud.example.com recusando uma conexão no mesmo URL do ownCloud.
Abra o mesmo URL no navegador do telefone. Se o navegador também recusar o acesso, concentre-se na conectividade da rede e no endpoint do serviço web, em vez das credenciais do aplicativo.

2. Teste o mesmo URL fora do aplicativo.

No telefone afetado, abra o URL exato do ownCloud em um navegador. Este é um ponto de partida importante. Se o navegador conseguir carregar a página do ownCloud, mas o aplicativo não, investigue o certificado específico do aplicativo, o redirecionamento, o OAuth ou a configuração da conta. Se tanto o navegador quanto o aplicativo falharem na mesma rede, continue com as verificações de servidor e rede.

Teste também a partir de mais de uma rede. No nosso exemplo com a Northstar, o Wi-Fi do escritório funciona, mas os dados móveis falham. Isso indica um problema de exposição a DNS público, firewall, NAT ou proxy reverso, e não um problema com o nome de usuário do ownCloud.

3. Confirme se o ponto de extremidade público está realmente escutando.

A partir de uma máquina que consiga acessar o servidor, teste o URL e o socket de escuta. Comandos como os seguintes são pontos de partida úteis:

curl -I https://cloud.example.com/owncloud
sudo ss -tlnp | grep -E ':80|:443'

Uma resposta HTTP bem-sucedida não precisa ser 200um redirecionamento; isso também pode comprovar que um serviço web está respondendo. A distinção importante é se uma conexão TCP é aceita. Se nada estiver escutando na porta pública esperada, corrija isso antes de alterar as configurações do aplicativo ownCloud.

Ilustração do terminal mostrando o curl acessando um URL do ownCloud e um socket escutando na porta TCP 443.
As verificações do lado do servidor podem confirmar se o HTTPS está respondendo e se um processo está escutando na porta 443.

4. Verifique o servidor web ou o proxy reverso.

Muitas implementações do ownCloud utilizam Apache, NGINX, HAProxy, Traefik ou outro proxy na frente da aplicação. Certifique-se de que o serviço exposto à internet esteja em execução, vinculado à interface correta e encaminhando o tráfego para o servidor de backend do ownCloud. Um proxy parado, vinculado apenas à interface `/etc/passwd` 127.0.0.1ou configurado para a porta upstream incorreta pode resultar em uma recusa imediata.

A documentação do ownCloud sobre proxies reversos é explícita e exige que os endereços de proxy nos quais o ownCloud deve confiar sejam configurados trusted_proxies. Ela também documenta as configurações de sobrescrita para casos em que a detecção automática de nome de host, protocolo ou raiz da web falha por trás de um proxy. Consulte o guia de configuração de proxy reverso do ownCloud .

Terminal de servidor ilustrativo mostrando regras de firewall para as portas 80 e 443, um serviço nginx ativo e um caminho de proxy reverso para um backend do ownCloud.
Quando um proxy estiver posicionado à frente do ownCloud, verifique tanto o listener voltado para a Internet quanto o caminho do proxy para o backend do ownCloud.

5. Verifique o firewall, o NAT e o caminho de rede.

Se o HTTPS funcionar no próprio servidor, mas não em um telefone fora da rede local (LAN), verifique o firewall do host, o grupo de segurança na nuvem, o roteador ou a regra NAT e qualquer firewall corporativo upstream. Para uma implementação HTTPS normal, a porta TCP 443 deve estar acessível no endereço público. Se você usar intencionalmente uma porta personalizada, essa porta exata deve ser exposta e incluída na URL.

Não desative o firewall como solução permanente. Em vez disso, identifique o listener necessário e permita apenas o tráfego exigido pelo seu projeto. No cenário Northstar, a pergunta útil não é "O firewall está ativado?", mas sim "Um cliente externo consegue acessar o endereço e a porta publicados para o ownCloud?".

Ilustração das configurações de rede do celular mostrando Wi-Fi e rede móvel ativados para testar uma conexão ownCloud em uma segunda rede.
Alternar entre Wi-Fi e dados móveis é uma maneira prática de determinar se a recusa segue um caminho de rede específico.

6. Verifique os certificados TLS e os redirecionamentos após a porta estar acessível.

Um problema de certificado é diferente de uma recusa literal de TCP, mas geralmente aparece imediatamente após a correção da conectividade. A documentação atual do iOS afirma que o aplicativo verifica os certificados TLS ao adicionar um servidor e permite que o usuário inspecione os detalhes do certificado. A documentação do Android também descreve avisos para certificados que não podem ser verificados.

Sempre que possível, utilize um certificado cujo nome de host corresponda ao nome de host público do ownCloud e cuja cadeia seja confiável para o dispositivo. Revise também os redirecionamentos de HTTP para HTTPS. A documentação de segurança do iOS observa que os redirecionamentos durante o login não são seguidos silenciosamente; os usuários precisam aprová-los. Consulte a documentação de segurança do ownCloud para iOS .

Tela ilustrativa da conta móvel do ownCloud mostrando o mesmo URL do servidor com uma conexão segura bem-sucedida.
Após a verificação de conectividade e TLS estarem corretas, o cliente móvel deverá ser capaz de prosseguir além da verificação inicial de conexão com o servidor.

7. Confirme os domínios confiáveis ​​do ownCloud e o gerenciamento de URLs de proxy.

Assim que o servidor web aceitar conexões, verifique se o ownCloud reconhece o nome do host usado pelo telefone. O ownCloud exige que os URLs usados ​​para acessar o servidor sejam permitidos trusted_domains. Isso é importante quando você introduz um novo nome de host público, migra o serviço ou expõe uma instalação anteriormente interna.

Para uma instalação clássica, inspecione a configuração em vez de editá-la às cegas. Você pode usar o comando occpara ler os domínios configurados:

sudo -u www-data ./occ config:system:get trusted_domains

Se o nome de host público estiver faltando, adicione-o usando a occ config:system:setsintaxe documentada para um índice de array não utilizado. A referência oficial do comando está disponível na documentação do comando `occ` do ownCloud . Para implantações em contêineres, a documentação atual do ownCloud expõe configurações equivalentes relacionadas a domínio e proxy por meio de variáveis ​​de ambiente como `<domain>` e OWNCLOUD_TRUSTED_DOMAINS`<proxy> OWNCLOUD_TRUSTED_PROXIES`.

Editor config.php ilustrativo mostrando trusted_domains, protocolo de sobrescrita HTTPS, host público e configurações de raiz web /owncloud.
Domínios confiáveis ​​e configurações de sobrescrita tornam-se relevantes depois que o ponto de extremidade da rede está acessível, especialmente por trás de um proxy reverso.

8. Repita o teste com o telefone original e compare os resultados.

Volte ao dispositivo afetado e teste em uma sequência controlada: primeiro, carregue o URL no navegador; em seguida, adicione ou reconecte a conta ownCloud; depois, abra a visualização Arquivos e confirme se a lista de diretórios é exibida. Repita o processo uma vez via Wi-Fi e outra via dados móveis, caso o serviço deva funcionar em ambas as redes.

No exemplo do Northstar, suponha que o administrador descubra que o proxy reverso substituto estava escutando na porta 443 apenas na interface privada. Vincular corretamente o ouvinte público explicaria por que o acesso do escritório funcionava enquanto o acesso celular era negado. Isso é apenas uma ilustração do processo de raciocínio, não uma afirmação sobre um incidente real do ownCloud.

Listas ilustrativas de arquivos do ownCloud exibidas em computadores e dispositivos móveis após uma conexão bem-sucedida.
Uma verificação final útil é garantir que tanto a interface web quanto o aplicativo móvel consigam acessar o mesmo servidor e exibir a hierarquia de arquivos esperada.

Tabela de diagnóstico rápido

O que você observaA próxima verificação mais útil
O aplicativo e o navegador do celular são recusados.Nome de host público, porta, ouvinte, firewall, NAT, serviço de proxy
Funciona com Wi-Fi, mas não com dados móveis.DNS público e caminho de firewall/NAT/proxy voltado para a Internet
O navegador funciona, mas o aplicativo trava na verificação do certificado.Nome de host TLS, cadeia de certificados, redirecionamentos
O servidor responde, mas o ownCloud rejeita o host.trusted_domainse configurações de sobrescrita de proxy reverso
A conexão é bem-sucedida, mas o login falha.Credenciais, OAuth2, autenticação de dois fatores ou política de tokens

O que não mudar primeiro

Evite alterar senhas, configurações de banco de dados, permissões de arquivos ou limites de memória PHP apenas porque o aplicativo móvel exibe a mensagem "Conexão recusada". Essas configurações podem ser relevantes para outras falhas do ownCloud, mas não devem ser o primeiro lugar a ser investigado quando o cliente não consegue estabelecer uma conexão de rede. Da mesma forma, não ignore permanentemente os avisos de certificado como substituto para corrigir uma configuração TLS pública.

Lista de verificação final

  • O telefone utiliza o URL base do ownCloud pretendido, incluindo o esquema correto, o nome do host, o caminho e a porta não padrão, se aplicável.
  • O nome do host é resolvido corretamente a partir da rede à qual o telefone está conectado.
  • Um servidor web público ou proxy reverso está escutando na porta TCP esperada.
  • O host, a nuvem, o roteador e os firewalls upstream permitem o tráfego pretendido.
  • O proxy reverso consegue acessar o backend do ownCloud.
  • O certificado TLS é apropriado para o nome de host público e foi aceito pelo dispositivo.
  • O nome do host está presente na configuração de domínios confiáveis ​​do ownCloud.
  • A interface web e o aplicativo móvel funcionam em todas as redes que a implantação deve suportar.

A partir de outubro de 2026, o ownCloud publica a documentação atualizada para seu servidor Classic e para os clientes móveis Android e iOS. Os rótulos e telas exatos podem mudar entre as versões do aplicativo, portanto, use a ordem de solução de problemas acima como o método mais confiável: primeiro, verifique a conectividade da rede; em seguida, valide o comportamento do proxy e do TLS; e somente depois, acesse as configurações de autenticação e do aplicativo ownCloud.

Deixar um comentário

10 Melhores Ferramentas de Varredura de Ping para Encontrar Dispositivos na Sua Rede

10 Melhores Ferramentas de Varredura de Ping para Encontrar Dispositivos na Sua Rede

Compare 10 ferramentas de varredura de ping para descoberta rápida de LAN, varredura multiplataforma e gerenciamento de endereços IP. Saiba o que uma varredura pode — e não pode — revelar.

6 Melhores Ferramentas de Gerenciamento de Rede para Monitorar o Desempenho

6 Melhores Ferramentas de Gerenciamento de Rede para Monitorar o Desempenho

Compare seis ferramentas de gerenciamento de rede para monitoramento de desempenho, incluindo cobertura SNMP, mapeamento, alertas, modelos de implantação e custo-benefício.

Melhores analisadores de Wi-Fi para Windows, iOS e Android

Melhores analisadores de Wi-Fi para Windows, iOS e Android

Compare as melhores opções de analisadores de Wi-Fi para Windows, iPhone e Android, incluindo ferramentas para congestionamento de canais, cobertura de sinal, mapas de calor e solução de problemas de rede.

Monitor de Ping: 7 ferramentas gratuitas e de código aberto para disponibilidade de rede

Monitor de Ping: 7 ferramentas gratuitas e de código aberto para disponibilidade de rede

Compare sete monitores de ping gratuitos e de código aberto, desde suítes completas de rede até sondas de latência específicas, e escolha a opção mais adequada para disponibilidade, perda de pacotes e histórico.

Taxa de transferência de rede versus largura de banda: o que significam e como afetam o desempenho

Taxa de transferência de rede versus largura de banda: o que significam e como afetam o desempenho

Veja como a taxa de transferência de rede difere da largura de banda, o que causa desempenho lento ou instável e quais ferramentas podem testar um caminho ou monitorar o tráfego.

Melhor software de servidor SFTP para transferências seguras de arquivos

Melhor software de servidor SFTP para transferências seguras de arquivos

Compare softwares de servidor SFTP confiáveis ​​para Windows e Linux, incluindo OpenSSH, Bitvise, SolarWinds e SFTPGo. Encontre a solução ideal para suas necessidades de segurança e transferência de arquivos.

Melhores práticas de monitoramento de rede: o que monitorar e quais ferramentas usar

Melhores práticas de monitoramento de rede: o que monitorar e quais ferramentas usar

Crie um monitoramento de rede prático com cobertura clara de dispositivos, métricas de desempenho úteis, alertas acionáveis ​​e uma comparação entre SolarWinds NPM, PRTG e OpManager.

As 7 melhores ferramentas de gerenciamento de endereços IP para equipes de rede

As 7 melhores ferramentas de gerenciamento de endereços IP para equipes de rede

Compare sete ferramentas de gerenciamento de endereços IP para descoberta de sub-redes, coordenação de DNS e DHCP, inventário de rede e IPAM de código aberto.

10 Melhores Ferramentas de Varredura de Rede para Descobrir Dispositivos e IPs

10 Melhores Ferramentas de Varredura de Rede para Descobrir Dispositivos e IPs

Compare ferramentas de varredura de rede para descoberta rápida de dispositivos, varreduras de IP multiplataforma e IPAM corporativo, com orientações sobre como escolher a opção mais adequada para sua rede.

6 ferramentas de monitoramento de rede Linux para dispositivos, hosts e tráfego.

6 ferramentas de monitoramento de rede Linux para dispositivos, hosts e tráfego.

Compare seis ferramentas de monitoramento de rede Linux para descoberta de dispositivos SNMP, gráficos de interface, métricas de host, verificação de serviços e fluxos de tráfego.