Термінал пристроїв
Безкоштовно Desktop v8.6+ Windows, Linux і macOS
На цій сторінці 13 розділів
- Як це працює
- Перш ніж почати
- Додавання пристрою
- Натисніть «Додати пристрій»
- Виберіть токен
- Виконайте команду на комп’ютері
- Введіть код і підтвердьте
- Без людини біля комп’ютера
- Параметри команди
- Список пристроїв
- Відкриття терміналу в браузері
- Натисніть «Термінал»
- Введіть код автентифікатора
- Підключення через ssh
- SSH-ключі
- За допомогою клієнта Localtonet
- Ключі доступу для скриптів і ШІ-агентів
- Elio
- Історія підключень
- Перейменування, видалення або вимкнення пристрою
- Примітки щодо безпеки
- Усунення несправностей
- Пов’язані сторінки
«Мої пристрої» показує ваші комп’ютери з навантаженням на CPU, пам’ять і диск і відкриває справжню оболонку на будь-якому з них прямо у браузері. Ви вмикаєте цю функцію однією командою на самому комп’ютері; нічого на ньому не має слухати публічний порт.
Як це працює #
Ви запускаєте localtonet --terminal enable на комп’ютері та підтверджуєте в панелі керування короткий код, який вона виводить. Відтоді кнопка Термінал відкриває оболонку на цьому комп’ютері у вкладці браузера. До тієї самої оболонки можна підключитися з будь-якого терміналу командою ssh, яку показує панель керування.
- Пристрій лише встановлює вихідні з’єднання. Не потрібно відкривати вхідні порти чи встановлювати SSH-сервер.
- Щоб відкрити оболонку з браузера, щоразу потрібен свіжий код із вашого застосунку-автентифікатора.
- Увімкнути термінал може лише локальна команда. З панелі керування його ввімкнути не можна.
Перш ніж почати #
- Localtonet на комп’ютері. Мінімальна версія застосунку Localtonet для цієї функції: Desktop v8.6. Завантажте її на сторінці Завантаження.
- AuthToken для цього комп’ютера. Давайте кожному комп’ютеру окремий токен: якщо запустити один токен на другому комп’ютері, перший буде відключено. Термінал працює з токенами вашого особистого облікового запису, а не з токенами команди. Див. AuthToken.
- Двофакторна автентифікація. Щоб відкрити оболонку, у вашому обліковому записі має бути застосунок-автентифікатор. Якщо його ще не налаштовано, «Мої пристрої» покаже Увімкнути двофакторну автентифікацію. Див. Обліковий запис і безпека.
«Мої пристрої» є в меню вашої особистої панелі керування. Коли вибрано команду, цього пункту немає.
Додавання пристрою #
-
Натисніть «Додати пристрій» #
Відкрийте Мої пристрої і виберіть Додати пристрій.
-
Виберіть токен #
Виберіть наявний токен або натисніть Створити новий токен, щоб створити його й одразу вставити в команду. Якщо Localtonet уже працює на цьому комп’ютері, виберіть його токен. У списку позначено токени, які онлайн або вже використовуються на іншому пристрої. Для токена, що підключений просто зараз, показується попередження: використовуйте його, лише якщо Localtonet запущено саме на цьому комп’ютері.
-
Виконайте команду на комп’ютері #
Скопіюйте команду з діалогу та виконайте її в терміналі на комп’ютері, який хочете додати. Якщо Localtonet працює там як служба, скористайтеся терміналом від імені адміністратора або
sudo.На комп’ютеріlocaltonet --terminal enable --authtoken <YOUR_TOKEN>Команда виводить код підтвердження й очікує:
ВивідApproval code: ABCD-EFGH Open https://localtonet.com/devices, choose Add device and enter this code. Waiting for approval...Якщо ви запускаєте її від імені адміністратора або root, вона спершу запитує Run shells as user: і пропонує ваш власний обліковий запис. Без цих прав оболонки запускаються від імені облікового запису, який виконав команду.
-
Введіть код і підтвердьте #
Повернувшись до діалогу, введіть код підтвердження в полі 2. Введіть код, який він покаже. Великі літери й дефіс додаються автоматично, а також можна вставити весь рядок, який вивела команда. Введіть 6-значний код зі свого застосунку-автентифікатора та натисніть Підтвердити пристрій.
Після цього команда на комп’ютері виводить Terminal enabled. Shells will run as …, а пристрій з’являється в списку. Він має статус «онлайн», поки на ньому працює Localtonet.
Код підтвердження дійсний 15 хвилин. Він складається з 8 символів і ніколи не містить I, L, O, U, 0 або 1. Якщо термін дії минув, команда повідомить про це: запустіть її знову.
Після підтвердження команда, яку ви запустили вручну в консолі, продовжує працювати як звичайний запуск Localtonet. У скрипті, або коли Localtonet уже працює на пристрої з цим токеном, команда завершується одразу після ввімкнення терміналу.
Без людини біля комп’ютера #
Для комп’ютера, на якому ніхто не може прочитати код, наприклад сервера, який ви налаштовуєте скриптом, замість коду підтвердження використовуйте одноразовий ключ.
- У діалозі Додати пристрій виберіть токен і введіть код зі свого автентифікатора.
- Відкрийте На цьому комп’ютері ніхто не може прочитати код? і натисніть Створити одноразовий ключ. Ключ дійсний одну годину й спрацьовує лише один раз.
- Скопіюйте команду та замініть
ACCOUNTна обліковий запис, від імені якого мають запускатися оболонки на цьому комп’ютері.
localtonet --terminal enable --authtoken <YOUR_TOKEN> --terminal-user <ACCOUNT> --pairing-key <PAIRING_KEY>З дійсним ключем пристрій підтверджується одразу, і код не показується.
Параметри команди #
| Параметр | Що робить |
|---|---|
--terminal enable | Вмикає віддалений термінал на цьому комп’ютері та починає з’єднання. |
--terminal disable | Вимикає його на цьому комп’ютері та видаляє пристрій зі свого облікового запису. |
--terminal status | Показує, чи ввімкнено термінал і від імені якого облікового запису запускаються оболонки. |
--terminal-user <ACCOUNT> | Обліковий запис, від імені якого запускаються оболонки, коли ви вмикаєте термінал від root або адміністратора. У цьому разі параметр обов’язковий, якщо команда виконується без консолі, наприклад зі скрипта. |
--pairing-key <PAIRING_KEY> | Одноразовий ключ із панелі керування, тож код підтвердження не потрібен. |
Список пристроїв #
Поки сторінка відкрита, список оновлюється автоматично.
| Стовпець | Що показує |
|---|---|
| Пристрій | Назва комп’ютера, його операційна система та архітектура, а також обліковий запис, від імені якого запускаються оболонки. |
| Статус | Онлайн означає, що Localtonet працює на комп’ютері та підключений. |
| CPU | Поточне навантаження процесора. Показується, поки пристрій онлайн. |
| Пам’ять | Використана пам’ять із загального обсягу. Показується, поки пристрій онлайн. |
| Диск | Використане місце на диску із загального обсягу. Показується, поки пристрій онлайн. |
| Дії | Термінал, Ключі, історія підключень, перейменування та видалення. |
Відкриття терміналу в браузері #
-
Натисніть «Термінал» #
У рядку пристрою натисніть Термінал. Кнопка працює, лише поки пристрій онлайн. Діалог показує, від імені якого облікового запису запускається оболонка.
-
Введіть код автентифікатора #
Введіть 6-значний код зі свого застосунку-автентифікатора та натисніть Відкрити термінал. Оболонка відкриється в новій вкладці браузера.
Підключення через ssh #
Діалог Термінал також показує команду в розділі Або з будь-якого терміналу, нічого не встановлюючи. Вона працює з будь-якого комп’ютера з клієнтом ssh. Команда має такий вигляд, де <DEVICE> — назва вашого пристрою, а <NODE> — сервер Localtonet, до якого він підключений:
ssh -p 24 <DEVICE>@<NODE>Скопіюйте команду з діалогу: він показує точну команду для вашого пристрою.
- Діалог показує Відбиток сервера. Під час першого підключення ssh також показує відбиток. Якщо вони збігаються, ви підключилися саме до Localtonet.
- Якщо ви не додали SSH-ключ, ssh покаже посилання для підтвердження в браузері. Сторінка Підтвердження підключення називає пристрій і IP-адресу, з якої надійшов запит. Введіть код автентифікатора, натисніть Дозволити підключення і поверніться до свого терміналу. Запит дійсний 5 хвилин.
Підтверджуйте підключення, лише якщо ви щойно самі виконали команду ssh. Той, хто надіслав запит, отримує оболонку на цьому комп’ютері.
SSH-ключі #
Додайте публічний SSH-ключ свого комп’ютера, щоб ssh, scp і sftp підключалися без підтвердження в браузері.
- У розділі Мої пристрої натисніть SSH-ключі.
- Введіть Назва та вставте в поле Публічний ключ один рядок файлу публічного ключа, наприклад
~/.ssh/id_ed25519.pub. Ніколи не вставляйте приватний ключ. - Введіть код автентифікатора та натисніть Додати ключ.
Підтримувані типи ключів: ssh-ed25519, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384, ecdsa-sha2-nistp521 і ssh-rsa. Ключ діє для всіх пристроїв вашого облікового запису. Натисніть Видалити біля ключа, щоб він перестав працювати. Діалог також показує приклад scp для одного з ваших пристроїв:
scp -P 24 file.txt <DEVICE>@<NODE>:/tmp/За допомогою клієнта Localtonet #
Якщо Localtonet встановлено на комп’ютері, з якого ви підключаєтеся, підключитися можна й через localtonet ssh, і сеанс залишається зашифрованим до самого пристрою.
localtonet ssh <DEVICE>
localtonet ssh <DEVICE> -- uptimeБез ключа вона виводить Approve this connection in your browser із посиланням і продовжує після вашого підтвердження. Усе, що стоїть після --, виконується на пристрої як одна команда замість відкриття оболонки.
Ключі доступу для скриптів і ШІ-агентів #
Ключ доступу дозволяє скрипту або ШІ-агенту дістатися одного комп’ютера без браузера. Хто має цей ключ, може виконувати там команди, тому зберігайте його в таємниці.
- У рядку пристрою натисніть Ключі.
- Введіть Назва, вкажіть Термін дії (днів) і введіть код автентифікатора. Ключ перестає працювати після цієї кількості днів, максимум 3650.
- Натисніть Створити ключ і скопіюйте його одразу. Знову його не буде показано.
Як використовувати ключ:
- ssh. Виконайте команду ssh, яку показує діалог. Коли ssh запросить, вставте ключ.
- Клієнт Localtonet. Передайте ключ параметром
--key, як у прикладі нижче. - MCP. ШІ-агенти, підключені до MCP-сервера Localtonet, можуть передати ключ інструменту
RunDeviceCommand.
localtonet ssh <DEVICE> --key <ACCESS_KEY> -- uptimeДіалог показує ключі пристрою з датою завершення терміну дії. Натисніть Видалити, щоб відкликати ключ.
Elio #
Кнопка Elio у «Мої пристрої» стосується Elio — безкоштовного SSH-клієнта з відкритим кодом від Localtonet. Ви завантажуєте його на elio.sh, входите в Elio та підтверджуєте запит у панелі керування своїм двофакторним кодом. Після цього Elio бачить назви та статус ваших пристроїв. Щоб відкрити на одному з них оболонку, усе одно потрібен ключ доступу цього пристрою або підтвердження. Діалог показує копії Elio, у яких виконано вхід; видалення однієї з них виконує вихід.
Історія підключень #
Натисніть кнопку з годинником у рядку пристрою, щоб побачити його останні підключення. Кожен рядок показує, коли воно відбулося, яким способом і з якої IP-адреси. Спосіб може бути таким: термінал у браузері, ssh із вашим SSH-ключем, ssh із ключем доступу, ssh, підтверджений у браузері, localtonet ssh із ключем доступу або підтверджений у браузері, а також ШІ-агент через MCP із ключем доступу. У списку зберігається 50 останніх підключень.
Localtonet зберігає лише цей запис. Команди, які ви вводите, та їхній вивід не зберігаються. Користуйтеся списком, щоб помітити підключення, яке ви не робили: якщо знайдете таке, видаліть ключі доступу та SSH-ключі, які вам більше не потрібні.
Перейменування, видалення або вимкнення пристрою #
| Дія | Де | Результат |
|---|---|---|
| Перейменувати | Кнопка з олівцем у рядку. | Змінює назву, яка показується в списку й використовується в команді ssh. Використовуйте літери, цифри, крапки, дефіси або підкреслення. |
| Видалити | Кнопка зі смітником у рядку. | Видаляє комп’ютер зі свого облікового запису. Його ключі перестають працювати, і щоб повернути комп’ютер, його потрібно підтвердити знову. |
| Вимкнути | На самому комп’ютері. | Локально вимикає термінал і видаляє пристрій зі свого облікового запису. |
localtonet --terminal disable --authtoken <YOUR_TOKEN>
localtonet --terminal status --authtoken <YOUR_TOKEN>Вимкнення завжди працює на самому комп’ютері, навіть якщо панель керування недоступна. У такому разі команда радить також видалити пристрій у панелі керування.
Примітки щодо безпеки #
- Оболонка на комп’ютері — це повний доступ до всього, що може робити її обліковий запис. Обирайте обліковий запис для оболонок обережно: непривілейований обліковий запис обмежує те, що може змінити сеанс.
- Усе, що може привести до оболонки, вимагає свіжого коду автентифікатора: підтвердження пристрою, відкриття терміналу, створення ключа доступу, додавання SSH-ключа та підтвердження підключення ssh.
- Ключ доступу або доданий SSH-ключ підключає без цього коду. Давайте ключам короткий термін дії, зберігайте їх як паролі та видаляйте ті, які вам більше не потрібні.
- Після надто великої кількості спроб за короткий час панель керування відповідає Забагато спроб. Зачекайте хвилину й повторіть.
- Час від часу переглядайте історію підключень. Підключення, яке ви не впізнаєте, означає, що було використано ключ або підтвердження, якого ви не очікували.
- Видалення пристрою або виконання на ньому
--terminal disableзакриває доступ для всіх його ключів.
Усунення несправностей #
Код підтвердження неправильний або прострочений.
Порівняйте код із тим, який вивела команда. Код дійсний 15 хвилин і належить обліковому запису власника токена з команди. Виконайте команду знову, щоб отримати новий код.
Remote terminal is available on personal tokens only
Токен у команді належить команді. Створіть токен у своєму особистому обліковому записі та використайте його.
The pairing key is not valid or has expired
Одноразовий ключ діє один раз і одну годину. Створіть новий у діалозі Додати пристрій.
Choose the account for shells with --terminal-user
Команда запущена від імені root або адміністратора без консолі, тож не може запитати. Додайте --terminal-user <ACCOUNT>.
Кнопка «Термінал» вимкнена, або з’являється «Пристрій офлайн»
Термінал відкривається, лише поки пристрій онлайн. Запустіть Localtonet на цьому комп’ютері з тим самим токеном.
Код автентифікатора неправильний.
Введіть 6-значний код, який ваш застосунок-автентифікатор показує для Localtonet. Це не ваш пароль і не код, показаний на комп’ютері, і він змінюється кожні 30 секунд.
Термін дії запиту минув. Почніть знову з розділу «Мої пристрої».
Запит на відкриття терміналу або підтвердження підключення ssh діє недовго. Натисніть Термінал ще раз або знову виконайте команду ssh.
Це не схоже на публічний SSH-ключ.
Вставте весь рядок із файлу .pub, починаючи з типу ключа.
The terminal is already enabled on this device
Нічого робити не потрібно. Щоб повторно з’єднати комп’ютер, спершу виконайте --terminal disable, потім --terminal enable.