Con One-Click Apps, puedes instalar aplicaciones como Nextcloud, n8n, bases de datos o herramientas de monitorización desde un catálogo de aplicaciones en tu servidor dedicado y gestionarlas directamente desde el panel de ZapX. Para ello, se ejecuta Coolify en segundo plano, una plataforma de código abierto para aplicaciones en contenedores.
A diferencia de un VPS, en un servidor dedicado tienes que configurar Aplicaciones con un clic una sola vez: crea un comando en el panel y ejecútalo como root en tu servidor. ZapX se encarga del resto. En esta guía descubrirás qué necesita tu servidor, cómo se configura, cómo puedes gestionar las aplicaciones y qué hace en tu servidor el acceso de mantenimiento de ZapX.
Esto es lo que necesita tu servidor dedicado: Comprueba estos puntos antes de ejecutar el comando. El propio comando los verificará y se detendrá sin hacer cambios si algo no cumple los requisitos.
| Requisito | Mínimo |
|---|---|
| Sistema operativo | Debian o Ubuntu con servidor SSH |
| RAM | 2 GB |
| CPU | 2 núcleos |
| Espacio libre | 30 GB |
| Dirección IP | Dirección IPv4 pública configurada en el servidor |
| Puertos libres | 8000, 6001, 6002 y 8080 (tus aplicaciones necesitan los puertos 80 y 443) |
| SSH | ZapX debe poder acceder al puerto SSH de tu servidor |
Se recomienda un sistema operativo recién instalado: Lo mejor es configurar Aplicaciones con un clic en una instalación nueva de Debian o Ubuntu. Si hay servicios que ya ocupan puertos, una configuración propia de Docker o una instalación de Coolify con un inicio de sesión propio, la configuración se interrumpirá. Puedes iniciar una reinstalación en la pestaña Instalación de tu servidor dedicado.
Host de Proxmox y Windows: No puedes configurar Aplicaciones con un clic directamente en un host de Proxmox. Para hacerlo, usa una VM en el servidor que utilice una de las direcciones IP de tu servidor. Windows no es compatible.
Solo el titular del servidor puede configurar Aplicaciones con un clic.
Abre tu servidor dedicado en el panel de ZapX y ve a la pestaña One-Click Apps. Allí encontrarás la tarjeta Configurar One-Click Apps.
Elige dos opciones:
- Dirección IP para el panel y las apps: Aquí aparecen las direcciones IPv4 públicas de tu servidor; la principal está marcada. Más adelante, podrás acceder al panel de Coolify y a tus aplicaciones desde esta IP.
- Correo electrónico de Admin para Coolify: Usa esta dirección de correo electrónico para iniciar sesión en el panel de Coolify.
A continuación, haz clic en Crear comando. ZapX preparará la dirección de tu panel. Esto puede tardar hasta un minuto.
Conéctate a tu servidor por SSH como root. Copia el comando que aparece con el icono de copiar y ejecútalo. Empieza por curl -fsSL y termina con | bash.
Si tu servidor no tiene curl, instálalo antes con:
apt update && apt install -y curl
Después, la instalación continuará en segundo plano. Puedes cerrar el terminal.
No compartas el comando: El comando contiene una clave personal para este servidor y es válida durante 24 horas. No la compartas. Si necesitas un comando nuevo, haz clic en Cancelar instalación manual y créalo de nuevo.
En la pestaña puedes ver el progreso de la configuración:
| Mensaje | Significado |
|---|---|
| Estamos esperando a que ejecutes el comando en tu servidor. | El comando aún no se ha iniciado |
| Conectado. La instalación se está ejecutando en tu servidor. | ZapX está instalando Coolify. Suele tardar hasta 10 minutos |
| Coolify está instalado. Estamos conectando el panel. | Es el último paso y tarda alrededor de un minuto |
Si ZapX no puede conectarse a tu servidor por SSH después de unos minutos, la pestaña mostrará un aviso. Comprueba si el firewall permite conexiones entrantes al puerto SSH de tu servidor.
- Comprueba el sistema operativo, los recursos, la dirección IP y los puertos libres. Si algo no cumple los requisitos, se detiene y muestra un mensaje.
- Crea el usuario
zapx-appscon permisos sudo. ZapX usa este usuario para gestionar Coolify y tus aplicaciones. Solo se puede iniciar sesión con una clave de ZapX y desde direcciones de ZapX; no es posible iniciar sesión con una contraseña. - Instala Coolify con el instalador oficial, que también configura Docker.
- Para la configuración, ZapX utiliza temporalmente una clave root con permisos muy limitados y, si hace falta, ajusta la configuración de SSH. Ambos elementos se eliminan al terminar la configuración.
- El comando no modifica las reglas del firewall.
Encontrarás el registro de la configuración en el servidor, en /var/lib/zapx-oneclick-apps/setup.log.
Cuando termine la configuración, la pestaña One-Click Apps mostrará tres secciones:
| Sección | Contenido |
|---|---|
| Aplicaciones instaladas | Tus aplicaciones, con su estado y las acciones disponibles |
| Catálogo de aplicaciones | Todas las aplicaciones disponibles para instalar |
| Acceso y configuración | Dirección del panel, inicio de sesión y acceso de mantenimiento |
- Abre el Catálogo de apps y busca la aplicación que quieras.
- Haz clic en Instalar.
- En la ventana Instalar app, completa los campos solicitados, por ejemplo,
[dein_appname]o[deine_domain]. - Haz clic en Poner instalación en cola.
Si tu servidor no tiene suficiente RAM para una aplicación, verás en el catálogo el aviso «Tu servidor no tiene suficiente RAM para esta aplicación».
Ayuda del agente de IA de ZapX: En el agente de IA de ZapX de tu servidor, puedes pedir que te recomiende una aplicación adecuada, comprobar el estado de tus aplicaciones o preparar una instalación. El agente solo realizará cambios después de que los confirmes. Gestiona siempre las credenciales y los secretos en la pestaña One-Click Apps.
En Aplicaciones instaladas, puedes controlar directamente cada aplicación:
| Acción | Propósito |
|---|---|
| Iniciar | Inicia una aplicación detenida |
| Detener | Detiene una aplicación en ejecución |
| Reiniciar | Reinicia la aplicación |
| Registros | Muestra los registros de la aplicación para ayudarte a solucionar problemas |
| Configuración | Cambia las variables de entorno, el dominio y otras opciones de la aplicación |
La tarjeta Acceso de mantenimiento indica si ZapX puede acceder a tu servidor:
| Estado | Significado |
|---|---|
| Activo | ZapX puede acceder a tu servidor y gestionar Coolify y tus aplicaciones |
| Interrumpido | ZapX ya no puede acceder a tu servidor, por ejemplo, porque cambió la clave de host SSH o ya no se acepta la clave de ZapX |
| Eliminado | Has eliminado el acceso de mantenimiento |
Al hacer clic en Retirar acceso, ZapX elimina de tu servidor su clave, la regla sudo y el usuario zapx-apps. Coolify y tus aplicaciones seguirán funcionando, pero ZapX ya no podrá gestionarlos: dejarán de estar disponibles la instalación, la resolución de problemas y los cambios desde el panel. En ese caso, gestiona tus aplicaciones directamente desde el panel de Coolify.
Si no se puede acceder a tu servidor al eliminar el acceso, ZapX lo bloqueará desde su lado. En ese caso, puedes eliminar manualmente el usuario zapx-apps y el archivo /etc/sudoers.d/zapx-apps del servidor.
Al hacer clic en Restablecer acceso, crearás un comando nuevo que solo volverá a configurar el acceso de mantenimiento. Coolify y tus aplicaciones no cambiarán. Ejecútalo como root en tu servidor, igual que durante la configuración inicial.
| Evento | Qué ocurre |
|---|---|
| Reinstalación desde la pestaña Instalación | Se restablece la configuración y se eliminan las direcciones de zap.cloud. El sistema se configura de nuevo; guarda antes los datos de tus aplicaciones. Después, tendrás que volver a configurar Aplicaciones con un clic. |
| Liberación de la dirección IP del panel y las aplicaciones | Se elimina el acceso de mantenimiento, se borran las direcciones de zap.cloud y se restablece la configuración. Coolify y tus aplicaciones seguirán funcionando en el servidor. Para volver a gestionarlos desde el panel, configura de nuevo Aplicaciones con un clic con otra dirección IP. |
| Cancelación o fin del contrato | Se elimina el acceso de mantenimiento y se borran las direcciones de zap.cloud. |
| Mensaje o problema | Solución |
|---|---|
| No hay conexión por SSH después de unos minutos | Comprueba que el servidor SSH esté en ejecución y que el firewall permita el acceso al puerto SSH |
| Los puertos ya están ocupados | Detén los servicios que usan los puertos 8000, 6001, 6002 y 8080, o reinstala el servidor |
| Coolify ya está instalado | ZapX no puede gestionar una instalación de Coolify con un inicio de sesión propio. Elimínala o usa un sistema recién instalado |
| El servidor SSH solo permite ciertos usuarios (AllowUsers) | Añade zapx-apps a la configuración de SSH y vuelve a ejecutar el comando |
| Hay una instalación en curso en el servidor | Espera a que termine la instalación en la pestaña Instalación |
| El servidor aún no tiene una dirección IPv4 pública | Primero, configura una dirección IPv4 pública para tu servidor |
| Demasiados intentos | Espera unos minutos y vuelve a crear el comando |
Encontrarás más detalles sobre una configuración fallida en /var/lib/zapx-oneclick-apps/setup.log. Si necesitas ayuda, crea un ticket de soporte e indica el mensaje de error que aparece en la pestaña.
Fuente preferida en Google
