Saltar al contenido
Localtonet Localtonet Panel

Encabezados, reescritura de ruta y opciones HTTP

Ayuda con esta página
En esta página 11 secciones
  1. Antes de empezar
  2. Encabezados HTTP
  3. Añadir un encabezado
  4. Elige el tipo de encabezado
  5. Añade el encabezado
  6. Guarda
  7. Conjuntos predefinidos
  8. Encabezados sugeridos
  9. Reglas
  10. Encabezado Host
  11. Reescribir ruta
  12. Cambia ¿Reescribir ruta? a Sí
  13. Introduce la ruta que se añade
  14. Guarda
  15. Tiempo de espera HTTP
  16. ¿Solo HTTPS?
  17. ¿HTTP/3 activo?
  18. Ejemplos
  19. Permitir que una aplicación web de otro sitio llame a tu API
  20. Publicar una aplicación que vive bajo una subruta
  21. Los mismos ajustes mediante la API
  22. Solución de problemas
  23. Páginas relacionadas

Cambia cómo pasan las solicitudes y respuestas HTTP por un túnel: añade encabezados fijos, define el encabezado Host que recibe tu servicio, pon una ruta delante de cada solicitud, ajusta el tiempo de espera de las solicitudes y elige solo HTTPS o HTTP/3 para la dirección pública.

Antes de empezar #

  • Un túnel HTTP. Consulta HTTP / HTTPS.
  • Los ajustes están en el panel de configuración del túnel: abre Mis túneles › HTTP y selecciona Configuración en la fila del túnel.
AjusteHTTPGateway MCP
EncabezadosSí–
¿Reescribir ruta?Sí–
Tiempo de espera HTTPSíSí
¿Solo HTTPS?SíSí
¿HTTP/3 activo?SíSí

Ninguno de estos ajustes reinicia el túnel. Un cambio se aplica al túnel en ejecución en cuanto lo guardas.

Encabezados HTTP #

Encabezados › Gestionar abre el cuadro de diálogo Encabezados HTTP. Añade encabezados fijos al tráfico que pasa por el túnel:

  • Los Encabezados de solicitud llegan a tu servicio local con cada solicitud.
  • Los Encabezados de respuesta llegan al visitante con cada respuesta.

Los valores se envían exactamente como los escribes.

Añadir un encabezado #

  1. Elige el tipo de encabezado #

    Selecciona Encabezados de solicitud o Encabezados de respuesta en la parte superior del cuadro de diálogo. Cada pestaña muestra cuántos encabezados contiene.

  2. Añade el encabezado #

    Selecciona Añadir encabezado y rellena Nombre y Valor, o selecciona un nombre en Sugerencias para obtener una fila con un valor inicial razonable. Para un encabezado que el cuadro de diálogo conoce, el icono de información de la fila explica qué hace.

  3. Guarda #

    Selecciona Guardar. Para quitar un encabezado, selecciona el botón de quitar de su fila y luego Guardar.

Conjuntos predefinidos #

En la pestaña Encabezados de respuesta, los Conjuntos predefinidos añaden un grupo de encabezados de una sola vez. Entonces el cuadro de diálogo dice "Se ha añadido NAME. Revisa los valores y guarda." Un conjunto rellena un encabezado que ya está en la lista solo si su valor está vacío.

ConjuntoEncabezados que añadeÚsalo para
Permitir CORS
  • Access-Control-Allow-Origin: *
  • Access-Control-Allow-Methods: GET, POST, PUT, PATCH, DELETE, OPTIONS
  • Access-Control-Allow-Headers: Content-Type, Authorization
Permite que aplicaciones web de otros sitios llamen a este túnel.
Encabezados de seguridad
  • Strict-Transport-Security: max-age=31536000; includeSubDomains
  • X-Content-Type-Options: nosniff
  • X-Frame-Options: SAMEORIGIN
  • Referrer-Policy: strict-origin-when-cross-origin
