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

Установка Localtonet в Windows

Помощь по этой странице
На этой странице 9 разделов
  1. Перед началом
  2. Выбор сборки
  3. Использование приложения
  4. Установите и откройте приложение
  5. Войдите с помощью токена
  6. Запустите туннель
  7. Использование консольного клиента
  8. Скачайте и распакуйте
  9. Запустите его с вашим токеном
  10. Проверьте сессию
  11. Запуск как служба Windows
  12. Установите службу
  13. Проверьте, что она работает
  14. Команды службы
  15. Обновление
  16. Удаление
  17. Устранение неполадок
  18. Связанные страницы

В Windows можно использовать приложение Localtonet из Microsoft Store, портативную сборку того же приложения или консольный клиент. Консольный клиент также умеет устанавливать себя как служба Windows, которая запускается при каждой загрузке системы.

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

  • Аккаунт Localtonet. Если его нет, создайте его бесплатно.
  • Ваш AuthToken. Нажмите Копировать в карточке AuthToken на странице Панель управления или скопируйте токен на странице Мои токены.
  • Для службы Windows: окно «Командная строка» или PowerShell, запущенное от имени администратора.

Выбор сборки #

СборкаЗагрузкаПримечания
Приложение из Microsoft StoreLocaltonet в Microsoft StoreОкно приложения с экраном входа. Требуется Windows 10 версии 1809 (сборка 17763) или новее.
Приложение для рабочего стола, портативный ZIPx64, x86, ARM64То же приложение без Store. Распакуйте ZIP и запустите приложение из распакованной папки.
Консольный клиент64-разрядная, 32-разрядная, ARM64ZIP-архив с одним файлом, localtonet.exe. Именно эта сборка предлагает команды для работы со службой.

На странице Загрузки в разделе Сборки доступны приложение из Microsoft Store и три консольные сборки.

Использование приложения #

  1. Установите и откройте приложение #

    Установите Localtonet из Microsoft Store или распакуйте портативный ZIP и запустите приложение. Приложение откроется на экране Sign in to Localtonet.

  2. Войдите с помощью токена #

    Вставьте AuthToken в поле Authtoken or PIN и нажмите Connect. Если при открытии экрана токен находится в буфере обмена, приложение подставит его само. Вместо токена можно ввести 6-значный PIN-код, который страница Мои токены показывает для токена. PIN-код действует одну минуту.

    Если приложение отвечает Pin or authtoken is not valid., скопируйте токен ещё раз и проверьте, что все 33 символа на месте.

  3. Запустите туннель #

    После входа приложение показывает список туннелей, работающих на этом устройстве. Пока в списке написано No active tunnels, создайте и запустите туннель в панели управления, см. Быстрый старт. Кнопка Sign Out удаляет токен из приложения, а Quit Localtonet закрывает его.

Использование консольного клиента #

  1. Скачайте и распакуйте #

    Скачайте ZIP для вашего процессора и распакуйте его в папку, которая останется на месте, например C:\Localtonet. Служба, которую вы установите позже, запускает localtonet.exe из этой папки.

  2. Запустите его с вашим токеном #

    Откройте «Командную строку» или PowerShell в этой папке и выполните:

    Командная строка
    localtonet --authtoken <YOUR_TOKEN>

    PowerShell запускает программу из текущей папки, только если указать путь, поэтому там команда выглядит так:

    PowerShell
    .\localtonet --authtoken <YOUR_TOKEN>

    Клиент сохраняет токен локально. В следующий раз его можно запускать просто командой localtonet. Если запустить его без сохранённого токена, он спросит Please Enter AuthToken or PIN.

  3. Проверьте сессию #

    В окне отображается Session Status: Connected над таблицей с одной строкой на каждый работающий туннель: IP/Url, Protocol, Client IP, Client Port, Ping и Status. Пока вы не запустите туннель в панели управления, таблица пуста. Под таблицей отображается имя вашего токена.

    Нажмите Ctrl + C, чтобы остановить клиент. Нажмите F12, чтобы удалить сохранённый токен и выйти.

Запуск как служба Windows #

