buffTerm

简体中文 | English

面向 AI 的 SSH 工具与 MCP 服务器

An AI-first SSH tool and MCP server

buffTerm 是一款面向 AI 的 SSH 工具与 MCP 服务器，内置自研 AI Agent 编排层，接入任意 OpenAI 兼容协议的大模型（如 DeepSeek、Qwen、Kimi 等），用自然语言就能查询状态、排查问题、安装程序、开展运维工作。

并支持将多个主机同时暴露为 MCP 服务，提供给其他 AI 工具调用，安全级别由你把关。高危命令拦截、AI 操作审批与审计全程兜底；配置、凭据与审计数据只存本机，AI 对话与巡检内容会发送到你配置的模型平台。

🤖 Agent 编排层完全自研：核心工具调用循环（SSE 流式解析 → 工具执行 → 结果回填）由本项目手写实现，不依赖 LangChain / OpenAI Agents SDK / Vercel AI SDK 等框架——审批拦截、安全策略、审计留痕全部自己掌控。

📥 下载

请前往 GitHub Releases 下载最新安装包：

• macOS：下载 .dmg（Universal，同时支持 Apple Silicon 与 Intel）
• Windows：下载 .exe

⚠️ macOS 版本目前未做 Apple 公证。凭据以 AES-256-GCM 加密存本机 SQLite，主密钥存系统钥匙串；未签名开发版首次访问钥匙串时可能弹一次系统授权提示，属 macOS 正常行为。

✨ 功能特性

AI Agent

• 自研 Agent 编排层：SSE 流式解析、工具调用循环、审批与审计均为手写实现，无框架依赖
• russh 协议级执行：AI 工具调用走统一 SSH 连接池（连接复用、通道并发、known_hosts 校验）
• 多平台配置：DeepSeek / OpenAI / 通义千问 / Kimi / Ollama，单厂商可配多模型
• 工具调用：exec_command、read_file、list_dir、resource_usage、query_history（历史指标趋势，支持分钟 / 小时 / 天三档聚合粒度，AI 按分析目的自选）、update_task_plan（本地任务台账，免审批）
• 发送上下文按模型窗口做预算：旧轮次自动压缩摘要，任务台账始终保留
• 每台主机独立会话历史，可随时中断 / 清空

MCP 服务

• buffTerm 作为 MCP 服务器：基于 Streamable HTTP + JSON-RPC + token 认证，把勾选的服务器能力开放给 Codex、Claude Desktop 等外部 AI 工具
• 三种权限模式：只读（禁止写操作）/ 管控（危险命令需确认）/ 全部放行
• 启动后自动生成外部 AI 的 MCP 配置 JSON，支持 token 轮换与吊销

SSH 与 SFTP

• 协议级 SSH：交互终端、AI、MCP、监控、巡检与 SFTP 全部基于 russh / russh-sftp，不调用系统 ssh / sftp 命令
• 多种认证方式：支持密码、keyboard-interactive 回退、普通/加密私钥、Unix ssh-agent；RSA 自动协商 SHA-2 签名
• 严格主机指纹校验：首次连接展示 SHA-256 指纹并等待确认，已记录指纹变化时直接拒绝并显示新旧指纹
• 并发连接复用：AI、MCP、监控、巡检和 SFTP 按主机复用 SSH 连接，通道级并发，空闲连接自动回收
• 结构化 SFTP：目录浏览、上传、下载、重命名、删除、建目录、覆盖确认、进度与取消；支持符号链接和含空格文件名
• 批量上传：文件选择支持多选，最多 3 个并发传输（每条独立进度与取消，可一键全部取消）；冲突文件汇总为一次覆盖确认，可选择「全部覆盖」或「跳过冲突项」仅上传其余文件
• 内置文件编辑器：文件面板行内悬浮按钮（或双击文件行）即可在中间区以标签页打开文件（CodeMirror 6，按扩展名高亮），支持编辑与 Ctrl/Cmd+S 保存；保存采用「同目录临时文件 + rename」原子替换并沿用原权限，写入前校验 mtime 避免冲掉他人改动；符号链接写入落到真实目标而不替换链接；单文件 2 MiB 上限并对二进制 / 非 UTF-8 文件直接拒绝；~/.ssh、/etc/sudoers、/etc/shadow、cron、systemd、登录 shell 启动脚本等敏感路径需二次确认，每次保存写入操作审计

终端防护

• 回车前拦截高危命令：基于终端实际命令行判定（覆盖 Tab 补全 / 方向键历史 / 编辑键），命中规则弹窗确认后才执行
• 预置 + 自定义危险规则：覆盖 rm -rf、mkfs、dd if=、systemctl stop、drop table、curl | sh 等，可删改、可一键恢复
• 全屏应用（vim / htop 等）内自动透传，不误判编辑内容；每次拦截写入审计日志

安全体系

• 三级安全级别：全部审核 / 智能审核（只读自动执行，危险命令需批准）/ 全部放行
• 凭据加密：SSH 密码 / 私钥口令、AI API Key、MCP token、SMTP 密码统一 AES-256-GCM 加密存本机，主密钥存系统钥匙串；私钥口令仅用于本地解密私钥
• 操作审计：记录 AI Agent、终端防护、MCP 服务、修复执行与文件编辑的时间、主机、来源、命令、审批方式与结果摘要
• 输出脱敏：命令输出进入模型前过滤 AK/SK、密钥、口令等敏感信息；私钥与 API Key 永不进入模型上下文

监控、巡检与通知

• 监控面板：CPU / 内存 / 磁盘仪表盘 + 负载 + TOP 进程，自动刷新；终端会话连接后即后台采集（复用会话连接，面板打开 5 秒 / 后台静默 30 秒，保留最近 30 分钟），面板打开即可看到连接以来的趋势，多主机切换不丢数据
• AI 巡检：采集只读基线数据生成 Markdown 报告（中文 / 英文随界面语言），含木马 / 挖矿风险检测
• 一键整改：AI 结合巡检报告生成整改步骤，确认后自动执行，支持步骤编辑与失败重试
• 邮件通知：巡检报告与整改结果可自动发送至已配置的收件人

🧱 技术栈

层次	技术
桌面框架	Tauri 2（Rust 后端）
前端	React 19 + TypeScript + xterm.js + CodeMirror 6 + Vite
交互终端 / SFTP / AI / MCP / 监控	russh + russh-sftp（协议级 SSH，全部能力走同一套连接实现）
存储	SQLite（rusqlite）存配置 / 审计 / 加密凭据 + 系统钥匙串（keyring）存主密钥
AI 接入	OpenAI 兼容协议，SSE 流式解析，自研工具调用循环
MCP 服务	自研 Streamable HTTP + JSON-RPC 服务器（tiny_http）

🏗 架构