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

Термінал пристроїв

Безкоштовно Desktop v8.6+ Windows, Linux і macOS

Допомога зі сторінкою
На цій сторінці 13 розділів
  1. Як це працює
  2. Перш ніж почати
  3. Додавання пристрою
  4. Натисніть «Додати пристрій»
  5. Виберіть токен
  6. Виконайте команду на комп’ютері
  7. Введіть код і підтвердьте
  8. Без людини біля комп’ютера
  9. Параметри команди
  10. Список пристроїв
  11. Відкриття терміналу в браузері
  12. Натисніть «Термінал»
  13. Введіть код автентифікатора
  14. Підключення через ssh
  15. SSH-ключі
  16. За допомогою клієнта Localtonet
  17. Ключі доступу для скриптів і ШІ-агентів
  18. Elio
  19. Історія підключень
  20. Перейменування, видалення або вимкнення пристрою
  21. Примітки щодо безпеки
  22. Усунення несправностей
  23. Пов’язані сторінки

«Мої пристрої» показує ваші комп’ютери з навантаженням на CPU, пам’ять і диск і відкриває справжню оболонку на будь-якому з них прямо у браузері. Ви вмикаєте цю функцію однією командою на самому комп’ютері; нічого на ньому не має слухати публічний порт.

Як це працює #

Ви запускаєте localtonet --terminal enable на комп’ютері та підтверджуєте в панелі керування короткий код, який вона виводить. Відтоді кнопка Термінал відкриває оболонку на цьому комп’ютері у вкладці браузера. До тієї самої оболонки можна підключитися з будь-якого терміналу командою ssh, яку показує панель керування.

  • Пристрій лише встановлює вихідні з’єднання. Не потрібно відкривати вхідні порти чи встановлювати SSH-сервер.
  • Щоб відкрити оболонку з браузера, щоразу потрібен свіжий код із вашого застосунку-автентифікатора.
  • Увімкнути термінал може лише локальна команда. З панелі керування його ввімкнути не можна.

Перш ніж почати #

  • Localtonet на комп’ютері. Мінімальна версія застосунку Localtonet для цієї функції: Desktop v8.6. Завантажте її на сторінці Завантаження.
  • AuthToken для цього комп’ютера. Давайте кожному комп’ютеру окремий токен: якщо запустити один токен на другому комп’ютері, перший буде відключено. Термінал працює з токенами вашого особистого облікового запису, а не з токенами команди. Див. AuthToken.
  • Двофакторна автентифікація. Щоб відкрити оболонку, у вашому обліковому записі має бути застосунок-автентифікатор. Якщо його ще не налаштовано, «Мої пристрої» покаже Увімкнути двофакторну автентифікацію. Див. Обліковий запис і безпека.

«Мої пристрої» є в меню вашої особистої панелі керування. Коли вибрано команду, цього пункту немає.

Додавання пристрою #

  1. Натисніть «Додати пристрій» #

    Відкрийте Мої пристрої і виберіть Додати пристрій.

  2. Виберіть токен #

    Виберіть наявний токен або натисніть Створити новий токен, щоб створити його й одразу вставити в команду. Якщо Localtonet уже працює на цьому комп’ютері, виберіть його токен. У списку позначено токени, які онлайн або вже використовуються на іншому пристрої. Для токена, що підключений просто зараз, показується попередження: використовуйте його, лише якщо Localtonet запущено саме на цьому комп’ютері.

  3. Виконайте команду на комп’ютері #

    Скопіюйте команду з діалогу та виконайте її в терміналі на комп’ютері, який хочете додати. Якщо 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: і пропонує ваш власний обліковий запис. Без цих прав оболонки запускаються від імені облікового запису, який виконав команду.

  4. Введіть код і підтвердьте #

    Повернувшись до діалогу, введіть код підтвердження в полі 2. Введіть код, який він покаже. Великі літери й дефіс додаються автоматично, а також можна вставити весь рядок, який вивела команда. Введіть 6-значний код зі свого застосунку-автентифікатора та натисніть Підтвердити пристрій.

    Після цього команда на комп’ютері виводить Terminal enabled. Shells will run as …, а пристрій з’являється в списку. Він має статус «онлайн», поки на ньому працює Localtonet.

