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

Направление туннеля через определённую сеть

Помощь по этой странице
На этой странице 10 разделов
  1. Перед началом
  2. Шаги
  3. Выведите список сетей устройства
  4. Откройте настройку «Аргументы» туннеля
  5. Укажите сеть
  6. Сохраните
  7. Аргументы в текстовом виде
  8. Для чего используется выбранная сеть
  9. Когда сеть недоступна
  10. Выбор сети для всего клиента
  11. Пример: два прокси на двух модемах
  12. Та же настройка через API
  13. Устранение неполадок
  14. Связанные страницы

Если у устройства больше одного подключения к интернету, например вторая линия или USB-модем, вы можете направить один туннель через определённую сеть. Остальные туннели продолжают использовать подключение по умолчанию. Сеть вы выбираете двумя значениями: её названием и IP-адресом устройства в ней.

Перед началом #

  • Устройство минимум с двумя активными сетями и установленным на нём клиентом Localtonet. См. Установка.
  • Туннель типа, у которого есть настройка Аргументы: HTTP, TCP - UDP, TLS или Прокси-сервер.
  • В Linux запускайте клиент от имени root или с sudo без пароля. Клиент добавляет правила маршрутизации для выбранной сети командой ip; без этого разрешения трафик может уходить через маршрут по умолчанию.

Шаги #

  1. Выведите список сетей устройства #

    На устройстве выполните:

    Терминал
    localtonet --network

    Команде не нужен AuthToken. Она перечисляет все активные сети с их IP-адресами, проверяет каждый адрес IPv4 на доступ в интернет и завершается:

    Вывод
    NetworkName: Ethernet 2
    --net Ethernet 2 --ip 192.168.8.100   --> Internet available (public IP 203.0.113.25)
    --------------------------------------------------
    NetworkName: Wi-Fi
    --net Wi-Fi --ip 192.168.1.20   --> Internet available (public IP 198.51.100.7)
    --net Wi-Fi --ip 2001:db8::20   --> IPv6, internet check not available
    --------------------------------------------------

    Каждая строка, начинающаяся с --net, — готовая пара из названия сети и IP-адреса. Запишите пару нужной вам сети. Строка, оканчивающаяся на No internet access, относится к адресу, для которого проверка доступа в интернет не прошла. После списка команда выводит краткое пояснение по --net и --ip.

  2. Откройте настройку «Аргументы» туннеля #

    В панели управления откройте страницу типа туннеля, выберите Настройки в строке туннеля, затем Аргументы › Управлять. Откроется диалог Выбор сети.

  3. Укажите сеть #

    Включите Использовать определённую сеть и заполните оба поля:

    ПолеЧто ввестиПример
    Название сетиНазвание в точности так, как его выводит localtonet --network после NetworkName:.Ethernet 2
    IP устройства в этой сетиАдрес IPv4 или IPv6 устройства в этой сети, из строки --net этой сети.192.168.8.100

    Передаётся приложению показывает получившиеся аргументы, например --net Ethernet 2 --ip 192.168.8.100.

  4. Сохраните #

    Выберите Сохранить. Работающий туннель перезапускается и с этого момента использует выбранную сеть.

Аргументы в текстовом виде #

Редактировать как текст переключает диалог на одно поле Аргументы, а Заполнить форму возвращает обратно. Текст имеет такой вид:

--net <NETWORK_NAME> --ip <IP_ADDRESS>
  • --net и --ip нужно указывать вместе. Если указан только один из них, у туннеля нет собственной сети: он использует сеть по умолчанию или сеть, выбранную для всего клиента.
  • Название сети с пробелами можно писать как есть или в кавычках: --net Wi-Fi 2 --ip 192.168.1.5 и --net "Wi-Fi 2" --ip 192.168.1.5 означают одно и то же.
  • Сначала название сравнивается точно. Название, отличающееся только регистром, принимается, если ему соответствует ровно одна сеть.
  • IP-адрес должен быть тем, который у устройства сейчас есть в этой сети.

Для чего используется выбранная сеть #

  • Для подключения туннеля от устройства к серверу Localtonet.
  • Для прокси-туннеля — для трафика, который уходит с устройства напрямую в интернет, и для DNS-запросов этого трафика. Если у прокси-туннеля задан Вышестоящий прокси, подключение к вышестоящему прокси не привязывается к выбранной сети.
  • Для подключения к вашей локальной службе, когда эта служба доступна через выбранную сеть. Служба на самом устройстве (127.0.0.1) или в другой локальной сети доступна обычным способом.

