Перейти к содержимому
Localtonet Localtonet Панель управления

Заголовки, перезапись пути и параметры HTTP

Помощь по этой странице
На этой странице 11 разделов
  1. Перед началом
  2. HTTP-заголовки
  3. Добавление заголовка
  4. Выберите тип заголовка
  5. Добавьте заголовок
  6. Сохранение
  7. Готовые наборы
  8. Предлагаемые заголовки
  9. Правила
  10. Заголовок Host
  11. Перезапись пути
  12. Переключите «Перезапись пути?» в положение «Да»
  13. Введите добавляемый путь
  14. Сохранение
  15. Таймаут HTTP
  16. Только HTTPS?
  17. HTTP/3 включён?
  18. Примеры
  19. Разрешите веб-приложению на другом сайте обращаться к вашему API
  20. Публикация приложения, которое работает по вложенному пути
  21. Те же настройки через API
  22. Устранение неполадок
  23. Связанные страницы

Измените то, как HTTP-запросы и ответы проходят через туннель: добавляйте фиксированные заголовки, задавайте заголовок Host, который получает ваш сервис, добавляйте путь перед каждым запросом, настраивайте таймаут запроса и выбирайте для публичного адреса только HTTPS или HTTP/3.

Перед началом #

  • HTTP-туннель. См. HTTP / HTTPS.
  • Параметры находятся в панели настроек туннеля: откройте Мои туннели › HTTP и нажмите Настройки в строке туннеля.
ПараметрHTTPMCP-шлюз
ЗаголовкиДа–
Перезапись пути?Да–
Таймаут HTTPДаДа
Только HTTPS?ДаДа
HTTP/3 включён?ДаДа

Ни один из этих параметров не перезапускает туннель. Изменение применяется к работающему туннелю сразу после сохранения.

HTTP-заголовки #

Заголовки › Управлять открывает диалог HTTP-заголовки. Он добавляет фиксированные заголовки к трафику, проходящему через туннель:

  • Заголовки запроса доходят до вашего локального сервиса с каждым запросом.
  • Заголовки ответа доходят до посетителя с каждым ответом.

Значения отправляются ровно в том виде, как вы их ввели.

Добавление заголовка #

  1. Выберите тип заголовка #

    Вверху диалога выберите Заголовки запроса или Заголовки ответа. На каждой вкладке показано, сколько в ней заголовков.

  2. Добавьте заголовок #

    Нажмите Добавить заголовок и заполните Название и Значение либо выберите имя в разделе Варианты, чтобы получить строку с разумным начальным значением. Для заголовка, который знает диалог, значок информации в строке объясняет, что он делает.

  3. Сохранение #

    Нажмите Сохранить. Чтобы удалить заголовок, нажмите кнопку удаления в его строке, затем Сохранить.

Готовые наборы #

На вкладке Заголовки ответа Готовые наборы добавляют сразу группу заголовков. После этого диалог сообщает: «Набор «NAME» добавлен. Проверьте значения и сохраните.» Набор заполняет заголовок, который уже есть в списке, только если его значение пустое.

НаборКакие заголовки добавляетДля чего использовать
Разрешить CORS
  • Access-Control-Allow-Origin: *
  • Access-Control-Allow-Methods: GET, POST, PUT, PATCH, DELETE, OPTIONS
  • Access-Control-Allow-Headers: Content-Type, Authorization
Позволяет веб-приложениям на других сайтах обращаться к этому туннелю.
Заголовки безопасности
  • 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, защита от встраивания во фреймы и политика реферера.
Отключить кэшированиеCache-Control: no-storeНе позволяет браузерам и прокси кэшировать ответы.
Скрыть от поисковиковX-Robots-Tag: noindex, nofollowПросит поисковые системы не включать этот адрес в выдачу.

Предлагаемые заголовки #

ЗаголовокТипЧто диалог говорит о нём
HostЗапросВаш сервис получает это имя хоста вместо адреса туннеля. Полезно, когда локальный веб-сервер выбирает сайт по имени хоста.
AuthorizationЗапросОтправляет вашему сервису одни и те же учётные данные с каждым запросом.
X-API-KeyЗапросФиксированный ключ для сервисов, которые ожидают его в заголовке.
X-Forwarded-ProtoЗапросСообщает вашему приложению, что посетители используют HTTPS, чтобы оно формировало ссылки и перенаправления с https://.
OriginЗапросНекоторые сервисы принимают запросы только от известного источника.
Access-Control-Allow-OriginОтветКакие сайты могут обращаться к этому туннелю из браузера. * разрешает любой сайт.
Access-Control-Allow-CredentialsОтветПозволяет браузерам отправлять cookie. Не работает вместе с Access-Control-Allow-Origin: *.
Strict-Transport-SecurityОтветСообщает браузерам, что для этого адреса всегда нужно использовать HTTPS.
X-Frame-OptionsОтветНе позволяет другим сайтам показывать ваши страницы во фрейме.
Content-Security-PolicyОтветОпределяет, откуда страницы могут загружать скрипты, стили и изображения. Строгая политика может сломать страницы, поэтому проверьте её.
Cache-ControlОтветno-store не позволяет браузерам и прокси кэшировать ответы.
X-Robots-TagОтветПросит поисковые системы не включать этот адрес в выдачу.

Среди вариантов также есть User-Agent, Accept-Language и Cache-Control для запросов и Access-Control-Allow-Methods, Access-Control-Allow-Headers, X-Content-Type-Options, Referrer-Policy и Permissions-Policy для ответов. Можно ввести и любое другое имя заголовка.

