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

Справочник по настройкам туннеля

Помощь по этой странице
На этой странице 15 разделов
  1. Как открыть настройки туннеля
  2. Откройте страницу нужного типа туннеля
  3. Нажмите «Настройки» в строке туннеля
  4. Как изменить настройку
  5. Как применяются изменения
  6. Какие настройки есть у какого типа туннеля
  7. Что делает каждая настройка
  8. Сведения о туннеле
  9. Заметка к туннелю
  10. Локальный HTTPS (SslStream)?
  11. Протокол PROXY?
  12. Классическое подключение?
  13. IP локального сервера
  14. IP туннеля
  15. Настройки в списке туннелей
  16. Смена сервера
  17. Смена AuthToken
  18. Межсетевой экран веб-приложений
  19. Те же настройки через API
  20. Устранение неполадок
  21. Связанные страницы

У каждого туннеля в панели управления есть панель настроек. На этой странице показано, где её открыть, перечислены все настройки, указано, для каких типов туннелей они доступны, и даны ссылки на страницы с подробным описанием.

Как открыть настройки туннеля #

  1. Откройте страницу нужного типа туннеля #

    В меню панели управления откройте Мои туннели и выберите тип: Мои туннели › HTTP, TCP - UDP, TLS, Файловый сервер, Прокси-сервер, Ротационный прокси или MCP-шлюз.

  2. Нажмите «Настройки» в строке туннеля #

    Найдите туннель в списке Ваши туннели и нажмите Настройки в столбце Действия. Сбоку страницы откроется панель Настройки туннеля.

  3. Как изменить настройку #

    Панель состоит из таких частей:

    • Сведения о туннеле: данные, такие как адрес туннеля, дата создания и имя 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 на его устройстве подключено. Иначе панель управления ответит «Проверьте подключение устройства.» и оставит прежнее значение. Для остановленного туннеля значение сохраняется и применяется при следующем запуске.

Какие настройки есть у какого типа туннеля #

Названия соответствуют тем, что показывает раздел Настройки. «Да» означает, что у этого типа туннеля такая строка есть.

НастройкаHTTPTCP - UDPTLSФайловый серверПрокси-серверРотационный прокси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>/
Ограничение по IPip-restrictions
Заголовкиheaders, host-header
Basic-аутентификацияauthentication
Срок действияexpiration
Порт сервераserver-port
Таймаут HTTPhttp-timeout
Лимиты скоростиrate-limit
Лимит трафика и использованный трафикbandwidth-limit, bandwidth-usage, bandwidth-usage/reset
Аргументыarguments
Только HTTPS?, HTTP/3 включён?, Перезапись пути?https-only, http3, path-rewrite
Локальный HTTPS (SslStream)?, Протокол PROXY?, Режим SSLssl-stream, proxy-protocol, pass-through
Заметка к туннелюnote
Серверserver

Устранение неполадок #

«Проверьте подключение устройства.»

Настройка перезапускает туннель, а приложение Localtonet на устройстве туннеля не подключено. Запустите приложение на устройстве, дождитесь, пока в столбце Подключение появится ВКЛ, и сохраните ещё раз. Можно также сначала остановить туннель: у остановленного туннеля значение сохраняется без перезапуска.

«Чтобы пользоваться этой функцией, пополните баланс.»

Для настройки нужен Balance на аккаунте. Это относится к зарезервированным портам, собственному порту сервера, фиксированным исходящим портам, ограничениям по IP и смене сервера. См. Тарифы и баланс.

«У вас нет прав на изменение этого туннеля.»

Вы работаете в команде, и ваша роль не позволяет менять туннели. Попросите владельца команды выдать вам это право. См. Управление командой.

В моей панели нет строки из таблицы

Панель показывает только строки, относящиеся к типу туннеля, а некоторые строки зависят от самого туннеля: для IP локального сервера нужен сервер Локальный или VPN, SSO-провайдеры не показываются у командных туннелей, а у туннеля UDP нет строк Локальный HTTPS (SslStream)? и Протокол PROXY?.

Поддержка