Risoluzione dei problemi relativi all'installazione dell'app Nextcloud che segnala l'assenza di connessione a Internet.

Dalla versione 33 di Nextcloud, il timeout predefinito per la richiesta dei metadati dell'App Store è di 120 secondi e può essere modificato occ. Questo aiuta in caso di risposte lente, ma il messaggio "Impossibile installare l'app perché il server non ha accesso a Internet" dovrebbe essere verificato prima dal server o dal container su cui è in esecuzione Nextcloud, non dal browser.

Verifica l'endpoint dell'App Store direttamente dall'ambiente di runtime di Nextcloud, quindi risolvi il problema specifico: DNS, HTTPS in uscita, configurazione del proxy, attendibilità del certificato o un'impostazione dell'App Store. Il messaggio è generico e non dimostra che l'intero server sia offline.

1. Verifica dove si verifica l'errore durante l'installazione.

Verifica se il problema riguarda tutte le app o solo una. Se il catalogo si carica ma un'app non si installa, controlla la compatibilità con la versione di Nextcloud e le autorizzazioni della directory dell'app; non si tratta necessariamente di un problema di rete.

Per un messaggio di errore più chiaro, prova l'installazione dalla riga di comando. Se l'installazione ha esito positivo, l'app verrà installata, quindi utilizza l'ID dell'app desiderato. Eseguila come utente HTTP per preservare la proprietà dei file. Su Debian o Ubuntu:

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

Sostituisci newscon l'ID dell'app di cui hai bisogno. In Docker, esegui il comando all'interno del container dell'app Nextcloud come utente web. Confronta l'output completo con nextcloud.log; gli errori di compatibilità o di autorizzazione richiedono una soluzione diversa rispetto agli errori DNS.

2. Testare DNS e HTTPS dall'ambiente di runtime di Nextcloud.

Esegui questi controlli nello spazio in cui è in esecuzione il processo PHP di Nextcloud. Una richiesta andata a buon fine dal tuo laptop o dall'host Docker non dimostra che il container dell'applicazione abbia lo stesso accesso alla rete.

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 predefinito dell'App Store è https://apps.nextcloud.com/api/v1; Nextcloud recupera metadati come categories.jsonda esso. Il DNS dovrebbe restituire un indirizzo e HTTPS dovrebbe restituire una risposta. Gli errori di risoluzione dei nomi o i timeout indicano problemi con DNS, routing, firewall o proxy; gli errori TLS indicano problemi con l'attendibilità del certificato o con l'ora di sistema. Un errore HTTP significa che un server ha risposto, quindi è necessario esaminare l'URL e la risposta del proxy.

In Docker, esegui i controlli nel container dell'applicazione Nextcloud. Verifica che il DNS funzioni correttamente e che la porta TCP 443 in uscita sia consentita. Se un proxy filtra le destinazioni, controlla i log di Nextcloud per individuare eventuali hostname di download dall'App Store, nonché l'host del catalogo.

3. Risolvere i problemi relativi a proxy o TLS senza compromettere la sicurezza.

Se il traffico in uscita richiede un proxy, configurarlo per il client PHP/HTTP di Nextcloud, non solo per il browser o la shell dell'amministratore. Nextcloud supporta le impostazioni proxy, opzionali proxyuserpwde proxyexclude. Mantieni riservate le credenziali del proxy. Verifica se PHP-FPM e CLI ereditano lo stesso ambiente HTTPS_PROXYo .NO_PROXY

In caso di errori TLS, verificare l'orologio del server e aggiornare il bundle CA del sistema operativo. Se si utilizza un proxy di ispezione aziendale approvato, aggiungere la relativa CA attendibile al runtime PHP. Non disabilitare la verifica TLS né utilizzarla curl -kper la richiesta all'App Store; ciò indebolisce la protezione contro un host di download impersonato.

4. Verifica l'URL dell'App Store e le autorizzazioni di installazione

L'App Store è abilitato per impostazione predefinita e il suo URL predefinito è https://apps.nextcloud.com/api/v1. Verifica config/config.phpo interroga i valori effettivi con 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 appstoreenabledè esplicitamente impostato su falso, attivalo solo se la tua policy consente lo store pubblico. Se appstoreurlpunta a uno store personalizzato obsoleto o irraggiungibile, ripristina l'impostazione predefinita solo se intendi utilizzare l'App Store pubblico di Nextcloud. Le organizzazioni che utilizzano un App Store self-hosted dovrebbero mantenere quell'URL e riparare invece il DNS, il certificato o il percorso di accesso.

Se il catalogo si carica ma l'installazione continua a fallire, verifica le apps_pathsvoci nella configurazione effettiva. Almeno una directory dell'app configurata deve essere scrivibile dall'utente del server web di Nextcloud. Correggi il proprietario o il gruppo della directory e i relativi permessi di scrittura; non rendere la directory scrivibile da tutti. Un'app bloccata da una lista di autorizzazione organizzativa o incompatibile con la tua versione di Nextcloud richiede anche una decisione relativa ai criteri dell'amministratore o alla versione, non una modifica della rete.

5. Riprova, quindi regola il timeout solo se le prove indicano una lentezza

Dopo che i controlli DNS, HTTPS, proxy, TLS e di configurazione sono andati a buon fine, riprova l'installazione dalla pagina App o con lo stesso occ app:installcomando. Se la richiesta è raggiungibile ma impiega costantemente più tempo del timeout dei metadati configurato, Nextcloud 33 e versioni successive consentono di impostarlo su un valore superiore. Ad esempio:

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

Questo porta il tempo di attesa a 180 secondi; non risolve i problemi di traffico in uscita bloccato, certificati non validi o URL di archiviazione errati. Il valore predefinito documentato è di 120 secondi in Nextcloud 33 e versioni successive. Per rimuovere una modifica e ripristinare il valore predefinito:

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

Per un server intenzionalmente isolato dalla rete, la configurazione supportata prevede l'utilizzo di un App Store self-hosted approvato. Non tentare di risolvere il problema scaricando un file ZIP di un'app a caso e inserendolo nella directory delle app; utilizza una fonte attendibile e verifica che la versione sia compatibile con il tuo server.

Verifica

Verifica che il catalogo dell'App Store si carichi, che l'app desiderata si installi e appaia nell'elenco delle app abilitate e che il registro non registri più errori di connessione, TLS o timeout per il tentativo. Se l'endpoint risponde dal runtime di Nextcloud ma l'interfaccia utente continua a indicare l'assenza di connessione a Internet, confronta l'URL e le impostazioni dell'App Store, esamina le differenze nell'ambiente proxy tra PHP-FPM e CLI e controlla se solo un'app è bloccata o incompatibile.

Riferimenti: Gestione delle app Nextcloud e impostazioni dell'App Store ; App Nextcloud OCC e comandi di configurazione ; Parametri di configurazione Nextcloud per i proxy ; Endpoint dei metadati dell'App Store di Nextcloud .