Документация VNTerm

Краткое руководство — от установки до синхронизации хостов между устройствами.

Установить приложение

Скачайте установщик для вашей ОС на странице Загрузки.

macOS (11+, Apple Silicon & Intel)

1. Откройте файл VNTerm_<версия>_aarch64.dmg и перетащите VNTerm в папку Applications.
2. Если при первом запуске macOS сообщает, что не удалось проверить разработчика: щёлкните приложение правой кнопкой → Open.

Ubuntu / Debian (22.04+, x86_64)

sudo apt install ./vnterm_*_amd64.deb

Или используйте AppImage без установки:

chmod +x VNTerm_*_amd64.AppImage && ./VNTerm_*_amd64.AppImage

Windows 10/11 (x64)

Запустите VNTerm_*_x64-setup.exe (или VNTerm_*_x64_en-US.msi для развёртывания через GPO/Intune). Если SmartScreen покажет предупреждение, выберите More info → Run anyway.

Создать аккаунт

Аккаунт нужен для синхронизации vault между устройствами. Зарегистрироваться можно прямо в приложении или на странице регистрации.

• Мастер-пароль (не менее 8 символов) шифрует весь vault на вашем устройстве. Он никогда не отправляется на сервер, и мы не можем его восстановить.
• После регистрации приложение покажет ключ восстановления ровно один раз — сохраните его (см. Ключ восстановления).
• Войдите в тот же аккаунт на другом устройстве, чтобы получить все хосты, ключи и сниппеты. Список устройств и кнопка отзыва — на странице Аккаунт.

Добавить хост

1. В разделе Hosts нажмите New host.
2. Введите Address (IP или имя хоста), Label, при необходимости выберите Parent Group и Tags.
3. Укажите порт SSH (по умолчанию 22), Username и Password или привяжите ключ / Identity из Keychain.
4. Дважды щёлкните карточку хоста, чтобы подключиться. При первом подключении приложение покажет отпечаток сервера для подтверждения; отпечаток сохраняется в Known Hosts, и вы получите предупреждение, если он изменится.

Уже есть конфигурация? Выберите New host → Import from ~/.ssh/config для массового импорта. В расширенных настройках хоста есть agent forwarding, стартовый сниппет, цепочки хостов (jump host), прокси SOCKS5/HTTP и собственная тема терминала.

Keychain & Identity

• Создание ключа: Keychain → Generate key, выберите ed25519 (рекомендуется), ECDSA или RSA и при желании задайте passphrase.
• Импорт ключа: вставьте или выберите файл существующего приватного ключа (OpenSSH / PEM).
• Добавьте публичный ключ в ~/.ssh/authorized_keys на сервере, затем привяжите ключ к хосту в разделе Credentials.
• Identity объединяет имя пользователя и пароль/ключ в один набор для многих хостов: смените пароль один раз — и все хосты с этим Identity обновятся.

Quick connect: SSH, Mosh, Telnet

Введите адрес в поле поиска на странице Hosts и нажмите Enter или Connect. Синтаксис:

[ssh|mosh|telnet] [user@]host[:port]
[email protected]
mosh [email protected]
telnet 10.0.0.5:23
[2001:db8::1]:2222

Если протокол не указан, приложение предложит выбрать SSH, Mosh или Telnet и при необходимости запросит учётные данные.

• SSH — порт 22 по умолчанию, поддержка пароля, ключа и агента.
• Mosh — запускает системный клиент mosh во вкладке и сохраняет сессию при нестабильной сети или смене Wi-Fi. Требуется mosh на вашем компьютере и mosh-server на сервере.
• Telnet — порт 23 по умолчанию, для старого сетевого оборудования. Telnet не шифрует трафик — используйте его только в доверенной сети.

SFTP

Откройте вкладку SFTP: слева — ваш компьютер, справа — сохранённый хост. Можно просматривать каталоги, загружать / скачивать файлы через контекстное меню, создавать папки, переименовывать, удалять и менять права (chmod). Удерживайте ⌘/Ctrl при клике, чтобы выбрать несколько файлов.

Port forwarding

Раздел Port Forwarding хранит правила вместе с vault; каждое правило включается / выключается независимо.

Базы данных

Раздел Databases подключается к MySQL, MariaDB, PostgreSQL и SQLite. Параметры подключения (включая пароли) хранятся в хранилище и сквозно шифруются, как и хосты. Выберите хост в поле Подключаться через SSH-хост, чтобы идти через SSH-туннель — правило проброса порта не нужно. Доступно на компьютере и на телефоне.

• Дерево слева — папка → подключение → база → Таблицы, Представления, Функции, События, Запросы. Каждый пункт открывается во вкладке; правый клик (на телефоне — долгое нажатие) открывает меню.
• Данные — нажмите на ячейку, чтобы изменить её, и уберите указатель, чтобы сохранить; выберите строку по номеру, затем ⌘/Ctrl+C, ⌘/Ctrl+V добавит новую строку. Фильтр, сортировка, экспорт в CSV / JSON / SQL и импорт CSV.
• Конструктор таблиц — поля, индексы, внешние ключи, триггеры, проверки и параметры; SQL можно посмотреть до сохранения.
• Только чтение — запросы по умолчанию только читают; чтобы записывать, выключите переключатель.

Serial

Страница Hosts → Serial: выберите порт (например, /dev/ttyUSB0, COM3) и скорость (baud rate) (300 – 921600, по умолчанию 9600). В разделе Advanced настраиваются data bits, parity и stop bits. В Linux пользователь должен входить в группу dialout, чтобы открыть последовательный порт.

