Saltar al contenido
Localtonet Localtonet Panel

Crea un túnel HTTP

Ayuda con esta página
En esta página 10 secciones
  1. Antes de empezar
  2. Pasos
  3. Abre la página HTTP
  4. Elige el tipo de URL
  5. Elige el dispositivo y la región
  6. Introduce la dirección local
  7. Inicia el túnel
  8. Tu dirección pública
  9. HTTPS y certificados
  10. El encabezado Host
  11. Configuración de un túnel HTTP
  12. Ejemplos
  13. Comparte una aplicación web
  14. Recibe webhooks
  15. La página de advertencia del plan Free
  16. Solución de problemas
  17. 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 #

  1. Abre la página HTTP #

    Abre My Tunnels › HTTP y selecciona Crear túnel HTTP para abrir el formulario.

  2. Elige el tipo de URL #

    Tipo de URLDirección que obtienesRequisitos
    Subdominio aleatorioUn nombre generado en el dominio seleccionado, por ejemplo https://<RANDOM_NAME>.localto.net.Nada adicional
    Subdominio personalizadoEl nombre que escribes en Subdominio, por ejemplo https://myapp.localto.net. Se permiten letras, dígitos y guiones.Saldo
    Dominio personalizadoUn dominio propio, seleccionado en Dominio.Saldo y un dominio en Gestor de DNS
  3. 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.

  4. Introduce la dirección local #

    CampoQué introducir
    Dominiolocalto.net o uno de tus propios dominios. Con Dominio personalizado, la lista solo contiene tus propios dominios.
    SubdominioSolo para Subdominio personalizado: el nombre que va delante del dominio.
    Dirección IP localDirección del servicio en tu dispositivo. Usa 127.0.0.1 para este dispositivo. El formulario acepta una dirección IPv4 o IPv6 o localhost.
    Puerto localEl 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.

  5. 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ónQué haceCuá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ónQué haceMás información
Balanceo de cargaReparte el tráfico entre dispositivos o usa un destino de respaldo.Balanceo de carga
Mostrar comando SSHInicia 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
EncabezadosGestiona los encabezados HTTP personalizados de solicitud y respuesta de este túnel.Encabezados y reescrituras
Tiempo de espera HTTPDefine 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 IPControla qué direcciones IP de cliente pueden acceder a este túnel.Control de acceso
Proveedores de SSOLos 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 AccionesAbre 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 bandaDeté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únelInspecciona solicitudes, revisa inicios, paradas y cambios de configuración, y consulta las comprobaciones de estado.Registros e inspección
ArgumentosEnvía este túnel por una red concreta de tu dispositivo.Selección de red
Puerto de salidaUsa puertos de salida fijos para la conexión de la app de Localtonet con el servidor, útil con firewalls estrictos.Puertos
Nota del túnelGuarda 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.

CampoValor
Tipo de URLSubdominio aleatorio
Dominiolocalto.net
Dirección IP local127.0.0.1
Puerto local3000

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:

URL del webhook
https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH>

Pruébalo desde cualquier equipo:

Terminal
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-warning con cualquier valor. Es adecuado para tus propios scripts y clientes de API.
  • Añade saldo a tu cuenta. Consulta Planes y saldo.
Terminal
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://.

Soporte