Справочник по настройкам туннеля
На этой странице 15 разделов
- Как открыть настройки туннеля
- Откройте страницу нужного типа туннеля
- Нажмите «Настройки» в строке туннеля
- Как изменить настройку
- Как применяются изменения
- Какие настройки есть у какого типа туннеля
- Что делает каждая настройка
- Сведения о туннеле
- Заметка к туннелю
- Локальный HTTPS (SslStream)?
- Протокол PROXY?
- Классическое подключение?
- IP локального сервера
- IP туннеля
- Настройки в списке туннелей
- Смена сервера
- Смена AuthToken
- Межсетевой экран веб-приложений
- Те же настройки через API
- Устранение неполадок
- Связанные страницы
У каждого туннеля в панели управления есть панель настроек. На этой странице показано, где её открыть, перечислены все настройки, указано, для каких типов туннелей они доступны, и даны ссылки на страницы с подробным описанием.
Как открыть настройки туннеля #
-
Откройте страницу нужного типа туннеля #
В меню панели управления откройте Мои туннели и выберите тип: Мои туннели › HTTP, TCP - UDP, TLS, Файловый сервер, Прокси-сервер, Ротационный прокси или MCP-шлюз.
-
Нажмите «Настройки» в строке туннеля #
Найдите туннель в списке Ваши туннели и нажмите Настройки в столбце Действия. Сбоку страницы откроется панель Настройки туннеля.
-
Как изменить настройку #
Панель состоит из таких частей:
- Сведения о туннеле: данные, такие как адрес туннеля, дата создания и имя AuthToken, а также значения, которые можно изменить, выбрав их: заголовок у туннелей любого типа, а у туннелей HTTP, TCP - UDP и TLS ещё и локальный адрес и локальный порт.
- Цели балансировки нагрузки туннеля, для типов туннелей, которые её поддерживают. См. Балансировка нагрузки.
- Показать SSH-команду, для типов туннелей, которые можно запустить через обычный SSH. См. SSH без установки.
- Настройки: по одной строке на каждую настройку. В строке есть либо переключатель Да / Нет, либо кнопка (Управлять, Сменить, Показать или Очистить), которая открывает диалог. Значок информации рядом с названием одним предложением объясняет настройку.
Большинство переключателей просят подтвердить действие, прежде чем что-либо изменить, например Включить «Только HTTPS»? с кнопками Включить и Отмена. Включение Basic Auth? или Перезапись пути? вместо этого открывает диалог, а включение Порт зарезервирован? у запущенного туннеля резервирует порт без вопросов.
Как применяются изменения #
Одни настройки применяются к запущенному туннелю без перерыва в работе. Другие останавливают туннель и запускают его снова с новым значением: это занимает некоторое время, а открытые соединения разрываются.
| Применяются без перезапуска | Перезапускают запущенный туннель |
|---|---|
| Только HTTPS?, Перезапись пути?, HTTP/3 включён?, Порт зарезервирован?, Заголовки, Таймаут HTTP, Заметка к туннелю, Ограничение по IP, Срок действия, Исходящий порт, Лимит трафика, Использованный трафик, переключатель WAF | Заголовок, локальный адрес и локальный порт в разделе Сведения о туннеле, Basic Auth?, Локальный HTTPS (SslStream)?, Протокол PROXY?, Классическое подключение?, Порт сервера, Аргументы, IP локального сервера, Лимиты скорости, смена сервера, смена AuthToken |
Настройку, которая перезапускает туннель, можно сохранить для запущенного туннеля, только пока приложение Localtonet на его устройстве подключено. Иначе панель управления ответит «Проверьте подключение устройства.» и оставит прежнее значение. Для остановленного туннеля значение сохраняется и применяется при следующем запуске.
Какие настройки есть у какого типа туннеля #
Названия соответствуют тем, что показывает раздел Настройки. «Да» означает, что у этого типа туннеля такая строка есть.
| Настройка | HTTP | TCP - UDP | TLS | Файловый сервер | Прокси-сервер | Ротационный прокси | MCP-шлюз |
|---|---|---|---|---|---|---|---|
| Только HTTPS? | Да | – | – | – | – | – | Да |
| Перезапись пути? | Да | – | – | – | – | – | – |
| Basic Auth? | Да | – | – | Да, тип Default | – | – | Да |
| Локальный HTTPS (SslStream)? | Да | Да, кроме UDP | Да | – | – | – | – |
| HTTP/3 включён? | Да | – | – | – | – | – | Да |
| Порт зарезервирован? | – | Да | – | – | Да | Да | – |
| Протокол PROXY? | – | Да, кроме UDP | – | – | – | – | – |
| Классическое подключение? | Да | Да | Да | Да | Да | – | Да |
| Режим SSL | – | – | Да | – | – | – | – |
| SSO-провайдеры | Да, кроме командных туннелей | – | – | – | – | – | – |
| Токен шлюза | – | – | – | – | – | – | Да |
| Заголовки | Да | – | – | – | – | – | – |
| Таймаут HTTP | Да | – | – | – | – | – | Да |
| Порт сервера | – | Да | – | – | Да, кроме VLESS | Да | – |
| Заметка к туннелю | Да | Да | Да | Да | Да | Да | Да |
| IP локального сервера | Только локальный сервер | Только локальный сервер | Только локальный сервер | – | Только локальный сервер | – | Только локальный сервер |
| Аргументы | Да | Да | Да | – | Да | – | – |
| Ограничение по IP | Да | Да | Да | Да | Да | Да | Да |
| Срок действия | Да | Да | Да | Да | Да | – | Да |
| Лимиты скорости | Да | Да | Да | Да | Да | – | Да |
| Исходящий порт | Да | Да | Да | Да | Да | Да | Да |
| Лимит трафика | Да | Да | Да | Да | Да | – | Да |
| Статистика трафика | Да | Да | Да | Да | Да | Да | Да |
| Использованный трафик | Да | Да | Да | Да | Да | – | Да |
| IP туннеля | – | Да | Да | – | Да | Да | – |
| Журнал запросов | Да | Да | Да | Да | Да | – | Да |
| Журнал активности | Да | Да | Да | Да | Да | Да | Да |
| Состояние туннеля | Да | Да | Да | – | Да | Да | Да |
У страниц «Прокси-сервер» и «Ротационный прокси» есть и собственные строки, например Аутентификация прокси, Контроль доступа, Вышестоящий прокси, VPN-доступ, Тест скорости, Токен туннеля и Только IPv4?. Они описаны в разделах Прокси-сервер и Ротационный прокси. У туннеля, который использует сервер Локальный, строки Исходящий порт нет. «Только локальный сервер» относится и к туннелю, у которого в столбце Сервер указано VPN.
Что делает каждая настройка #
| Настройка | Что делает | Подробнее |
|---|---|---|
| Только HTTPS? | Открывает публичный URL только по HTTPS. | Заголовки и перезапись |
| Перезапись пути? | Добавляет путь перед каждым запросом, прежде чем он попадёт в ваш локальный сервис. | Заголовки и перезапись |
| Basic Auth? | Запрашивает у посетителей имя пользователя и пароль. | Контроль доступа |
| Локальный HTTPS (SslStream)? | Сообщает туннелю, что ваш локальный сервис сам использует HTTPS или TLS. | Эта страница |
| HTTP/3 включён? | Позволяет клиентам открывать публичный URL по HTTP/3. | Заголовки и перезапись |
| Порт зарезервирован? | Сохраняет тот же порт сервера при перезапуске туннеля. | Порты |
| Протокол PROXY? | Передаёт исходный адрес клиента вашему сервису в заголовке протокола PROXY. | Эта страница |
| Классическое подключение? | Альтернативный способ подключения, который стоит попробовать, если туннель не может подключиться обычным способом. | Эта страница |
| Режим SSL | Определяет, кто обрабатывает HTTPS для туннеля TLS: Localtonet или ваш сервис, которому передаётся зашифрованный трафик без изменений. | TLS |
| SSO-провайдеры | Требует от посетителей войти через одного из ваших провайдеров удостоверений, прежде чем они смогут открыть туннель. | Единый вход |
| Токен шлюза | Показывает токен, который ваши MCP-клиенты отправляют для подключения к шлюзу. | MCP-шлюз |
| Заголовки | Добавляет фиксированные заголовки запроса и ответа. | Заголовки и перезапись |
| Таймаут HTTP | Задаёт, как долго туннель ждёт ответа вашего сервиса на запрос. | Заголовки и перезапись |
| Порт сервера | Меняет порт, к которому подключаются пользователи на сервере Localtonet. | Порты |
| Заметка к туннелю | Личное напоминание о том, для чего нужен туннель. | Эта страница |
| IP локального сервера | Адреса, по которым доступен ваш локальный сервер. | Эта страница |
| Аргументы | Направляет туннель через определённую сеть устройства. | Выбор сети |
| Ограничение по IP | Определяет, каким IP-адресам разрешено подключаться к туннелю. | Контроль доступа |
| Срок действия | Останавливает туннель в заданную дату. | Лимиты и срок действия |
| Лимиты скорости | Ограничивает скорость загрузки и отдачи. | Лимиты и срок действия |
| Исходящий порт | Фиксирует порты, к которым приложение Localtonet подключается наружу, для строгих межсетевых экранов. | Порты |
| Лимит трафика | Останавливает туннель после передачи заданного объёма данных. | Лимиты и срок действия |
| Статистика трафика | Показывает на графике данные, прошедшие через туннель. | Лимиты и срок действия |
| Использованный трафик | Обнуляет счётчик данных туннеля. | Лимиты и срок действия |
| IP туннеля | Показывает IP-адреса сервера, на котором работает туннель. | Эта страница |
| Журнал запросов | Показывает запросы или соединения, записанные для туннеля. | Журналы и инспекция |
| Журнал активности | Перечисляет запуски, остановки и изменения настроек. | Журналы и инспекция |
| Состояние туннеля | Показывает результаты регулярных проверок состояния. | Журналы и инспекция |
Сведения о туннеле #
Выберите значение в разделе Сведения о туннеле, чтобы изменить его. Сохранение любого из трёх значений перезапускает запущенный туннель. Локальный адрес и локальный порт можно изменить здесь у туннелей HTTP, TCP - UDP и TLS; у остальных типов туннелей показан только заголовок.
| Диалог | Что ввести | Правила |
|---|---|---|
| Переименовать туннель | Имя, которое вы легко узнаете в списке туннелей, например «Office NAS». | Обязательно. До 30 символов: диалог считает до 100, но заголовок длиннее 30 символов отклоняется с сообщением «Заголовок не может быть длиннее 30 символов.» |
| Локальный адрес | Где приложение Localtonet находит ваш сервис. Укажите 127.0.0.1, если сервис работает на том же устройстве, что и приложение. Чтобы подключиться к другому устройству в вашей сети, введите его адрес, например 192.168.1.20. | Адрес IPv4, адрес IPv6 или имя хоста. Без http://, без пути, без порта. |
| Локальный порт | Порт, который слушает ваш сервис на устройстве, где он запущен. | Число от 1 до 65535. |
Заметка к туннелю #
Заметка к туннелю › Управлять открывает диалог Заметка. Заметка напоминает, для чего нужен туннель, и видна только вашему аккаунту.
- Длина заметки не более 499 символов. Диалог считает их по мере ввода.
- Варианты в разделе Метка добавляют метку в начало заметки: Продакшн, Стейджинг, Тестирование, Демо или Временный. Тогда заметка начинается, например, с
Staging -. Выбор другой метки заменяет прежнюю.
Локальный HTTPS (SslStream)? #
Включите Локальный HTTPS (SslStream)?, когда ваш локальный сервис сам использует HTTPS или TLS, например сервер разработки, который слушает только https://localhost. Оставьте выключенным для сервиса, который работает по обычному HTTP или обычному TCP. Переключатель есть у туннелей HTTP, TCP и TLS; у туннеля UDP его нет.
Протокол PROXY? #
Если включён Протокол PROXY?, туннель передаёт исходный адрес клиента вашему сервису в заголовке протокола PROXY. Включайте его, только если ваш сервис настроен на чтение этого заголовка: сервис, который его не ожидает, увидит незнакомые байты в начале каждого соединения. Переключатель есть у туннелей TCP; у туннеля UDP его нет.
Классическое подключение? #
Классическое подключение? переключает туннель на альтернативный способ подключения. Попробуйте его, если туннель не может подключиться обычным способом, и снова выключите, если это не помогло.
IP локального сервера #
Эта строка есть только у туннелей, у которых в столбце Сервер указано Локальный или VPN. В диалоге IP локального сервера хранятся адреса, по которым доступен ваш локальный сервер: Адрес IPv4 и, по желанию, Адрес IPv6. Оставьте IPv6 пустым, если не используете его. Нужен хотя бы один адрес. Адрес, который работает только на самом устройстве, например 127.0.0.1, 0.0.0.0 или ::1, отклоняется с сообщением «IP локального сервера должен быть доступен извне.»
IP туннеля #
IP туннеля › Показать открывает диалог IP сервера с адресом IPv4 и, если он есть у сервера, адресом IPv6 сервера, на котором работает туннель. Клиенты могут подключаться к туннелю по этому адресу вместо доменного имени.
IP-адреса серверов могут меняться. По возможности используйте в приложениях и скриптах доменное имя.
Настройки в списке туннелей #
Две настройки меняются в списке туннелей, а не в панели.
Смена сервера #
Выберите код сервера в столбце Сервер, укажите другой сервер в диалоге Сменить сервер и нажмите Отправить. Запущенный туннель перезапускается на новом сервере.
- Для смены сервера нужен Balance. Без него панель управления ответит «Чтобы пользоваться этой функцией, пополните баланс.»
- Если порт сервера этого туннеля уже занят на новом сервере, вы получите сообщение «Порт вашего туннеля (PORT) недоступен на выбранном сервере. Сначала смените порт.» Смените порт, как описано в разделе Порты, и повторите попытку.
- Туннели, у которых в столбце Сервер указано Локальный или VPN, перенести нельзя.
После смены сервера обновление DNS может занять до 3 часов.
Смена AuthToken #
Выберите имя токена в столбце AuthToken, чтобы открыть Сменить AuthToken, выберите другой AuthToken и нажмите Отправить. Туннель переносится на устройство, на котором работает приложение Localtonet с этим токеном.
- Запущенный туннель останавливается, ждёт 2 секунды и снова запускается с выбранным AuthToken. Остановленный туннель остаётся остановленным.
- Если приложение с новым токеном не подключено, токен всё равно меняется, а вы получаете сообщение «AuthToken обновлён, но туннель не удалось перезапустить. Подключите приложение Localtonet с выбранным токеном и запустите туннель.»
- Туннели «Ротационный прокси» используют группы AuthToken. Меняйте группы.
AuthToken описаны в разделе AuthToken.
Межсетевой экран веб-приложений #
У туннелей HTTP и MCP-шлюза в столбце Действия есть также кнопка со щитом. Она открывает межсетевой экран туннеля. См. Межсетевой экран веб-приложений.
Те же настройки через API #
Большинство настроек можно также читать и менять через API по пути туннеля. Аутентификация и полный справочник приведены в разделе API.
| Настройка | Путь после /api/v2/tunnels/<TUNNEL_ID>/ |
|---|---|
| Ограничение по IP | ip-restrictions |
| Заголовки | headers, host-header |
| Basic-аутентификация | authentication |
| Срок действия | expiration |
| Порт сервера | server-port |
| Таймаут HTTP | http-timeout |
| Лимиты скорости | rate-limit |
| Лимит трафика и использованный трафик | bandwidth-limit, bandwidth-usage, bandwidth-usage/reset |
| Аргументы | arguments |
| Только HTTPS?, HTTP/3 включён?, Перезапись пути? | https-only, http3, path-rewrite |
| Локальный HTTPS (SslStream)?, Протокол PROXY?, Режим SSL | ssl-stream, proxy-protocol, pass-through |
| Заметка к туннелю | note |
| Сервер | server |
Устранение неполадок #
«Проверьте подключение устройства.»
Настройка перезапускает туннель, а приложение Localtonet на устройстве туннеля не подключено. Запустите приложение на устройстве, дождитесь, пока в столбце Подключение появится ВКЛ, и сохраните ещё раз. Можно также сначала остановить туннель: у остановленного туннеля значение сохраняется без перезапуска.
«Чтобы пользоваться этой функцией, пополните баланс.»
Для настройки нужен Balance на аккаунте. Это относится к зарезервированным портам, собственному порту сервера, фиксированным исходящим портам, ограничениям по IP и смене сервера. См. Тарифы и баланс.
«У вас нет прав на изменение этого туннеля.»
Вы работаете в команде, и ваша роль не позволяет менять туннели. Попросите владельца команды выдать вам это право. См. Управление командой.
В моей панели нет строки из таблицы
Панель показывает только строки, относящиеся к типу туннеля, а некоторые строки зависят от самого туннеля: для IP локального сервера нужен сервер Локальный или VPN, SSO-провайдеры не показываются у командных туннелей, а у туннеля UDP нет строк Локальный HTTPS (SslStream)? и Протокол PROXY?.