La función One-Click Apps te permite explorar un amplio catálogo de aplicaciones e implementarlas directamente desde la interfaz web de tu VPS. En esta guía aprenderás a preparar tu servidor, elegir el tipo de instalación adecuado, instalar y gestionar aplicaciones, y utilizar la configuración avanzada y las herramientas de solución de problemas cuando sea necesario.
Antes de utilizar las One-Click Apps, tu VPS debe cumplir los requisitos mínimos y utilizar un sistema operativo compatible.
Requisitos mínimos La función de aplicaciones requiere que tu VPS esté en línea y cuente con recursos suficientes para ejecutar de forma fiable tanto los servicios de la plataforma como las aplicaciones instaladas.
| Requisito | Mínimo | Recomendado |
|---|---|---|
| Estado del servidor | En línea | En línea |
| Espacio en disco | 30 GB | 50 GB |
| RAM | 2 GB | 4 GB |
| CPU | 2 núcleos | 4 núcleos |
| Sistema operativo | Debian o Ubuntu LTS | Debian 13 |
Se recomienda un sistema operativo recién instalado Se recomienda encarecidamente configurar la función de aplicaciones en una instalación limpia del sistema operativo. Así evitarás conflictos con servicios existentes, puertos ocupados, configuraciones de Docker o ajustes personalizados que ya estén en el servidor.
Si necesitas reinstalar tu VPS, utiliza una imagen limpia y compatible de Debian o Ubuntu LTS desde la interfaz de gestión de tu VPS.
Después de la implementación, las aplicaciones instaladas aparecerán en la sección de gestión de la pestaña. Desde allí podrás supervisar y controlar tus servicios sin tener que gestionar manualmente los contenedores subyacentes.
La sección de aplicaciones instaladas te permite realizar acciones habituales del ciclo de vida directamente desde la pestaña.
| Acción | Función |
|---|---|
| Iniciar | Inicia una aplicación detenida |
| Detener | Detiene una aplicación en ejecución |
| Consultar registros | Abre los registros de la aplicación para solucionar problemas |
| Reinstalar | Vuelve a instalar la aplicación |
Estas herramientas facilitan la gestión de todas las aplicaciones desde un mismo lugar, especialmente si prefieres un control sencillo basado en la web en vez de trabajar manualmente desde la línea de comandos.
Los proyectos y los entornos te ayudan a estructurar claramente tus implementaciones. Puedes utilizarlos para separar:
- Aplicaciones privadas y de producción
- Entornos de prueba y en vivo
- Implementaciones de distintos clientes o equipos
- Diferentes pilas en el mismo VPS
Esta organización cobra cada vez más importancia a medida que crece tu colección de aplicaciones y gestionas más servicios en uno o varios nodos.
La función One-Click Apps admite dominios personalizados y la integración con ZAP Cloud. Así puedes hacer que las aplicaciones sean accesibles de forma segura y proporcionar certificados SSL para tus implementaciones.
Compatibilidad con dominios y SSL Puedes utilizar dominios personalizados para tus aplicaciones y aprovechar la provisión automática de certificados SSL, siempre que la plataforma admita esa configuración.
Al asignar un dominio, asegúrate de que tus registros DNS apunten a [deine_server_ip]. Si el dominio no está configurado correctamente, es posible que no se pueda acceder a la aplicación desde Internet.
| Valor | Descripción |
|---|---|
[deine_domain] | El dominio o subdominio asignado a tu aplicación |
[deine_server_ip] | La dirección IP pública de tu VPS |
El DNS debe apuntar a tu VPS
Si el DNS de [deine_domain] no apunta a [deine_server_ip], puede fallar la validación del dominio y el acceso a la aplicación.
Si el panel muestra un estado degradado, significa que la plataforma no puede acceder a la instancia que ejecuta la función One-Click Apps o recuperar datos de ella. Sigue los pasos de solución de problemas en orden.
La ventana emergente de solución de problemas puede mostrar los siguientes indicadores:
| Estado | Significado |
|---|---|
| Estado de Coolify: Activo | El servicio del panel parece estar en ejecución |
| Estado de la API: Accesible | La API está disponible en este momento |
| Estado del servicio: En línea | Tu VPS está en línea |
Si alguno de los componentes no funciona correctamente, continúa con los siguientes pasos.
Primero, asegúrate de que tu VPS aparezca en línea en el panel de ZapX. Si el servidor está desconectado, la plataforma de aplicaciones no podrá funcionar.
Utiliza la acción Actualizar estado para volver a ejecutar la comprobación de estado con los datos más recientes. Esto puede resolver problemas temporales de conexión.
Problemas temporales de conexión A veces, un estado degradado se debe a problemas de comunicación transitorios. Actualizar el estado es la comprobación inicial más rápida.
Si el estado sigue degradado, utiliza la acción Reiniciar Docker. Esto reiniciará la instancia de la plataforma. Cuando recibas la confirmación, espera 1-2 minutos y vuelve a actualizar el estado.
Reinicio del servicio Al reiniciar Docker, es posible que las aplicaciones en ejecución se interrumpan temporalmente mientras se reinician los servicios.
Como último paso, utiliza Actualizar credenciales. Esto es especialmente importante si el estado aparece en línea, pero algunas funciones del panel, como la instalación de aplicaciones, no funcionan.
Esta acción:
- No elimina tus datos
- Actualiza las credenciales del usuario root
- Renueva el token de API que utiliza el panel
- Actualiza automáticamente las credenciales del panel si se completa correctamente
Actualización segura de las credenciales Actualizar las credenciales no elimina las aplicaciones instaladas ni los datos de implementación. Solo renueva las credenciales necesarias para el acceso y la comunicación.
Si el problema persiste después de seguir todos los pasos de solución de problemas, crea un ticket de soporte desde el sitio web de ZAP-Hosting.
Para que las One-Click Apps sigan siendo estables y fáciles de gestionar, ten en cuenta estas recomendaciones:
| Buena práctica | Motivo |
|---|---|
| Utilizar una instalación limpia del sistema operativo | Evita conflictos con servicios y puertos existentes |
| Cumplir los requisitos de recursos recomendados | Mejora el rendimiento y la fiabilidad |
| Organizar las aplicaciones en proyectos y entornos | Mantiene las implementaciones ordenadas |
| Configurar el DNS antes de asignar un dominio | Evita problemas de acceso y SSL |
| Utilizar la configuración avanzada con cuidado | Evita cambios personalizados no compatibles |
Mantén las implementaciones organizadas
Si quieres alojar muchas aplicaciones, define una convención de nombres clara para [dein_projektname], [dein_umgebungsname] y [dein_appname] antes de realizar la primera implementación.