HSTS, nosniff, protección frente a frames y política de referrer.
Desactivar cachéCache-Control: no-storeEvita que los navegadores y los proxies guarden las respuestas en caché.
Ocultar a los buscadoresX-Robots-Tag: noindex, nofollowPide a los buscadores que no incluyan esta dirección.

Encabezados sugeridos #

EncabezadoTipoQué dice el cuadro de diálogo al respecto
HostSolicitudTu servicio recibe este nombre de host en lugar de la dirección del túnel. Útil cuando un servidor web local elige el sitio por el nombre de host.
AuthorizationSolicitudEnvía las mismas credenciales a tu servicio con cada solicitud.
X-API-KeySolicitudUna clave fija para servicios que esperan una en un encabezado.
X-Forwarded-ProtoSolicitudIndica a tu aplicación que los visitantes usan HTTPS, para que construya enlaces y redirecciones con https://.
OriginSolicitudAlgunos servicios solo aceptan solicitudes de un origen conocido.
Access-Control-Allow-OriginRespuestaQué sitios web pueden llamar a este túnel desde un navegador. * permite cualquier sitio.
Access-Control-Allow-CredentialsRespuestaPermite que los navegadores envíen cookies. No funciona junto con Access-Control-Allow-Origin: *.
Strict-Transport-SecurityRespuestaIndica a los navegadores que usen siempre HTTPS para esta dirección.
X-Frame-OptionsRespuestaImpide que otros sitios muestren tus páginas en un frame.
Content-Security-PolicyRespuestaControla desde dónde pueden cargar las páginas scripts, estilos e imágenes. Una política estricta puede romper páginas, así que pruébala.
Cache-ControlRespuestano-store evita que los navegadores y los proxies guarden las respuestas en caché.
X-Robots-TagRespuestaPide a los buscadores que no incluyan esta dirección.

Las sugerencias incluyen también User-Agent, Accept-Language y Cache-Control para las solicitudes, y Access-Control-Allow-Methods, Access-Control-Allow-Headers, X-Content-Type-Options, Referrer-Policy y Permissions-Policy para las respuestas. También puedes escribir cualquier otro nombre de encabezado.

Reglas #

  • Los nombres de encabezado pueden usar letras, números y guiones, por ejemplo X-Api-Key, y pueden tener hasta 256 caracteres.
  • Un nombre puede aparecer una vez por pestaña. Una segunda fila con el mismo nombre se rechaza con "NAME ya está en esta lista."
  • Una fila necesita un nombre. Una fila vacía se ignora al guardar.

Encabezado Host #

De forma predeterminada, tu servicio recibe la dirección del túnel como nombre de host de una solicitud. Para enviar otro nombre de host, añade el encabezado de solicitud Host en el cuadro de diálogo Encabezados HTTP y pon como valor el nombre que espera tu servicio, por ejemplo localhost o shop.internal.

Úsalo cuando un servidor web local elige el sitio por el nombre de host, como un host virtual de Apache o nginx, IIS con enlaces de host, o un servidor de desarrollo que solo responde a localhost. Consulta Hosts virtuales para ver un ejemplo completo.

Reescribir ruta #

Una reescritura de ruta añade una ruta delante de cada solicitud antes de que llegue a tu servicio local. Los visitantes siguen usando la dirección corta.

  1. Cambia ¿Reescribir ruta? a Sí #

    Se abre el cuadro de diálogo Reescribir ruta.

  2. Introduce la ruta que se añade #

    Escríbela en Ruta que se añade, por ejemplo /api o /app/v2, o selecciona una de las Rutas habituales. La ruta empieza con una barra; si omites la barra, se añade por ti. El cuadro Ejemplo muestra el resultado para una solicitud de muestra.

  3. Guarda #

    Selecciona Guardar.

Con /api como ruta:

