xxssh

xxssh

一个用 Rust 编写的终端 SSH 客户端，主打好用与连接稳定：多服务器集中管理、全功能彩色终端、客户端保活，让长连接不再被 NAT/防火墙悄悄掐断。

核心特性

• 多服务器管理：新建 / 编辑 / 保存 / 删除 SSH 服务器信息（JSON 持久化，自动创建配置目录）
• 全功能终端：PTY 交互式 shell，ANSI 颜色和控制序列完整透传（vim / top / htop 等全屏程序正常）
• 客户端保活：空闲时每 20s 发送 keepalive@openssh.com，连续 3 次无响应才判定为死连接 —— 跨过 NAT / 防火墙的空闲超时，长会话稳定存活
• 窗口尺寸同步：终端尺寸变化自动发送 window-change，远程全屏程序自适应
• 多种认证：密码认证（自动回退 keyboard-interactive）、公钥认证（支持加密私钥）
• ~. 强制断开：遵循 OpenSSH 约定，卡死时可一键回到服务器列表
• 命令行直连：支持 xxssh my-server（按名连已保存服务器）或 xxssh user@host -p 端口 -i 私钥（直接连，不进 TUI、不写配置），会话结束即退出
• 自更新：xxssh --update 一键从仙缘渡下载最新版本并替换当前二进制，带 sha256 校验与进度显示
• SOCKS5 代理：连接可走 SOCKS5 代理，三档配置（服务器单独设置 > 命令行 -x > 全局设置开关），空值自动降级到下一档
• 文件传输 (SFTP)：xxssh put / xxssh get 上传下载文件，-r 递归传输整个目录，带进度条与覆盖策略；TUI 中按 F 进入双栏文件浏览器，本地/远程目录可视化浏览与传输
• 跨平台：Windows / Linux / macOS 原生运行
• 单文件零依赖：Windows 静态链接 MSVC CRT、Linux 全静态 musl，拷贝即用
• 界面国际化：English / 简体中文 / 繁體中文，设置即时生效并持久化

一键安装

# Linux / macOS
curl -fsSL https://magicdo.top/install/xxssh.sh | bash

# Windows (PowerShell)
irm https://magicdo.top/install/xxssh.ps1 | iex

快速开始

方式一：命令行直连（最快）

xxssh root@192.168.1.1              # 直连，回车后输入密码
xxssh root@host -p 2222             # 指定端口
xxssh root@host -i ~/.ssh/id_rsa    # 用私钥
xxssh root@host -x socks5://127.0.0.1:1080  # 走 SOCKS5 代理
xxssh put /local/dir root@host:/remote/ -r  # SFTP 上传目录（递归）
xxssh get root@host:/remote/file /local/    # SFTP 下载文件
xxssh my-server                     # 连接已保存的服务器（按名）

方式二：服务器管理界面（TUI）

启动后用方向键在服务器列表中操作：

| 按键 | 功能 |

|------|------|

| N | 新建服务器 |

| E | 编辑选中 |

| Enter | 连接（未保存密码时弹出输入框） |

| D | 删除 |

| S | 设置（语言/代理） |

| F | 文件传输（SFTP 双栏浏览器） |

| Q / Esc | 退出 |

终端会话中输入 ~. 可强制断开返回列表。

配置文件

位于用户主目录，首次运行自动创建：

| 平台 | 路径 |

|------|------|

| Windows | C:\Users\<user>\.xxssh\servers.json |

| Linux / macOS | ~/.xxssh/servers.json |

可用环境变量 XXSSH_CONFIG 覆盖路径。Unix 下配置文件权限为 0600。

跨平台二进制

| 平台 | 文件 |

|------|------|

| Windows x64 | xxssh.exe（静态 CRT，无外部 DLL 依赖） |

| Linux x64 | xxssh（musl 全静态，任意 x86_64 Linux 直接运行） |

技术栈（均商用友好）

| 库 | 用途 | 许可证 |

|----|------|--------|

| russh | SSH 协议（ring 后端） | Apache-2.0 |

| tokio | 异步运行时 | MIT |

| ratatui | 终端 UI 框架 | MIT |

| crossterm | 终端控制 / raw 模式 | MIT |

| serde / serde_json | 配置持久化 | MIT / Apache-2.0 |

| dirs | 跨平台主目录定位 | MIT / Apache-2.0 |

| tokio-socks | SOCKS5 代理客户端 | MIT |

| russh-sftp | SFTP 文件传输 | Apache-2.0 |