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

Створення HTTP-тунелю

Допомога зі сторінкою
На цій сторінці 10 розділів
  1. Перш ніж почати
  2. Кроки
  3. Відкрийте сторінку HTTP
  4. Оберіть тип URL
  5. Оберіть пристрій і регіон
  6. Введіть локальну адресу
  7. Запустіть тунель
  8. Ваша публічна адреса
  9. HTTPS і сертифікати
  10. Заголовок Host
  11. Налаштування HTTP-тунелю
  12. Приклади
  13. Надайте доступ до вебзастосунку
  14. Приймайте вебхуки
  15. Сторінка з попередженням на безкоштовному тарифі
  16. Усунення несправностей
  17. Пов’язані сторінки

HTTP-тунель дає вебзастосунку, API або одержувачу вебхуків на вашому пристрої публічну HTTPS-адресу. Сертифікат надає Localtonet, тож ваш локальний сервіс може працювати на звичайному HTTP.

Перш ніж почати #

  • Клієнт Localtonet встановлено на пристрої та підключено за допомогою AuthToken. Якщо ні, скористайтеся Швидким стартом.
  • Ваш вебсервіс запущено, і ви знаєте його порт, наприклад 3000.
  • Для Власний піддомен або Власний домен: баланс на вашому акаунті. Для Власний домен також потрібен домен, який ви додали в Менеджер DNS. Дивіться Власні домени.

Кроки #

  1. Відкрийте сторінку HTTP #

    Відкрийте Мої тунелі › HTTP і натисніть Створити HTTP-тунель, щоб відкрити форму.

  2. Оберіть тип URL #

    Тип URLАдреса, яку ви отримаєтеЩо потрібно
    Випадковий піддоменЗгенероване ім'я на вибраному домені, наприклад https://<RANDOM_NAME>.localto.net.Нічого додатково
    Власний піддоменІм'я, яке ви вводите в поле Піддомен, наприклад https://myapp.localto.net. Дозволені літери, цифри та дефіси.Баланс
    Власний доменВаш власний домен, вибраний у полі Домен.Баланс і домен у Менеджері DNS
  3. Оберіть пристрій і регіон #

    У полі Токен пристрою виберіть токен, який використовує застосунок Localtonet на вашому пристрої. У полі Регіон сервера оберіть регіон, близький до вашого пристрою, щоб зменшити затримку.

  4. Введіть локальну адресу #

    ПолеЩо вводити
    Доменlocalto.net або один із ваших власних доменів. Для Власний домен у списку лише ваші власні домени.
    ПіддоменЛише для Власний піддомен: ім'я перед доменом.
    Локальна IP-адресаАдреса сервісу на вашому пристрої. Для цього пристрою використовуйте 127.0.0.1. Форма приймає IPv4- або IPv6-адресу чи localhost.
    Локальний портПорт, який слухає ваш локальний сервіс, від 1 до 65535.

    Натисніть Створити тунель. Тунель з'явиться в розділі Ваші тунелі як Tunnel # із зазначенням його ID.

  5. Запустіть тунель #

    Натисніть кнопку запуску в стовпці Дії. Коли тунель працює, його адреса в стовпці 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-тунель до порту вашого одержувача, запустіть його та введіть у провайдера адресу тунелю плюс шлях вашої кінцевої точки:

URL вебхука
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://.

Підтримка