Problemen oplossen met Nextcloud-app-installaties die melden dat er geen internetverbinding is

Sinds Nextcloud 33 is de time-out voor het opvragen van metadata in de App Store standaard ingesteld op 120 seconden en kan deze worden aangepast met occ. Dit helpt bij een trage reactie, maar de melding "App kon niet worden geïnstalleerd omdat de server geen internetverbinding heeft" moet eerst worden gecontroleerd op de server of container waarop Nextcloud draait, en niet in uw browser.

Test het App Store-eindpunt vanuit de eigen runtime van Nextcloud en los vervolgens de specifieke fout op: DNS, uitgaande HTTPS, proxyconfiguratie, certificaatvertrouwen of een App Store-instelling. Het bericht is algemeen; het bewijst niet dat de hele server offline is.

1. Controleer waar de installatie mislukt.

Controleer of alle apps of slechts één app niet werken. Als de catalogus wel laadt, maar één app niet installeert, controleer dan de compatibiliteit met de Nextcloud-versie en de machtigingen voor de app-directory; dit hoeft niet per se een netwerkprobleem te zijn.

Voor een duidelijkere foutmelding kunt u de installatie via de commandoregel proberen. Als de installatie lukt, wordt de app geïnstalleerd, dus gebruik de juiste app-ID. Voer het programma uit als de HTTP-gebruiker om het eigenaarschap van de bestanden te behouden. Op Debian of Ubuntu:

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

Vervang dit newsdoor de app-ID die je nodig hebt. Voer in Docker de opdracht uit in de Nextcloud-appcontainer als de webgebruiker. Vergelijk de volledige uitvoer met nextcloud.logde compatibiliteits- of machtigingsfouten; deze vereisen een andere oplossing dan DNS-fouten.

2. Test DNS en HTTPS vanuit de Nextcloud-runtime.

Voer deze controles uit op de locatie waar het PHP-proces van Nextcloud draait. Een succesvol verzoek vanaf uw laptop of Docker-host bewijst niet dat de app-container dezelfde netwerktoegang heeft.

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

De standaard App Store-URL is https://apps.nextcloud.com/api/v1; Nextcloud haalt metadata zoals categories.jsonhieruit op. DNS zou een adres moeten retourneren en HTTPS zou een antwoord moeten geven. Naamresolutiefouten of time-outs wijzen op DNS, routering, firewall of proxy; TLS-fouten wijzen op certificaatvertrouwen of systeemtijd. Een HTTP-fout betekent dat een server heeft gereageerd, dus controleer de URL en het proxyantwoord.

Voer in Docker de controles uit in de Nextcloud-applicatiecontainer. Controleer of DNS werkt en of uitgaand TCP-verkeer op poort 443 is toegestaan. Als een proxy bestemmingen filtert, controleer dan de Nextcloud-logboeken op hostnamen van App Store-downloads en de catalogushost.

3. Los proxy- of TLS-problemen op zonder de beveiliging te verzwakken.

Als uitgaand verkeer een proxy vereist, configureer deze dan voor de PHP/HTTP-client van Nextcloud, niet alleen voor de browser of shell van de beheerder. Nextcloud ondersteunt de optionele proxyinstellingen . Houd de proxygegevens privé. Controleer of PHP-FPM en CLI dezelfde omgevingsvariabelen overnemen .proxyuserpwdproxyexcludeHTTPS_PROXYNO_PROXY

Controleer bij TLS-fouten de serverklok en werk de CA-bundel van het besturingssysteem bij. Als een goedgekeurde bedrijfsinspectieproxy wordt gebruikt, voeg dan de vertrouwde CA ervan toe aan de PHP-runtime. Schakel TLS-verificatie niet uit en gebruik deze niet curl -kvoor de App Store-aanvraag; dit verzwakt de bescherming tegen een downloadhost die zich voordoet als een andere host.

4. Controleer de URL van de App Store en de installatiemachtigingen.

De App Store is standaard ingeschakeld en de standaard-URL is https://apps.nextcloud.com/api/v1. Controleer config/config.phpof vraag de actuele waarden op met 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

Als appstoreenableddit expliciet onwaar is, schakel het dan alleen in als uw beleid de openbare store toestaat. Als appstoreurlhet verwijst naar een oude of onbereikbare aangepaste store, herstel dan de standaardinstelling alleen als u van plan bent de openbare App Store van Nextcloud te gebruiken. Organisaties die een zelfgehoste App Store gebruiken, moeten die URL behouden en in plaats daarvan de DNS, het certificaat of het toegangspad herstellen.

Als de catalogus wel laadt, maar de installatie nog steeds mislukt, controleer dan de apps_pathsinstellingen in de actieve configuratie. Ten minste één geconfigureerde app-directory moet beschrijfbaar zijn voor de Nextcloud-webservergebruiker. Corrigeer de eigenaar of groep van de directory en de beoogde schrijfrechten; maak de directory niet voor iedereen beschrijfbaar. Een app die wordt geblokkeerd door een whitelist van de organisatie of die incompatibel is met uw Nextcloud-versie, vereist ook een beleids- of versiebeslissing van de beheerder, geen netwerkwijziging.

5. Probeer het opnieuw en pas de time-out alleen aan als er aanwijzingen zijn voor traagheid.

Nadat de DNS-, HTTPS-, proxy-, TLS- en configuratiecontroles zijn geslaagd, probeer de installatie dan opnieuw vanaf de pagina Apps of met hetzelfde occ app:installcommando. Als de aanvraag bereikbaar is, maar consequent langer duurt dan de geconfigureerde time-out voor metadata, kan Nextcloud 33 en latere versies deze time-out verhogen. Bijvoorbeeld:

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

Dit verhoogt de wachttijd naar 180 seconden; het herstelt geen geblokkeerde uitgaande verbindingen, een ongeldig certificaat of een onjuiste URL van de store. De standaardwaarde in Nextcloud 33 en later is 120 seconden. Om een ​​overschrijving ongedaan te maken en terug te keren naar de standaardwaarde:

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

Voor een server die opzettelijk van het internet is afgesloten, is een goedgekeurde, zelfgehoste app store de aanbevolen configuratiemethode. Probeer de storing niet op te lossen door een willekeurig app-zipbestand te downloaden en in de app-directory te plaatsen; gebruik een betrouwbare bron en controleer of de release overeenkomt met uw server.

Verificatie

Controleer of de App Store-catalogus laadt, de beoogde app wordt geïnstalleerd en in de lijst met ingeschakelde apps verschijnt, en of er in het logboek geen verbindings-, TLS- of time-outfout meer wordt geregistreerd voor de poging. Als het eindpunt reageert vanuit de Nextcloud-runtime, maar de gebruikersinterface nog steeds aangeeft dat er geen internetverbinding is, vergelijk dan de App Store-URL en -instellingen, bekijk de verschillen in proxyomgeving tussen PHP-FPM en de CLI, en controleer of er slechts één app wordt geblokkeerd of incompatibel is.

Referenties: Nextcloud app-beheer en App Store-instellingen ; Nextcloud OCC app- en configuratieopdrachten ; Nextcloud-configuratieparameters voor proxy's ; Nextcloud App Store-metadata-eindpunt .