Перейти к содержимому
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 (SslStream)?Сообщает приложению Localtonet, что к вашему локальному сервису нужно подключаться по TLS. Приложение принимает сертификат локального сервиса как есть, поэтому самоподписанный сертификат подойдёт.Включайте, когда ваш локальный сервис сам использует HTTPS, например сервер разработки на https://localhost:5001.
Классическое подключение?Подключает туннель устаревшим способом вместо обычного.Попробуйте, если туннель не удаётся подключить обычным способом.

Эти переключатели находятся в разделе Настройки панели Настройки туннеля. Изменение Локальный HTTPS (SslStream)? или Классическое подключение? у работающего туннеля перезапускает его, поэтому приложение Localtonet должно быть подключено.

Нужно шифрование до вашего собственного сервиса? В HTTP-туннеле Localtonet расшифровывает трафик на своём сервере. Используйте TLS-туннель, если ваш сервис должен предъявлять собственный сертификат.

Заголовок Host #

Ваш сервис получает имя хоста, которое использовал посетитель, то есть адрес туннеля. Некоторые локальные веб-серверы выбирают сайт по имени хоста и отвечают не тем сайтом или ошибкой. В этом случае откройте Заголовки в настройках туннеля и добавьте заголовок запроса Host с именем, которое ожидает ваш сервер. Тогда ваш сервис получит это имя хоста вместо адреса туннеля. См. Заголовки и перезапись и Виртуальные хосты.

Настройки HTTP-туннеля #

Нажмите кнопку настроек в столбце Действия, чтобы открыть панель Настройки туннеля. В разделе Сведения о туннеле можно переименовать туннель и изменить локальный IP-адрес и локальный порт. В таблице перечислено, что ещё доступно для HTTP-туннеля и где это описано.

ПараметрЧто делаетПодробнее
Балансировка нагрузкиРаспределяйте трафик между устройствами или используйте резервную цель.Балансировка нагрузки
Показать SSH-командуЗапустите этот туннель обычным SSH без установки приложения Localtonet.SSH без установки
Только HTTPS?, HTTP/3 включён?, Локальный HTTPS (SslStream)?, Классическое подключение?Как подключаются посетители и ваш сервис.Эта страница, выше
Перезапись пути?Изменяйте путь запроса до того, как он попадёт в ваш локальный сервис.Заголовки и перезапись
ЗаголовкиУправляйте пользовательскими HTTP-заголовками запросов и ответов для этого туннеля.Заголовки и перезапись
Таймаут HTTPЗадайте, как долго сервер ждёт ответа от вашего локального приложения, от 1 до 600 секунд.Заголовки и перезапись
Basic Auth?Запрашивать у посетителей имя пользователя и пароль.Контроль доступа
Ограничение по IPУправляйте тем, какие IP-адреса клиентов могут обращаться к этому туннелю.Контроль доступа
SSO-провайдерыПосетители входят через одного из ваших провайдеров удостоверений, прежде чем смогут открыть туннель. Провайдерами управляет кнопка SSO в верхней части страницы.Единый вход
Кнопка WAF в столбце ДействияОткрывает Настройки WAF. Кнопка показывает, что межсетевой экран веб-приложений не настроен, активен или неактивен.Web Application Firewall
Срок действия, Лимиты скорости, Лимит трафика, Использованный трафик, Статистика трафикаОстановите туннель в заданную дату, ограничьте его скорость и объём данных, сбросьте счётчик данных и посмотрите, как менялся трафик со временем.Лимиты и срок действия
Журнал запросов, Журнал активности, Состояние туннеляИзучайте запросы, просматривайте запуски, остановки и изменения настроек, а также проверки состояния.Журналы и инспекция
АргументыНаправьте этот туннель через определённую сеть на вашем устройстве.Выбор сети
Исходящий портИспользуйте фиксированные исходящие порты для подключения приложения Localtonet к серверу, если брандмауэры строгие.Порты
Заметка к туннелюСохраните личную заметку, чтобы легче узнавать этот туннель.Справочник по настройкам

SSO-провайдеры не отображаются для туннеля, который принадлежит команде.

Примеры #

Поделиться веб-приложением #

Ваше приложение работает на том же компьютере, что и клиент Localtonet, и слушает порт 3000.

ПолеЗначение
Тип URLСлучайный поддомен
Доменlocalto.net
Локальный IP-адрес127.0.0.1
Локальный порт3000

Создайте туннель, запустите его и отправьте адрес из столбца URL тем, кто должен увидеть приложение. Чтобы сначала запрашивать у них пароль, включите Basic Auth?.

Если приложение работает на другой машине в вашей сети, введите адрес этой машины в поле Локальный 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://.

Поддержка