Solução de problemas de instalações do aplicativo Nextcloud que relatam falta de internet

Desde o Nextcloud 33, o tempo limite da solicitação de metadados da App Store é definido por padrão como 120 segundos e pode ser ajustado com ` occ. Isso ajuda a reduzir a lentidão nas respostas, mas a mensagem "O aplicativo não pôde ser instalado porque o servidor não tem internet" deve ser verificada primeiro no servidor ou contêiner que executa o Nextcloud — e não no seu navegador.

Teste o endpoint da App Store a partir do próprio ambiente de execução do Nextcloud e, em seguida, corrija a falha específica: DNS, HTTPS de saída, configuração de proxy, confiança no certificado ou alguma configuração da App Store. A mensagem é genérica; ela não comprova que todo o servidor esteja offline.

1. Verifique onde a instalação falhou

Verifique se todos os aplicativos ou apenas um falha. Se o catálogo carregar, mas um aplicativo não instalar, verifique a compatibilidade com a versão do Nextcloud e as permissões do diretório do aplicativo; isso não significa necessariamente que seja um problema de rede.

Para obter uma mensagem de erro mais clara, tente a instalação pela linha de comando. Se a instalação for bem-sucedida, o aplicativo será instalado, portanto, use o ID do aplicativo desejado. Execute o comando como o usuário HTTP para preservar a propriedade dos arquivos. No Debian ou Ubuntu:

sudo -u www-data php /var/www/nextcloud/occ app:install news

Substitua newspelo ID do aplicativo que você precisa. No Docker, execute o comando dentro do contêiner do aplicativo Nextcloud como o usuário web. Compare a saída completa com nextcloud.log; erros de compatibilidade ou permissão exigem uma solução diferente de falhas de DNS.

2. Teste o DNS e o HTTPS a partir do ambiente de execução do Nextcloud.

Execute essas verificações no mesmo local onde o processo PHP do Nextcloud está em execução. Uma requisição bem-sucedida do seu laptop ou host Docker não comprova que o contêiner do aplicativo tenha o mesmo acesso à rede.

getent ahosts apps.nextcloud.com
curl -sS --connect-timeout 10 --max-time 30 -o /dev/null -w 'HTTP %{http_code}' https://apps.nextcloud.com/api/v1/categories.json

O URL padrão da App Store é https://apps.nextcloud.com/api/v1; o Nextcloud obtém metadados como a categories.jsonpartir dele. O DNS deve retornar um endereço e o HTTPS deve retornar uma resposta. Erros de resolução de nomes ou tempos limite indicam problemas com DNS, roteamento, firewall ou proxy; erros de TLS indicam problemas com a confiança no certificado ou com a hora do sistema. Um erro HTTP significa que um servidor respondeu, portanto, inspecione o URL e a resposta do proxy.

No Docker, execute as verificações no contêiner do aplicativo Nextcloud. Confirme se o DNS está funcionando e se a porta TCP 443 de saída está permitida. Se um proxy estiver filtrando os destinos, inspecione os logs do Nextcloud em busca de nomes de host de downloads da App Store, bem como o host do catálogo.

3. Corrigir problemas de proxy ou TLS sem comprometer a segurança.

Se o tráfego de saída exigir um proxy, configure-o para o cliente PHP/HTTP do Nextcloud, e não apenas para o navegador ou terminal do administrador. O Nextcloud oferece suporte a configurações proxyopcionais . Mantenha as credenciais do proxy em sigilo. Verifique se o PHP-FPM e a CLI compartilham o mesmo ambiente .proxyuserpwdproxyexcludeHTTPS_PROXYNO_PROXY

Para erros de TLS, verifique o relógio do servidor e atualize o pacote de CA do sistema operacional. Se um proxy de inspeção corporativo aprovado for usado, adicione sua CA confiável ao ambiente de execução do PHP. Não desative a verificação TLS nem a utilize curl -kpara a solicitação da App Store; isso enfraquece a proteção contra um host de download falsificado.

4. Verifique o URL da App Store e as permissões de instalação.

A App Store está ativada por padrão e seu URL padrão é https://apps.nextcloud.com/api/v1. Verifique config/config.phpou consulte os valores efetivos com occ:

sudo -u www-data php /var/www/nextcloud/occ config:system:get appstoreenabled
sudo -u www-data php /var/www/nextcloud/occ config:system:get appstoreurl

Se appstoreenabledfor explicitamente falso, ative-o somente se sua política permitir a loja pública. Se appstoreurlapontar para uma loja personalizada antiga ou inacessível, restaure o padrão somente se você pretende usar a App Store pública do Nextcloud. Organizações que usam uma App Store auto-hospedada devem manter esse URL e corrigir seu DNS, certificado ou caminho de acesso.

Se o catálogo carregar, mas a instalação ainda falhar, verifique as apps_pathsentradas na configuração efetiva. Pelo menos um diretório de aplicativo configurado deve ter permissão de escrita para o usuário do servidor web Nextcloud. Corrija o proprietário ou grupo do diretório e suas permissões de escrita pretendidas; não torne o diretório gravável por todos. Um aplicativo bloqueado por uma lista de permissões da organização ou incompatível com a sua versão do Nextcloud também requer uma política de administrador ou uma decisão de versão, e não uma alteração de rede.

5. Tente novamente e ajuste o tempo limite somente se houver evidências de lentidão.

Após as verificações de DNS, HTTPS, proxy, TLS e configuração serem aprovadas, tente novamente a instalação a partir da página de Aplicativos ou com o mesmo occ app:installcomando. Se a solicitação estiver acessível, mas demorar consistentemente mais do que o tempo limite de metadados configurado, o Nextcloud 33 e versões posteriores podem aumentar esse valor. Por exemplo:

sudo -u www-data php /var/www/nextcloud/occ config:app:set settings appstore-timeout --value=180

Isso aumenta o tempo de espera para 180 segundos; não corrige bloqueios de saída, certificados inválidos ou URLs de armazenamento incorretos. O valor padrão documentado é de 120 segundos no Nextcloud 33 e versões posteriores. Para remover uma alteração e retornar ao valor padrão:

sudo -u www-data php /var/www/nextcloud/occ config:app:delete settings appstore-timeout

Para um servidor intencionalmente isolado da internet (air-gapped), uma loja de aplicativos auto-hospedada e aprovada é a configuração recomendada. Não tente resolver a indisponibilidade baixando um arquivo ZIP de um aplicativo qualquer e colocando-o no diretório de aplicativos; use uma fonte confiável e verifique se a versão é compatível com o seu servidor.

Verificação

Confirme se o catálogo da App Store carrega, se o aplicativo desejado é instalado e aparece na lista de aplicativos habilitados e se o log não registra mais erros de conexão, TLS ou tempo limite para a tentativa. Se o endpoint responder do ambiente de execução do Nextcloud, mas a interface do usuário ainda indicar que não há internet, compare o URL e as configurações da App Store, verifique as diferenças no ambiente de proxy entre o PHP-FPM e a CLI e verifique se apenas um aplicativo está bloqueado ou incompatível.

Referências: Gerenciamento de aplicativos Nextcloud e configurações da App Store ; Comandos de configuração e do aplicativo Nextcloud OCC ; Parâmetros de configuração do Nextcloud para proxies ; Endpoint de metadados da App Store do Nextcloud .