Служба запускает Localtonet при каждой загрузке, продолжает работать после выхода из системы и не требует открытого терминала. Выполняйте эти команды с консольным клиентом в «Командной строке» или PowerShell, запущенных от имени администратора.

  1. Установите службу #

    Командная строка (администратор)
    localtonet --install-service --authtoken <YOUR_TOKEN>

    Команда регистрирует службу Windows для этого токена, задаёт автоматический тип запуска и сразу запускает её. В ответ она выводит имя службы:

    [CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'

    <TOKEN_PREFIX> — это первые 9 символов вашего токена. У каждого токена своя служба, поэтому остальным командам для работы со службой нужен тот же --authtoken, чтобы её найти.

  2. Проверьте, что она работает #

    Командная строка (администратор)
    localtonet --status-service --authtoken <YOUR_TOKEN>

    Работающая служба отвечает [CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running. Служба также видна в services.msc под тем же именем, с описанием Localtonet Service. В панели управления токен на странице Мои токены отображается как Онлайн.

Команды службы #

Добавляйте --authtoken <YOUR_TOKEN> к каждой команде.

КомандаЧто делаетНужны права администратора
--install-serviceСоздаёт службу с автоматическим запуском и запускает её. Windows перезапускает службу через одну минуту после сбоя.Да
--start-serviceЗапускает установленную службу, например после того, как вы её остановили.Да
--stop-serviceОстанавливает службу. При следующей загрузке она запустится снова.Да
--status-serviceВыводит состояние: Running, Stopped, Installing, пока служба запускается, Paused, NotFound, если для этого токена службы нет, Error или Unknown.Нет
--remove-serviceОстанавливает службу и удаляет её.Да

Служба устанавливается с теми параметрами, которые вы передаёте вместе с --install-service, поэтому параметры клиента, такие как --net и --ip, добавляйте в эту команду. Параметры перечислены в Справочнике по командной строке.

Служба запускает localtonet.exe из той папки, в которой он находился при установке службы, а токен входит в её команду запуска. Не перемещайте и не удаляйте этот файл, пока служба установлена.

Обновление #

  • Приложение из Microsoft Store: приложение обновляет Microsoft Store.
  • Консольный клиент и портативное приложение: скачайте актуальный ZIP на странице Загрузки и замените старые файлы. Windows не позволяет заменить localtonet.exe, пока он работает, поэтому сначала закройте клиент. Если он работает как служба, выполните --stop-service, замените файл, затем выполните --start-service.

localtonet --version выводит установленную версию. На странице Мои токены в столбце Клиент показана версия, о которой устройство сообщило в последний раз, и значок Требуется обновление, когда доступна более новая.

Удаление #

  1. Если вы устанавливали службу, удалите её: localtonet --remove-service --authtoken <YOUR_TOKEN> от имени администратора.
  2. Чтобы удалить сохранённый токен, запустите консольный клиент и нажмите F12.
  3. Удалите папку с localtonet.exe или деинсталлируйте приложение из Store в разделе «Параметры» Windows.

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

'localtonet' is not recognized

Терминал открыт не в той папке, где находится localtonet.exe, либо вы работаете в PowerShell. Сначала перейдите в нужную папку. В PowerShell запускайте клиент как .\localtonet.

Install failed: 'Windows service installation' requires elevated (admin/root) privileges.

Терминал запущен не от имени администратора. Откройте «Командную строку» или PowerShell через Запуск от имени администратора и повторите команду. --start-service, --stop-service и --remove-service отвечают сообщениями того же вида.

Install failed: Service 'Localtonet_…' already exists.

Служба для этого токена уже установлена. Проверьте её командой --status-service. Чтобы установить её заново, например с другими параметрами или из другой папки, сначала выполните --remove-service.

Start failed: Service could not be started

Сообщение включает ответ утилиты Windows sc. Ошибка 1056 означает, что служба уже запущена. Это ожидаемо, если вы выполняете --start-service сразу после --install-service, потому что команда установки уже запускает службу. Ошибка 1060 означает, что для этого токена службы не существует.

Статус NotFound, хотя я установил службу

Имя службы строится из токена. Если вы передаёте не тот токен, с которым устанавливали службу, клиент ищет другую службу. Используйте тот же токен или найдите в services.msc службу, имя которой начинается с Localtonet_.

Service installation cannot persist proxy passwords.

Вы совместили --install-service с --proxy-user или с URL прокси, содержащим пароль. Служба не устанавливается с паролями прокси. Используйте --proxy env и передайте учётные данные через окружение службы. См. Справочник по командной строке.

Wrong Token!

Клиент ожидает 33-символьный AuthToken со страницы Мои токены или неистёкший 6-значный PIN-код. Скопируйте токен ещё раз и введите его в строке запроса.

This token is used in another localtonet application!

На этом компьютере уже работает другое окно Localtonet с тем же токеном. Закройте его или запустите это окно с другим токеном. На один токен — один работающий клиент.

Токен остаётся Офлайн в панели управления

Офлайн означает, что устройство отключено. Проверьте, что окно клиента всё ещё открыто или что состояние службы — Running, и что клиент запущен с тем токеном, который вы смотрите.

Поддержка