Documentación
Inicio rápido + descripción de cada función y de cada dispositivo (en constante actualización)
Operación mediante túnel
Este artículo presenta la «Operación mediante túnel» del panel: conectar al panel servidores sin IP pública.
En una frase
A los dispositivos sin IP pública (máquinas de red interna, dispositivos tras un NAT, móviles Android) no puedes «conectarte tú activamente» desde fuera. La Operación mediante túnel hace que estos dispositivos se «conecten hacia fuera» activamente al servidor del panel, y a partir de ahí puedes operarlos igual que un servidor normal.
Descripción de la función
Con dispositivos que no tienen ninguna dirección accesible desde la red pública (máquinas de red interna, dispositivos tras un NAT, móviles Android, etc.) no se puede conectar por SSH directamente. La Operación mediante túnel hace que estos dispositivos se conecten activamente al servidor del panel mediante un túnel inverso, y a partir de ahí puedes operarlos igual que un servidor normal.
Principio
- El servidor del panel (con IP pública) ejecuta un servicio de túnel
- En el dispositivo de destino se instala un Agent ligero que «marca» activamente la conexión hacia el servidor del panel
- Una vez establecida la conexión, el panel puede hacer SSH inverso al dispositivo de destino a través de este túnel
> En términos sencillos: el dispositivo de destino es como si «llamara por teléfono» activamente al servidor del panel; una vez establecida la llamada, el panel puede controlarlo a su vez por esta «línea dedicada».
Casos de uso
- Gestionar dispositivos de red interna de casa (Raspberry Pi, NAS, router software)
- Gestionar VPS baratos sin IP pública (servidores NAT)
- Gestionar móviles Android (entorno Termux)
Cómo se usa (tres pasos)
1. Abre «Operación mediante túnel» y pulsa «Script de instalación con un clic» para generar un comando independiente
2. Pega el comando en el dispositivo de destino y ejecútalo una vez (instala el Agent + configura el autoarranque automáticamente)
3. Unos 10 segundos después, el dispositivo aparece automáticamente en el panel y ya puedes conectarte por SSH y usar todas las funciones
> El comando de instalación se ha acortado a propósito para poder teclearlo a mano cuando aún no hay nada instalado:
> - Linux (curl): curl -sSL http://servidor:5501/i/<token> | sudo bash
> - Termux: curl -sSL http://servidor:5501/t/<token> | bash
> - Si ya eres root, puedes quitar sudo; en Alpine usa wget -qO- … | sudo bash y en BSD fetch -o - … | sudo bash
>
> Ubicación de instalación: en Linux se instala por defecto en /opt/sshe-agent (si falta /opt o no es escribible, el script recurre automáticamente a ~/sshe-agent, sin dar error); Termux usa ~/sshe-agent (se inicia con Termux).
>
> Conexión sin contraseña: tras la instalación, el panel se conecta al dispositivo sin contraseña usando una clave inyectada de antemano, sin tener que introducir la contraseña cada vez.
Entornos compatibles con el Agent
| Entorno | Método de instalación |
|---|---|
| Linux (apt/yum/dnf/apk) | Script con un clic, instala dependencias + autoarranque con systemd automáticamente |
| Android / Termux | Script específico (instala el Agent + se inicia con Termux) |
> ⚠️ macOS aún no es compatible: las diferencias de autenticación SSH entre versiones de macOS son grandes y no se puede garantizar una conexión estable entre versiones, por lo que esta versión no ofrece acceso por túnel para macOS. Usa dispositivos Linux / Termux para la Operación mediante túnel.
Estado en línea del Agent
- En línea: el túnel funciona correctamente y se puede operar en cualquier momento
- Sin conexión: el dispositivo se ha desconectado (apagado, red caída, Agent detenido). El registro sin conexión se conserva un tiempo y se restaura automáticamente al reconectarse
> 📌 Determinación en la tarjeta del servidor: el «en línea/sin conexión» de un dispositivo en túnel lo determina el latido del Agent. Cuando el Agent está en línea, establece dinámicamente un canal SSH a través del túnel para recoger datos de estado reales (carga/memoria/disco/tiempo en funcionamiento/batería/temperatura), igual que un servidor normal.
Advertencias
1. El Agent es el único programa que el panel necesita instalar en el dispositivo de destino (una excepción al concepto de «cero huella»). Como a los dispositivos sin IP pública no se les puede conectar activamente, solo puede ser él quien se conecte hacia fuera.
2. El Agent consume muy pocos recursos (un proceso Python + una conexión persistente).
3. El Agent transmite por un túnel cifrado, por lo que la comunicación es segura.
4. Si cambia la IP del dispositivo o el Agent deja de funcionar, basta con volver a ejecutar el script de instalación para recuperarlo.
Relación con la Penetración de puertos
La Operación mediante túnel se encarga de «conectar el dispositivo al panel», y la Penetración de puertos se encarga de «exponer a la red pública el puerto de la aplicación del dispositivo». Se combinan: primero conectas el dispositivo sin IP pública con la Operación mediante túnel y después mapeas sus aplicaciones (como Navidrome, Nextcloud) al puerto público del servidor del panel con la Penetración de puertos.