Удаленная разработка и управление

В этом руководстве описаны четыре темы: как открыть доступ к VelaTerm для других устройств в вашей сети, как подключаться к другим компьютерам по SSH или по ссылке сопряжения, как делиться диалогами со своими устройствами через аккаунт VelaTerm и как передавать файлы на удалённые компьютеры и обратно.

1. Точки входа

Удалённые функции находятся в правой части строки заголовка:

• Значок глобуса — это «Удалённый доступ (браузер)». Он позволяет телефону, планшету или другому компьютеру в вашей сети работать с этим VelaTerm через веб-браузер. Пока сервер работает, значок подсвечен акцентным цветом, а во всплывающей подсказке добавляется «Работает · порт N».
• Значок со стрелкой — это «Подключиться к удалённому серверу». Он делает этот компьютер клиентом другого компьютера: по SSH, по ссылке сопряжения или через ваш аккаунт VelaTerm.
• Значок человека — это кнопка «Аккаунт» с пометкой «Экспериментальная функция». С её помощью этот компьютер входит в аккаунт VelaTerm, после чего можно через интернет делиться диалогами с другими вашими устройствами, на которых выполнен вход.

Кнопка «Поделиться» рядом с ними открывает окно «Поделиться VelaTerm», в котором можно порекомендовать VelaTerm другим людям; доступ к сессиям это окно не открывает.

2. Открытие доступа к этому компьютеру для других устройств (удалённый доступ)

2.1 Запуск сервера

Нажмите кнопку с глобусом. Укажите порт в поле «Порт» (по умолчанию 8799; последний использованный порт запоминается), IP-адрес для ссылки сопряжения в поле «IP» («Автоматически (первый LAN-адрес)» или конкретный интерфейс; интерфейсы VPN помечены «VPN») и пароль доступа («Задайте пароль доступа»), затем нажмите «Запустить сервер».

Пароль доступа нужен каждому подключающемуся устройству. Пока сервер работает, на панели отображается примечание: «Удалённый доступ автоматически возобновляется при повторном открытии приложения. „Остановить сервер“ отключает это.» Если при одном из следующих запусков автоматический запуск не удастся, на панели появится надпись «Сбой автоматического запуска:» с указанием причины.

Флажок «Зеркалировать раскладку на всех устройствах» по умолчанию установлен. Когда он установлен, вкладки, разделения и активная сессия одинаковы на всех подключённых устройствах, а фокус клавиатуры на каждом устройстве остаётся независимым. Снимите флажок, если на каждом устройстве вкладки должны располагаться по-своему.

2.2 Подключение устройства

Когда сервер запущен, панель показывает состояние, «Отпечаток сертификата (SHA-256)», ссылку сопряжения и QR-код:

Чтобы подключить устройство, отсканируйте QR-код его камерой или отправьте на него ссылку сопряжения (например, через AirDrop или сообщением самому себе), откройте ссылку в браузере и введите пароль доступа. Нужны и ссылка сопряжения, и пароль; если открыть просто адрес без ссылки сопряжения, появится сообщение «Этот сервер требует ссылку для сопряжения.» Трафик между браузером и этим компьютером защищён сквозным шифрованием.

Для безопасности важны два момента:

• Ссылка сопряжения содержит учётные данные для доступа. Отправляйте её только на свои устройства. Если вы считаете, что она стала известна посторонним, нажмите «Пересоздать ссылку (отключить всех)»: старая ссылка сразу перестаёт работать, а все подключённые устройства отключаются, пока не откроют новую ссылку.
• При первом посещении браузер предупреждает, что сертификат не является доверенным; для самоподписанного сертификата это ожидаемо. Сравните отпечаток, который показывает браузер, с отпечатком на панели. Если они совпадают, вы подключены к своему компьютеру.

Если у компьютера несколько сетевых интерфейсов (проводной, Wi-Fi, VPN), панель показывает предпочтительный адрес, а остальные перечисляет под надписью «Ещё ссылок: N». Выберите адрес в той же сети, что и подключаемое устройство.

Ссылки сопряжения остаются действительными после перезапуска VelaTerm. Заменить их можно только кнопкой «Пересоздать ссылку (отключить всех)».

2.3 Возможности браузерного клиента

Страница входа и основной интерфейс на подключённом устройстве:

Браузерный клиент работает с теми же живыми сессиями, что и настольное приложение: то же дерево проектов, тот же вывод терминалов и диалогов, а вводить текст можно с любой стороны. Если флажок «Зеркалировать раскладку на всех устройствах» установлен, в строке заголовка хоста отображается «Зеркалят: N»; щёлкните этот элемент, чтобы открыть список «Подключённые клиенты» с их именами, адресами и временем подключения. Имена клиентов сообщают сами клиенты, поэтому считайте их условными метками, а не подтверждением личности.

Когда один и тот же терминал открыт на нескольких устройствах, его размер определяется одним из них. Остальные устройства показывают масштабированную копию со значком «⤢ Зеркало … · нажмите, чтобы подогнать под окно» в правом верхнем углу терминала; щёлкните значок, чтобы подогнать терминал под текущее окно.

В браузерных клиентах нет вкладок браузера и варианта нативной вставки изображений. Файлы в них можно загружать и скачивать на вкладке «Файлы» (§5).

2.4 Сопряжённые устройства

Нажмите «Сопряжённые устройства» на панели работающего сервера, чтобы увидеть все устройства, которые когда-либо подключались, и время их последнего подключения («Последнее подключение»):

Чтобы заблокировать устройство, нажмите «Заблокировать», а затем «Подтвердить блокировку». Устройство сразу отключается и не сможет подключиться снова, пока не откроет новую ссылку сопряжения; другие устройства это не затрагивает. Чтобы отключить сразу все устройства, используйте «Пересоздать ссылку (отключить всех)».

2.5 Остановка сервера

Нажмите «Остановить сервер» внизу панели. Браузерные клиенты отключаются, а работающие сессии продолжают работу, потому что принадлежат настольному приложению. Остановка также отключает автоматический запуск; при следующем запуске сервера пароль доступа нужно ввести снова.

3. Подключение к другим компьютерам

Нажмите кнопку подключения в строке заголовка. На панели три вкладки: «SSH», «URL» и «Remote».

3.1 SSH: на удалённом компьютере нужен только SSH

Используйте этот режим для удалённого компьютера без каких-либо компонентов VelaTerm. На удалённом компьютере может работать Linux (x86_64 или ARM64), macOS (Apple Silicon или Intel) или Windows (x86_64); на компьютерах с Windows можно использовать сервер OpenSSH от Microsoft либо SSH-сервер Cygwin или MSYS2. При подключении вся настройка выполняется автоматически: VelaTerm определяет удалённую систему, копирует на неё соответствующий сервер VelaTerm, запускает сервер так, чтобы он продолжал работать самостоятельно, перенаправляет на него локальный порт и открывает удалённое окно, в котором вход выполняется автоматически.

Введите user@host[:port] и нажмите «Подключиться». Полезно знать следующее:

Проверка ключа хоста. При первом подключении к хосту показывается его «Отпечаток ключа хоста SSH» с примечанием «Первое подключение к этому хосту — проверьте отпечаток, прежде чем продолжить.» Проверьте отпечаток и нажмите «Отпечаток верный, подключиться»; ключ сохраняется в known_hosts, и больше этот вопрос не задаётся. Если ключ известного хоста изменился, появляется красное предупреждение: «⚠ Ключ этого хоста изменился — возможно, переустановка сервера или атака „человек посередине“. Продолжайте, только если уверены.» Прежде чем подтверждать подключение, выясните причину.

Аутентификация. Ваши существующие настройки SSH (ssh-agent, ~/.ssh/config и ключи) используются как есть. Запрос «Пароль SSH» появляется, только если аутентификация по ключу не удалась. «Запомнить пароль» сохраняет пароль в системной связке ключей (и никогда в базе данных) и использует его в следующий раз.

Зеркалирование удалённого настольного приложения. Параметр «Зеркалировать удалённое настольное приложение» по умолчанию выключен и запоминается для каждого хоста. Включите его, если на удалённом компьютере также работает настольное приложение VelaTerm и вы хотите видеть в точности то же, что оно показывает: те же вкладки, разделения и активную сессию, причём изменения с любой стороны отображаются на обеих. Если настольное приложение на удалённом компьютере не запущено, VelaTerm открывает его базу данных напрямую, а если её нет — отдельную базу данных. Без этого параметра удалённый сервер использует собственный каталог данных (~/.velaterm/data, в Windows — %USERPROFILE%\.velaterm\data), отдельный от любого установленного там настольного приложения.

Если при нажатии кнопки подключения удерживать Option (в Windows и Linux — Alt), при выключенном зеркалировании появляется ещё один параметр — «Использовать базу данных настольного приложения на удалённой машине». Он позволяет удалённому серверу открыть базу данных удалённого настольного приложения, не подключаясь к работающему приложению. Рекомендуется использовать на обоих компьютерах одну и ту же версию VelaTerm.