Remote Desktop

Управляйте компьютерами Windows прямо во вкладке настольного приложения. В Windows ничего не нужно устанавливать или настраивать — достаточно включённого удалённого рабочего стола (Settings → System → Remote Desktop) и доступного порта 3389.

1. New host → выберите Remote Desktop, укажите адрес, имя пользователя (при необходимости с доменом, например CORP\admin) и пароль.
2. Дважды щёлкните хост, чтобы открыть экран Windows. Разрешение подстраивается под размер вкладки.
3. Панель вкладки: Качество (автоматически по скорости сети или фиксированное), GFX (графика RDP 8+, включена по умолчанию), кнопка Ctrl + Alt + Del, разделение экрана, плавающее окно и общий доступ.

• Копирование / вставка текста работает в обе стороны между вашим компьютером и Windows.
• Сочетания клавиш передаются в Windows. На Mac ⌘ + C / V / X / Z / A / F / S становятся Ctrl, остальные сочетания с ⌘ — клавишей Windows; ⌘ W по-прежнему закрывает вкладку.
• Медленная сеть: режим «Автоматически» снижает качество изображения ради отзывчивости и повышает его снова, когда сеть улучшается.

Вкладки и группы вкладок

• Каждая сессия — отдельная вкладка; несколько сессий к одному хосту нумеруются, например Onik (1), Onik (2).
• Перетащите одну вкладку на другую, чтобы объединить их в группу. Группу можно разгруппировать или закрыть целиком одним действием.
• Кнопка + на панели вкладок открывает quick connect или локальный терминал.

Плавающее окно

Щёлкните вкладку правой кнопкой → Float on top, чтобы вынести терминал (или экран удалённого рабочего стола) в маленькое окно поверх всех — удобно следить за логами или сборкой, занимаясь другим. При закрытии плавающего окна сеанс возвращается во вкладку.

Multiplayer

Щёлкните вкладку правой кнопкой → Multiplayer, чтобы создать ссылку. Получатели открывают её в браузере без аккаунта. Содержимое шифруется сквозным шифрованием, ключ находится после # в ссылке, поэтому сервер не может его прочитать. Вы включаете и выключаете ввод (или управление удалённым рабочим столом) для зрителей и можете остановить показ в любой момент.

Темы и оформление

В Settings выберите тему терминала по умолчанию, размер шрифта и язык интерфейса. У каждого хоста может быть своя тема (в панели редактирования хоста); хосты без темы используют тему аккаунта по умолчанию. Эти настройки синхронизируются вместе с vault.

Горячие клавиши

Синхронизация и сквозное шифрование

VNTerm шифрует хранилище на вашем устройстве: сервер хранит только зашифрованные данные и никогда не получает мастер-пароль. Пока включён быстрый вход через Google / Apple / Telegram (по умолчанию), сервер также хранит зашифрованную копию ключа хранилища, чтобы открыть хранилище на новом устройстве, — выключите его в приложении: Настройки → Учётная запись.

• Мастер-пароль → PBKDF2-SHA256 (600 000 итераций) → master key. Из него выводятся auth key (отправляется на сервер для входа, сервер хранит его в виде Argon2id) и enc key (остаётся только на вашем устройстве).
• Каждый хост, ключ, сниппет… шифруется AES-256-GCM случайным vault key перед синхронизацией. Vault key оборачивается с помощью enc key.
• Каждый API-запрос дополнительно шифруется ещё одним слоем (X25519 + AES-256-GCM, с привязкой к endpoint и времени, защита от повторов) внутри HTTPS.
• Синхронизация по ревизиям: одновременное изменение одной записи на двух устройствах распознаётся как конфликт, а не молча перезаписывается.

Ключ восстановления

Ключ восстановления — единственный способ сохранить данные vault, если вы забудете мастер-пароль.

1. Храните ключ (в виде XXXX-XXXX-…) в надёжном месте: в менеджере паролей или в распечатанном виде.
2. Если вы забыли пароль: откройте Забыли пароль, введите 6-значный код из письма, задайте новый пароль и вставьте ключ восстановления — vault сохранится.
3. Без ключа восстановления старый vault удаляется, вы получаете пустой vault и новый ключ восстановления. После сброса пароля все устройства выходят из аккаунта.

Team vault

1. Кнопка Vaults ▾ на верхней панели → Add vault: задайте имя и пригласите участников по почте.
2. Меню хоста → Move to vault переносит хост (вместе с ключами / identity) в командное хранилище.
3. В меню Vaults ▾ щёлкните хранилище, чтобы скрыть / показать его, или only, чтобы видеть только его. Это действует только на текущем устройстве.
4. Manage vaults (Settings → Invite People) показывает участников и ожидающие приглашения; удаление участника сразу отзывает доступ.

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

Планы и оплата

Смотрите и покупайте планы на странице Цены. Оплата картой (Stripe) или PayPal, помесячно или за год; можно ввести промокод. Планы предоплачены и не списывают деньги автоматически — перед окончанием придёт напоминание, продлить можно на странице Аккаунт.

• Функции открываются в приложении через несколько секунд после оплаты (или когда вы вернётесь в приложение).
• Планы Team / Business оплачиваются за место; участники вашего командного хранилища пользуются функциями плана.
• Когда план заканчивается, ничего не теряется: хранилище по-прежнему загружается на все устройства, блокируются только функции плана.

Остались вопросы? Сообщите об ошибке или предложите функцию.