nyaterm/README.zh-CN.md

NyaTerm

基于 Tauri、React 与 Rust 构建的现代远程终端工作区。
nyaterm.app · 在线文档

在一个桌面客户端中处理 SSH、本地 Shell、Telnet、串口、SFTP、隧道、OTP、AI 辅助与加密同步。

   

English · 简体中文

---

---

AI Assistant

NyaTerm 内置 AI Assistant 面板，可用于生成命令、解释终端输出、分析错误，以及在终端上下文中执行多步辅助操作。

它能做什么

• Ask 模式：适合单次问答，例如生成命令、解释选中输出、分析错误
• Agent 模式：基于当前活跃终端会话，按“观察、决策、执行”的循环完成多步任务
• 结构化命令卡片：展示风险等级、执行控制，并可保存为快捷命令
• 会话提及：输入 @ 可把其他终端会话纳入当前 AI 上下文
• Provider 管理：支持内置 provider 和自定义 OpenAI Compatible 端点
• 风险控制：对高影响命令提供审批门槛和更安全的替代建议

---

NyaTerm 是什么

NyaTerm 是一个面向 SSH 运维和混合终端工作流的桌面客户端。它使用 React + Tauri 构建界面，由 Rust 后端负责 SSH、SFTP、会话生命周期、认证、网络工具、AI 辅助终端操作、导入导出、诊断、加密同步与备份。

• NyaTerm 是 面向开发者、系统管理员和 DevOps 工程师的 SSH 客户端
• NyaTerm 是 支持标签页、横向分屏和纵向分屏的终端工作区
• NyaTerm 是 带传输队列和“本地编辑后回传”流程的 SFTP 文件浏览器
• NyaTerm 支持 SSH、本地终端、Telnet 和串口会话
• NyaTerm 不是 Shell 替代品；它用于连接远程 Shell、本地 Shell、Telnet 端点和串口设备

---

为什么选择 NyaTerm

NyaTerm 适合每天在服务器、本地命令、设备调试和配置文件之间来回切换的工作方式。

• 工作区优先：用标签页、分屏、侧边面板和子窗口组织相关任务
• 远程操作不脱离上下文：在会话旁浏览 SFTP 文件、跟随终端路径、管理传输、编辑远程文件
• 面向安全的工作流：管理凭据、私钥、known hosts、OTP、锁屏和主密码保护的本地存储
• 可迁移配置：从已有工具导入会话，导出加密 .dgfy 备份，并通过 WebDAV 或 S3 兼容存储同步加密快照
• 恰到好处的 AI：从当前终端上下文生成命令、检查输出，并在审批后执行多步操作

---

功能特性

会话与工作区

• 支持 SSH、本地终端、Telnet 和串口会话
• 多标签页工作区，标签页内支持横向和纵向分屏
• 已保存连接支持分组、图标、元数据、复制、重连和导入
• 左右活动栏覆盖文件浏览器、网络、Security/Auth、Sync & Backup、AI Assistant、已保存连接、活动会话、命令历史和资源监控
• 设置、新建连接、快捷命令编辑、自动上传提示使用独立子窗口
• 支持托盘与关闭时最小化到托盘

终端体验

• 终端搜索、复制粘贴、右键菜单和选中文本操作
• 命令历史、模糊建议，以及用于过滤噪音命令的长度配置
• 可选行号和时间戳 gutter
• 可选动作链接，识别 IPv4、host:port 和压缩包文件名
• 可选关键词高亮，支持内置预设和自定义规则
• 大输出保护、可配置回滚缓冲区、SSH Keep-Alive 和会话录制
• 可从选中文本发起在线搜索和翻译
• 支持直接在终端中使用 Zmodem 进行文件传输
• 支持自定义终端与界面操作的键盘快捷键

SFTP 与文件工作流

