Paso 1. Prepara un VPS y Verifica los Requisitos Previos
Antes de iniciar el instalador, aprovisiona un VPS/VDS limpio (ya sea de tu propio proveedor o mediante los socios recomendados en /vps y /cabinet):
- Sistema Operativo: Debian 13 limpio (recomendado) o Debian 12 x86_64. Evita paneles de control preinstalados o reglas de firewall en conflicto.
- Credenciales de Acceso: Dirección IPv4 pública, puerto SSH (normalmente
22), nombre de usuario (rooto un usuario con sudo), y una contraseña SSH o clave privada OpenSSH/PEM (-----BEGIN OPENSSH PRIVATE KEY-----). - Dominio (Opcional antes de instalar): Puedes vincular un dominio personalizado y emitir certificados TLS directamente dentro del panel de administración de Apium Cloud OS justo después del despliegue.
- Slot de Licencia (Opcional): Si planeas usar Pro (hasta 100 usuarios, REST API completo, Cascada) o Ultra (hasta 1.000 usuarios), adquiere un slot vitalicio en /cabinet de antemano—o empieza gratis en Lite (hasta 25 usuarios) y actualiza más tarde.
Paso 2. Inicia el Asistente Zero-Disk SSH en el Gabinete
Inicia sesión en /cabinet (soporta 2FA), elige «Instalar en mi servidor» y rellena el formulario de despliegue:
- Introduce la IP / Host del servidor, el Puerto SSH y el Usuario SSH.
- Selecciona el tipo de autenticación: Contraseña SSH o Clave SSH Privada. Las credenciales permanecen estrictamente en memoria durante la sesión SSH activa y nunca se escriben en disco (arquitectura Zero-Disk).
- Opcionalmente selecciona un slot de licencia de pago sin asignar (Pro o Ultra) para auto-vincular durante el aprovisionamiento, o déjalo en Lite.
- Haz clic en «Instalar Apium Cloud OS en el servidor» y observa la consola de progreso en vivo.
Paso 3. Las 4 Etapas Automatizadas de Instalación
Qué Ocurre Durante el Despliegue
Pipeline AutomatizadoEl asistente ejecuta cuatro etapas deterministas en tu servidor Debian de destino y transmite registros en tiempo real a tu Gabinete.
| Etapa | Identificador | Acciones Realizadas en el VPS de Destino |
|---|---|---|
| Etapa 1 | SSH Preflight & OS Check | Verifica la accesibilidad SSH, privilegios root/sudo, compatibilidad con Debian 12/13 y recursos del sistema disponibles. |
| Etapa 2 | Prepare Apium Cloud OS Environment | Configura repositorios, instala dependencias del sistema, ajusta parámetros de red del kernel y prepara directorios aislados. |
| Etapa 3 | Bootstrap Runtime & Panel | Despliega el demonio de control en Rust, servicios systemd, motores Xray/Hysteria2/accel-ppp/strongSwan, reglas nftables y vincula tu licencia si fue seleccionada. |
| Etapa 4 | Health & Readiness Verification | Ejecuta comprobaciones de salud de servicios en los demonios principales y muestra tu URL única del panel, usuario admin y contraseña temporal. |
Paso 4. Primer Inicio de Sesión y Configuración Inicial del Panel
Una vez finalizada la Etapa 4, guarda las credenciales de un solo uso mostradas en la salida del asistente y abre la URL de tu consola de administración:
- 1. Asegura tu Cuenta Admin: Inicia sesión con las credenciales temporales y actualiza de inmediato la contraseña de administrador.
- 2. Selecciona el Modo de Operación: Mantén Cascade VPN para internet multiprotocolo y enrutamiento upstream relay, o activa Corporate Gateway para una base de datos aislada, CA X.509, AD/RADIUS y ACLs de segmento.
- 3. Configura Dominio y Protocolos: Apunta tu registro DNS A a la IP del VPS, vincula tu dominio en la configuración del panel para TLS (Windows SSTP / consola HTTPS) y habilita los protocolos que necesites (
VLESS Reality,Hysteria 2,Windows SSTP,L2TP/IPsec). - 4. Establece Perfiles de Firewall y Shaper: Elige un nivel
nftables(Basic,RestrictedoParanoidpara bloquear P2P/SMTP) y configura límites de ancho de bandatcpor grupo.
Paso 5. Gestión, Importación y Transferencia de Licencias
- Auto-Vinculación vía Asistente: Las licencias seleccionadas en el Paso 2 se activan automáticamente en el nodo durante la Etapa 3.
- Importación Manual (Servidores Independientes): Copia el Identificador de Servidor desde la cabecera del panel admin, genera
license.keyen el Gabinete e impórtalo en el panel. - Migración de VPS en Un Clic: ¿Te mudas a un nuevo servidor? Haz clic en Desvincular del servidor en el Gabinete para revocar la vinculación antigua y reutilizar tu slot vitalicio en el nuevo VPS.
Paso 6. Lista de Verificación Post-Instalación
Comprobación Técnica de Salud
- Confirma que todos los Servicios de Túnel requeridos muestren ONLINE en el Dashboard de Apium (MS-SSTP, L2TP, strongSwan, sing-box/Xray).
- Verifica que la telemetría de CPU, RAM y carga de canal en tiempo real se esté actualizando.
Verificación de Clientes y Enrutamiento
- Crea una cuenta de prueba, verifica los límites de cuota/velocidad y prueba la conectividad desde tu cliente objetivo (app, Windows SSTP o MikroTik/Keenetic).
- Si usas Upstream Relay, verifica que las sondas de salud de 15s pasen para tus nodos de salida por país.