Перейти до вмісту
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, захист від фреймів і політика referrer.
Вимкнути кешуванняCache-Control: no-storeНе дає браузерам і проксі кешувати відповіді.
Приховати від пошукових системX-Robots-Tag: noindex, nofollowПросить пошукові системи не індексувати цю адресу.

Запропоновані заголовки #

ЗаголовокТипЩо про нього каже діалог
HostЗапитВаш сервіс отримує це ім’я хоста замість адреси тунелю. Корисно, коли локальний вебсервер вибирає сайт за ім’ям хоста.
AuthorizationЗапитНадсилає ваш сервісу ті самі облікові дані з кожним запитом.
X-API-KeyЗапитФіксований ключ для сервісів, які очікують його в заголовку.
X-Forwarded-ProtoЗапитПовідомляє вашому застосунку, що відвідувачі використовують HTTPS, тож він формує посилання та перенаправлення з https://.
OriginЗапитДеякі сервіси приймають запити лише з відомого джерела (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. Замініть * у Access-Control-Allow-Origin на https://app.example.com, якщо API може викликати лише цей сайт, а потім натисніть Зберегти.

Публікація застосунку, що живе під підшляхом #

Ваш сервер застосунку віддає застосунок за адресою /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?, який повідомляє тунелю, що ваш локальний сервіс сам використовує HTTPS. Див. Довідник налаштувань.

Підтримка