Lumin-SSH

<div align="center"> # Lumin **轻量、高速、全平台 SSH 客户端** [](https://github.com/wmwlwmwl/Lumin-SSH/releases) [](https://github.com/wmwlwmwl/Lumin-SSH/releases) [](LICENSE) [English](./README_EN.md) · [简体中文](./README.md) </div> --- ## 概述 Lumin 是一款面向开发者和运维人员的桌面 SSH 客户端。基于 Go 原生并发 + WebSocket + xterm.js 构建，提供毫秒级响应的终端体验。内置系统资源探针、远程文件管理器、命令历史与快捷指令、云端加密同步、AI 代理集成等丰富功能，无需在服务器上安装任何 Agent。 <div align="center"> <img src="assets/pc_empty_main.png" alt="Lumin 主面板" width="800" /> <br /><br /> <img src="assets/pc_connected_session.png" alt="Lumin 终端与资源监控" width="800" /> </div> --- ## 核心功能 ### 终端与连接 - **原生级全异步 PTY 引擎** — 基于 Go 原生并发处理 I/O，WebSocket + xterm.js 构建极低延迟通道 - **预测本地回显 (Predictive Local Echo)** — 高延迟网络下也能提供丝滑输入体验 - **多终端标签页** — 一个 SSH 会话内可打开多个独立终端标签页，支持关闭 - **会话管理** — 支持同时管理多个 SSH 会话，标签页右键菜单可断开/关闭/重连 - **敏感信息隐藏** — 一键隐藏/显示密码、密钥等敏感信息 ### 快捷连接与仪表盘 (Dashboard) - **闪电直连** — 无需预配，通过表单快速输入主机、端口、用户名、密码/密钥即可直连 - **卡片/表格双视图** — 服务器列表支持网格卡片和表格两种视图 - **搜索过滤** — 实时搜索服务器名称、主机、标签等 - **智能延迟检测** — 支持 **SSH Banner RTT**（可穿透 TUN 代理，推荐配合 Clash/V2Ray 使用）和 **TCP Dial** 两种协议 - **可配置 Ping 自动刷新** — 延迟检测间隔可自定义 ### 服务器管理 - **自动保存** — 闪电直连成功后自动保存服务器配置 - **克隆服务器** — 右键服务器可一键克隆，拷贝所有配置（含密码/密钥） - **重复检测** — 添加/编辑/克隆/闪电直连时自动检测 host+port+username 重复并阻止 - **分组管理** — 支持服务器分组、移动分组、按组过滤 - **操作系统图标识别** — 自动识别 30+ 种操作系统并显示对应图标 - **凭据管理** — 集中管理可复用的用户名/密码/私钥认证凭据，修改后自动生效于所有引用的服务器 ### 系统资源探针 - **零 Agent 部署** — 直连后自动挂载监控面板，无需在服务器上安装任何软件 - **实时指标** — CPU 每核心实时曲线、内存甜甜圈图、网络吞吐折线图、磁盘分区挂载表 - **GPU 与 RAID 支持** — 额外支持显卡和磁盘阵列信息查询 - **进程管理** — 实时查看和终止进程，支持搜索、排序、信号发送 - **可配置刷新间隔** — 探针数据刷新频率可在设置中调整 ### 远程文件管理器 - **完整文件操作** — 浏览、上传、下载、删除、重命名、新建目录/文件 - **内置代码编辑器** — 直接编辑远程文件，支持语法高亮（最大 5MB） - **压缩/解压** — 支持 tar.gz / zip 格式 - **文件权限修改 (chmod)** — 可视化权限编辑和八进制设置 - **拖拽上传** — 支持从本地拖拽文件到面板上传 - **右键复制路径** — 文件和文件夹均支持右键复制完整远程路径 - **三种布局模式** — 支持标签页、右侧分屏、底部分屏任意切换 ### 命令历史与快捷指令 - **自动捕获** — 终端中手工输入并回车执行的指令自动留存到服务器数据库 - **搜索与回放** — 按服务器或全局搜索历史命令，一键重发 - **快捷指令库** — 支持分组管理命令片段，一键发送到当前或全部会话 - **动态参数** — 命令中支持插入 `p#` 动态参数，执行时弹窗填入 ### 凭据管理 - **集中认证管理** — 创建可复用的密码/私钥凭据组，关联到多台服务器 - **自动同步更新** — 修改凭据后自动在所有引用的服务器上生效 - **私钥密码短语** — 支持配置私钥密码短语（可选留空） ### AI 代理集成 (MCP) - **内置 MCP 服务** — 应用启动时自动启动 Streamable HTTP MCP 服务器，为 AI 工具提供 SSH 会话访问能力 - **AI 代理面板** — 会话页显示 AI 工具配置面板，展示 MCP 服务地址、可用工具列表、连接指引 - **可见性控制** — 可在设置中开启/关闭 AI 代理面板（默认关闭） - **终端输出控制** — 可限制 MCP 读取终端输出的最大行数和字符数 - **零配置接入** — AI 编辑器（如 Windsurf、Cursor、VS Code + Copilot 等）通过 MCP 客户端配置即可接入 ### 全时云端漫游 - **四种云存储后端** — 支持 **WebDAV**、**Cloudflare R2 (S3 兼容)**、**FTP**、**SFTP** - **AES-256-GCM 加密** — 每次配置变更自动加密快照，云端只存储加密数据 - **多端一键恢复** — 在新设备上配置同步后端后即可恢复所有服务器配置 - **自动同步模式** — 启动时按偏好自动执行合并同步 - **保留份数** — 可配置备份保留份数，避免无限堆积 ### 本地高强度加密 - 首次运行自动生成 32 字节随机 AES 密钥 - 所有密码、私钥、令牌凭据均经 AES-GCM 加密后落盘 ### 自动更新 - 启动时自动检测 GitHub Release（延迟 2.5s，不阻塞启动） - 设置页支持手动检查更新 - 实时下载进度 + SHA256 文件校验 - 校验通过后热替换可执行文件并自动重启 ### 系统托盘 - 关闭窗口可选择 **最小化到托盘**、**直接退出** 或 **每次询问** - 单实例保护，重复启动自动唤起已有窗口 - 托盘图标左键显示窗口，右键弹出菜单（显示主窗口 / 完全退出） ### 操作确认与安全 - **操作确认弹窗** — 关闭连接、关闭全部、关闭窗口均支持二次确认 - **"不再询问" 选项** — 可勾选跳过确认，设置中支持独立恢复 - **主机密钥验证** — 首次连接的主机密钥指纹确认 + 密钥变更检测防中间人攻击 - **连接进度动画** — 连接过程可视化卡片 ### 视觉与主题 - **深色/浅色双主题** — 支持跟随系统自动切换 - **自定义强调色** — 10 种预设色彩选择 - **四套终端配色方案** — Lumin Default、Tokyo Night、Catppuccin、Dracula - **自定义终端壁纸** — 支持上传图片作为终端背景，可调节透明度 - **毛玻璃与微动效** — 弹窗毛玻璃模糊、菜单缩放入场、连接波纹等 - **Toast 通知** — 操作结果通过非侵入式毛玻璃 Toast 提示 ### 布局与分屏 - **左侧分屏/底部分屏** — 两种分屏模式，可自由拖拽调整大小 - **探针面板宽度可调** — 监控面板支持拖拽调节宽度 - **AI 面板宽度可调** — AI 代理面板支持拖拽调节宽度 - **布局偏好持久化** — 所有布局设置实时保存到本地存储 ### 快捷键与个性化 - **自定义快捷键** — 复制、粘贴、清屏、新建标签页、SIGINT、EOF、SIGTSTP、清空输入行均支持自由绑定 - **终端字体大小** — 滑块实时调节 - **终端输入回显** — 支持关闭回显以保护输入敏感内容 - **国际化** — 简体中文 / English 即时切换 ### 窗口记忆 - **记住窗口大小** — 启动时自动恢复上次关闭时的窗口尺寸 - **自适应屏幕** — 根据屏幕分辨率自动调整初始窗口大小（留 10% 边距） --- ## 快速开始 ### 首次使用 1. 从 [Releases](https://github.com/wmwlwmwl/Lumin-SSH/releases) 下载最新版 `Lumin.exe` 2. 双击运行 — 配置目录自动创建在 `%APPDATA%\Lumin\config\` 3. 在仪表盘点击 **闪电直连**，输入主机、端口、用户名、密码/密钥即可快速连接，连接后自动保存到服务器列表 4. 或点击 **添加服务器** 打开完整表单，填写更多配置项后保存 ### 日常操作 - **连接服务器** — 双击服务器卡片，或右键 → 连接 - **多标签终端** — 会话内点击标签栏 `+` 号新建独立终端标签页 - **系统探针** — 点击侧栏 **探针** 面板查看实时 CPU、内存、磁盘、网络指标 - **文件管理** — 点击侧栏 **文件** 面板浏览、上传、下载、编辑远程文件 - **快捷指令** — 在设置 → 快捷指令中保存常用命令，一键发送 - **克隆服务器** — 右键任意服务器 → 克隆，复制包含密码/密钥在内的全部配置 - **凭据管理** — 在仪表盘 → 凭据管理中创建可复用凭据，跨服务器关联引用 --- ## 配置与数据 ### 数据存储路径 首次运行自动在用户配置目录下创建 `Lumin/config/` 文件夹： | 平台 | 路径 | |------|------| | Windows | `%APPDATA%\Lumin\config\` | | macOS | `~/Library/Application Support/Lumin/config/` | | Linux | `~/.config/Lumin/config/` | ### 主要文件 | 文件 | 用途 | |------|------| | `lumin.key` | 32 字节 AES 加密密钥（首次运行时自动生成） | | `connections.json` | 服务器连接配置（AES-GCM 加密存储密码/密钥） | | `credentials.json` | 凭据管理数据 | | `webdav.json` | WebDAV / R2 / FTP / SFTP 同步配置 | | `quick_commands.json` | 快捷指令库数据 | | `param_history.json` | 动态参数历史记录 | | `history/` | 每个服务器的命令历史 | | `sync_mode.json` | 自动同步模式配置 | | `last_sync_time` | 上次同步时间戳 | | `snapshot_time` | 快照时间戳 | --- ## 自动更新机制 Lumin 采用 GitHub Releases 作为更新分发渠道，全流程如下： 1. **版本检测** — 启动时及设置页中调用 GitHub API 获取最新 Release 信息 2. **语义化比较** — 自动对比本地版本与最新版本 3. **资源匹配** — 根据当前运行版本（便携版/安装版）自动匹配对应的 `.exe` 4. **安全下载** — 强制 HTTPS，实时推送下载进度 5. **完整性校验** — SHA256 校验，防止文件篡改 6. **热替换重启** — 校验通过后替换当前可执行文件并自动重启 > 版本号统一管理：`wails.json`（构建）、`frontend/src/config.js`（前端）、`frontend/package.json`（npm）三者保持一致。 --- ## 配置界面 Lumin 提供丰富的设置面板，通过标签页分类管理： | 标签页 | 功能 | |--------|------| | **通用** | 界面语言、关闭连接确认、关闭全部确认、关闭窗口行为 | | **网络** | 延迟检测协议选择（SSH Banner RTT / TCP Dial）、探针与延迟刷新间隔 | | **外观** | 终端字体大小、终端输入回显、终端颜色主题、界面主题、强调色、终端壁纸 | | **AI 集成** | 显示/隐藏 AI 代理面板、MCP 终端输出行数与字符数上限 | | **快捷键** | 所有终端操作快捷键的自由绑定 | | **同步与云** | WebDAV / R2 / FTP / SFTP 配置与自动同步策略 | | **关于** | 版本信息、检查更新、社区链接 | --- ## 构建指南 ### 环境要求 - **Go 1.20+** - **Node.js 18+** - **Wails CLI** ### 安装与构建 ```bash # 安装 Wails CLI go install github.com/wailsapp/wails/v2/cmd/wails@latest # 克隆仓库 git clone https://github.com/wmwlwmwl/Lumin-SSH.git cd Lumin-SSH # 生产构建（便携版） wails build # 构建 NSIS 安装包（需安装 NSIS） wails build -nsis ``` ### 构建产物 - 便携版：`build/bin/Lumin.exe` - 安装包：`build/bin/Lumin-amd64-installer.exe` --- ## 注意事项 ### 安全相关 - **AES 密钥备份** — `lumin.key` 是主密钥，一旦丢失所有加密数据（密码、私钥）将无法恢复，请务必备份 - **WebSocket 鉴权** — 终端 WebSocket 连接使用随机 32 字节令牌 + 严格 Origin 头校验（`wails://wails`），防止未授权本地访问 - **主机密钥验证** — 首次连接时请仔细核对主机密钥指纹，Lumin 会自动检测密钥变更以防止中间人攻击 ### 操作相关 - **单实例保护** — Lumin 仅允许运行一个实例，重复启动会自动唤起已有窗口 - **关闭窗口行为** — 可在设置 → 通用中配置关闭窗口时的行为：每次询问、直接退出、最小化到托盘 - **同步冲突处理** — 多设备同步时自动合并策略会处理冲突，可在设置 → 同步与云中查看同步模式 ### MCP / AI 集成 - **固定本地端口** — 内置 MCP 服务器绑定在 `127.0.0.1:5779`，请确保该端口未被占用 - **仅本地访问** — MCP 服务仅监听 localhost，AI 编辑器需运行在同一台机器上 --- ## 常见问题 (FAQ) ### 密码/密钥如何加密存储？ 首次运行时自动生成 32 字节随机 AES 密钥，保存到 `lumin.key`。所有密码、私钥、凭据均使用 AES-256-GCM 加密后落盘。 ### 如何同步配置到多台电脑？ 设置 → 同步与云 → 配置 WebDAV / R2 / FTP / SFTP 任一后端，Lumin 会在每次配置变更时自动加密快照并同步。在新设备上配置同一后端即可恢复。 ### 克隆服务器会复制密码吗？ 会。克隆通过后端 API 获取解密后的真实密码/密钥数据，克隆后的服务器配置（含密码、私钥、凭据引用）与原服务器完全一致，无需重新输入。 ### 凭据管理和直接使用用户名密码有什么区别？ 凭据管理将认证配置（用户名/密码/私钥）抽取为独立实体，可关联到多台服务器。修改凭据后所有引用该凭据的服务器自动生效，无需逐台编辑。适合多台服务器使用相同认证信息的管理场景。 ### AI 代理面板如何使用？ Lumin 内置 MCP (Model Context Protocol) 服务器，启动时自动监听 `127.0.0.1:5779`。AI 编辑器（Windsurf、Cursor、Copilot 等）通过 MCP 客户端配置即可连接，AI 可以读取终端输出并执行命令。可在设置 → AI 集成中控制面板显隐和输出范围。 ### 支持哪些操作系统？ 支持 Windows、macOS、Linux 三大平台，各平台原生构建均已通过测试。 ### 窗口关闭行为如何设置？ 设置 → 通用 → 关闭窗口时，支持三种选择： - **每次询问** — 关闭窗口时弹窗询问退出或最小化到托盘 - **直接退出** — 点击关闭直接退出应用 - **最小化到托盘** — 点击关闭最小化到系统托盘 --- ## 赞助支持 如果你觉得 Lumin 对你有帮助，欢迎扫码赞助支持，你的每一份鼓励都是持续更新的动力。 <div align="center"> <table> <tr> <td align="center"> <img src="assets/wx.png" alt="微信赞赏" width="200" /> <br/> <strong>微信</strong> </td> <td align="center"> <img src="assets/zfb.png" alt="支付宝赞赏" width="200" /> <br/> <strong>支付宝</strong> </td> <td align="center"> <img src="assets/qq.png" alt="QQ赞赏" width="200" /> <br/> <strong>QQ</strong> </td> </tr> </table> </div> --- ## 贡献指南 欢迎任何形式的贡献！你可以通过以下方式参与： - **报告 Bug** — 通过 [GitHub Issues](https://github.com/wmwlwmwl/Lumin-SSH/issues/new) 提交 - **代码贡献** — Fork 仓库，提交 PR - 遵循现有代码风格和命名约定 - 非阻塞操作使用异步模式 --- ## 许可证 本项目遵循 [MIT License](LICENSE) 协议开源。