安装指南

系统要求

NyaTerm 支持以下操作系统：

NyaTerm 用 GPUI 做原生 GPU 渲染，因此对图形环境有要求：

Linux：需要可用的 Vulkan 驱动（例如 libvulkan1 和 mesa-vulkan-drivers），以及 X11 或 Wayland 会话。缺少 Vulkan 驱动时应用无法启动
macOS：使用 Metal，系统自带
Windows：使用系统图形驱动，通常无需额外安装

NyaTerm 是桌面客户端而不是终端复用器，在纯 SSH 的无头服务器上无法运行。

前往 Releases 页面，按操作系统下载安装包：

Windows 便携版解压后运行 NyaTerm.exe，数据保存在旁边的 data/。GPUI 的 Help → 检查更新 使用签名更新清单，支持适用安装方式的下载和安装；Homebrew、deb/rpm 用户通过包管理器更新。

从 1.x 迁移：Windows 便携版和旧 MSI 必须手动升级。 先退出并备份完整数据及密钥；便携版完整覆盖程序文件并保留 data/，MSI 备份后卸载旧版再安装 NSIS。不能只复制主程序，也不承诺所有旧安装方式都能自动升级。详见 2.0 迁移指南。

macOS 用户可以通过 Homebrew 安装 NyaTerm：

brew install nyakang/nyaterm/nyaterm

该命令会使用 nyakang/homebrew-nyaterm tap，并安装 nyaterm cask。也可以从 nyaterm.app 或 Releases 下载 .dmg 安装包，然后将 NyaTerm 拖入 /Applications。

NyaTerm 目前还没有使用 Apple Developer 证书签名。安装后如果 macOS 提示应用已损坏或无法打开，可以移除 quarantine 属性后再打开：

sudo xattr -cr /Applications/NyaTerm.app

从源码构建见开发环境搭建。

在其他客户端维护过会话时，安装后可以直接导入 Xshell、MobaXterm、WindTerm、SecureCRT、FinalShell、Termius 或 NyaTerm / Electerm JSON。完整格式清单和导入注意事项见 SSH 连接管理 → 导入其他客户端的会话。

要完整恢复一个 NyaTerm 环境，用 .nya 加密配置备份而不是会话导入——它恢复的不只是连接列表。.nya 导入 / 导出需要先在 设置 → 安全 设置主密码，导入后通常需要重启应用。

装好之后从快速开始继续，它会带你建立第一个连接、认识工作区，并指出哪些设置值得先过一遍。