Crea un túnel HTTP
En esta página 10 secciones
- Antes de empezar
- Pasos
- Abre la página HTTP
- Elige el tipo de URL
- Elige el dispositivo y la región
- Introduce la dirección local
- Inicia el túnel
- Tu dirección pública
- HTTPS y certificados
- El encabezado Host
- Configuración de un túnel HTTP
- Ejemplos
- Comparte una aplicación web
- Recibe webhooks
- La página de advertencia del plan Free
- Solución de problemas
- Páginas relacionadas
Un túnel HTTP da a una aplicación web, una API o un receptor de webhooks de tu dispositivo una dirección HTTPS pública. Localtonet proporciona el certificado, así que tu servicio local puede seguir usando HTTP simple.
Antes de empezar #
- El cliente de Localtonet está instalado en el dispositivo y conectado con un AuthToken. Si no es así, sigue la Guía de inicio rápido.
- Tu servicio web está en ejecución y conoces su puerto, por ejemplo
3000. - Para Subdominio personalizado o Dominio personalizado: saldo en tu cuenta. Para Dominio personalizado también necesitas un dominio que hayas añadido en Gestor de DNS. Consulta Dominios personalizados.
Pasos #
-
Abre la página HTTP #
Abre My Tunnels › HTTP y selecciona Crear túnel HTTP para abrir el formulario.
-
Elige el tipo de URL #
Tipo de URL Dirección que obtienes Requisitos Subdominio aleatorio Un nombre generado en el dominio seleccionado, por ejemplo https://<RANDOM_NAME>.localto.net.Nada adicional Subdominio personalizado El nombre que escribes en Subdominio, por ejemplo https://myapp.localto.net. Se permiten letras, dígitos y guiones.Saldo Dominio personalizado Un dominio propio, seleccionado en Dominio. Saldo y un dominio en Gestor de DNS -
Elige el dispositivo y la región #
En Token del dispositivo, selecciona el token que usa la app de Localtonet en tu dispositivo. En Región del servidor, elige una región cercana a tu dispositivo para reducir la latencia.
-
Introduce la dirección local #
Campo Qué introducir Dominio localto.neto uno de tus propios dominios. Con Dominio personalizado, la lista solo contiene tus propios dominios.Subdominio Solo para Subdominio personalizado: el nombre que va delante del dominio. Dirección IP local Dirección del servicio en tu dispositivo. Usa 127.0.0.1para este dispositivo. El formulario acepta una dirección IPv4 o IPv6 olocalhost.Puerto local El puerto en el que escucha tu servicio local, de 1 a 65535. Selecciona Crear túnel. El túnel aparece en Tus túneles como
Tunnel #seguido de su ID. -
Inicia el túnel #
Selecciona el botón de inicio en la columna Acciones. Cuando el túnel está en marcha, su dirección en la columna URL se convierte en un enlace. Ábrelo en un navegador. Las solicitudes a esa dirección ya llegan al servicio de tu dispositivo.
Si la app de Localtonet de ese token está sin conexión, un cuadro de diálogo te lo indica. Inicia la app o selecciona Iniciar de todos modos y el túnel se activará cuando la app se conecte.
Tu dirección pública #
- La dirección es
https://seguido del nombre de host de la columna URL. - Un túnel HTTP conserva su subdominio hasta que lo eliminas. Detenerlo e iniciarlo de nuevo no lo cambia.
- La dirección no lleva número de puerto. Los visitantes la abren como cualquier otro sitio web.
- Las conexiones WebSocket pasan a través de un túnel HTTP.
HTTPS y certificados #
Los visitantes acceden a un túnel HTTP por HTTPS con un certificado que Localtonet proporciona y renueva. TLS termina en el servidor de Localtonet. Desde ahí, la solicitud viaja por el túnel hasta tu dispositivo y la app de Localtonet la entrega a tu servicio.
| Opción | Qué hace | Cuándo usarlo |
|---|---|---|
| ¿Solo HTTPS? | Sirve la URL pública solo por HTTPS. Una solicitud a http:// se redirige a la misma dirección en https://. Mientras está desactivada, la dirección responde por ambos. | Actívala para todo lo que maneje inicios de sesión o datos privados. |
| ¿HTTP/3 activo? | Permite que los clientes accedan a la URL pública por HTTP/3. Un túnel nuevo la tiene activada. | Desactívala solo si un cliente tiene problemas con HTTP/3. |
| ¿SslStream activo? | Indica a la app de Localtonet que se conecte a tu servicio local con TLS. La app acepta el certificado del servicio local tal cual, así que funciona un certificado autofirmado. | Actívala cuando tu propio servicio local use HTTPS, por ejemplo un servidor de desarrollo en https://localhost:5001. |
| ¿Conexión heredada? | Conecta el túnel con el método heredado en lugar del normal. | Pruébala si el túnel no puede conectarse con el método normal. |
Encuentras estos interruptores en Configuración, dentro del panel Configuración del túnel. Cambiar ¿SslStream activo? o ¿Conexión heredada? en un túnel en ejecución lo reinicia, por lo que la app de Localtonet debe estar conectada.
¿Necesitas cifrado hasta tu propio servicio? Con un túnel HTTP, Localtonet descifra el tráfico en su servidor. Usa un túnel TLS cuando tu servicio deba presentar su propio certificado.
El encabezado Host #
Tu servicio recibe el nombre de host que usó el visitante, que es la dirección del túnel. Algunos servidores web locales eligen el sitio según el nombre de host y responden con el sitio equivocado o con un error. En ese caso, abre Encabezados en la configuración del túnel y añade un encabezado de solicitud llamado Host con el nombre que espera tu servidor. Tu servicio recibirá entonces ese nombre de host en lugar de la dirección del túnel. Consulta Encabezados y reescrituras y Hosts virtuales.
Configuración de un túnel HTTP #
Selecciona el botón de configuración en la columna Acciones para abrir el panel Configuración del túnel. En Detalles del túnel puedes renombrar el túnel y cambiar la dirección IP local y el puerto local. La tabla enumera qué más ofrece un túnel HTTP y dónde se explica.
| Opción | Qué hace | Más información |
|---|---|---|
| Balanceo de carga | Reparte el tráfico entre dispositivos o usa un destino de respaldo. | Balanceo de carga |
| Mostrar comando SSH | Inicia este túnel con SSH simple, sin instalar la app de Localtonet. | SSH sin instalación |
| ¿Solo HTTPS?, ¿HTTP/3 activo?, ¿SslStream activo?, ¿Conexión heredada? | Cómo se conectan los visitantes y tu servicio. | Esta página, más arriba |
| ¿Reescribir ruta? | Cambia la ruta de la solicitud antes de que llegue a tu servicio local. | Encabezados y reescrituras |
| Encabezados | Gestiona los encabezados HTTP personalizados de solicitud y respuesta de este túnel. | Encabezados y reescrituras |
| Tiempo de espera HTTP | Define cuánto espera el servidor una respuesta de tu aplicación local, de 1 a 600 segundos. | Encabezados y reescrituras |
| ¿Autenticación básica? | Pide a los visitantes un nombre de usuario y una contraseña. | Control de acceso |
| Restricción de IP | Controla qué direcciones IP de cliente pueden acceder a este túnel. | Control de acceso |
| Proveedores de SSO | Los visitantes inician sesión con uno de tus proveedores de identidad antes de poder abrir el túnel. El botón SSO de la parte superior de la página gestiona los proveedores. | Inicio de sesión único |
| Botón WAF en la columna Acciones | Abre Configuración de WAF. El botón indica si el firewall de aplicaciones web no está configurado, está activo o está inactivo. | Web Application Firewall |
| Fecha de caducidad, Límites de velocidad, Límite de ancho de banda, Uso de ancho de banda, Tráfico de ancho de banda | Detén el túnel en una fecha, limita su velocidad, limita sus datos, restablece el contador de datos y consulta el tráfico a lo largo del tiempo. | Límites y caducidad |
| Registro de solicitudes, Registro de actividad, Salud del túnel | Inspecciona solicitudes, revisa inicios, paradas y cambios de configuración, y consulta las comprobaciones de estado. | Registros e inspección |
| Argumentos | Envía este túnel por una red concreta de tu dispositivo. | Selección de red |
| Puerto de salida | Usa puertos de salida fijos para la conexión de la app de Localtonet con el servidor, útil con firewalls estrictos. | Puertos |
| Nota del túnel | Guarda una nota privada que te ayude a identificar este túnel. | Referencia de configuración |
Proveedores de SSO no se muestra en un túnel que pertenece a un equipo.
Ejemplos #
Comparte una aplicación web #
Tu aplicación se ejecuta en el mismo equipo que el cliente de Localtonet y escucha en el puerto 3000.
| Campo | Valor |
|---|---|
| Tipo de URL | Subdominio aleatorio |
| Dominio | localto.net |
| Dirección IP local | 127.0.0.1 |
| Puerto local | 3000 |
Crea el túnel, inícialo y envía la dirección de la columna URL a las personas que deban ver la aplicación. Para pedirles una contraseña primero, activa ¿Autenticación básica?.
Si la aplicación se ejecuta en otra máquina de tu red, introduce la dirección de esa máquina en Dirección IP local, por ejemplo 192.168.1.20. El dispositivo que ejecuta el cliente de Localtonet debe poder alcanzarla.
Recibe webhooks #
Un proveedor de webhooks necesita una dirección HTTPS pública a la que enviar eventos. Crea un túnel HTTP hacia el puerto de tu receptor, inícialo e introduce en el proveedor la dirección del túnel más la ruta de tu endpoint:
https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH>Pruébalo desde cualquier equipo:
curl -X POST https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH> \
-H "Content-Type: application/json" \
-d '{"event":"test"}'Para ver qué ha llegado, selecciona el icono de la columna Webhooks del túnel (Ver registros de solicitudes y respuestas). Primero debes iniciar el túnel. Consulta Registros e inspección.
En el plan Free, añade saldo antes de depender de los webhooks. Las solicitudes a un túnel HTTP de una cuenta Free reciben primero una página de advertencia, y un proveedor de webhooks no puede hacer clic para superarla. Consulta la sección siguiente.
La página de advertencia del plan Free #
Cuando una cuenta no tiene saldo, un visitante nuevo de su túnel HTTP ve una página de Localtonet titulada "You are about to navigate to:" con los botones Cancel y Visit Site. La página está ahí para disuadir el uso indebido. Visit Site guarda una cookie en el navegador del visitante y abre tu sitio. Mientras el navegador conserve esa cookie, no se le vuelve a preguntar.
La propia página indica las dos formas de quitarla:
- Envía un encabezado de solicitud llamado
localtonet-skip-warningcon cualquier valor. Es adecuado para tus propios scripts y clientes de API. - Añade saldo a tu cuenta. Consulta Planes y saldo.
curl -H "localtonet-skip-warning: 1" https://<YOUR_SUBDOMAIN>.localto.net/Solución de problemas #
El cuadro de diálogo dice que el token está sin conexión, o aparece "La app de Localtonet del AuthToken … no está conectada."
El cliente de Localtonet que usa el token de este túnel no está en ejecución o no puede alcanzar Localtonet. Inicia el cliente en el dispositivo con el mismo token. El cuadro de diálogo inicia el túnel por sí mismo en cuanto la app se conecta. Con Iniciar de todos modos el túnel se activa y se pone en marcha más tarde.
"Inicia o actualiza la app de Localtonet."
No se pudo iniciar el túnel en el dispositivo. Comprueba que el cliente esté en ejecución e instala la versión actual desde la página de Descargas si la tuya es antigua.
El navegador muestra "Tunnel Recently Started or Stopped"
La solicitud llegó a Localtonet, pero el túnel no acepta conexiones. El túnel acaba de iniciarse o está detenido. Comprueba que esté iniciado y que la columna Conexión muestre Sí, y recarga la página.
El navegador muestra una página de error de Localtonet que nombra mi dirección local
La página dice que el tráfico se envió por túnel al agente de Localtonet, pero el agente no pudo conectarse al servicio de origen en tu IP y puerto locales. El encabezado es el error, por ejemplo ConnectionRefused. No hay nada escuchando en esa dirección. Inicia tu servicio y luego comprueba la dirección IP local y el puerto local en Detalles del túnel. Puedes probar el servicio en el propio dispositivo abriendo la dirección local en un navegador.
"Necesitas comprar saldo para usar esta función."
Subdominio personalizado y Dominio personalizado requieren saldo. Usa Subdominio aleatorio o añade saldo en Saldo.
"You need a total balance of … to create another tunnel of this type."
Tu saldo no cubre otro túnel. En el plan Free solo puedes crear un túnel en total, sea cual sea su tipo. Elimina tu túnel existente antes de crear otro, o añade saldo.
"… ya existe." o "… no está permitido."
Otro túnel usa ese subdominio, o Localtonet reserva el nombre. Elige un subdominio distinto.
"¡ATENCIÓN! No tienes ningún dominio."
Elegiste Dominio personalizado pero aún no has añadido ningún dominio. Añádelo primero en Gestor de DNS. Si ves "… ya lo usa otro túnel.", ese dominio ya pertenece a uno de tus túneles. Un dominio personalizado solo puede servir a un túnel.
"Actualiza el límite de ancho de banda o borra el uso de ancho de banda." o "Actualiza la fecha de caducidad."
El túnel alcanzó su propio límite de ancho de banda o su fecha de caducidad y no puede iniciarse. Cambia el límite o la fecha en la configuración del túnel, o restablece el contador con Uso de ancho de banda. Consulta Límites y caducidad.
"Comprueba la conexión del dispositivo."
Cambiaste un ajuste que reinicia un túnel en ejecución mientras la app de Localtonet estaba sin conexión. Conecta la app y guarda el ajuste de nuevo, o detén primero el túnel.
Mi aplicación responde con el sitio equivocado o genera enlaces y redirecciones http://
Tu aplicación decide según el nombre de host o el esquema que recibe. En Encabezados, añade un encabezado de solicitud Host si la aplicación espera un nombre de host fijo. Añade un encabezado de solicitud X-Forwarded-Proto con el valor https para indicar a la aplicación que los visitantes usan HTTPS, de modo que genere enlaces y redirecciones con https://.