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.
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 .
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.
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 .
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?".
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 .
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:
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`.
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.
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ê observa
A 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.