快速开始
📅 2026-8-8
一键安装
Linux / macOS:
curl -fsSL https://magicdo.top/install/xxssh.sh | bash
Windows (PowerShell):
irm https://magicdo.top/install/xxssh.ps1 | iex
脚本自动下载最新版、校验 sha256、安装到标准路径。
首次使用
启动 xxssh,进入服务器列表界面:
| 按键 | 功能 |
|------|------|
| ↑ / ↓ 或 j / k | 选择服务器 |
| N | 新建服务器 |
| E | 编辑选中的服务器 |
| Enter | 连接(未保存密码时弹出输入框) |
| D | 删除选中的服务器 |
| S | 设置(界面语言) |
| Q / Esc / Ctrl+C | 退出 |
新建服务器
按 N 进入编辑表单,用 ↑↓ / Tab 切换字段:
- 名称、主机、端口、用户名
- 认证方式(在 auth 字段按
Space切换 密码 / 公钥) - 密码 / 私钥路径
按 Enter 保存返回列表,Esc 取消。
终端会话
连接成功后进入全功能 PTY 终端:
- 正常打字即可交互(支持 vim / top / htop 等全屏程序,ANSI 颜色完整透传)
- 终端窗口大小变化会自动同步到远程
- 输入
~.(行首)可强制断开,返回服务器列表
配置文件
位于用户主目录,首次运行自动创建,无需手动配置:
| 平台 | 路径 |
|------|------|
| Windows | C:\Users\<user>\.xxssh\servers.json |
| Linux / macOS | ~/.xxssh/servers.json |
- 可用环境变量
XXSSH_CONFIG覆盖路径 - Unix 下配置文件权限为 0600(含密码,保护安全)
- 应用设置存于同目录
settings.json(界面语言等)