• SSH 会话内置 SFTP 文件浏览器
• 支持上传、下载、重命名、移动、删除、属性、新建文件/文件夹和符号链接
• 支持文件夹上传、多选、可编辑路径栏，以及与终端 cwd 手动/自动同步
• 传输队列支持暂停、继续、取消、失败重试、时间戳保留和并发配置
• 可在本地编辑远程文件，保存后通过 watcher 驱动的自动上传流程回传
• Windows 下支持从系统文件管理器拖拽文件或文件夹到文件浏览器上传

安全、认证与网络

• 密码认证、私钥、主机密钥校验和本地加密持久化
• 凭据管理支持基于正则的终端自动填充
• OTP 管理支持 TOTP/HOTP、二维码导入和 SSH 自动填充
• 支持代理配置、SSH 跳板机，以及本地/远程/动态隧道
• 支持锁屏、主密码、诊断设置、本地日志管理和诊断包导出

同步、备份与迁移

• 通过 WebDAV 和 S3 兼容存储进行加密云同步与备份
• 启用同步、备份、加密导入导出或定时加密备份前必须设置主密码
• 支持启动同步检查、本地变更后的防抖自动推送和定时备份保留策略
• 支持手动测试、推送、拉取、备份、远程备份恢复和快照级冲突处理
• 支持从 Xshell、MobaXterm 和 WindTerm 导入会话
• 支持完整 NyaTerm 配置的加密 .dgfy 导入导出

---

截图

工作区

在同一个标签页和分屏工作区中管理 SSH、本地 Shell、Telnet 和串口会话。

终端增强

在终端中使用命令历史、搜索、翻译、动作链接、时间戳、关键词高亮和大输出保护。

远程文件

在终端旁浏览 SFTP 文件、管理传输队列，并把本地编辑器保存的修改回传到远端路径。

安全与网络工具

在专用面板中管理凭据、OTP、known hosts、代理、跳板机和 SSH 隧道。

同步与备份

通过 WebDAV 或 S3 兼容存储同步加密的可移植配置快照，并按需恢复远程备份。

---

支持平台

系统	支持情况
Windows	Windows 10/11，x64 / arm64
macOS	macOS 12+，Intel / Apple Silicon
Linux	Ubuntu 20.04+、Fedora 36+、Arch Linux 及类似发行版

可从 nyaterm.app 或 Releases 页面下载安装包。

---

支持的会话类型

类型	典型场景	说明
SSH	Linux / Unix 远程服务器	支持 SFTP、OTP、资源监控、代理、跳板机和隧道
本地终端	本地 Shell 工作流	使用本机 Shell 路径和工作目录
Telnet	旧设备或实验环境	轻量终端会话，不包含 SSH 专属能力
串口	路由器、开发板、嵌入式设备	可配置端口、波特率、数据位、校验位和停止位

---

快速开始

下载

从 nyaterm.app 或 Releases 下载适合你平台的最新版。

平台	格式
Windows	.msi / .exe
macOS	.dmg
Linux	.deb / .AppImage

开发环境要求

• Node.js 18+
• 通过 rustup 安装 Rust stable
• pnpm

本地开发

git clone https://github.com/nyakang/nyaterm.git
cd nyaterm
pnpm install
pnpm tauri dev

项目结构

├── src/                    # React 前端
│   ├── components/         # UI、终端、面板、对话框、设置页
│   ├── hooks/              # 前端状态与工作流 hooks
│   ├── lib/                # 终端、AI、同步、主题、平台辅助逻辑
│   ├── pages/              # 子窗口页面
│   └── i18n/               # 应用内多语言
├── src-tauri/              # Tauri 2 + Rust 后端
│   ├── src/cmd/            # 暴露给前端的 Tauri commands
│   ├── src/core/           # SSH、SFTP、PTY、Telnet、串口、AI、备份逻辑
│   ├── src/config/         # 持久化配置模型
│   └── crates/otp/         # 本地 OTP 实现
├── docs-site/              # Docusaurus 文档站点
├── public/                 # 静态资源
└── scripts/                # 检查、版本同步与演示辅助脚本

---

许可证

本项目基于 MIT License 开源。