Недавние хосты. Хосты, к которым вы подключались, перечислены в разделе «Недавние хосты» («Показать все (N)» открывает полный список). Щелчок по записи только заполняет форму; проверьте её и нажмите «Подключиться». Значок ключа означает сохранённый пароль, а кнопка × («Забыть этот хост») удаляет хост и его сохранённый пароль.

Ход подключения. При первом подключении копируется сервер (десятки мегабайт), и кнопка показывает «Подготовка сервера…», «Передача сервера…» и «Запуск сервера…» с процентами. Последующие подключения используют сервер, который уже есть на удалённом компьютере, и проходят намного быстрее.

3.2 URL: на другом компьютере запущен удалённый доступ

Используйте этот режим, когда в VelaTerm на другом компьютере запущен удалённый доступ (§2) и у вас есть его ссылка сопряжения. По сравнению с открытием ссылки в веб-браузере вы получаете отдельное окно, автоматический вход с паролем, сохранённым в системной связке ключей, и проверку отпечатков силами приложения.

Вставьте ссылку сопряжения, введите в поле «Пароль для входа» пароль, заданный на другом компьютере, и нажмите «Подключиться». При первом подключении показывается отпечаток TLS-сертификата другого компьютера; сравните его со значением «Отпечаток сертификата (SHA-256)» на панели того компьютера. Последующие подключения с неизменным отпечатком проходят сразу, а при изменившемся отпечатке появляется красное предупреждение. Недавние ссылки сопряжения перечислены под формой, как и хосты SSH.

3.3 Remote: ваши устройства с входом в тот же аккаунт

На вкладке «Remote» перечислены устройства, на которых выполнен вход в ваш аккаунт VelaTerm (§4). Для каждого устройства показано, находится ли оно «В сети» или «Не в сети», и что оно предоставляет в общий доступ: например, «Всё рабочее пространство», проект или диалог, либо «На этом устройстве нет материалов с общим доступом.» Если устройство в сети и делится материалами, кнопка «Посмотреть доступные материалы →» открывает их в новом окне. Если вы не вошли в аккаунт, на вкладке отображается ссылка «Войти в VelaTerm».

4. Общий доступ через аккаунт VelaTerm (экспериментальная функция)

Общий доступ через аккаунт позволяет продолжать диалоги с ИИ, запущенные на одном компьютере, с других ваших устройств через интернет, не открывая порты и не находясь в одной сети. Общие материалы передаются через velaterm.com со сквозным шифрованием. Это экспериментальная функция.

4.1 Вход

Нажмите кнопку аккаунта в строке заголовка. В окне «Аккаунт» отображается кнопка «Войти в VelaTerm»; нажмите её, чтобы продолжить в веб-браузере. Пока VelaTerm ждёт, отображается сообщение «Завершите вход в браузере, затем вернитесь в VelaTerm.» Можно развернуть раздел «Сведения о запросе на вход», чтобы сравнить запрос с тем, что показывает сайт.

После входа окно показывает ваше имя и «ID аккаунта:», кнопку «Аккаунт», которая открывает страницу вашего аккаунта на velaterm.com, и кнопку «Выйти». При выходе этот компьютер отключается и прекращает общий доступ ко всему, чем он делился.

4.2 Предоставление общего доступа

В разделе «Открыть общий доступ» выберите «Область общего доступа»: «Всё рабочее пространство», «Проект» или «Диалог». Для проекта или диалога выберите нужный элемент в списке, затем нажмите «Открыть общий доступ». Каждый общий элемент отображается в разделе «Общий доступ включён» со своим статусом («Общий доступ включён» или «Общие материалы пока недоступны») и кнопкой «Закрыть доступ». Можно делиться несколькими элементами одновременно. Общий доступ сохраняется после перезапуска и действует, только пока на этом компьютере запущен VelaTerm и есть подключение к интернету.

В общий доступ попадают только диалоги с ИИ. Обычные терминалы и страницы браузера никогда не передаются, а устройство, на котором просматриваются общие материалы, не может открывать терминалы, файлы, настройки или новые вкладки.

4.3 Открытие общих материалов с другого устройства

На другом устройстве, где выполнен вход в тот же аккаунт, откройте вкладку «Remote» кнопки подключения (§3.3) и нажмите «Посмотреть доступные материалы →». Вы сможете читать общие диалоги. Кроме того, можно отправлять сообщения, прерывать агента и отвечать на его запросы разрешений, но только в тех сессиях, которые на предоставляющем доступ компьютере открыты в виде беседы; для остальных сессий окно поясняет, что на хосте сначала нужно переключить сессию в вид беседы.

