Створення HTTP-тунелю
На цій сторінці 10 розділів
- Перш ніж почати
- Кроки
- Відкрийте сторінку HTTP
- Оберіть тип URL
- Оберіть пристрій і регіон
- Введіть локальну адресу
- Запустіть тунель
- Ваша публічна адреса
- HTTPS і сертифікати
- Заголовок Host
- Налаштування HTTP-тунелю
- Приклади
- Надайте доступ до вебзастосунку
- Приймайте вебхуки
- Сторінка з попередженням на безкоштовному тарифі
- Усунення несправностей
- Пов’язані сторінки
HTTP-тунель дає вебзастосунку, API або одержувачу вебхуків на вашому пристрої публічну HTTPS-адресу. Сертифікат надає Localtonet, тож ваш локальний сервіс може працювати на звичайному HTTP.
Перш ніж почати #
- Клієнт Localtonet встановлено на пристрої та підключено за допомогою AuthToken. Якщо ні, скористайтеся Швидким стартом.
- Ваш вебсервіс запущено, і ви знаєте його порт, наприклад
3000. - Для Власний піддомен або Власний домен: баланс на вашому акаунті. Для Власний домен також потрібен домен, який ви додали в Менеджер DNS. Дивіться Власні домени.
Кроки #
-
Відкрийте сторінку HTTP #
Відкрийте Мої тунелі › HTTP і натисніть Створити HTTP-тунель, щоб відкрити форму.
-
Оберіть тип URL #
Тип URL Адреса, яку ви отримаєте Що потрібно Випадковий піддомен Згенероване ім'я на вибраному домені, наприклад https://<RANDOM_NAME>.localto.net.Нічого додатково Власний піддомен Ім'я, яке ви вводите в поле Піддомен, наприклад https://myapp.localto.net. Дозволені літери, цифри та дефіси.Баланс Власний домен Ваш власний домен, вибраний у полі Домен. Баланс і домен у Менеджері DNS -
Оберіть пристрій і регіон #
У полі Токен пристрою виберіть токен, який використовує застосунок Localtonet на вашому пристрої. У полі Регіон сервера оберіть регіон, близький до вашого пристрою, щоб зменшити затримку.
-
Введіть локальну адресу #
Поле Що вводити Домен localto.netабо один із ваших власних доменів. Для Власний домен у списку лише ваші власні домени.Піддомен Лише для Власний піддомен: ім'я перед доменом. Локальна IP-адреса Адреса сервісу на вашому пристрої. Для цього пристрою використовуйте 127.0.0.1. Форма приймає IPv4- або IPv6-адресу чиlocalhost.Локальний порт Порт, який слухає ваш локальний сервіс, від 1 до 65535. Натисніть Створити тунель. Тунель з'явиться в розділі Ваші тунелі як
Tunnel #із зазначенням його ID. -
Запустіть тунель #
Натисніть кнопку запуску в стовпці Дії. Коли тунель працює, його адреса в стовпці URL стає посиланням. Відкрийте її в браузері. Запити на цю адресу тепер доходять до сервісу на вашому пристрої.
Якщо застосунок Localtonet цього токена офлайн, діалогове вікно повідомить про це. Запустіть застосунок або натисніть Запустити все одно, і тунель запрацює, коли застосунок підключиться.
Ваша публічна адреса #
- Адреса складається з
https://та імені хоста зі стовпця URL. - HTTP-тунель зберігає свій піддомен, доки ви не видалите тунель. Зупинка й повторний запуск його не змінюють.
- В адресі немає номера порту. Відвідувачі відкривають її, як будь-який інший вебсайт.
- З'єднання WebSocket проходять через HTTP-тунель.
HTTPS і сертифікати #
Відвідувачі потрапляють до HTTP-тунелю через HTTPS із сертифікатом, який надає й поновлює Localtonet. TLS завершується на сервері Localtonet. Звідти запит іде тунелем до вашого пристрою, а застосунок Localtonet передає його вашому сервісу.
| Параметр | Що робить | Коли використовувати |
|---|---|---|
| Лише HTTPS? | Обслуговує публічний URL лише через HTTPS. Запит до http:// перенаправляється на ту саму адресу на https://. Поки параметр вимкнено, адреса відповідає на обох. | Вмикайте для всього, що передає логіни чи приватні дані. |
| HTTP/3 активний? | Дозволяє клієнтам звертатися до публічного URL через HTTP/3. У новому тунелі його ввімкнено. | Вимикайте, лише якщо в клієнта виникають проблеми з HTTP/3. |
| Локальний HTTPS? | Наказує застосунку Localtonet підключатися до вашого локального сервісу через TLS. Застосунок приймає сертифікат локального сервісу як є, тож самопідписаний сертифікат працює. | Вмикайте, коли ваш локальний сервіс сам використовує HTTPS, наприклад сервер розробки на https://localhost:5001. |
| Застаріле підключення? | Підключає тунель застарілим методом замість звичайного. | Спробуйте це, якщо тунель не вдається підключити звичайним методом. |
Ці перемикачі розташовані в розділі Налаштування панелі Налаштування тунелю. Зміна Локальний HTTPS? або Застаріле підключення? на запущеному тунелі перезапускає його, тому застосунок Localtonet має бути підключений.
Потрібне шифрування аж до вашого власного сервісу? У HTTP-тунелі Localtonet розшифровує трафік на своєму сервері. Використовуйте TLS-тунель, якщо ваш сервіс має пред'являти власний сертифікат.
Заголовок Host #
Ваш сервіс отримує ім'я хоста, яким скористався відвідувач, тобто адресу тунелю. Деякі локальні вебсервери вибирають сайт за іменем хоста й відповідають не тим сайтом або помилкою. У такому разі відкрийте Заголовки в налаштуваннях тунелю та додайте заголовок запиту Host з іменем, якого очікує ваш сервер. Тоді ваш сервіс отримуватиме це ім'я хоста замість адреси тунелю. Дивіться Заголовки та перезаписи і Віртуальні хости.
Налаштування HTTP-тунелю #
Натисніть кнопку налаштувань у стовпці Дії, щоб відкрити панель Налаштування тунелю. У розділі Деталі тунелю можна перейменувати тунель і змінити локальну IP-адресу та локальний порт. У таблиці перелічено, що ще пропонує HTTP-тунель і де це описано.
| Параметр | Що робить | Докладніше |
|---|---|---|
| Балансування навантаження | Розподіляйте трафік між пристроями або використовуйте резервну ціль. | Балансування навантаження |
| Показати SSH-команду | Запустіть цей тунель звичайним SSH без встановлення застосунку Localtonet. | SSH без встановлення |
| Лише HTTPS?, HTTP/3 активний?, Локальний HTTPS?, Застаріле підключення? | Як підключаються відвідувачі та ваш сервіс. | Ця сторінка, вище |
| Перезапис шляху? | Змінюйте шлях запиту, перш ніж він досягне вашого локального сервісу. | Заголовки та перезаписи |
| Заголовки | Керуйте власними HTTP-заголовками запитів і відповідей для цього тунелю. | Заголовки та перезаписи |
| HTTP-таймаут | Задайте, як довго сервер очікує відповіді від вашого локального застосунку, від 1 до 600 секунд. | Заголовки та перезаписи |
| Базова автентифікація? | Запитуйте у відвідувачів ім'я користувача та пароль. | Контроль доступу |
| IP-обмеження | Керуйте тим, з яких IP-адрес клієнтів можна звертатися до цього тунелю. | Контроль доступу |
| SSO-провайдери | Відвідувачі входять через одного з ваших провайдерів ідентифікації, перш ніж зможуть відкрити тунель. Кнопка SSO угорі сторінки керує провайдерами. | Єдиний вхід |
| Кнопка WAF у стовпці Дії | Відкриває Налаштування WAF. Кнопка показує, чи брандмауер вебзастосунків не налаштовано, активний чи неактивний. | Брандмауер вебзастосунків |
| Термін дії, Обмеження швидкості, Ліміт трафіку, Використання трафіку, Трафік тунелю | Зупиняйте тунель у задану дату, обмежуйте його швидкість і обсяг даних, скидайте лічильник даних і переглядайте трафік у часі. | Ліміти та термін дії |
| Журнал запитів, Журнал активності, Стан тунелю | Перевіряйте запити, переглядайте запуски, зупинки та зміни налаштувань і дивіться перевірки стану. | Журнали та перевірка |
| Аргументи | Спрямуйте цей тунель через певну мережу на вашому пристрої. | Вибір мережі |
| Вихідний порт | Використовуйте фіксовані вихідні порти для підключення застосунку Localtonet до сервера, якщо діють суворі брандмауери. | Порти |
| Нотатка тунелю | Збережіть приватну нотатку, яка допоможе вам упізнати цей тунель. | Довідник налаштувань |
SSO-провайдери не показуються для тунелю, що належить команді.
Приклади #
Надайте доступ до вебзастосунку #
Ваш застосунок працює на тому самому комп'ютері, що й клієнт Localtonet, і слухає порт 3000.
| Поле | Значення |
|---|---|
| Тип URL | Випадковий піддомен |
| Домен | localto.net |
| Локальна IP-адреса | 127.0.0.1 |
| Локальний порт | 3000 |
Створіть тунель, запустіть його та надішліть адресу зі стовпця URL тим, хто має побачити застосунок. Щоб спершу запитувати в них пароль, увімкніть Базова автентифікація?.
Якщо застосунок працює на іншому комп'ютері у вашій мережі, введіть адресу цього комп'ютера в поле Локальна IP-адреса, наприклад 192.168.1.20. Пристрій, на якому працює клієнт Localtonet, має мати до нього доступ.
Приймайте вебхуки #
Провайдеру вебхуків потрібна публічна HTTPS-адреса, на яку надсилати події. Створіть HTTP-тунель до порту вашого одержувача, запустіть його та введіть у провайдера адресу тунелю плюс шлях вашої кінцевої точки:
https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH>Перевірте з будь-якого комп'ютера:
curl -X POST https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH> \
-H "Content-Type: application/json" \
-d '{"event":"test"}'Щоб побачити, що надійшло, натисніть значок у стовпці Вебхуки тунелю (Переглянути журнали запитів і відповідей). Спершу тунель має бути запущено. Дивіться Журнали та перевірка.
На безкоштовному тарифі поповніть баланс, перш ніж покладатися на вебхуки. Запити до HTTP-тунелю безкоштовного акаунта спершу отримують сторінку з попередженням, а провайдер вебхуків не може її пройти. Дивіться наступний розділ.
Сторінка з попередженням на безкоштовному тарифі #
Коли на акаунті немає балансу, відвідувач, який уперше заходить до його HTTP-тунелю, бачить сторінку Localtonet із заголовком "You are about to navigate to:" і кнопками Cancel та Visit Site. Ця сторінка стримує зловживання. Visit Site зберігає cookie в браузері відвідувача й відкриває ваш сайт. Поки браузер зберігає цей cookie, сторінка більше не з'являється.
Сама сторінка називає два способи її прибрати:
- Надішліть заголовок запиту
localtonet-skip-warningз будь-яким значенням. Це підходить для ваших власних скриптів і API-клієнтів. - Поповніть баланс акаунта. Дивіться Тарифи та баланс.
curl -H "localtonet-skip-warning: 1" https://<YOUR_SUBDOMAIN>.localto.net/Усунення несправностей #
Діалогове вікно каже, що токен офлайн, або я бачу «Застосунок Localtonet для AuthToken «…» не підключено.»
Клієнт Localtonet, що використовує токен цього тунелю, не запущено або він не може дістатися до Localtonet. Запустіть клієнт на пристрої з тим самим токеном. Діалогове вікно запускає тунель саме, щойно застосунок підключиться. Із Запустити все одно тунель вмикається й запрацює пізніше.
«Запустіть або оновіть застосунок Localtonet.»
Не вдалося запустити тунель на пристрої. Переконайтеся, що клієнт запущено, і, якщо він старий, встановіть поточну версію зі сторінки Завантаження.
У браузері з'являється «Tunnel Recently Started or Stopped»
Запит дійшов до Localtonet, але тунель не приймає з'єднань. Тунель щойно запущено або зупинено. Переконайтеся, що тунель запущено і що в стовпці Підключення показано УВІМК, а потім перезавантажте сторінку.
У браузері з'являється сторінка помилки Localtonet з моєю локальною адресою
На сторінці сказано, що трафік було передано агенту Localtonet, але агент не зміг підключитися до вихідного сервісу за вашою локальною IP-адресою та портом. Заголовок і є помилкою, наприклад ConnectionRefused. За цією адресою ніхто не слухає. Запустіть свій сервіс, а потім перевірте локальну IP-адресу та локальний порт у розділі Деталі тунелю. Перевірити сервіс можна на самому пристрої, відкривши локальну адресу в браузері.
«Щоб користуватися цією функцією, поповніть баланс.»
Власний піддомен і Власний домен потребують балансу. Скористайтеся Випадковий піддомен або поповніть баланс у розділі Баланс.
«Щоб створити ще один тунель цього типу, на балансі має бути загалом …»
Вашого балансу не вистачає на ще один тунель. На безкоштовному тарифі можна створити лише один тунель загалом, незалежно від його типу. Видаліть наявний тунель, перш ніж створювати інший, або поповніть баланс.
«… уже існує.» або «… не дозволено.»
Цей піддомен використовує інший тунель, або ім'я зарезервоване Localtonet. Оберіть інший піддомен.
«УВАГА! У вас немає жодного домену!»
Ви обрали Власний домен, але ще не додали домен. Спершу додайте його в Менеджер DNS. Якщо ви бачите «… уже використовується іншим тунелем.», цей домен уже належить одному з ваших тунелів. Власний домен може обслуговувати один тунель.
«Змініть ліміт трафіку або скиньте використаний трафік.» або «Оновіть термін дії.»
Тунель досяг власного ліміту трафіку або терміну дії й не може запуститися. Змініть ліміт або дату в налаштуваннях тунелю чи скиньте лічильник за допомогою Використання трафіку. Дивіться Ліміти та термін дії.
«Перевірте підключення пристрою.»
Ви змінили налаштування, що перезапускає запущений тунель, коли застосунок Localtonet був офлайн. Підключіть застосунок і збережіть налаштування знову або спершу зупиніть тунель.
Мій застосунок відповідає не тим сайтом або формує посилання та перенаправлення з http://
Ваш застосунок вирішує за іменем хоста або схемою, які отримує. У розділі Заголовки додайте заголовок запиту Host, якщо застосунок очікує фіксоване ім'я хоста. Додайте заголовок запиту X-Forwarded-Proto зі значенням https, щоб повідомити застосунку, що відвідувачі користуються HTTPS, і він формував посилання та перенаправлення з https://.