El visitante abreTu servicio recibe
https://<YOUR_TUNNEL_ADDRESS>/orders?id=7/api/orders?id=7

Un túnel tiene una sola ruta, de hasta 200 caracteres. No puede contener espacios ni ser solo /. Para quitarla, cambia ¿Reescribir ruta? a No y confirma ¿Desactivar la reescritura de ruta?: la ruta guardada se elimina y las solicitudes llegan a tu servicio con su ruta original.

Tiempo de espera HTTP #

Tiempo de espera HTTP › Gestionar abre el cuadro de diálogo Tiempo de espera HTTP. El tiempo de espera es lo que el túnel aguarda a que tu servicio responda a una solicitud. Pasado ese tiempo, el visitante recibe un error de tiempo de espera agotado.

ElementoValores
Tiempo de esperaUn número entero de 1 a 600 segundos. Déjalo vacío para usar el valor predeterminado del servidor.
Valores predefinidosPredeterminado del servidor, 30 s, 1 min, 2 min, 5 min, 10 min

Aumenta el tiempo de espera para informes lentos, subidas grandes o long polling. Elige Predeterminado del servidor para volver al valor estándar.

¿Solo HTTPS? #

Cambia ¿Solo HTTPS? a Sí y confirma ¿Activar solo HTTPS? para servir la URL pública únicamente por HTTPS. Úsalo para todo lo que lleve inicios de sesión o datos personales, de modo que nadie llegue al túnel por HTTP sin cifrar.

¿HTTP/3 activo? #

Cambia ¿HTTP/3 activo? a Sí para que los clientes puedan acceder a la URL pública por HTTP/3. Los clientes que no admiten HTTP/3 siguen usando las versiones anteriores de HTTP.

Ejemplos #

Permitir que una aplicación web de otro sitio llame a tu API #

Tu front end se ejecuta en https://app.example.com y llama a una API detrás de un túnel. Abre Encabezados › Gestionar, ve a Encabezados de respuesta y selecciona Permitir CORS. Sustituye el * de Access-Control-Allow-Origin por https://app.example.com si solo ese sitio puede llamar a la API, y luego selecciona Guardar.

Publicar una aplicación que vive bajo una subruta #

Tu servidor de aplicaciones sirve la aplicación bajo /app/v2 y quieres que los visitantes abran la dirección simple del túnel. Activa ¿Reescribir ruta? e introduce /app/v2. Un visitante que abre /login llega a /app/v2/login en tu servicio.

Los mismos ajustes mediante la API #

Estos ajustes también están disponibles en /api/v2/tunnels/<TUNNEL_ID>/: headers, host-header, path-rewrite, http-timeout, https-only y http3. Consulta API.

Solución de problemas #

"Los nombres de encabezado pueden usar letras, números y guiones, por ejemplo X-Api-Key."

El nombre contiene un carácter que no se permite en un nombre de encabezado, como un espacio o dos puntos. Introduce solo el nombre en Nombre y el resto en Valor.

"Añade un nombre para este encabezado o quita la fila."

Una fila tiene valor pero no nombre. Rellena el nombre o quita la fila.

"Introduce solo la ruta, sin http:// ni el nombre de host."

Ruta que se añade admite una ruta como /api, no una URL completa.

"Introduce un número entero de 1 a 600 o elige Predeterminado del servidor."

El tiempo de espera debe estar entre 1 y 600 segundos. Para un trabajo más largo, responde primero a la solicitud y deja que el cliente consulte el resultado más tarde.

Mi encabezado CORS no funciona con cookies

Access-Control-Allow-Credentials no funciona junto con Access-Control-Allow-Origin: *. Establece Access-Control-Allow-Origin con el origen exacto del sitio que llama.

Mi servicio local usa HTTPS y el túnel muestra un error

Eso no es un problema de encabezados. Activa ¿SslStream activo?, que indica al túnel que tu propio servicio local usa HTTPS. Consulta Referencia de ajustes.

Soporte