Перейти к содержимому
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 прекращает доступ для всех его ключей.

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

That approval code is wrong or has expired

Сверьте код с тем, который вывела команда. Код действителен 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>.

Кнопка «Терминал» отключена или появляется This device is offline

Терминал открывается, только пока устройство онлайн. Запустите Localtonet на этом компьютере с тем же токеном.

That authenticator code is not correct

Введите 6-значный код, который приложение-аутентификатор показывает для Localtonet. Это не ваш пароль и не код, показанный на компьютере, и он меняется каждые 30 секунд.

This request has expired. Start again from My Devices

Запрос на открытие терминала или подтверждение ssh-подключения действует недолго. Нажмите Терминал ещё раз или снова выполните команду ssh.

That doesn't look like an SSH public key

Вставьте всю строку из файла .pub, начиная с типа ключа.

The terminal is already enabled on this device

Ничего делать не нужно. Чтобы выполнить сопряжение машины заново, сначала выполните --terminal disable, затем --terminal enable.

Поддержка