Учтите, что ИИ-агент действует с правами пользователя на компьютере, который предоставляет доступ: он может выполнять там команды и изменять файлы. Любой, кто может продолжить общий диалог, может управлять агентом, поэтому делитесь только с устройствами, которые вы контролируете, и нажимайте «Закрыть доступ», когда доступ больше не нужен.

5. Передача файлов

В браузерных клиентах, а также в удалённых окнах URL и SSH вкладка «Файлы» правой панели позволяет перемещать файлы между вашим устройством и компьютером, на котором работают сессии. Локальному настольному приложению это не нужно, и в нём эти действия не отображаются.

• Загрузка: щёлкните правой кнопкой мыши папку или файл внутри неё и выберите «Загрузить файлы…»; нажмите кнопку загрузки в заголовке вкладки «Файлы» («Загрузить файлы в эту папку»); или перетащите файлы в дерево файлов. Папки загружать нельзя.
• Скачивание: щёлкните файл правой кнопкой мыши и выберите «Скачать». В веб-браузере файл скачивается через собственный менеджер загрузок браузера. В удалённом окне URL или SSH окно сохранения спрашивает, куда сохранить файл (по умолчанию — в папку «Загрузки»).

Загрузки, а также скачивания в удалённых окнах отображаются в списке «Передача файлов» с размером, скоростью и оставшимся временем. Кнопка отмены останавливает передачу элемента, а «Очистить» убирает завершённые элементы. Если во время загрузки соединение прерывается, элемент показывает «Переподключение…», и VelaTerm продолжает попытки около минуты. Прерванная загрузка никогда не оставляет неполный файл в месте назначения, а повторная загрузка того же файла продолжается с места остановки.

6. Работа с VelaTerm на телефоне

Откройте ссылку сопряжения (§2.2) в браузере телефона, например отсканировав QR-код на панели удалённого доступа. На телефоне VelaTerm переключается на интерфейс, рассчитанный на небольшие сенсорные экраны. Интерфейс выбирается при загрузке страницы: он используется на сенсорных устройствах, у которых короткая сторона экрана меньше 768 пикселей. Чтобы выбрать интерфейс самостоятельно, добавьте к адресу ?view=mobile или ?view=desktop (на планшете можно использовать ?view=mobile) либо выберите «Перейти к версии для ПК» в меню «Другие действия» (•••); выбор запоминается.

Мобильный интерфейс состоит из двух уровней:

• Список сессий: дерево проектов с полем поиска («Поиск сессий / групп…») и фильтрами по статусу («В работе», «Ожидает», «Просмотрено»). Сессии создаются в настольном приложении или в браузере на компьютере и появляются здесь автоматически.
• Страница сессии: коснитесь сессии, чтобы открыть её, и нажмите «‹ Назад», чтобы вернуться к списку. Сессии в виде беседы показывают диалог полностью. Сессии Claude Code, Codex, OpenCode, Pi и OMP, работающие в виде терминала, показывают свой диалог с полем сообщения, текст из которого вводится в терминал. Остальные сессии показывают терминал с панелью клавиш: Esc, Tab, Ctrl (открывает ряд сочетаний с Ctrl, например ^C, ^D, ^R и ^W), клавиши со стрелками, ^C, кнопка клавиатуры и кнопка камеры для отправки изображения. Проведите пальцем для прокрутки, коснитесь экрана, чтобы показать клавиатуру, а чтобы выделить слово и скопировать его кнопкой «Копировать», нажмите на него и удерживайте.

В мобильном интерфейсе нет вкладок браузера, вкладок документов, разделённых панелей и сочетаний клавиш; кроме того, он сохраняет собственную раскладку и не следует параметру «Зеркалировать раскладку на всех устройствах». История сессий Kiro доступна только для чтения.

VelaTerm для iOS доступен в App Store, а для Android — в Google Play.

7. Отключение, закрытие и что при этом сохраняется

7.1 Три уровня состояния

Останется ли «всё на месте после отключения», зависит от уровня:

Внимания требует только третий уровень: пока процесс удалённого сервера работает, ваши работающие сессии продолжают работать.

7.2 Закрытие удалённого окна

