Solucionar problemas de instalación de la aplicación Nextcloud que reportan falta de conexión a Internet

Desde Nextcloud 33, el tiempo de espera predeterminado para la solicitud de metadatos de la App Store es de 120 segundos y se puede ajustar occ. Esto ayuda con una respuesta lenta, pero el mensaje "No se pudo instalar la aplicación porque el servidor no tiene conexión a internet" debe verificarse primero desde el servidor o contenedor que ejecuta Nextcloud, no desde su navegador.

Prueba el punto final de la App Store desde el entorno de ejecución de Nextcloud y luego corrige el fallo específico: DNS, HTTPS saliente, configuración del proxy, confianza del certificado o alguna configuración de la App Store. El mensaje es genérico; no demuestra que todo el servidor esté fuera de línea.

1. Compruebe dónde falla la instalación.

Comprueba si fallan todas las aplicaciones o solo una. Si el catálogo se carga pero una aplicación no se instala, verifica su compatibilidad con la versión de Nextcloud y los permisos del directorio de aplicaciones; esto no necesariamente indica un problema de red.

Para obtener un error más claro, intente la instalación desde la línea de comandos. Si tiene éxito, instalará la aplicación, así que utilice el ID de aplicación previsto. Ejecútela como usuario HTTP para conservar la propiedad de los archivos. En Debian o Ubuntu:

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

Reemplaza newscon el ID de la aplicación que necesitas. En Docker, ejecuta el comando dentro del contenedor de la aplicación Nextcloud como su usuario web. Compara la salida completa con nextcloud.log; los errores de compatibilidad o permisos requieren una solución diferente a los fallos de DNS.

2. Prueba DNS y HTTPS desde el entorno de ejecución de Nextcloud.

Ejecuta estas comprobaciones donde se ejecuta el proceso PHP de Nextcloud. Una solicitud exitosa desde tu portátil o host Docker no demuestra que el contenedor de la aplicación tenga el mismo acceso a la red.

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

La URL predeterminada de la App Store es https://apps.nextcloud.com/api/v1; Nextcloud obtiene metadatos como categories.jsonde ella. DNS debería devolver una dirección y HTTPS debería devolver una respuesta. Los errores de resolución de nombres o los tiempos de espera indican problemas con DNS, enrutamiento, firewall o proxy; los errores de TLS indican problemas con la confianza del certificado o la hora del sistema. Un error HTTP significa que un servidor respondió, así que inspeccione la URL y la respuesta del proxy.

En Docker, ejecuta las comprobaciones en el contenedor de la aplicación Nextcloud. Confirma que el DNS funciona y que se permite el tráfico TCP 443 saliente. Si un proxy filtra los destinos, revisa los registros de Nextcloud para detectar cualquier nombre de host de descarga de la App Store, así como el host del catálogo.

3. Solucionar problemas de proxy o TLS sin debilitar la seguridad.

Si el tráfico saliente requiere un proxy, configúrelo para el cliente PHP/HTTP de Nextcloud, no solo para el navegador o la consola del administrador. Nextcloud admite configuraciones proxyopcionales . Mantenga las credenciales del proxy privadas. Compruebe si PHP-FPM y la CLI heredan el mismo entorno .proxyuserpwdproxyexcludeHTTPS_PROXYNO_PROXY

Para errores de TLS, compruebe la hora del servidor y actualice el paquete de CA del sistema operativo. Si utiliza un proxy de inspección corporativo aprobado, añada su CA de confianza al entorno de ejecución de PHP. No desactive la verificación TLS ni la utilice curl -kpara la solicitud de la App Store; esto debilita la protección contra la suplantación de identidad del servidor de descarga.

4. Verifica la URL de la App Store y los permisos de instalación.

La App Store está habilitada por defecto y su URL predeterminada es https://apps.nextcloud.com/api/v1. Compruebe config/config.phpo consulte los valores efectivos 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

Si appstoreenabledes explícitamente falso, actívelo solo si su política permite la tienda pública. Si appstoreurlapunta a una tienda personalizada antigua o inaccesible, restaure la configuración predeterminada solo si tiene previsto utilizar la App Store pública de Nextcloud. Las organizaciones que utilicen una App Store autohospedada deben conservar esa URL y reparar su DNS, certificado o ruta de acceso.

Si el catálogo se carga pero la instalación sigue fallando, revise las apps_pathsentradas en la configuración efectiva. Al menos un directorio de la aplicación configurada debe tener permisos de escritura para el usuario del servidor web de Nextcloud. Corrija el propietario o grupo del directorio y sus permisos de escritura; no permita que el directorio tenga permisos de escritura para todos los usuarios. Una aplicación bloqueada por una lista de permitidos de la organización o incompatible con su versión de Nextcloud también requiere una política de administrador o una decisión de versión, no un cambio de red.

5. Vuelva a intentarlo y ajuste el tiempo de espera solo si hay indicios de lentitud.

Una vez que las comprobaciones de DNS, HTTPS, proxy, TLS y configuración se hayan superado, vuelva a intentar la instalación desde la página de Aplicaciones o con el mismo occ app:installcomando. Si la solicitud es accesible pero tarda sistemáticamente más que el tiempo de espera de metadatos configurado, Nextcloud 33 y versiones posteriores pueden aumentarlo. Por ejemplo:

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

Esto aumenta el tiempo de espera a 180 segundos; no repara el bloqueo de salida, un certificado defectuoso ni una URL de almacenamiento incorrecta. El valor predeterminado documentado es de 120 segundos en Nextcloud 33 y versiones posteriores. Para eliminar una anulación y volver al valor predeterminado:

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

Para un servidor aislado intencionalmente de la red, la configuración recomendada es mediante una App Store autohospedada y aprobada. No intente solucionar la interrupción descargando un archivo ZIP de una aplicación cualquiera y colocándolo en el directorio de aplicaciones; utilice una fuente confiable y verifique que la versión sea compatible con su servidor.

Verificación

Confirme que el catálogo de la App Store se carga, la aplicación deseada se instala y aparece en la lista de aplicaciones habilitadas, y que el registro ya no muestra errores de conexión, TLS o tiempo de espera durante el intento. Si el punto final responde desde el entorno de ejecución de Nextcloud, pero la interfaz de usuario sigue indicando que no hay conexión a internet, compare la URL y la configuración de la App Store, revise las diferencias en el entorno del proxy entre PHP-FPM y la CLI, y compruebe si solo una aplicación está bloqueada o es incompatible.

Referencias: Gestión de aplicaciones Nextcloud y configuración de la App Store ; Comandos de configuración y aplicación OCC de Nextcloud ; Parámetros de configuración de Nextcloud para proxies ; Punto final de metadatos de la App Store de Nextcloud .