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