下载
运行安装程序,或把便携版 zip 解压到任意目录。数据存于 %LOCALAPPDATA%\xssh,与程序分开。
安装
> irm https://xssh.io/install.ps1 | iexAgent:xssh.io/llms.txt、xssh.io/latest.json。
v0.5.1
最新xssh-0.5.1-windows-x86_64.msiWindows 安装程序 · 大小 20.1 MB · 下载次数 17
- SHA-256
6fe36f3e44df97b10e49227eef2cb2e0bef6a234aefed22b9b7216a6cfde8f41- 校验
> (Get-FileHash .\xssh-0.5.1-windows-x86_64.msi -Algorithm SHA256).Hash -eq '6FE36F3E44DF97B10E49227EEF2CB2E0BEF6A234AEFED22B9B7216A6CFDE8F41'
xssh-0.5.1-windows-x86_64.zip便携版 zip · 大小 22.3 MB · 下载次数 15
- SHA-256
dc07195304b1be4c03191a682f80de16c815a903cce3e16e724f9f580f03d78f- 校验
> (Get-FileHash .\xssh-0.5.1-windows-x86_64.zip -Algorithm SHA256).Hash -eq 'DC07195304B1BE4C03191A682F80DE16C815A903CCE3E16E724F9F580F03D78F'
更新内容
- 安装包和更新改由 dl.xiake.com(在中国大陆有节点的 CDN)提供,国内安装和更新更快、更稳定;更早版本的安装会通过这次更新自动切换过来。
v0.5.0
更新内容
- 全新的运行与升级方式:xssh.exe、xs3.exe、xssh-desktop.exe 改为小巧的启动器,每个版本是数据目录中的一个签名包;升级不再替换正在运行的程序,不会再出现“文件正在使用”。
- 新版本先在独立进程中校验并自检,通过后才被新命令使用;启动即崩溃的版本会自动回到上一版本。
- 正在运行的程序保持原版本:新命令立即使用新版,空闲的守护进程自行切换,桌面程序重启即进入新版;xssh 桌面程序只运行一个实例。
- 0.4.x 的安装会在这次更新中自动迁移到新结构;`xssh update` 显示当前版本和上一版本。
v0.4.9
更新内容
- 桌面程序:输入框中的文字底部不再被截断(下划线及 g、p、y 等字母完整显示)。
- 桌面程序:主机和存储列表随窗口宽度自适应,操作列始终可见;测试、凭据、删除收进“…”菜单,跳板机显示在地址下方,多余标签折叠为“+N”,连通时间显示为“3 天前连通过”。
- 桌面程序:表单和对话框按 Enter 即可提交;凭据中的“删除已保存的…”仅在已保存时可用并会先确认;有终端连接时重启更新前会先确认。
- 桌面程序:重命名主机时即使中途保存失败也不会丢失已保存的密码;删除主机时如有凭据未能删除会明确提示;导出到剪贴板的主机和存储 2 分钟后自动清除。
- 桌面程序:全面精简和澄清界面文案,英文数量的单复数显示正确。
v0.4.8
更新内容
- 桌面程序:主机、存储表单的“分组”和“移动到分组”改为可搜索的下拉框,按完整路径列出所有分组;输入还不存在的名称时可直接新建,按 Enter 选中第一项。
- 桌面程序:对话框中第一个和最后一个输入框的焦点高亮不再被截断。
v0.4.7
更新内容
- 桌面程序:一键打开 SSH 终端。主机行的“终端”按钮、双击主机或右键“打开终端”,在带标签页的终端窗口中连接主机(彩色、中文与输入法、选中复制与粘贴、vim/htop 中的鼠标、历史滚动、缩放、窗口大小同步)。连接由桌面程序按已保存的主机设置建立(密码、密钥、跳板机、known_hosts),会话结束后按 Enter 重连。打开和关闭终端记入审计日志,键入的内容不记录。
- 桌面程序:显示已连接主机的运行状态。打开了终端或有 agent 连接的主机,在主机行下方和终端窗口底部显示主机名、CPU 及走势、内存、上传/下载速率、运行天数、登录用户和各挂载点磁盘占用,每 2 秒刷新(Linux 主机)。
- 粘贴的文本不能提前结束 bracketed paste;远端程序写入剪贴板(OSC 52)有大小限制。
v0.4.6
更新内容
- 日志:命令里直接写的密码、令牌和密钥(URL 中的密码、password=/token= 的值、--password 参数、Authorization 头、curl -u、AWS/OpenAI/GitHub 密钥、mysql -p、sshpass -p、docker login -p、用户名:密码)在审计日志、诊断日志和会话记录中会被遮盖;exec --no-wait 的命令现在也会写入审计日志。
- 修复:网络较慢时批量复制文件可能报 “cannot stat .….xssh-part”,实际文件已传完;改名请求现在与传输使用同样的超时,已经完成的改名视为成功。
- 修复:连接一台不可达主机、等待连接超时期间,daemon status(以及桌面程序的状态栏)可能卡住最多 15 秒。
- 主机名写错时会提示最接近的已保存主机(“did you mean gpu_173_205?”)。
- 更新检查改为每小时一次,守护进程和桌面程序共用;发布清单没有变化时不再重复下载。
v0.4.5
更新内容
- 分组支持多级:用路径命名,如 aws/东京。`-g aws` 和 `@aws` 包含这一组及其子分组,xssh、xs3、命令行和 MCP 工具一致。
- xssh Desktop:主机页和存储页左侧新增分组树,显示各组数量;点击分组查看该组及其子分组,右键可新建子分组、重命名、删除分组(内容移到上一级)。右键主机“移动到分组”按树形列出分组;在某个分组下添加主机时默认填入该分组。地址列下方显示认证方式,存储的 Access Key 显示在服务下方。
- 修复:在调试版桌面程序里选中或右键某一行可能导致程序退出。
v0.4.4
更新内容
- 主机和存储支持分组:未指定分组的归入 default。`xssh host list`、`xs3 remote list` 按“[分组] 数量”分段列出,`-g 分组` 只看一组,`@分组` 对整组主机执行命令(如 `xssh exec @prod -- uptime`);`host add/edit`、`remote add/edit` 用 `-g 分组` 设置。
- xssh Desktop:主机页和存储页可按分组筛选;表单里可选择已有分组或输入新分组;选中多行后右键“移动到分组”。剪贴板导出导入会带上分组。
- 给 agent:MCP 工具 xssh_hosts、xs3_remotes 返回每项的分组并可按分组筛选;skill 说明了分组和 @分组 的用法。
v0.4.3
更新内容
- xssh Desktop:主机表单的“跳板机”可以直接从已保存的主机里选,点输入框右侧的箭头即可;仍可手动输入多级跳板(a,b)或 user@host:port 这样的地址。
v0.4.2
更新内容
- 主机和存储可以几步搬到新电脑:在 xssh Desktop 的“主机”或“存储”页选中要带走的行(Ctrl/Shift 多选),右键“导出”,连同登录密码、sudo 密码、私钥口令、Secret Key 和私钥文件一起复制到剪贴板;到新电脑上点导入按钮,先列出将新增哪些,按名称合并(同名的默认保留本机的,可选择覆盖),导入后自动清空剪贴板。
- 所选主机经过的跳板机会一并导出;靠 ~/.ssh 默认私钥登录的主机,可以选择带上默认私钥。私钥原来所在的文件夹在新电脑上不存在时,放进 xssh 数据目录,主机自动改用新位置。
- 导出的内容含明文密码,已标记为不进入 Windows 剪贴板历史和云剪贴板。导出只在桌面程序里提供,没有任何命令或守护进程接口会把它交给 agent。
v0.4.1
更新内容
- 新增 Windows 安装程序(`.msi`):安装向导随 Windows 显示语言为中文或英文;按当前用户安装、无需管理员权限,可自选目录,可选开始菜单和桌面的 xssh Desktop 快捷方式,以及把 xssh、xs3 加入用户 PATH。在“设置 → 应用”中卸载,数据保留。便携版 zip 继续提供。
- `install.ps1` 现在也会创建 xssh Desktop 快捷方式(设置 `XSSH_NO_SHORTCUTS=1` 跳过)、刷新已安装的 agent skill;若之前用 .msi 装在其他目录,会原地更新那里的安装。
- `xssh.exe`、`xs3.exe`、`xssh-desktop.exe` 带上了 Windows 版本信息(公司、产品名、版本号),可在资源管理器的文件属性中查看。
v0.4.0
更新内容
- 新增 `xs3`(随 zip 提供):给 agent 用的对象存储客户端,支持 S3、Cloudflare R2、阿里云 OSS、腾讯云 COS 和 MinIO。远端配置保存后按别名使用,密钥存系统凭据管理器;支持 ls/stat/read/write/edit/rm/presign、可续传的分片复制、MCP 服务和独立手册(`xs3 guide`)。桌面程序新增“存储”页。
- 自动更新:守护进程或桌面程序运行时,新版本在后台下载,经签名清单和 SHA-256 校验后整组替换并自检;自检失败自动回退并跳过该版本。`xssh update` 查看状态,`xssh update off` 或桌面程序新增的“更新”页可以关闭。0.3.x 没有更新器,需要手动安装一次 0.4.0。
- 数据改存到用户数据目录(`%LOCALAPPDATA%\xssh`),不再放在程序旁边的 `data\`,替换或删除程序目录不会丢数据。首次运行会合并旧的 `data\` 并改名为 `data.migrated`;`xssh config import DIR` 可合并其他目录。
- 手册和 skill 更精简:细节移到 `xssh guide 主题`(ssh-config、limits、mcp、update);xs3 的 MCP 把只读的 `xs3_object` 和 `xs3_write` 分开。
- 事件日志:xs3 写入与 xssh 相同的事件(`"tool": "xs3"`),每次 S3 调用另记一条 `http` 事件;更新过程记为 `update` 事件。
v0.3.3
更新内容
- cp:从慢速链路(约 100 KB/s)下载不再在约 12 秒时报 `Timeout`。SFTP 同时挂起 16 个请求(约 4 MiB),每个请求最长等待 120 秒。
- cp:第二个 SFTP 通道(用于原子重命名)只在目标主机打开,且与第一个并行建立;小文件下载的建连耗时约减半。
- 手册:说明 cp 会自动创建缺失的目标目录,agent 无需先 `mkdir -p`(实际使用中约占 exec 调用的六分之一)。
- 执行:输出文件在第一个字节写入时才创建,空输出(大多数 stderr)不再留下文件。
- 事件日志:新增 `transfer` 事件,记录字节数、吞吐及建通道/校验耗时;结果无法送达时,daemon 日志会写明请求与客户端。
- `daemon status`、`session list`、`forward list` 遇到其他版本的 daemon 时如实报告其在运行,停止/重启前的检查也会覆盖它。
v0.3.2
更新内容
- 诊断事件日志,默认开启:数据目录下的 logs/events.jsonl 记录所有请求(含轮询)、新建连接及连接/认证耗时、exec 各阶段(排队、连接、执行、输出字节数、空闲槽位)、后台任务、会话、daemon 生命周期及当时生效的配置,以及 CLI 端到端耗时。命令文本与审计日志一样截断并脱敏。
- 配置项:event_log(默认 true)、event_log_max_mb(单文件 32 MB)、event_log_keep(保留 10 个轮转文件)。`daemon status --json` 显示日志路径。
v0.3.1
更新内容
- SSH 配置:xssh 不应用的选项(AddKeysToAgent、UseKeychain、IdentityAgent、ForwardAgent、SendEnv、PubkeyAcceptedAlgorithms 等)恢复为警告,不再阻止导入和连接。只有主机密钥信任相关选项(RevokedHostKeys、KnownHostsCommand、CASignatureAlgorithms)和 CanonicalizeHostname 仍会报错拒绝。
- SSH 配置:IdentityFile 或 CertificateFile 指向的文件不存在时,与 OpenSSH 一样跳过并给出警告。
- 执行:不发送退出码的设备恢复可用,只有连接断开才判为结果未知。多主机执行中发送前取消的任务正确标记为已取消,提示显示实际耗时。
- Daemon:`daemon stop --force` / `restart --force` 给运行中的请求 10 秒宽限期,不再直接失败;不带 --force 时若有其他客户端的请求在运行则拒绝。空闲退出不会切断请求。daemon 繁忙时也会清理过期输出文件,正在写入的文件除外。
- 导出:启用旧算法的主机重新写出 HostKeyAlgorithms / PubkeyAcceptedAlgorithms +ssh-rsa。
v0.3.0
更新内容
- 可恢复执行:任务 ID、重试去重、增量输出、有界等待与主动取消。完成记录在 daemon 重启后保留,结果不确定的命令绝不自动重放。
- 输出:持续落盘脱敏文本,保留超过 64 MiB 的输出尾部,明确报告磁盘配额、保存/丢失字节与部分输出文件。
- 并发:全局与每目标执行限制、有界队列及 daemon 重启保护;重启失败正确透传给调用方。
- SSH 配置:新增 check-config,保留算法 +/-/^ 语义,不支持的安全选项与 Match 条件明确报错。
- MCP:5 个结构化 stdio 工具共用 CLI 的 daemon、凭据和审计。会话结果区分已验证的完成与 TUI/提示符推断。
- 升级说明:本地 daemon 协议升级为 2;切换构建前请完成或取消活动任务,关闭非持久会话与转发。配置兼容仍为 OpenSSH 子集,cp 未实现块级增量传输。
v0.2.4
更新内容
- 审计日志:从末尾按需读取匹配记录,不足时继续读取轮转文件,跳过损坏记录。
- 守护进程日志:按需读取指定尾部内容,CLI 与桌面端共用读取实现。
- 桌面端:重命名跳板主机时,正确更新多级 ProxyJump 链中的引用。
v0.2.3
更新内容
- 桌面端支持英文和简体中文:首次启动跟随系统语言,可在侧栏底部切换,选择会被记住。
v0.2.2
更新内容
- 桌面端审计日志:多行命令不再重叠,点击一行查看完整命令和详情。
- 桌面端端口转发:从已保存的主机中选择。
- 桌面端:空状态说明如何添加内容;副标题单行;成功和未查询状态不再抢眼。
v0.2.1
更新内容
- Skill:仅在 xssh 未加入 PATH 时写入完整路径,节省 agent 上下文。
- 桌面端集成页:加入 / 移出 PATH 后,已安装的 skill 显示为需更新。
v0.2.0
更新内容
- 首个公开版本。
- 主机:--expires、prune、导出 ssh_config,标出重复登录。
- 连接失败显示上次成功时间与地址;识别本地代理/TUN。
- 失效连接自动替换;他人会话未结束时拒绝 daemon stop/restart。
- 无终端时,密码与主机密钥确认改用桌面对话框。
- file write/edit --secrets、job start -q、xssh path。