VNTerm
中文

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（通过 GPO/Intune 部署时请使用 VNTerm_*_x64_en-US.msi）。如果 SmartScreen 显示警告，请选择 More info → Run anyway。

创建账户

账户用于在多台设备间同步保险库。您可以直接在应用中注册，也可以在注册页面注册。

  • 主密码（至少 8 个字符）在您的设备上加密整个保险库。它永远不会被发送到服务器，我们也无法帮您找回。
  • 注册后，应用会显示您的恢复密钥，且仅显示一次——请妥善保存（参见恢复密钥）。
  • 在其他设备上登录同一账户，即可获取全部主机、密钥和代码片段。设备列表和撤销按钮位于账户页面。

添加主机

  1. 在 Hosts 部分，点击 New host。
  2. 输入 Address（IP 或主机名）和 Label，并按需选择 Parent Group 和 Tags。
  3. 设置 SSH 端口（默认 22）、Username 和 Password，或从 Keychain 关联密钥 / Identity。
  4. 双击主机卡片即可连接。首次连接时，应用会显示服务器的指纹供您确认；指纹会保存到 Known Hosts，如果它发生变化，您将收到警告。

已有配置？选择 New host → Import from ~/.ssh/config 即可批量导入。主机的高级设置包括代理转发（agent forwarding）、启动代码片段、主机链（跳板机）、SOCKS5/HTTP 代理以及独立的终端主题。

Keychain & Identity

  • 生成密钥：Keychain → Generate key，选择 ed25519（推荐）、ECDSA 或 RSA，并可按需设置密码短语。
  • 导入密钥：粘贴或选择现有的私钥文件（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，支持密码、密钥和代理（agent）认证。
  • Mosh——在标签页中运行系统自带的 mosh 客户端，在网络不稳定或切换 Wi-Fi 时保持会话不中断。需要在您的电脑上安装 mosh，并在服务器上安装 mosh-server。
  • Telnet——默认端口 23，适用于老旧网络设备。Telnet 不加密，请仅在可信网络中使用。

SFTP

打开 SFTP 标签页：左侧窗格是您的电脑，右侧窗格是已保存的主机。您可以浏览目录，通过右键菜单上传 / 下载，新建文件夹、重命名、删除以及修改权限（chmod）。按住 ⌘/Ctrl 点击可多选文件。

Port forwarding

Port Forwarding 部分将规则随保险库一起保存，每条规则可独立启用 / 停用。

类型等效命令适用场景
Local (L)ssh -L 5432:db.internal:5432 host通过您电脑上的端口访问服务器后方的服务，例如内部数据库。
Remote (R)ssh -R 8080:localhost:3000 host让服务器访问您电脑上正在运行的服务。
Dynamic (D)ssh -D 1080 host创建本地 SOCKS5 代理，所有流量均经由服务器转发。

数据库

Databases 可连接 MySQL、MariaDB、PostgreSQL 和 SQLite。连接信息（包括密码）与主机一样端到端加密，保存在 vault 中。在通过 SSH 主机连接中选择一台主机即可走 SSH 隧道，无需创建端口转发规则。桌面端和手机端均可使用。

  • 左侧树 — 文件夹 → 连接 → 数据库 → 表、视图、函数、事件、查询。每一项在标签页中打开；右键（手机上长按）打开菜单。
  • 数据 — 点击单元格编辑，鼠标移开即保存；通过行号选中一行，再按 ⌘/Ctrl+C、⌘/Ctrl+V 添加新行。支持筛选、排序、导出 CSV / JSON / SQL 以及导入 CSV。
  • 表设计器 — 字段、索引、外键、触发器、检查约束和选项；保存前可预览 SQL。
  • 只读 — 查询默认只读；关闭开关后才能写入。

Serial

Hosts 页面 → Serial：选择端口（例如 /dev/ttyUSB0、COM3）和波特率（300 – 921600，默认 9600）。Advanced 部分可设置数据位、校验位和停止位。在 Linux 上，您的用户需要属于 dialout 组才能打开串口。

Remote Desktop

