Résolution des problèmes d'installation de l'application Nextcloud signalant une absence de connexion Internet

Depuis Nextcloud 33, le délai d'expiration des requêtes de métadonnées de l'App Store est fixé par défaut à 120 secondes et peut être ajusté occ. Cela permet d'améliorer la réactivité, mais le message « L'application n'a pas pu être installée car le serveur n'a pas accès à Internet » doit d'abord être vérifié sur le serveur ou le conteneur exécutant Nextcloud, et non dans votre navigateur.

Testez le point de terminaison de l'App Store depuis l'environnement d'exécution de Nextcloud, puis corrigez la défaillance : DNS, HTTPS sortant, configuration du proxy, confiance du certificat ou paramètre de l'App Store. Le message est générique ; il ne prouve pas que le serveur est entièrement hors ligne.

1. Vérifiez où l'installation échoue.

Vérifiez si toutes les applications ou une seule ne fonctionne pas. Si le catalogue se charge mais qu'une application ne s'installe pas, vérifiez sa compatibilité avec la version de Nextcloud et les autorisations d'accès au répertoire de l'application ; il ne s'agit pas forcément d'un problème de réseau.

Pour obtenir un message d'erreur plus clair, essayez l'installation en ligne de commande. L'application sera installée si l'opération réussit ; utilisez donc l'identifiant d'application prévu. Exécutez-la en tant qu'utilisateur HTTP pour conserver la propriété des fichiers. Sous Debian ou Ubuntu :

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

Remplacez newspar l'ID de l'application souhaitée. Dans Docker, exécutez la commande dans le conteneur de l'application Nextcloud en tant qu'utilisateur web. Comparez la sortie complète avecnextcloud.log ; les erreurs de compatibilité ou d'autorisation nécessitent une solution différente des erreurs DNS.

2. Tester le DNS et le HTTPS depuis l'environnement d'exécution Nextcloud

Effectuez ces vérifications à l'emplacement où s'exécute le processus PHP de Nextcloud. Une requête réussie depuis votre ordinateur portable ou votre hôte Docker ne garantit pas que le conteneur de l'application dispose du même accès réseau.

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

L'URL par défaut de l'App Store esthttps://apps.nextcloud.com/api/v1 ; Nextcloud récupère les métadonnées à partir categories.jsonde cette URL. Le DNS doit renvoyer une adresse et le HTTPS une réponse. Les erreurs de résolution de nom ou les délais d'attente indiquent un problème de DNS, de routage, de pare-feu ou de proxy ; les erreurs TLS indiquent un problème de confiance du certificat ou d'heure système. Une erreur HTTP signifie qu'un serveur a répondu ; examinez donc l'URL et la réponse du proxy.

Dans Docker, effectuez les vérifications dans le conteneur de l'application Nextcloud. Assurez-vous que le DNS fonctionne et que le trafic TCP sortant sur le port 443 est autorisé. Si un proxy filtre les destinations, examinez les journaux de Nextcloud à la recherche de noms d'hôtes de téléchargement de l'App Store, ainsi que de l'hôte du catalogue.

3. Corriger les problèmes de proxy ou de TLS sans compromettre la sécurité

Si le trafic sortant nécessite un proxy, configurez-le pour le client PHP/HTTP de Nextcloud, et non uniquement pour le navigateur ou l'interface de ligne de commande de l'administrateur. Nextcloud prend en charge les paramètres `proxy` proxy, `php proxyuserpwd-fpm` et ` cli` (optionnels proxyexclude). Conservez les identifiants du proxy confidentiels. Vérifiez si PHP-FPM et l'interface de ligne de commande (CLI) héritent du même HTTPS_PROXYenvironnement NO_PROXY.

En cas d'erreur TLS, vérifiez l'horloge du serveur et mettez à jour le bundle d'autorité de certification du système d'exploitation. Si vous utilisez un proxy d'inspection d'entreprise approuvé, ajoutez son autorité de certification de confiance à l'environnement d'exécution PHP. Ne désactivez pas la vérification TLS et ne l'utilisez pas curl -kpour les requêtes vers l'App Store ; cela affaiblit la protection contre l'usurpation d'identité d'un hébergeur de téléchargement.

4. Vérifiez l'URL de l'App Store et les autorisations d'installation.

L'App Store est activé par défaut et son URL par défaut esthttps://apps.nextcloud.com/api/v1 : . Consultez config/config.phpou interrogez les valeurs effectives avecocc :

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

Si appstoreenabledla valeur est explicitement fausse, activez cette option uniquement si votre politique autorise la boutique publique. Si appstoreurlelle pointe vers une boutique personnalisée ancienne ou inaccessible, rétablissez la valeur par défaut uniquement si vous prévoyez d'utiliser la boutique d'applications publique de Nextcloud. Les organisations utilisant une boutique d'applications auto-hébergée doivent conserver cette URL et corriger plutôt son DNS, son certificat ou son chemin d'accès.

Si le catalogue se charge mais que l'installation échoue toujours, vérifiez les apps_pathsentrées de la configuration effective. Au moins un répertoire d'application configuré doit être accessible en écriture par l'utilisateur du serveur web Nextcloud. Corrigez le propriétaire ou le groupe du répertoire ainsi que ses permissions d'écriture ; ne rendez pas le répertoire accessible en écriture à tous. Une application bloquée par une liste blanche de l'organisation ou incompatible avec votre version de Nextcloud nécessite également une décision de l'administrateur concernant une stratégie ou une version, et non une modification du réseau.

5. Réessayez, puis ajustez le délai d'attente uniquement si des éléments indiquent une lenteur.

Une fois les vérifications DNS, HTTPS, proxy, TLS et de configuration réussies, réessayez l'installation depuis la page Applications ou avec la même occ app:installcommande. Si la requête aboutit mais prend systématiquement plus de temps que le délai d'expiration des métadonnées configuré, Nextcloud 33 et versions ultérieures permettent d'augmenter ce délai. Par exemple :

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

Cela porte le délai d'attente à 180 secondes ; cela ne corrige pas les blocages de sortie, les certificats invalides ou les URL de stockage incorrectes. La valeur par défaut documentée est de 120 secondes dans Nextcloud 33 et versions ultérieures. Pour annuler cette modification et revenir à la valeur par défaut :

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

Pour un serveur volontairement isolé du réseau, l'utilisation d'une boutique d'applications auto-hébergée et approuvée est la solution recommandée. Ne tentez pas de résoudre la panne en téléchargeant un fichier ZIP d'application quelconque et en le plaçant dans le répertoire des applications ; utilisez une source fiable et vérifiez que la version correspond à votre serveur.

Vérification

Vérifiez que le catalogue de l'App Store se charge, que l'application souhaitée s'installe et apparaît dans la liste des applications activées, et que le journal ne signale plus d'erreur de connexion, TLS ou de délai d'attente. Si le point de terminaison répond depuis l'environnement d'exécution de Nextcloud mais que l'interface utilisateur indique toujours l'absence de connexion Internet, comparez l'URL et les paramètres de l'App Store, examinez les différences de configuration du proxy entre PHP-FPM et l'interface de ligne de commande (CLI), et vérifiez si une seule application est bloquée ou incompatible.

Références : Gestion des applications Nextcloud et paramètres de l’App Store ; Application Nextcloud OCC et commandes de configuration ; Paramètres de configuration Nextcloud pour les proxys ; Point de terminaison des métadonnées de l’App Store Nextcloud .