Referencia de configuración de túneles
En esta página 15 secciones
- Abre la configuración de un túnel
- Abre la página del tipo de túnel
- Selecciona Configuración en la fila del túnel
- Cambia un ajuste
- Cómo se aplican los cambios
- Qué ajuste tiene cada tipo de túnel
- Qué hace cada ajuste
- Detalles del túnel
- Nota del túnel
- ¿SslStream activo?
- ¿Protocolo PROXY?
- ¿Conexión heredada?
- IP del servidor local
- IP del túnel
- Ajustes en la lista de túneles
- Cambiar el servidor
- Cambiar el AuthToken
- Firewall de aplicaciones web
- Los mismos ajustes mediante la API
- Solución de problemas
- Páginas relacionadas
Cada túnel tiene un panel de configuración en el dashboard. Esta página muestra dónde abrirlo, enumera cada ajuste, indica qué tipos de túnel lo tienen y enlaza a la página que lo explica en detalle.
Abre la configuración de un túnel #
-
Abre la página del tipo de túnel #
En el menú del dashboard, abre Mis túneles y elige el tipo: Mis túneles › HTTP, TCP - UDP, TLS, Servidor de archivos, Servidor proxy, Proxy rotativo o Gateway MCP.
-
Selecciona Configuración en la fila del túnel #
Busca el túnel en Tus túneles y selecciona Configuración en la columna Acciones. El panel Configuración del túnel se abre a un lado de la página.
-
Cambia un ajuste #
El panel tiene estas partes:
- Detalles del túnel: datos como la dirección del túnel, la fecha de creación y el nombre del AuthToken, además de los valores que puedes editar seleccionándolos: el título en todos los tipos de túnel y, en los túneles HTTP, TCP - UDP y TLS, también la dirección local y el puerto local.
- Los destinos de balanceo de carga del túnel, en los tipos de túnel que los admiten. Consulta Balanceo de carga.
- Mostrar comando SSH, en los tipos de túnel que se pueden iniciar con SSH simple. Consulta SSH sin instalación.
- Configuración: una fila por ajuste. Cada fila tiene un interruptor Sí / No o un botón (Gestionar, Cambiar, Mostrar o Borrar) que abre un cuadro de diálogo. El icono de información junto a una etiqueta explica el ajuste en una frase.
La mayoría de los interruptores te piden confirmar antes de cambiar nada, por ejemplo ¿Activar solo HTTPS? con los botones Activar y Cancelar. Al activar ¿Autenticación básica? o ¿Reescribir ruta? se abre un cuadro de diálogo, y al activar ¿Puerto reservado? en un túnel en ejecución, el puerto se reserva sin preguntar.
Cómo se aplican los cambios #
Algunos ajustes se aplican a un túnel en ejecución sin interrumpirlo. Otros detienen el túnel y lo vuelven a iniciar con el nuevo valor, lo que tarda un momento y corta las conexiones abiertas.
| Se aplica sin reiniciar | Reinicia un túnel en ejecución |
|---|---|
| ¿Solo HTTPS?, ¿Reescribir ruta?, ¿HTTP/3 activo?, ¿Puerto reservado?, Encabezados, Tiempo de espera HTTP, Nota del túnel, Restricción de IP, Fecha de caducidad, Puerto de salida, Límite de ancho de banda, Uso de ancho de banda, el interruptor de WAF | El título, la dirección local y el puerto local en Detalles del túnel, ¿Autenticación básica?, ¿SslStream activo?, ¿Protocolo PROXY?, ¿Conexión heredada?, Puerto del servidor, Argumentos, IP del servidor local, Límites de velocidad, el cambio de servidor y el cambio de AuthToken |
Un ajuste que reinicia el túnel solo se puede guardar en un túnel en ejecución mientras la app de Localtonet de su dispositivo esté conectada. De lo contrario, el dashboard responde "Comprueba la conexión del dispositivo." y conserva el valor anterior. En un túnel detenido, el valor se guarda y se usa en el siguiente inicio.
Qué ajuste tiene cada tipo de túnel #
Las etiquetas son las que muestra la sección Configuración. "Sí" significa que el tipo de túnel tiene esa fila.
| Ajuste | HTTP | TCP - UDP | TLS | Servidor de archivos | Servidor proxy | Proxy rotativo | Gateway MCP |
|---|---|---|---|---|---|---|---|
| ¿Solo HTTPS? | Sí | – | – | – | – | – | Sí |
| ¿Reescribir ruta? | Sí | – | – | – | – | – | – |
| ¿Autenticación básica? | Sí | – | – | Sí, de tipo Default | – | – | Sí |
| ¿SslStream activo? | Sí | Sí, no para UDP | Sí | – | – | – | – |
| ¿HTTP/3 activo? | Sí | – | – | – | – | – | Sí |
| ¿Puerto reservado? | – | Sí | – | – | Sí | Sí | – |
| ¿Protocolo PROXY? | – | Sí, no para UDP | – | – | – | – | – |
| ¿Conexión heredada? | Sí | Sí | Sí | Sí | Sí | – | Sí |
| Modo SSL | – | – | Sí | – | – | – | – |
| Proveedores de SSO | Sí, no en túneles de equipo | – | – | – | – | – | – |
| Token del gateway | – | – | – | – | – | – | Sí |
| Encabezados | Sí | – | – | – | – | – | – |
| Tiempo de espera HTTP | Sí | – | – | – | – | – | Sí |
| Puerto del servidor | – | Sí | – | – | Sí, no para VLESS | Sí | – |
| Nota del túnel | Sí | Sí | Sí | Sí | Sí | Sí | Sí |
| IP del servidor local | Solo servidor local | Solo servidor local | Solo servidor local | – | Solo servidor local | – | Solo servidor local |
| Argumentos | Sí | Sí | Sí | – | Sí | – | – |
| Restricción de IP | Sí | Sí | Sí | Sí | Sí | Sí | Sí |
| Fecha de caducidad | Sí | Sí | Sí | Sí | Sí | – | Sí |
| Límites de velocidad | Sí | Sí | Sí | Sí | Sí | – | Sí |
| Puerto de salida | Sí | Sí | Sí | Sí | Sí | Sí | Sí |
| Límite de ancho de banda | Sí | Sí | Sí | Sí | Sí | – | Sí |
| Tráfico de ancho de banda | Sí | Sí | Sí | Sí | Sí | Sí | Sí |
| Uso de ancho de banda | Sí | Sí | Sí | Sí | Sí | – | Sí |
| IP del túnel | – | Sí | Sí | – | Sí | Sí | – |
| Registro de solicitudes | Sí | Sí | Sí | Sí | Sí | – | Sí |
| Registro de actividad | Sí | Sí | Sí | Sí | Sí | Sí | Sí |
| Salud del túnel | Sí | Sí | Sí | – | Sí | Sí | Sí |
Las páginas de Servidor proxy y Proxy rotativo tienen más filas propias, como Autenticación del proxy, Control de acceso, Proxy upstream, Acceso VPN, Test de velocidad, Token del túnel y ¿Solo IPv4?. Se describen en Servidor proxy y Proxy rotativo. Un túnel que usa el servidor Local no tiene fila Puerto de salida. "Solo servidor local" también incluye un túnel cuya columna Servidor muestra VPN.
Qué hace cada ajuste #
| Ajuste | Qué hace | Detalles |
|---|---|---|
| ¿Solo HTTPS? | Sirve la URL pública solo por HTTPS. | Encabezados y reescrituras |
| ¿Reescribir ruta? | Añade una ruta delante de cada solicitud antes de que llegue a tu servicio local. | Encabezados y reescrituras |
| ¿Autenticación básica? | Pide a los visitantes un nombre de usuario y una contraseña. | Control de acceso |
| ¿SslStream activo? | Indica al túnel que tu propio servicio local usa HTTPS o TLS. | Esta página |
| ¿HTTP/3 activo? | Permite a los clientes acceder a la URL pública por HTTP/3. | Encabezados y reescrituras |
| ¿Puerto reservado? | Mantiene el mismo puerto del servidor cuando el túnel se reinicia. | Puertos |
| ¿Protocolo PROXY? | Pasa la dirección original del cliente a tu servicio en una cabecera del protocolo PROXY. | Esta página |
| ¿Conexión heredada? | Un método de conexión alternativo para probar cuando el túnel no puede conectarse con el normal. | Esta página |
| Modo SSL | Elige si Localtonet gestiona el HTTPS de un túnel TLS o deja pasar el tráfico cifrado hasta tu servicio. | TLS |
| Proveedores de SSO | Obliga a los visitantes a iniciar sesión con uno de tus proveedores de identidad antes de poder abrir el túnel. | Inicio de sesión único |
| Token del gateway | Muestra el token que tus clientes MCP envían para conectarse al gateway. | Gateway MCP |
| Encabezados | Añade encabezados fijos de solicitud y de respuesta. | Encabezados y reescrituras |
| Tiempo de espera HTTP | Define cuánto espera el túnel a que tu servicio responda a una solicitud. | Encabezados y reescrituras |
| Puerto del servidor | Cambia el puerto al que se conecta la gente en el servidor de Localtonet. | Puertos |
| Nota del túnel | Un recordatorio privado de para qué sirve el túnel. | Esta página |
| IP del servidor local | Las direcciones en las que se puede acceder a tu servidor local. | Esta página |
| Argumentos | Envía el túnel por una red concreta del dispositivo. | Selección de red |
| Restricción de IP | Elige qué direcciones IP pueden conectarse al túnel. | Control de acceso |
| Fecha de caducidad | Detiene el túnel en una fecha determinada. | Límites y caducidad |
| Límites de velocidad | Limita la velocidad de subida y de descarga. | Límites y caducidad |
| Puerto de salida | Mantiene fijos los puertos por los que la app de Localtonet se conecta hacia fuera, para firewalls estrictos. | Puertos |
| Límite de ancho de banda | Detiene el túnel después de que haya movido una cantidad determinada de datos. | Límites y caducidad |
| Tráfico de ancho de banda | Muestra en gráficos los datos que han pasado por el túnel. | Límites y caducidad |
| Uso de ancho de banda | Pone a cero el contador de datos del túnel. | Límites y caducidad |
| IP del túnel | Muestra las direcciones IP del servidor en el que se ejecuta el túnel. | Esta página |
| Registro de solicitudes | Muestra las solicitudes o conexiones registradas para el túnel. | Registros e inspección |
| Registro de actividad | Enumera los inicios, las paradas y los cambios de configuración. | Registros e inspección |
| Salud del túnel | Muestra los resultados de las comprobaciones de salud periódicas. | Registros e inspección |
Detalles del túnel #
Selecciona un valor en Detalles del túnel para editarlo. Al guardar cualquiera de los tres, se reinicia un túnel en ejecución. La dirección local y el puerto local se pueden editar aquí en los túneles HTTP, TCP - UDP y TLS; los demás tipos de túnel solo muestran el título.
| Cuadro de diálogo | Qué introducir | Reglas |
|---|---|---|
| Renombrar túnel | Un nombre que reconozcas en tu lista de túneles, por ejemplo "NAS de la oficina". | Obligatorio. Hasta 30 caracteres: el cuadro cuenta hasta 100, pero un título de más de 30 se rechaza con "El título no puede superar los 30 caracteres." |
| Dirección local | Dónde encuentra la app de Localtonet tu servicio. Usa 127.0.0.1 cuando el servicio se ejecuta en el mismo dispositivo que la app. Para llegar a otro dispositivo de tu red, introduce su dirección, por ejemplo 192.168.1.20. | Una dirección IPv4, una dirección IPv6 o un nombre de host. Sin http://, sin ruta, sin puerto. |
| Puerto local | El puerto en el que escucha tu servicio, en el dispositivo que lo ejecuta. | Un número del 1 al 65535. |
Nota del túnel #
Nota del túnel › Gestionar abre el cuadro de diálogo Nota. Una nota es un recordatorio de para qué sirve el túnel, y solo la ve tu cuenta.
- Una nota puede tener hasta 499 caracteres. El cuadro los cuenta mientras escribes.
- Las opciones de Etiqueta ponen una etiqueta delante de la nota: Producción, Staging, Pruebas, Demo o Temporal. Entonces la nota empieza, por ejemplo, con
Staging -. Si eliges otra etiqueta, sustituye a la que ya había.
¿SslStream activo? #
Activa ¿SslStream activo? cuando tu propio servicio local usa HTTPS o TLS, por ejemplo un servidor de desarrollo que solo escucha en https://localhost. Déjalo desactivado para un servicio que habla HTTP simple o TCP simple. Los túneles HTTP, TCP y TLS tienen el interruptor; un túnel UDP no.
¿Protocolo PROXY? #
Con ¿Protocolo PROXY? activado, el túnel pasa la dirección original del cliente a tu servicio en una cabecera del protocolo PROXY. Actívalo solo cuando tu servicio esté configurado para leer esa cabecera, porque un servicio que no la espera ve bytes desconocidos al principio de cada conexión. Los túneles TCP tienen el interruptor; un túnel UDP no.
¿Conexión heredada? #
¿Conexión heredada? cambia el túnel a un método de conexión alternativo. Pruébalo si el túnel no puede conectarse con el método normal y vuelve a desactivarlo si no ayuda.
IP del servidor local #
Esta fila aparece solo en los túneles cuya columna Servidor muestra Local o VPN. El cuadro IP del servidor local contiene las direcciones en las que se puede acceder a tu servidor local: una Dirección IPv4 y, opcionalmente, una Dirección IPv6. Deja IPv6 vacía si no la usas. Se requiere al menos una dirección. Una dirección que solo funciona en el propio dispositivo, como 127.0.0.1, 0.0.0.0 o ::1, se rechaza con "La IP del servidor local debe ser accesible desde fuera."
IP del túnel #
IP del túnel › Mostrar abre el cuadro IP del servidor con la dirección IPv4 y, si el servidor la tiene, la IPv6 del servidor en el que se ejecuta el túnel. Los clientes pueden conectarse al túnel con esta dirección en lugar del nombre de dominio.
Las direcciones IP de los servidores pueden cambiar. Usa el nombre de dominio en apps y scripts siempre que puedas.
Ajustes en la lista de túneles #
Dos ajustes se cambian desde la lista de túneles, no desde el panel.
Cambiar el servidor #
Selecciona el código del servidor en la columna Servidor, elige otro servidor en el cuadro Cambiar servidor y selecciona Enviar. Un túnel en ejecución se reinicia en el nuevo servidor.
- Cambiar el servidor requiere saldo (Balance). Sin él, el dashboard responde "Necesitas comprar saldo para usar esta función."
- Si el puerto del servidor del túnel ya está ocupado en el nuevo servidor, recibes "El puerto de tu túnel (PORT) no está disponible en el servidor seleccionado. Cambia primero el puerto." Cambia el puerto como se describe en Puertos y vuelve a intentarlo.
- Los túneles cuya columna Servidor muestra Local o VPN no se pueden mover.
Cuando se cambia de servidor, las actualizaciones de DNS pueden tardar hasta 3 horas.
Cambiar el AuthToken #
Selecciona el nombre del token en la columna AuthToken para abrir Cambiar AuthToken, elige otro AuthToken y selecciona Enviar. Esto mueve el túnel al dispositivo que ejecuta la app de Localtonet con ese token.
- Un túnel en ejecución se detiene, espera 2 segundos y se reinicia con el AuthToken seleccionado. Un túnel detenido permanece detenido.
- Si la app con el nuevo token no está conectada, el token se cambia igualmente y recibes "El AuthToken se actualizó, pero no se pudo reiniciar el túnel. Conecta la app de Localtonet con el token seleccionado e inicia el túnel."
- Los túneles de Proxy rotativo usan grupos de AuthToken. Cambia los grupos en su lugar.
Los AuthToken se explican en AuthTokens.
Firewall de aplicaciones web #
Los túneles HTTP y de Gateway MCP también tienen un botón con forma de escudo en la columna Acciones. Abre el firewall del túnel. Consulta Firewall de aplicaciones web.
Los mismos ajustes mediante la API #
La mayoría de los ajustes también se pueden leer y cambiar con la API, bajo la ruta del túnel. La autenticación y la referencia completa están en API.
| Ajuste | Ruta tras /api/v2/tunnels/<TUNNEL_ID>/ |
|---|---|
| Restricción de IP | ip-restrictions |
| Encabezados | headers, host-header |
| Autenticación básica | authentication |
| Fecha de caducidad | expiration |
| Puerto del servidor | server-port |
| Tiempo de espera HTTP | http-timeout |
| Límites de velocidad | rate-limit |
| Límite de ancho de banda y uso | bandwidth-limit, bandwidth-usage, bandwidth-usage/reset |
| Argumentos | arguments |
| ¿Solo HTTPS?, ¿HTTP/3 activo?, ¿Reescribir ruta? | https-only, http3, path-rewrite |
| ¿SslStream activo?, ¿Protocolo PROXY?, Modo SSL | ssl-stream, proxy-protocol, pass-through |
| Nota del túnel | note |
| Servidor | server |
Solución de problemas #
"Comprueba la conexión del dispositivo."
El ajuste reinicia el túnel y la app de Localtonet del dispositivo del túnel no está conectada. Inicia la app en el dispositivo, espera hasta que la columna Conexión muestre SÍ y guarda de nuevo. También puedes detener primero el túnel: en un túnel detenido, el valor se guarda sin reinicio.
"Necesitas comprar saldo para usar esta función."
El ajuste requiere saldo (Balance) en la cuenta. Esto se aplica a los puertos reservados, a un puerto de servidor personalizado, a los puertos de salida fijos, a las restricciones de IP y al cambio de servidor. Consulta Planes y saldo.
"No tienes permiso para actualizar este túnel."
Trabajas en un equipo y tu rol no incluye cambiar túneles. Pide al propietario del equipo que te dé ese permiso. Consulta Gestión de equipos.
Falta una fila de la tabla en mi panel
El panel solo muestra las filas del tipo del túnel, y algunas filas dependen del propio túnel: IP del servidor local requiere el servidor Local o VPN, Proveedores de SSO no se muestra en los túneles de equipo, y un túnel UDP no tiene ¿SslStream activo? ni ¿Protocolo PROXY?.