Как работает Localtonet
На этой странице 10 разделов
Клиент Localtonet на вашем устройстве открывает исходящий зашифрованный туннель к серверу Localtonet. Сервер даёт вашей службе публичный адрес и пересылает трафик по этому туннелю на выбранные вами локальный IP-адрес и порт.
Путь запроса #
- Посетитель подключается к публичному адресу вашего туннеля. Этот адрес принадлежит серверу Localtonet в выбранном вами регионе.
- Сервер Localtonet отправляет трафик в туннель, который клиент на вашем устройстве уже открыл.
- Клиент Localtonet получает трафик и подключается к локальному IP-адресу и порту, заданным в туннеле, например
127.0.0.1:3000. - Ваша служба отвечает, и ответ возвращается тем же путём.
Без проброса портов и без публичного IP #
Соединение начинает ваше устройство, поэтому открывать входящие порты не нужно. Вам не нужен публичный IP-адрес и не нужно менять настройки роутера. Это работает и за NAT и CGNAT, в домашних и мобильных сетях, где проброс портов невозможен.
Ваша сеть по-прежнему должна разрешать исходящее соединение. Его могут блокировать межсетевой экран или средство защиты конечных точек.
Для туннелей HTTP и TCP клиент можно тоже не устанавливать: в настройках туннеля показана SSH-команда, которая открывает туннель с любого компьютера с SSH-клиентом. См. SSH без установки.
Устройства и AuthToken #
AuthToken привязывает одно устройство к вашему аккаунту. Вы запускаете клиент с ним, и после этого можете выбирать это устройство при создании туннеля.
- Один токен на устройство. Создайте токен для каждого устройства в разделе Мои токены и дайте ему понятное имя, например
Office-PC. Имя — всего лишь метка. Сам токен генерирует Localtonet. - Одно подключение на токен. Новое подключение с тем же токеном заменяет предыдущее, поэтому не запускайте два устройства с одним токеном.
- Онлайн и Офлайн. В разделе «Мои токены» устройство отображается как Онлайн, пока приложение Localtonet подключено, и как Офлайн, когда оно отключено, даже если его туннели по-прежнему настроены.
- Храните его в тайне. Любой, у кого есть токен, может использовать его для входа в приложение от имени этого устройства.
AuthToken не защищает туннель. Он идентифицирует ваше устройство, а не ваших посетителей. Новый туннель доступен любому, у кого есть его адрес. Чтобы ограничить посетителей, см. Контроль доступа.
Подробнее о токенах: AuthToken.
Туннели #
Туннель — это сохранённый набор настроек, связывающий публичный адрес со службой на одном устройстве. Каждый туннель хранит:
| Настройка | Что она определяет |
|---|---|
| Тип туннеля | Протокол: HTTP, TCP, UDP, TLS, Файловый сервер, Прокси-сервер и другие. См. Типы туннелей. |
| Токен устройства | Устройство, которое получает трафик. Это токен, с которым был запущен клиент на этом устройстве. |
| Регион сервера | Расположение сервера Localtonet, на котором размещён публичный адрес. |
| Тип URL | Как выбирается публичный адрес. |
| Локальный IP-адрес и Локальный порт | Куда клиент отправляет трафик. Для службы на том же устройстве, что и клиент, используйте 127.0.0.1. |
Одно устройство может обслуживать несколько туннелей. В разделе «Мои токены» показано число активных и всех туннелей, связанных с каждым токеном. Чтобы перенести туннель на другое устройство, выберите имя его токена в списке туннелей и укажите другой токен в окне Сменить AuthToken. Работающий туннель останавливается и перезапускается с выбранным токеном. Исключение — туннели Ротационного прокси: они используют группы токенов вместо одного токена.
От создания до запуска #
- Создание. Создать туннель только сохраняет настройки. Пока ничего не работает в сети.
- Запуск. Выберите Запустить. Если клиент с токеном туннеля подключён, туннель начинает работать.
- Запуск при устройстве не в сети. Панель управления сообщает, что токен не в сети, и ждёт подключения приложения. Всё равно запустить включает туннель сейчас. Он считается активным и начинает работать, когда приложение подключится.
- Остановка. Публичный адрес перестаёт отвечать. Туннель и его настройки сохраняются на будущее.
- Удаление. Конечная точка и настройки туннеля удаляются.
Удаление токена удаляет его туннели. Туннели с этим токеном останавливаются и удаляются.
Регионы серверов #
Поле Регион сервера определяет, где размещён публичный адрес туннеля. Подсказка в панели управления: выберите регион поближе к вашему устройству, чтобы уменьшить задержку.
Список формируется для вашего аккаунта. В нём есть:
- Регионы Localtonet, по одной записи на страну. Карта сети на главной странице показывает расположение серверов.
- Ваши собственные серверы, если вы добавили их в Менеджере серверов. Их видит только ваш аккаунт, и список по умолчанию выбирает ваш сервер.
- Локально как сервер для типов туннелей, которые это поддерживают. См. ниже.
Существующий туннель можно перенести: выберите сервер туннеля в списке туннелей, чтобы открыть Сменить сервер. Для этого нужен Баланс, а при смене сервера обновление DNS может занять до 3 часов.
Публичные адреса и типы URL #
При создании туннеля Тип URL определяет, как выбирается его публичный адрес.
| Тип URL | Что вы получаете | Тариф |
|---|---|---|
| Случайный поддомен | Localtonet генерирует для вас поддомен. Адрес вы получаете сразу. | Бесплатный тариф |
| Свой поддомен | Вы сами вводите Поддомен и выбираете Домен, к которому он относится. | Нужен Баланс |
| Свой домен | Вы используете собственный домен, добавленный в Менеджер DNS. См. Собственные домены. | Нужен Баланс |
Не каждый тип туннеля предлагает все типы URL:
| Тип туннеля | Случайный поддомен | Свой поддомен | Свой домен |
|---|---|---|---|
| HTTP | Да | Да | Да |
| Файловый сервер | Да | Да | Да |
| MCP-шлюз | Да | Да | Да |
| TLS | Да | Да | Нет |
| TCP, UDP, UDP / TCP смешанный | Да | Да | Нет |
| Прокси-сервер | Да | Да | Нет |
| Ротационный прокси | Да | Да | Нет |
Туннели TCP, UDP и прокси доступны по имени хоста и Порту сервера.
Остаётся ли адрес прежним? #
- HTTP-туннель сохраняет свой поддомен, пока вы не удалите туннель.
- Для туннелей TCP, UDP и прокси туннель, созданный на аккаунте с Балансом, начинается с включённого Порт зарезервирован?, что сохраняет тот же порт при перезапусках. Это можно переключать для каждого туннеля; см. Порты.
- На Бесплатном тарифе порт освобождается при остановке туннеля, поэтому адрес может измениться.
Сквозное шифрование #
Туннель между вашим устройством и серверами Localtonet зашифрован. Это не то же самое, что сквозное шифрование между посетителем и вашей службой:
- Посетители обращаются к HTTP-туннелю по HTTPS с сертификатами, которыми управляет Localtonet. Этот HTTPS завершается на сервере Localtonet, а не на вашей службе. Оттуда трафик идёт на ваше устройство по зашифрованному туннелю.
- Для сквозного шифрования используйте TLS-туннель в режиме сквозной передачи, где ваша служба предъявляет собственный сертификат, или уже зашифрованный протокол, например SSH.
Когда клиент отключается #
Туннель работает, только пока работают три компонента: ваше устройство, клиент Localtonet и ваша локальная служба. Если клиент теряет соединение или вы его закрываете:
- Посетители больше не могут достучаться до службы по публичному адресу.
- Устройство отображается в разделе «Мои токены» как Офлайн. Сам туннель остаётся запущенным.
- Клиент сам продолжает пытаться переподключиться. Запущенный туннель снова начинает работать, как только приложение подключится.
- За запущенный туннель взимается плата, пока он запущен, даже если его устройство не в сети. Остановите туннель, чтобы прекратить начисления. См. Тарифы и баланс.
Чтобы клиент продолжал работать после выхода из системы или перезагрузки, установите его как службу: Запуск как служба. Чтобы получать уведомления об отключении туннеля или токена, настройте Вебхуки.
Локально как сервер #
Локально как сервер — пункт в списке Регион сервера. При его выборе публичный адрес не размещается ни на одном сервере Localtonet. Клиент Localtonet на вашем устройстве сам открывает прослушиватель, и посетители подключаются прямо к вашему устройству. В панели управления такие туннели также называются Client Relay.
- Он доступен при создании туннелей HTTP, TCP, UDP, TLS, Прокси-сервера и MCP-шлюза. Файловый сервер и Ротационный прокси его не предлагают.
- При его выборе форма запрашивает IP relay-сервера: IP-адрес вашего устройства, к которому подключаются посетители.
- Устройство, на котором размещён прослушиватель, должно оставаться подключённым.
- У туннелей Client Relay своя, более низкая цена. См. Тарифы и баланс.
| Сообщение | Что делать |
|---|---|
| Введите IP локального сервера. | Заполните IP relay-сервера. |
| IP локального сервера должен быть доступен извне. | Вы ввели адрес обратной петли или другой адрес, доступный только локально, например 127.0.0.1. Введите адрес, доступный вашим посетителям. |