Создание 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 (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-туннель на порт вашего приёмника, запустите его и укажите у провайдера адрес туннеля плюс путь вашей конечной точки:
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://.