Когда сеть недоступна #

Если выбранной сети нет, туннель не переключается на подключение по умолчанию: его соединения остаются закрытыми. Это важно для прокси: трафик не должен уходить через другую линию, не ту, которую вы выбрали.

  • Если сети нет при запуске туннеля, туннель ждёт её.
  • Если сеть пропадает позже, соединения туннеля остаются закрытыми, пока пара из названия сети и IP-адреса снова не станет доступна. Клиент проверяет это каждые несколько секунд и при изменении сетей устройства, и туннель возобновляет работу сам.
  • Если устройство получает в этой сети другой IP-адрес, пара больше не совпадает, и туннель остаётся закрытым. Назначьте устройству в этой сети фиксированный адрес или обновите настройку.

Запустите клиент с вашим токеном и --debug (localtonet --authtoken <YOUR_TOKEN> --debug), чтобы увидеть причину в его выводе ошибок. Строка начинается с отметки времени и [debug][proxy], затем называет туннель по его внутреннему идентификатору, проблему и пару, которую он ждёт:

Вывод клиента
[2026-11-14 10:15:30.123 UTC][debug][proxy] Tunnel <TUNNEL_IDENTIFIER>: Network interface 'Ethernet 2' was not found. Run 'localtonet --network' to list the interfaces. Its connections stay closed until --net Ethernet 2 --ip 192.168.8.100 is available.

Среди других проблем, которые он может назвать: "'192.168.8.100' is not an address of network interface 'Ethernet 2'.", "Network interface 'Ethernet 2' is Down." и "The --ip value is not an IP address."

Выбор сети для всего клиента #

Чтобы выбрать одну сеть для собственного подключения клиента и для всех туннелей без собственной сети, передайте те же два параметра при его запуске:

Терминал
localtonet --authtoken <YOUR_TOKEN> --net <NETWORK_NAME> --ip <IP_ADDRESS>
  • Нужны оба параметра. Если указан только один, клиент выводит "--net and --ip must be given together; the default network is used." и продолжает работать в сети по умолчанию.
  • Если сеть недоступна при запуске, клиент ждёт её до 30 секунд, а затем останавливается с указанием причины, а не работает в другой сети.
  • Туннель, у которого в Аргументы указана своя сеть, использует её. Параметры клиента действуют для туннелей без собственной сети.

Все параметры командной строки перечислены в справочнике по CLI.

Пример: два прокси на двух модемах #

У компьютера два USB-модема. localtonet --network выводит --net Modem A --ip 192.168.8.100 и --net Modem B --ip 192.168.9.100. Создайте два туннеля Прокси-сервер на AuthToken устройства. В первом откройте Аргументы › Управлять и введите Modem A и 192.168.8.100; во втором введите Modem B и 192.168.9.100. Теперь каждый прокси выходит через свой модем, а при отключении модема прокси перестаёт пропускать трафик.

Та же настройка через API #

Аргументы туннеля можно читать (GET) и задавать (PATCH) по адресу /api/v2/tunnels/<TUNNEL_ID>/arguments. Чтобы удалить их, отправьте пустое значение. Значение, заданное через API, используется при следующем запуске туннеля. См. API.

Тело запроса
{ "arguments": "--net Ethernet 2 --ip 192.168.8.100" }

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

«Введите название сети.» или «Введите IP-адрес устройства в этой сети.»

Оба поля обязательны, пока включено Использовать определённую сеть. Чтобы перестать использовать определённую сеть, выключите переключатель и сохраните.

«Введите IP-адрес, например 192.168.8.100.»

Во втором поле нужен IP-адрес устройства в этой сети, а не название сети и не публичный IP-адрес.

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

Сохранение перезапускает работающий туннель, а приложение Localtonet его устройства не подключено. Запустите приложение или остановите туннель и сохраните снова.

Туннель запущен, но не пропускает трафик

Вероятно, выбранная сеть недоступна. Выполните на устройстве localtonet --network и сравните название и IP-адрес с настройкой. Исправьте настройку или поднимите сеть.

В Linux трафик по-прежнему идёт через маршрут по умолчанию

Вероятно, клиент не смог добавить правила маршрутизации. Запустите его от имени root или разрешите sudo без пароля для команды ip, затем перезапустите клиент. Для сети, у которой нет шлюза, клиент правил не добавляет.

localtonet --network выводит "No active network interface with an IP address was found."

У устройства нет сети, которая работает и имеет адрес. Подключите сеть и выполните команду снова.

Поддержка