Заголовки, перезапис шляху та параметри 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, захист від фреймів і політика 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. Повний приклад див. у розділі Віртуальні хости.
Перезапис шляху #
Перезапис шляху додає шлях перед кожним запитом, перш ніж він досягне вашого локального сервісу. Відвідувачі й далі користуються короткою адресою.
-
Переключіть «Перезапис шляху?» на «Так» #
Відкриється діалог Перезапис шляху.
-
Введіть шлях, який додати #
Введіть його в поле Шлях, який додати, наприклад
/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. Замініть * у 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. Див. Довідник налаштувань.