sshx — 轻量级 SSH 远程执行工具

English version: README.en.md

安装

# go install（注入编译时间）
go install -ldflags "-s -w -X 'main.buildTime=$(date +'%Y-%m-%d %H:%M:%S')'" github.com/zxysilent/sshx@latest

# 从源码编译（注入 git sha + 编译时间）
go build -ldflags "-s -w -X 'main.buildSha=$(git rev-parse --short=8 HEAD)' -X 'main.buildTime=$(date +'%Y-%m-%d %H:%M:%S')'" -o sshx .

快速开始

行为对标原生 ssh，同时天然支持多主机并发：

# 交互式 shell（对齐 ssh）
sshx 192.168.1.10

# 单机执行命令
sshx 192.168.1.10 "ls -la /"

# 多机执行（-H 可重复）
sshx -H host1 -H host2 -H host3 "df -h"

# 多机并发（-c 控制并发度）
sshx -H h1 -H h2 -H h3 -H h4 -c 4 "uptime"

# 文件传输
sshx scp -p 2222 ./local.txt root:pass@192.168.1.10:/tmp/remote.txt
sshx scp -J bastion 192.168.1.10:/etc/hostname ./hostname.txt

子命令

子命令	用途	多主机
(默认)	交互 shell 或命令执行	✅
scp	单文件上传/下载 (SCP)	❌

exec 保留为默认模式的别名。

-H 格式

-H [用户名[:密码]@]主机[:端口]

行内凭据覆盖全局 -u/-P/-p。省略字段回退到全局值。

-H 192.168.1.10                  # 裸主机
-H root@192.168.1.10             # 指定用户
-H root:pass@192.168.1.10        # 用户 + 密码
-H root:pass@192.168.1.10:2222   # 全部指定

全局参数

参数	默认值	说明
-H	无	多主机模式目标（可多次指定）
-p	22	SSH 端口
-u	当前用户	SSH 用户名
-P	$SSHX_PASSWD	SSH 密码（支持 $VAR 展开）
-i	~/.ssh/id_rsa	私钥路径
-t	10s	连接超时
-J	无	跳板机（可多次指定，链式）
--strict-host-key	false	严格校验主机密钥
--known-hosts	~/.ssh/known_hosts	严格校验时使用的 known_hosts 文件
-c	1	最大并发数 (1=串行, 128=最大)
-f	无	本地 Shell 脚本路径
-h	—	显示帮助

-c / -f 仅在多主机模式 (-H) 下生效。

使用模式

单机模式（对齐 ssh）

# 交互式 shell
sshx 192.168.1.10
sshx root@192.168.1.10

# 单条命令
sshx 192.168.1.10 "df -h"
sshx -u admin -P secret 192.168.1.10 "hostname"

# 需要主机密钥校验时显式开启
sshx --strict-host-key --known-hosts ~/.ssh/known_hosts 192.168.1.10 "hostname"

# 过跳板机
sshx -J bastion 192.168.1.20 "uptime"

多机模式（-H）

# 串行（默认 -c 1）
sshx -H host1 -H host2 -H host3 "df -h"

# 并发
sshx -H h1 -H h2 -H h3 -H h4 -c 4 "uptime"

# 混合 -H 凭据
sshx -H root:pass1@host1 -H root:pass2@host2 "whoami"

# 本地脚本推送到多机执行
sshx -f deploy.sh -H host1 -H host2 -H host3

# 脚本 + 并发
sshx -f script.sh -H h1 -H h2 -c 4

文件传输 (scp)

# 上传
sshx scp -p 2222 ./config.yaml root:pass@192.168.1.10:/etc/app/config.yaml

# 下载
sshx scp 192.168.1.10:/var/log/app.log ./app.log

# 过跳板机传输
sshx scp -J 192.168.1.10 ./config.yaml 192.168.1.20:/tmp/config.yaml

远端路径格式：[用户名[:密码]@]主机:/path。端口统一使用 -p 指定。

跳板机 (-J)

支持多次指定，按顺序逐跳建立隧道：

# 单跳板
sshx -J root:pass@192.168.1.10 -H 192.168.1.20 "hostname"

# 多跳链
sshx -J hop1 -J hop2 -H target "uptime"

# 文件传输过跳板
sshx scp -J 192.168.1.10 ./local.txt 192.168.1.20:/tmp/remote.txt

认证策略

1. 私钥优先: -i 路径或 ~/.ssh/id_rsa
2. 密码回退: -P 参数 → $SSHX_PASSWD 环境变量 → -H 行内指定
3. 报错退出: 全部不可用时报错

避免密码出现在 shell 历史中：

export SSHX_PASSWD="your-secret"
sshx -H 192.168.1.10 "uptime"

也支持 -P $MY_ENV_VAR 引用其他环境变量（自动 $VAR 展开）。

主机密钥校验

默认行为不校验 SSH host key，以兼容临时主机、内网批量巡检和旧版用法。需要严格校验时显式开启：

sshx --strict-host-key --known-hosts ~/.ssh/known_hosts root@192.168.1.10 "uptime"

开启后，直连目标、跳板机链路和最终目标都会按 known_hosts 校验；未收录或密钥不匹配会连接失败。

参数混排

标志与位置参数可任意交错：

# 以下写法全部等价
sshx -H host1 -H host2 "ls -la"
sshx "ls -la" -H host1 -H host2
sshx -c 4 ls -la -H host1 -H host2 /tmp