Quick-SSH — 跨平台 SSH 连接管理器，提供 TUI 界面与 Docker 风格 CLI。

基于 Rust 实现，无需 Node.js 运行时，即下即用。

---

使用示例

---

---

安装指南

📦 使用系统包管理器

平台	包管理器	状态	命令
Windows	Scoop	✅ 已就绪	scoop bucket add cceli https://github.com/CCE-Li/scoop-bucket && scoop install quick-ssh
Windows	WinGet	❌ 未就绪	winget install CCE-Li.Quick-SSH
macOS	Homebrew	❓ 待就绪	brew tap CCE-Li/quick-ssh && brew install quick-ssh（自建 Tap）
Arch Linux	AUR (pacman)	✅ 已就绪	yay -S quick-ssh paru -S quick-ssh
Debian/Ubuntu	APT (.deb)	❌ 未就绪	从 Release 下载 .deb，执行 sudo dpkg -i quick-ssh_*.deb

包管理器工作原理：以上所有包管理器都引用了 GitHub Release 上的预编译二进制文件。 每次发布新版本后，运行 .\scripts\update-packaging.ps1 即可自动更新所有配置。

📥 直接下载

从 GitHub Releases 下载对应平台的归档文件：

# Linux / macOS — 下载 .tar.gz 并解压
tar xzf qssh-x86_64-linux.tar.gz
sudo cp qssh/qssh /usr/local/bin/
sudo cp qssh/qssh-uploader /usr/local/bin/

# Windows — 下载 .zip 并解压，将 qssh.exe 所在目录加入 PATH

🔧 从源码编译（cargo）

# 需要 Rust 工具链: https://rustup.rs
git clone https://github.com/CCE-Li/Quick-SSH.git
cd Quick-SSH
cargo build --release
# 二进制位于: target/release/qssh.exe (或 qssh)

---

5 分钟上手

启动 TUI

qssh

TUI 默认读取 ~/.ssh/config。常用键位：

按键	功能
↑ / ↓	选择主机
Enter	连接选中主机
/	搜索
Space	标记/取消标记
a / e	添加 / 编辑主机
d	删除选中
p	Ping 检测
q / Esc	退出 / 取消搜索
?	帮助

CLI 命令

qssh add mysrv root@192.168.1.100       # 添加主机
qssh add mysrv root@10.0.0.1 -k ~/.ssh/id_rsa  # 指定密钥
qssh ps                                  # 列出所有主机
qssh ps dev                              # 搜索含"dev"的主机
qssh mysrv                               # 一键连接
qssh rm mysrv                            # 删除主机
qssh export                              # 导出为 JSON
qssh import backup.json                  # 从 JSON 导入

记住密码

在 TUI 中按 a 添加或按 e 编辑主机，在 Password 字段输入登录密码并保存。密码输入会以 * 遮罩，并存放在系统安全凭据库中，不会写入 ~/.ssh/config：

• Windows：Credential Manager
• macOS：Keychain
• Linux：Secret Service / keyutils

连接时仍由系统 OpenSSH 先尝试配置的密钥和 ssh-agent，失败后才读取已保存密码。编辑已有主机时，密码留空表示保留原值，输入 !clear 表示删除；删除主机也会一并清理密码。

首次连接一台新主机时，请先运行 ssh <主机别名> 并核对、确认主机指纹。之后再用 qssh 连接即可自动填写密码。

文件上传

SSH 连接后，将本地文件或目录拖入终端窗口，Quick-SSH 会自动在新窗口中启动 SFTP 上传，显示每文件的进度条和总进度。

也可使用独立上传工具：

qssh-uploader mysrv ./myfile.zip /remote/path/

---

配置

所有连接数据保存在 ~/.ssh/config（标准 OpenSSH 格式），Quick-SSH 会保留文件中所有非自己管理的内容。

程序行为可通过 ~/.qsshrc 配置：

UploadConcurrency=3

---

文档

文档	说明
docx/architecture.md	Rust 架构设计
docx/release.md	发布流程与包管理器维护
docx/roadmap.md	开发路线图

---

License

MIT