Inicia un túnel con tu cliente SSH
Plan gratuito Túneles HTTP y TCP
En esta página 11 secciones
- Cuándo usarlo
- Antes de empezar
- Pasos
- Crea un túnel HTTP o TCP
- Abre el comando SSH
- Elige si debe reconectarse
- Ejecuta el comando
- Mantén la ventana abierta
- Desde el Asistente de configuración de túneles
- El comando explicado
- Reconexión automática
- Cuánto tiempo es válido un comando
- Límites
- Qué ves en el panel
- Solución de problemas
- Mensajes en el panel
- Mensajes en el terminal
- Páginas relacionadas
Pon un servicio local en línea sin instalar Localtonet. El panel te da un comando ssh listo para usar; mientras ese comando se ejecuta, tu túnel HTTP o TCP está activo.
Cuándo usarlo #
Usa SSH sin instalación en un equipo donde no puedes o no quieres instalar el cliente de Localtonet, por ejemplo un servidor al que accedes solo un momento, un equipo de trabajo restringido o una demostración rápida. Solo necesitas el cliente ssh que viene con Windows, macOS y Linux.
El comando SSH sustituye al cliente de Localtonet para un túnel. Todo lo demás permanece en el panel: la dirección del túnel, su configuración, sus registros y su ancho de banda.
| Tipo de túnel | Comando SSH |
|---|---|
| HTTP / HTTPS | Disponible |
| TCP | Disponible |
| UDP, UDP / TCP mixto, TLS, Servidor de archivos, Servidor proxy y los demás tipos | No disponible. Estos necesitan el cliente de Localtonet. |
Esta página no trata sobre cómo acceder a un servidor SSH. Para publicar tu propio servidor SSH mediante un túnel, consulta Usar Localtonet con SSH. Para abrir una shell en uno de tus dispositivos desde el panel, consulta Terminal de dispositivos.
Antes de empezar #
- Una cuenta de Localtonet y un servicio que ya esté en ejecución, por ejemplo una aplicación web en el puerto 3000.
- Un cliente
sshen el equipo que pueda acceder al servicio. Compruébalo conssh -V. - Deben estar permitidas las conexiones TCP salientes al puerto
223en la red de ese equipo. - Un AuthToken que no use ningún cliente de Localtonet en ejecución. Un túnel siempre pertenece a un token, pero con SSH ningún cliente inicia sesión con él. Si hay un cliente conectado con el token del túnel, el panel se niega a emitir el comando.
Pasos #
-
Crea un túnel HTTP o TCP #
Abre Mis túneles › HTTP o Mis túneles › TCP - UDP (protocolo TCP) y crea el túnel como de costumbre. Dirección IP local y Puerto local son el destino al que el cliente SSH enviará el tráfico:
127.0.0.1y el puerto de tu servicio cuando ejecutas el comando en el mismo equipo que el servicio. Deja el túnel detenido. -
Abre el comando SSH #
En la lista de túneles, selecciona Configuración del túnel y luego Mostrar comando SSH. Se abre el cuadro Comando SSH con el comando de este túnel. Un aviso te indica de cuántos segundos dispones para ejecutarlo; un comando sin usar caduca y entonces solicitas uno nuevo de la misma forma.
-
Elige si debe reconectarse #
Deja desactivada la opción Reconexión automática para obtener el comando
sshsimple. Actívala para envolver el comando en un bucle que lo vuelve a iniciar cuando se corta la conexión; después elige en Dónde lo vas a ejecutar para qué shell se escribe el bucle: PowerShell, Símbolo del sistema o macOS o Linux. -
Ejecuta el comando #
Copia el texto que aparece bajo Comando. Abre un terminal en el equipo que ejecuta tu servicio, pega el comando y pulsa Enter. No se pide contraseña. Cuando la conexión está establecida, el terminal muestra los endpoints del túnel:
Terminal+--------------------------------------------------------------+ | Welcome to Localtonet! | +--------------------------------------------------------------+ | Localtonet Tunnel Endpoints | +--------------------------------------------------------------+ | HTTP => http://<YOUR_ADDRESS> => 127.0.0.1:3000 | | HTTPS => https://<YOUR_ADDRESS> => 127.0.0.1:3000 | +--------------------------------------------------------------+ | Server Time: ... | +--------------------------------------------------------------+ You can view your requests and configure your tunnel settings from the Localtonet Dashboard.Un túnel TCP muestra una sola línea en su lugar:
TCP => <YOUR_ADDRESS>:<PORT> => 127.0.0.1:<LOCAL_PORT>. -
Mantén la ventana abierta #
El túnel se inicia solo cuando el comando se conecta; no tienes que seleccionar Iniciar. Permanece en línea mientras el comando se ejecute. Al cerrar la ventana se termina la conexión y la dirección pública deja de responder. Para terminar el comando tú mismo, escribe
exity pulsa Enter, o pulsa Ctrl + C.Terminar el comando no detiene el túnel en el panel. El túnel sigue iniciado y su conexión aparece como desactivada, de modo que el mismo comando pueda volver a conectarse. Cuando termines con el túnel, selecciona Detener en el panel. El panel solo emite un comando SSH nuevo para un túnel detenido.
Desde el Asistente de configuración de túneles #
El Asistente de configuración de túneles del Panel ofrece el mismo comando. En su último paso, donde eliges tu plataforma, selecciona SSH y luego Obtener comando SSH. La opción SSH solo aparece para túneles HTTP y TCP. El asistente muestra Esperando SSH hasta que tu comando se conecta y Conectado por SSH después. Reconexión automática añade el mismo bucle de reconexión y Obtener un comando nuevo reemplaza un comando que ha caducado.
El comando explicado #
El comando siempre tiene esta forma. El panel rellena los valores de tu túnel:
ssh -o ExitOnForwardFailure=yes -o ServerAliveInterval=15 -o ServerAliveCountMax=3 -o ConnectTimeout=15 -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -o LogLevel=ERROR -p 223 -l <COMMAND_KEY> <TUNNEL_ADDRESS> -R<SERVER_PORT>:<LOCAL_IP>:<LOCAL_PORT>| Parte | Qué hace |
|---|---|
-p 223 | Se conecta al puerto 223, donde Localtonet acepta estas conexiones SSH. |
-l <COMMAND_KEY> | El nombre de inicio de sesión. Es una clave que el panel genera para este túnel; no es tu AuthToken ni la contraseña de tu cuenta. Le indica a Localtonet qué túnel iniciar, por eso no se pide contraseña. |
<TUNNEL_ADDRESS> | La dirección de tu túnel. La conexión SSH va al servidor que lo aloja. |
-R<SERVER_PORT>:<LOCAL_IP>:<LOCAL_PORT> | El reenvío remoto: las conexiones que llegan al túnel en el servidor se envían a través de la conexión SSH a <LOCAL_IP>:<LOCAL_PORT>. Los dos últimos valores son la Dirección IP local y el Puerto local del túnel. Localtonet asigna el puerto del servidor y no debe modificarse. |
-o ExitOnForwardFailure=yes | Hace que ssh termine si no se puede establecer el reenvío, en lugar de seguir conectado sin un túnel funcional. |
-o ServerAliveInterval=15 -o ServerAliveCountMax=3 | Envía un keep-alive cada 15 segundos y cierra la conexión tras tres sin respuesta, de modo que una conexión caída se detecta en unos 45 segundos. |
-o ConnectTimeout=15 | Se rinde tras 15 segundos si no se puede alcanzar el servidor. |
-o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null | Omite la pregunta sobre la clave del host y no escribe el servidor en tu archivo known_hosts. |
-o LogLevel=ERROR | Oculta los mensajes informativos de ssh. Los errores se siguen mostrando. |
Como <LOCAL_IP> se resuelve en el equipo donde ejecutas ssh, el servicio no tiene que estar en ese equipo. Con una dirección local como 192.168.1.20, el comando reenvía a otro dispositivo de la misma red.
No compartas el comando. Quien lo ejecute mientras sea válido atenderá el tráfico de tu túnel.
Reconexión automática #
Con Reconexión automática activada, el panel envuelve el mismo comando ssh en un pequeño script para la shell que elegiste. Para Símbolo del sistema, el script se entrega en una sola línea powershell -NoProfile -EncodedCommand …. El script se comporta igual en todas las shells:
- Cuando
sshtermina, espera y lo vuelve a iniciar. La espera empieza en unos 10 segundos y se duplica tras cada intento fallido, hasta unos 2 minutos. - Una conexión que duró al menos 60 segundos cuenta como un éxito y restablece el tiempo de espera.
- Tras 8 intentos seguidos que terminaron cada uno en menos de 60 segundos, se detiene e imprime
SSH reconnect stopped. If a session or bandwidth limit was reached, get a new SSH command from the panel.
La reconexión reutiliza el mismo comando. Eso funciona tras una interrupción de red, pero no después de que el túnel se haya detenido en el panel o haya alcanzado un límite; en ese caso el script se rinde y necesitas un comando nuevo.
Cuánto tiempo es válido un comando #
- Antes del primer uso: el comando debe ejecutarse dentro del tiempo que muestra el panel al emitirlo. Pasado ese tiempo, la oferta de puerto caduca.
- Mientras se usa: una sesión SSH por túnel. Una segunda copia del comando se rechaza mientras la primera esté conectada.
- Después de que la conexión terminó: el mismo comando puede volver a conectarse, siempre que el túnel no se haya detenido en el panel y no se haya alcanzado ningún límite.
- Después de una detención: cuando el túnel se detuvo en el panel o por un límite, el comando queda inservible. Abre Mostrar comando SSH de nuevo para obtener uno nuevo.
El panel solo emite un comando mientras el túnel está detenido. Un comando nuevo puede traer un puerto de servidor distinto; en el plan gratuito, cada comando nuevo recibe uno nuevo. En un túnel TCP, ese puerto forma parte de la dirección pública, así que comprueba la dirección en la salida del terminal o en la lista de túneles después de solicitar un comando nuevo. El registro de actividad del túnel anota el cambio como Server port changed to "…" for SSH.
Límites #
- Límite de sesión en el plan gratuito. Un túnel iniciado por SSH sigue la misma regla que uno iniciado con el cliente: en el plan gratuito, los túneles TCP se detienen tras 30 minutos y se pueden volver a iniciar, y los túneles HTTP no tienen límite de tiempo. Los 30 minutos se cuentan desde la primera vez que se conecta un comando; reconectar con el mismo comando no los reinicia. Cuando una sesión TCP alcanza el límite, el servidor cierra la conexión SSH con el mensaje
Session time limit reached. Get a new SSH command from the panel.Consulta Planes y saldo. - Ancho de banda. El tráfico cuenta para tu ancho de banda igual que cualquier otro tráfico de túnel. Sin ancho de banda restante no se emite ningún comando, y el servidor cierra una sesión en curso con el mensaje
Bandwidth limit reached. Get a new command after bandwidth is available. - Solo reenvío inverso. El endpoint SSH acepta el único reenvío del comando. No te da una shell en un servidor de Localtonet ni ningún otro tipo de reenvío.
- Un túnel por comando. Para ejecutar varios túneles, solicita un comando para cada uno y ejecuta cada uno en su propio terminal.
Qué ves en el panel #
Mientras el comando está conectado, el túnel aparece como iniciado y las solicitudes aparecen en sus registros como de costumbre. El Registro de actividad del túnel anota Tunnel started over SSH. cuando se conecta un comando. Consulta Registros e inspección.
Solución de problemas #
Mensajes en el panel #
| Mensaje | Qué hacer |
|---|---|
| Detén el túnel antes de solicitar un comando SSH. | El túnel se está ejecutando con el cliente de Localtonet. Deténlo y luego selecciona Mostrar comando SSH de nuevo. |
| Detén el túnel SSH actual antes de solicitar un comando nuevo. | El túnel sigue iniciado por SSH, o hace un momento había una sesión SSH activa. Termina el comando ssh en ejecución, selecciona Detener en el túnel e inténtalo de nuevo. |
| Hay un cliente conectado a este túnel con el AuthToken que creaste. Crea un AuthToken nuevo. | Un cliente de Localtonet ha iniciado sesión con el token del túnel. Detén ese cliente o crea otro token en Mis tokens y úsalo para este túnel. |
| No te queda suficiente ancho de banda para iniciar el túnel. | Has agotado tu ancho de banda. Consulta Planes y saldo. |
| Esta función no está disponible para este tipo de protocolo. | El túnel no es un túnel HTTP ni TCP. |
| Esta función no está disponible en este servidor. Mueve tu túnel a otro servidor. | El servidor de este túnel no ofrece comandos SSH. Crea el túnel en otro servidor. |
| Hay una operación de túnel en curso. Inténtalo de nuevo en unos instantes. | Espera unos segundos e inténtalo de nuevo. |
| No se pudo asignar un nuevo puerto del servidor. | Inténtalo de nuevo. Si sigue fallando, crea el túnel en otro servidor. |
| No se pudo guardar el puerto SSH. Inténtalo de nuevo. | Inténtalo de nuevo. |
Mensajes en el terminal #
Cuando el servidor cierra una sesión, envía uno de los mensajes siguientes como motivo. La forma de mostrarlo depende de tu cliente ssh.
| Mensaje o síntoma | Causa y solución |
|---|---|
ssh termina de inmediato con un error de autenticación, normalmente Permission denied | Localtonet no aceptó el comando. No se ejecutó a tiempo, el túnel se detuvo o alcanzó un límite desde que se emitió, ya hay otra sesión del mismo comando conectada, o el texto se modificó al copiarlo. Obtén un comando nuevo del panel y pégalo sin cambios. |
Port mismatch. Get a new SSH command from the panel. | El puerto del servidor después de -R no es el que asignó Localtonet. Usa el comando exactamente como se emitió. |
Session time limit reached. Get a new SSH command from the panel. | La sesión de 30 minutos de un túnel TCP en el plan gratuito terminó. Solicita un comando nuevo para empezar de nuevo. |
Bandwidth limit reached. Get a new command after bandwidth is available. | Has agotado tu ancho de banda. |
Session stopped. Get a new SSH command from the panel. | El túnel se detuvo, por ejemplo desde el panel. |
Un tiempo de espera agotado o Connection refused | El equipo no puede alcanzar el servidor en el puerto 223. Permite las conexiones TCP salientes al puerto 223 en el firewall o prueba desde otra red. |
| El túnel está activo, pero los visitantes reciben un error | ssh está conectado pero no puede acceder a tu servicio. Comprueba que el servicio esté en ejecución y que la Dirección IP local y el Puerto local del túnel sean correctos. Tras cambiarlos, solicita un comando nuevo, porque el anterior sigue conteniendo los valores antiguos. |