直接在桌面应用的标签页中控制 Windows 电脑。无需在 Windows 上安装或配置任何东西——只需开启 Remote Desktop（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)。
  • 将一个标签页拖放到另一个标签页上即可将它们编为一组。标签组可以取消编组，也可以一次性全部关闭。
  • 标签栏上的 + 按钮可打开快速连接或本地终端。

浮动窗口

右键点击标签页 → Float on top，即可将终端（或 Remote Desktop 屏幕）分离到一个始终置顶的小窗口中——方便在做其他事情时查看日志或构建进度。关闭浮动窗口后，会话会回到原来的标签页。

Multiplayer

右键点击标签页 → Multiplayer 即可创建共享链接。接收者在浏览器中打开链接即可，无需账户。内容经过端到端加密，密钥位于链接的 # 之后，因此服务器无法读取。您可以随时开启 / 关闭观看者的输入权限（或 Remote Desktop 屏幕控制权），也可以随时停止共享。

主题 & 外观

在 Settings 中选择默认终端主题、字号和界面语言。每台主机都可以有自己的主题（在主机编辑面板中设置）；未设置主题的主机将使用账户的默认主题。这些设置会随保险库一起同步。

键盘快捷键

操作macOSLinux / Windows
打开本地终端⌘ ⇧ TCtrl Shift T
在终端中复制⌘ CCtrl Shift C
粘贴到终端⌘ VCtrl Shift V
从搜索框快速连接Enter
关闭面板 / 对话框，取消搜索Esc
在 SFTP 中多选文件⌘ + clickCtrl + click

同步 & 端到端加密

VNTerm 在设备上加密您的保险库：服务器只存储加密数据，从不接收您的主密码。开启 Google / Apple / Telegram 快速登录时（默认），服务器还会保存一份加密的保险库密钥副本，以便在新设备上打开保险库——可在应用中关闭：设置 → 账户。

  • 主密码 → PBKDF2-SHA256（600,000 轮迭代）→ master key。再由它派生出 auth key（发送到服务器用于登录，服务器以 Argon2id 形式存储）和 enc key（仅保存在您的设备上）。
  • 每台主机、每个密钥和代码片段……在同步前都会使用随机生成的 vault key 进行 AES-256-GCM 加密。vault key 再由 enc key 封装。
  • 在 HTTPS 之内，每个 API 请求还会额外加一层加密（X25519 + AES-256-GCM，与端点和时间戳绑定，防重放）。
  • 基于修订版本的同步：在两台设备上同时编辑同一条目会被识别为冲突，而不会被悄无声息地覆盖。

恢复密钥

恢复密钥是您忘记主密码时保留保险库数据的唯一方式。

  1. 将密钥（格式为 XXXX-XXXX-…）保存在安全的地方：密码管理器或纸质打印件。
  2. 忘记密码时：前往忘记密码，输入发送到邮箱的 6 位验证码，设置新密码并粘贴恢复密钥——您的保险库将完整保留。
  3. 没有恢复密钥：旧保险库将被删除，您会获得一个空保险库和新的恢复密钥。重置密码后，所有设备都将被登出。

Team vault

  1. 顶部栏的 Vaults ▾ 按钮 → Add vault：输入名称并通过邮箱邀请成员。
  2. 主机菜单 → Move to vault，即可将主机（连同其密钥 / Identity）移入团队保险库。
  3. 在 Vaults ▾ 菜单中，点击某个保险库可隐藏 / 显示它，点击 only 则只查看该保险库。此选择仅对当前设备生效。
  4. Manage vaults（Settings → Invite People）会列出成员和待处理的邀请；移除某人即立即撤销其访问权限。

新成员需要打开一次应用以生成密钥对；之后，持有密钥的成员会自动为其封装保险库密钥。

套餐 & 付款

在价格页面查看并购买套餐。支持银行卡（Stripe）或 PayPal 付款，按月或按年计费；可使用折扣码。套餐为预付费，绝不会自动扣款——到期前您会收到提醒邮件，并可在账户页面续费。

  • 付款后几秒钟内（或在您返回应用时），功能即会在应用中解锁。
  • Team / Business 套餐按席位计费；您团队保险库中的成员均可使用该套餐的功能。
  • 套餐到期后数据不会丢失：您的保险库仍可下载到所有设备，只是套餐功能会重新锁定。

还有疑问？报告错误或建议新功能。