SSH: удалённый сервер был запущен этим подключением, поэтому при закрытии окна открывается окно «Отключение от удалённого сервера» с тремя вариантами. «Остановить сервер» завершает работу сервера на удалённом компьютере вместе с его работающими сессиями. «Оставить работать» только отключает это окно; следующее подключение к этому компьютеру использует тот же сервер со всеми сессиями. «Отмена» оставляет окно открытым. Выберите «Оставить работать», если агенты должны продолжать работу в ваше отсутствие.

SSH с подключением к удалённому настольному приложению: если параметр «Зеркалировать удалённое настольное приложение» подключил окно к работающему настольному приложению, закрытие окна просто разрывает соединение; настольное приложение продолжает работать.

URL: вы были гостем в уже работавшем VelaTerm. Закрытие окна означает лишь, что вы уходите; другая сторона продолжает работать, и когда вы вернётесь, всё будет на месте.

7.3 Обрывы соединения

При обрыве сети в верхней части удалённого окна появляется красная полоса с сообщением «Соединение потеряно, переподключение…», и VelaTerm автоматически повторяет попытки. Работающие сессии это не затрагивает; в режиме SSH удалённый сервер работает независимо от SSH-соединения.

В окнах SSH VelaTerm также самостоятельно восстанавливает SSH-туннель («SSH-соединение потеряно, туннель восстанавливается…»). Если попытки прекращаются, на полосе отображается «SSH-соединение разорвано — нажмите „Переподключиться сейчас“, чтобы повторить»; нажмите «Переподключиться сейчас». Если остановился сам удалённый сервер, переподключение из окна не поможет: вернитесь в главное окно и подключитесь снова. При подключении проверяется, работает ли ещё удалённый сервер; если работает, он используется повторно (со всеми сессиями), а новый сервер запускается, только если прежний не работает.

Если удалённый компьютер переходит в спящий режим, завершает сеанс пользователя или перезагружается, сервер в режиме SSH и его работающие сессии завершаются. Дерево проектов хранится на диске, и это его не затрагивает.

7.4 Краткая справка

8. Безопасность вкратце

• Пароли (пароли SSH и пароли входа на удалённые серверы) хранятся только в системной связке ключей, никогда в базе данных, и только если вы выбрали «Запомнить пароль». Пароль удалённого доступа хранится только в виде хеша, чтобы сервер мог перезапускаться автоматически.
• Доступ из браузера в локальной сети использует TLS с самоподписанным сертификатом. Ссылки сопряжения содержат учётные данные для сквозного шифрования, и сервер отклоняет подключения без ссылки сопряжения.
• Ключам хостов SSH и TLS-сертификатам удалённых серверов доверяют при первом использовании: к известным и неизменившимся узлам подключение выполняется сразу, для новых требуется одно подтверждение, а при изменившемся отпечатке появляется красное предупреждение. Прежде чем подтверждать, выясните причину.
• Отдельные устройства можно заблокировать в любой момент (§2.4), а ссылку сопряжения можно пересоздать когда угодно.
• Общий доступ через аккаунт ограничен диалогами с ИИ, но агенты в этих диалогах действуют с вашими правами на компьютере, который предоставляет доступ (§4.3).

Если в строке заголовка отображается значок «⚠ vX ≠ vY», интерфейс и служба VelaTerm, к которой он подключён, сообщают разные версии, и некоторые функции могут работать некорректно. Обновите VelaTerm, чтобы обе части работали на одной версии.

9. Часто задаваемые вопросы

Окно подключено, но боковая панель остаётся пустой или красная полоса не исчезает. Вероятно, удалённый сервер остановился. Вернитесь в главное окно и подключитесь снова (§7.3).

Сервер не запускается на порту 8799. Порт занят другой программой. Выберите на панели другой порт и запустите сервер снова.

Браузер сообщает, что сертификат не является доверенным. Для самоподписанного сертификата это ожидаемо. Проверьте отпечаток и продолжите (§2.2).

Агент на удалённом компьютере должен продолжать работу в моё отсутствие. В режиме SSH при закрытии окна выберите «Оставить работать». Сессия продолжит работу на удалённом компьютере, а позже вы сможете подключиться снова и продолжить с того места, где она находится.

На телефоне терминал выглядит очень мелким. Это масштабированная копия, размер которой определяется другим устройством. Коснитесь надписи «подогнать под окно» на значке в правом верхнем углу терминала, чтобы подогнать его под размер экрана телефона.

Кнопка «Посмотреть доступные материалы» не появляется для моего компьютера. Эта кнопка появляется, только если компьютер в сети, на нём выполнен вход в тот же аккаунт и он чем-то делится. Откройте на нём VelaTerm и проверьте раздел «Общий доступ включён» в окне «Аккаунт».