Встановлення Localtonet у Windows
На цій сторінці 9 розділів
- Перш ніж почати
- Виберіть збірку
- Використання застосунку
- Встановіть і відкрийте застосунок
- Увійдіть за допомогою токена
- Запустіть тунель
- Використання консольного клієнта
- Завантажте й розпакуйте
- Запустіть його зі своїм токеном
- Перевірте сесію
- Запуск як служби Windows
- Встановіть службу
- Переконайтеся, що вона працює
- Команди служби
- Оновлення
- Видалення
- Усунення несправностей
- Пов’язані сторінки
У Windows можна використовувати застосунок Localtonet з Microsoft Store, портативну збірку того самого застосунку або консольний клієнт. Консольний клієнт також може встановити себе як службу Windows, що запускається під час кожного завантаження системи.
Перш ніж почати #
- Обліковий запис Localtonet. Якщо його ще немає, створіть його безкоштовно.
- Ваш AuthToken. Натисніть Копіювати на картці AuthToken на сторінці Панель керування або скопіюйте токен зі сторінки Мої токени.
- Для служби Windows: вікно Командного рядка або PowerShell, запущене від імені адміністратора.
Виберіть збірку #
| Збірка | Завантаження | Примітки |
|---|---|---|
| Застосунок із Microsoft Store | Localtonet у Microsoft Store | Вікно застосунку з екраном входу. Потрібна Windows 10 версії 1809 (збірка 17763) або новіша. |
| Настільний застосунок, портативний ZIP | x64, x86, ARM64 | Той самий застосунок без Store. Розпакуйте ZIP і запустіть застосунок із розпакованої папки. |
| Консольний клієнт | 64-бітна, 32-бітна, ARM64 | ZIP-архів з одним файлом, localtonet.exe. Це збірка, яка підтримує команди керування службою. |
На сторінці Завантаження є застосунок Microsoft Store і три консольні збірки в розділі Бінарні файли.
Використання застосунку #
-
Встановіть і відкрийте застосунок #
Встановіть Localtonet із Microsoft Store або розпакуйте портативний ZIP і запустіть застосунок. Застосунок відкриється на екрані Sign in to Localtonet.
-
Увійдіть за допомогою токена #
Вставте свій AuthToken у поле Authtoken or PIN і натисніть Connect. Якщо токен є в буфері обміну під час відкриття екрана, застосунок підставить його сам. Замість токена можна ввести 6-значний PIN, який показує сторінка Мої токени для токена. PIN дійсний одну хвилину.
Якщо застосунок відповідає
Pin or authtoken is not valid., скопіюйте токен ще раз і переконайтеся, що всі 33 символи на місці. -
Запустіть тунель #
Після входу застосунок показує тунелі, що працюють на цьому пристрої. Поки в списку написано No active tunnels, створіть і запустіть тунель на панелі керування, див. Швидкий старт. Sign Out видаляє токен із застосунку, Quit Localtonet закриває його.
Використання консольного клієнта #
-
Завантажте й розпакуйте #
Завантажте ZIP для вашого процесора й розпакуйте його в папку, яка залишатиметься на місці, наприклад
C:\Localtonet. Служба, яку ви встановите пізніше, запускаєlocaltonet.exeсаме з цієї папки. -
Запустіть його зі своїм токеном #
Відкрийте Командний рядок або PowerShell у цій папці та виконайте:
Командний рядокlocaltonet --authtoken <YOUR_TOKEN>PowerShell запускає програму з поточної папки, лише якщо ви вказуєте шлях, тому там команда має такий вигляд:
PowerShell.\localtonet --authtoken <YOUR_TOKEN>Клієнт зберігає токен локально. Наступного разу його можна запустити просто як
localtonet. Якщо запустити його без збереженого токена, він запитаєPlease Enter AuthToken or PIN. -
Перевірте сесію #
У вікні відображається
Session Status: Connectedнад таблицею з одним рядком для кожного запущеного тунелю:IP/Url,Protocol,Client IP,Client Port,PingіStatus. Таблиця порожня, доки ви не запустите тунель на панелі керування. Назва вашого токена з’являється під таблицею.Натисніть Ctrl + C, щоб зупинити клієнт. Натисніть F12, щоб видалити збережений токен і вийти.
Запуск як служби Windows #
Служба запускає Localtonet під час кожного завантаження системи, підтримує його роботу після виходу з облікового запису й не потребує відкритого терміналу. Виконуйте ці команди консольним клієнтом у Командному рядку або PowerShell, запущених від імені адміністратора.
-
Встановіть службу #
Командний рядок (адміністратор)localtonet --install-service --authtoken <YOUR_TOKEN>Команда реєструє службу Windows для цього токена, задає автоматичний тип запуску й одразу запускає її. У відповідь вона виводить назву служби:
[CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'<TOKEN_PREFIX>— це перші 9 символів вашого токена. Кожен токен має власну службу, тому інші команди для служби потребують того самого--authtoken, щоб її знайти. -
Переконайтеся, що вона працює #
Командний рядок (адміністратор)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, саме до цієї команди. Параметри перелічено в довіднику CLI.
Служба запускає localtonet.exe із папки, у якій він був під час встановлення служби, а токен входить до її команди запуску. Не переміщуйте й не видаляйте файл, поки служба встановлена.
Оновлення #
- Застосунок із Microsoft Store: застосунок оновлює Microsoft Store.
- Консольний клієнт і портативний застосунок: завантажте актуальний ZIP зі сторінки Завантаження і замініть старі файли. Windows не дозволяє замінити
localtonet.exe, поки він працює, тому спершу закрийте клієнт. Якщо він працює як служба, виконайте--stop-service, замініть файл, потім виконайте--start-service.
localtonet --version виводить встановлену версію. На сторінці Мої токени у стовпці Клієнт показано версію, про яку пристрій повідомив востаннє, а також позначку Потрібне оновлення, коли доступна новіша.
Видалення #
- Якщо ви встановлювали службу, видаліть її:
localtonet --remove-service --authtoken <YOUR_TOKEN>від імені адміністратора. - Щоб видалити збережений токен, запустіть консольний клієнт і натисніть F12.
- Видаліть папку з
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 і надайте облікові дані в середовищі служби. Див. довідник CLI.
Wrong Token!
Клієнт очікує 33-символьний AuthToken зі сторінки Мої токени або 6-значний PIN, строк дії якого не минув. Скопіюйте токен ще раз і введіть його у відповідь на запит.
This token is used in another localtonet application!
Інше вікно Localtonet на цьому комп’ютері вже працює з тим самим токеном. Закрийте його або запустіть це вікно з іншим токеном. Використовуйте один запущений клієнт на токен.
Токен залишається Офлайн на панелі керування
Офлайн означає, що пристрій відключено. Переконайтеся, що вікно клієнта досі відкрите або що статус служби Running, і що клієнт запущено з тим токеном, який ви переглядаєте.