Заголовки, перезапись пути и параметры HTTP
На этой странице 11 разделов
- Перед началом
- HTTP-заголовки
- Добавление заголовка
- Выберите тип заголовка
- Добавьте заголовок
- Сохранение
- Готовые наборы
- Предлагаемые заголовки
- Правила
- Заголовок Host
- Перезапись пути
- Переключите «Перезапись пути?» в положение «Да»
- Введите добавляемый путь
- Сохранение
- Таймаут HTTP
- Только HTTPS?
- HTTP/3 включён?
- Примеры
- Разрешите веб-приложению на другом сайте обращаться к вашему API
- Публикация приложения, которое работает по вложенному пути
- Те же настройки через API
- Устранение неполадок
- Связанные страницы
Измените то, как HTTP-запросы и ответы проходят через туннель: добавляйте фиксированные заголовки, задавайте заголовок Host, который получает ваш сервис, добавляйте путь перед каждым запросом, настраивайте таймаут запроса и выбирайте для публичного адреса только HTTPS или HTTP/3.
Перед началом #
- HTTP-туннель. См. HTTP / HTTPS.
- Параметры находятся в панели настроек туннеля: откройте Мои туннели › HTTP и нажмите Настройки в строке туннеля.
| Параметр | HTTP | MCP-шлюз |
|---|---|---|
| Заголовки | Да | – |
| Перезапись пути? | Да | – |
| Таймаут HTTP | Да | Да |
| Только HTTPS? | Да | Да |
| HTTP/3 включён? | Да | Да |
Ни один из этих параметров не перезапускает туннель. Изменение применяется к работающему туннелю сразу после сохранения.
HTTP-заголовки #
Заголовки › Управлять открывает диалог HTTP-заголовки. Он добавляет фиксированные заголовки к трафику, проходящему через туннель:
- Заголовки запроса доходят до вашего локального сервиса с каждым запросом.
- Заголовки ответа доходят до посетителя с каждым ответом.
Значения отправляются ровно в том виде, как вы их ввели.
Добавление заголовка #
-
Выберите тип заголовка #
Вверху диалога выберите Заголовки запроса или Заголовки ответа. На каждой вкладке показано, сколько в ней заголовков.
-
Добавьте заголовок #
Нажмите Добавить заголовок и заполните Название и Значение либо выберите имя в разделе Варианты, чтобы получить строку с разумным начальным значением. Для заголовка, который знает диалог, значок информации в строке объясняет, что он делает.
-
Сохранение #
Нажмите Сохранить. Чтобы удалить заголовок, нажмите кнопку удаления в его строке, затем Сохранить.
Готовые наборы #
На вкладке Заголовки ответа Готовые наборы добавляют сразу группу заголовков. После этого диалог сообщает: «Набор «NAME» добавлен. Проверьте значения и сохраните.» Набор заполняет заголовок, который уже есть в списке, только если его значение пустое.
| Набор | Какие заголовки добавляет | Для чего использовать |
|---|---|---|
| Разрешить CORS |
| Позволяет веб-приложениям на других сайтах обращаться к этому туннелю. |
| Заголовки безопасности |
| 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. Полный пример см. в разделе Виртуальные хосты.
Перезапись пути #
Перезапись пути добавляет путь перед каждым запросом, прежде чем он достигнет вашего локального сервиса. Посетители продолжают пользоваться коротким адресом.
-
Переключите «Перезапись пути?» в положение «Да» #
Откроется диалог Перезапись пути.
-
Введите добавляемый путь #
Введите его в поле Добавляемый путь, например
/apiили/app/v2, либо выберите один из Частых путей. Путь начинается со слэша; если вы его не поставите, он будет добавлен автоматически. В поле Пример показан результат для условного запроса. -
Сохранение #
Нажмите Сохранить.
Если путь равен /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. См. Справочник по настройкам.