Правила #

  • Имена заголовков могут содержать латинские буквы, цифры и дефисы, например X-Api-Key, и быть длиной до 256 символов.
  • Имя может встречаться на вкладке один раз. Вторая строка с тем же именем отклоняется с сообщением «NAME уже есть в списке.»
  • Строке нужно имя. Пустая строка при сохранении игнорируется.

Заголовок Host #

По умолчанию ваш сервис получает адрес туннеля как имя хоста запроса. Чтобы отправлять другое имя хоста, добавьте заголовок запроса Host в диалоге HTTP-заголовки и задайте ему значение, которое ожидает ваш сервис, например localhost или shop.internal.

Используйте это, когда локальный веб-сервер выбирает сайт по имени хоста: виртуальный хост Apache или nginx, IIS с привязками хостов или сервер разработки, который отвечает только для localhost. Полный пример см. в разделе Виртуальные хосты.

Перезапись пути #

Перезапись пути добавляет путь перед каждым запросом, прежде чем он достигнет вашего локального сервиса. Посетители продолжают пользоваться коротким адресом.

  1. Переключите «Перезапись пути?» в положение «Да» #

    Откроется диалог Перезапись пути.

  2. Введите добавляемый путь #

    Введите его в поле Добавляемый путь, например /api или /app/v2, либо выберите один из Частых путей. Путь начинается со слэша; если вы его не поставите, он будет добавлен автоматически. В поле Пример показан результат для условного запроса.

  3. Сохранение #

    Нажмите Сохранить.

Если путь равен /api:

Посетитель открываетВаш сервис получает
https://<YOUR_TUNNEL_ADDRESS>/orders?id=7/api/orders?id=7

У туннеля может быть один путь длиной до 200 символов. Он не может содержать пробелы и не может состоять только из /. Чтобы убрать его, переключите Перезапись пути? в положение Нет и подтвердите Выключить перезапись пути?: сохранённый путь удаляется, и запросы доходят до вашего сервиса с исходным путём.

Таймаут HTTP #

Таймаут HTTP › Управлять открывает диалог Таймаут запроса. Таймаут — это время, в течение которого туннель ждёт ответа вашего сервиса на запрос. После этого посетитель получает ошибку таймаута.

ЭлементЗначения
ТаймаутЦелое число от 1 до 600 секунд. Оставьте пустым, чтобы использовать значение сервера по умолчанию.
ПресетыЗначение сервера, 30 с, 1 мин, 2 мин, 5 мин, 10 мин

Увеличьте таймаут для медленных отчётов, больших загрузок или длинного опроса (long polling). Выберите Значение сервера, чтобы вернуться к стандартному значению.

Только HTTPS? #

Переключите Только HTTPS? в положение Да и подтвердите Включить «Только HTTPS»?, чтобы публичный URL работал только по HTTPS. Используйте это для всего, что передаёт логины или персональные данные, чтобы никто не мог обратиться к туннелю по обычному HTTP.

HTTP/3 включён? #

Переключите HTTP/3 включён? в положение Да, чтобы клиенты могли обращаться к публичному URL по HTTP/3. Клиенты, не поддерживающие HTTP/3, продолжают использовать более ранние версии HTTP.

Примеры #

Разрешите веб-приложению на другом сайте обращаться к вашему API #

Ваш фронтенд работает на https://app.example.com и обращается к API за туннелем. Откройте Заголовки › Управлять, перейдите на вкладку Заголовки ответа и выберите Разрешить CORS. Если обращаться к API может только этот сайт, замените * в Access-Control-Allow-Origin на https://app.example.com, затем нажмите Сохранить.

Публикация приложения, которое работает по вложенному пути #

Ваш сервер приложений отдаёт приложение по пути /app/v2, а вы хотите, чтобы посетители открывали простой адрес туннеля. Включите Перезапись пути? и введите /app/v2. Посетитель, открывший /login, попадает на /app/v2/login вашего сервиса.

Те же настройки через API #

Эти настройки также доступны по адресу /api/v2/tunnels/<TUNNEL_ID>/: headers, host-header, path-rewrite, http-timeout, https-only и http3. См. API.

Устранение неполадок #

«Имя заголовка может содержать латинские буквы, цифры и дефисы, например X-Api-Key.»

В имени есть символ, недопустимый в имени заголовка, например пробел или двоеточие. Введите в поле Название только имя, а всё остальное — в Значение.

«Укажите имя заголовка или удалите строку.»

В строке есть значение, но нет имени. Заполните имя или удалите строку.

«Введите только путь, без http:// и имени хоста.»

В поле Добавляемый путь вводится путь вроде /api, а не полный URL.

«Введите целое число от 1 до 600 или выберите «Значение сервера».»

Таймаут должен быть от 1 до 600 секунд. Для более долгой задачи сначала ответьте на запрос, а клиент пусть запросит результат позже.

Мой заголовок CORS не работает с cookie

Access-Control-Allow-Credentials не работает вместе с Access-Control-Allow-Origin: *. Задайте в Access-Control-Allow-Origin точный источник (origin) вызывающего сайта.

Мой локальный сервис использует HTTPS, и туннель показывает ошибку

Дело не в заголовках. Включите Локальный HTTPS (SslStream)?, который сообщает туннелю, что ваш локальный сервис сам использует HTTPS. См. Справочник по настройкам.

Поддержка