Код підтвердження дійсний 15 хвилин. Він складається з 8 символів і ніколи не містить I, L, O, U, 0 або 1. Якщо термін дії минув, команда повідомить про це: запустіть її знову.

Після підтвердження команда, яку ви запустили вручну в консолі, продовжує працювати як звичайний запуск Localtonet. У скрипті, або коли Localtonet уже працює на пристрої з цим токеном, команда завершується одразу після ввімкнення терміналу.

Без людини біля комп’ютера #

Для комп’ютера, на якому ніхто не може прочитати код, наприклад сервера, який ви налаштовуєте скриптом, замість коду підтвердження використовуйте одноразовий ключ.

  1. У діалозі Додати пристрій виберіть токен і введіть код зі свого автентифікатора.
  2. Відкрийте На цьому комп’ютері ніхто не може прочитати код? і натисніть Створити одноразовий ключ. Ключ дійсний одну годину й спрацьовує лише один раз.
  3. Скопіюйте команду та замініть 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Поточне навантаження процесора. Показується, поки пристрій онлайн.
Пам’ятьВикористана пам’ять із загального обсягу. Показується, поки пристрій онлайн.
ДискВикористане місце на диску із загального обсягу. Показується, поки пристрій онлайн.
ДіїТермінал, Ключі, історія підключень, перейменування та видалення.

Відкриття терміналу в браузері #

  1. Натисніть «Термінал» #

    У рядку пристрою натисніть Термінал. Кнопка працює, лише поки пристрій онлайн. Діалог показує, від імені якого облікового запису запускається оболонка.

  2. Введіть код автентифікатора #

    Введіть 6-значний код зі свого застосунку-автентифікатора та натисніть Відкрити термінал. Оболонка відкриється в новій вкладці браузера.

Підключення через ssh #

Діалог Термінал також показує команду в розділі Або з будь-якого терміналу, нічого не встановлюючи. Вона працює з будь-якого комп’ютера з клієнтом ssh. Команда має такий вигляд, де <DEVICE> — назва вашого пристрою, а <NODE> — сервер Localtonet, до якого він підключений:

Будь-який термінал
ssh -p 24 <DEVICE>@<NODE>

Скопіюйте команду з діалогу: він показує точну команду для вашого пристрою.

  • Діалог показує Відбиток сервера. Під час першого підключення ssh також показує відбиток. Якщо вони збігаються, ви підключилися саме до Localtonet.
  • Якщо ви не додали SSH-ключ, ssh покаже посилання для підтвердження в браузері. Сторінка Підтвердження підключення називає пристрій і IP-адресу, з якої надійшов запит. Введіть код автентифікатора, натисніть Дозволити підключення і поверніться до свого терміналу. Запит дійсний 5 хвилин.

Підтверджуйте підключення, лише якщо ви щойно самі виконали команду ssh. Той, хто надіслав запит, отримує оболонку на цьому комп’ютері.

SSH-ключі #

Додайте публічний SSH-ключ свого комп’ютера, щоб ssh, scp і sftp підключалися без підтвердження в браузері.

  1. У розділі Мої пристрої натисніть SSH-ключі.
  2. Введіть Назва та вставте в поле Публічний ключ один рядок файлу публічного ключа, наприклад ~/.ssh/id_ed25519.pub. Ніколи не вставляйте приватний ключ.
  3. Введіть код автентифікатора та натисніть Додати ключ.

Підтримувані типи ключів: 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 із посиланням і продовжує після вашого підтвердження. Усе, що стоїть після --, виконується на пристрої як одна команда замість відкриття оболонки.

Ключі доступу для скриптів і ШІ-агентів #

Ключ доступу дозволяє скрипту або ШІ-агенту дістатися одного комп’ютера без браузера. Хто має цей ключ, може виконувати там команди, тому зберігайте його в таємниці.

  1. У рядку пристрою натисніть Ключі.
  2. Введіть Назва, вкажіть Термін дії (днів) і введіть код автентифікатора. Ключ перестає працювати після цієї кількості днів, максимум 3650.
  3. Натисніть Створити ключ і скопіюйте його одразу. Знову його не буде показано.

Як використовувати ключ:

  • 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.

Підтримка