命令行与文本处理 / 知识点
SSH / SCP / SFTP 命令速查手册
版本、连接与基础会话
ssh -V确认本机 OpenSSH 客户端版本。
查看 OpenSSH 客户端版本
确认本机 OpenSSH 客户端版本。
基本语法
ssh -V推荐用法
ssh -V预期结果
stderr 输出类似 `OpenSSH_<VERSION>, OpenSSL ...`。关键边界
排查参数是否支持时先看版本;不同发行版可能回移安全补丁。
ssh -Q <QUERY>查询客户端支持的 cipher、kex、key、mac 等算法。
查看 SSH 支持算法
查询客户端支持的 cipher、kex、key、mac 等算法。
基本语法
ssh -Q <QUERY>推荐用法
ssh -Q cipher预期结果
逐行输出支持项。关键边界
常用查询:cipher、kex、key、mac;不要为了兼容老设备长期启用弱算法。
ssh <USER>@<HOST>使用默认端口 22 连接远程主机并进入登录 Shell。
基础 SSH 登录
使用默认端口 22 连接远程主机并进入登录 Shell。
基本语法
ssh <USER>@<HOST>推荐用法
ssh <USER>@<HOST>预期结果
首次连接确认主机指纹,认证成功后进入远程 Shell。关键边界
第一次连接必须核对主机指纹来源,不能机械输入 yes。
ssh -p <PORT> <USER>@<HOST>连接非 22 端口的 SSH 服务。
指定 SSH 端口
连接非 22 端口的 SSH 服务。
基本语法
ssh -p <PORT> <USER>@<HOST>推荐用法
ssh -p <PORT> <USER>@<HOST>预期结果
成功后进入远程 Shell。关键边界
ssh 使用小写 -p;scp/sftp 指定端口常用大写 -P,不要混淆。
ssh -l <USER> <HOST>用 -l 显式指定远程用户名。
指定登录用户
用 -l 显式指定远程用户名。
基本语法
ssh -l <USER> <HOST>推荐用法
ssh -l <USER> <HOST>预期结果
等价于常见的 `<USER>@<HOST>` 写法。关键边界
团队文档通常优先 <USER>@<HOST>,更直观。
ssh -4 <HOST>只通过 IPv4 解析和连接目标。
强制使用 IPv4
只通过 IPv4 解析和连接目标。
基本语法
ssh -4 <HOST>推荐用法
ssh -4 <USER>@<HOST>预期结果
连接使用 IPv4 地址。关键边界
适合排查双栈问题,不应把 -4 当永久掩盖 IPv6 故障的方案。
ssh -6 <HOST>只通过 IPv6 解析和连接目标。
强制使用 IPv6
只通过 IPv6 解析和连接目标。
基本语法
ssh -6 <HOST>推荐用法
ssh -6 <USER>@<HOST>预期结果
目标有可用 AAAA 与 IPv6 路由时连接成功。关键边界
用于验证 IPv6 路径。
ssh -C <HOST>对 SSH 会话数据启用压缩。
启用 SSH 压缩
对 SSH 会话数据启用压缩。
基本语法
ssh -C <HOST>推荐用法
ssh -C <USER>@<HOST>预期结果
连接建立后传输内容经过 SSH 压缩。关键边界
慢链路/文本数据可能受益;高速网络或已压缩数据可能更慢。
ssh -b <LOCAL_IP> <HOST>多网卡环境中指定 SSH 连接使用的本地源地址。
绑定本地源地址
多网卡环境中指定 SSH 连接使用的本地源地址。
基本语法
ssh -b <LOCAL_IP> <HOST>推荐用法
ssh -b <LOCAL_IP> <USER>@<HOST>预期结果
连接从指定本地 IP 发出。关键边界
源地址必须实际存在于本机接口。
ssh -B <INTERFACE> <HOST>多网卡环境按接口绑定 SSH 出站连接。
绑定本地网络接口
多网卡环境按接口绑定 SSH 出站连接。
基本语法
ssh -B <INTERFACE> <HOST>推荐用法
ssh -B <INTERFACE> <USER>@<HOST>预期结果
连接通过指定接口对应地址发出。关键边界
适合 VPN、多出口、策略路由排查。
远程命令与会话控制
ssh <HOST> <COMMAND>不进入交互 Shell,直接在远端执行命令。
执行单条远程命令
不进入交互 Shell,直接在远端执行命令。
基本语法
ssh <HOST> <COMMAND>推荐用法
ssh <USER>@<HOST> 'uname -a'预期结果
stdout 返回远端 `uname -a` 结果,ssh 退出码反映远程命令状态。关键边界
复杂远程 Shell 字符串要特别注意本地 Shell 与远程 Shell 的两层引用。
ssh <HOST> <COMMAND>; echo $?让自动化脚本根据远程命令是否成功做判断。
获取远程命令退出码
让自动化脚本根据远程命令是否成功做判断。
基本语法
ssh <HOST> <COMMAND>; echo $?推荐用法
ssh <USER>@<HOST> 'test -f /etc/os-release'; printf 'exit=%s\n' "$?"预期结果
文件存在通常输出 `exit=0`,不存在为非 0。关键边界
ssh 自身连接失败也返回非 0;业务上要区分连接失败和远程命令失败。
ssh <HOST> 'bash -s' < <SCRIPT>把本地脚本内容通过 stdin 交给远程 Bash 执行。
从标准输入执行远程脚本
把本地脚本内容通过 stdin 交给远程 Bash 执行。
基本语法
ssh <HOST> 'bash -s' < <SCRIPT>推荐用法
ssh <USER>@<HOST> 'bash -s' < ./check.sh预期结果
远端执行 `check.sh` 内容,不需要先复制脚本文件。关键边界
脚本依赖、Bash 版本和权限仍以远端环境为准。
ssh <HOST> 'bash -s -- <ARGS>' < <SCRIPT>通过 bash -s -- 给从 stdin 读取的远程脚本传参数。
向远程脚本传递参数
通过 bash -s -- 给从 stdin 读取的远程脚本传参数。
基本语法
ssh <HOST> 'bash -s -- <ARGS>' < <SCRIPT>推荐用法
ssh <USER>@<HOST> 'bash -s -- arg1 arg2' < ./task.sh预期结果
远端脚本 `$1/$2` 分别收到 arg1/arg2。关键边界
动态参数必须安全引用,避免拼接用户输入形成远程命令注入。
ssh -t <HOST> <COMMAND>为远程命令分配伪终端。
强制分配 TTY
为远程命令分配伪终端。
基本语法
ssh -t <HOST> <COMMAND>推荐用法
ssh -t <USER>@<HOST> 'sudo systemctl status nginx'预期结果
需要 TTY 的 sudo、交互程序可正常工作。关键边界
非交互自动化不要无脑 -t;TTY 会改变 stdout/stderr 和信号行为。
ssh -tt <HOST> <COMMAND>即使本地 stdin 不是终端也强制分配远端 TTY。
强制分配 TTY 两次
即使本地 stdin 不是终端也强制分配远端 TTY。
基本语法
ssh -tt <HOST> <COMMAND>推荐用法
ssh -tt <USER>@<HOST> 'sudo -i'预期结果
适合某些嵌套交互场景。关键边界
CI 中使用前确认不会卡在交互提示。
ssh -n <HOST> <COMMAND>把 ssh 的 stdin 重定向自 /dev/null。
禁止读取本地 stdin
把 ssh 的 stdin 重定向自 /dev/null。
基本语法
ssh -n <HOST> <COMMAND>推荐用法
ssh -n <USER>@<HOST> 'sleep 10'预期结果
远程命令不会占用当前脚本 stdin。关键边界
后台或循环中执行 ssh 时很有用。
ssh -f <HOST> <COMMAND>认证完成后让 ssh 进程进入后台。
后台运行 SSH
认证完成后让 ssh 进程进入后台。
基本语法
ssh -f <HOST> <COMMAND>推荐用法
ssh -f <USER>@<HOST> 'sleep 30'预期结果
ssh 在后台维护连接/执行远程任务。关键边界
-f 隐含 -n;长期任务通常更适合 systemd/tmux 等明确的进程管理。
ssh -N <HOST>只建立 SSH 连接,不启动远程命令。
仅建立连接不执行远程命令
只建立 SSH 连接,不启动远程命令。
基本语法
ssh -N <HOST>推荐用法
ssh -N <USER>@<HOST>预期结果
连接保持,终端无远程 Shell。关键边界
端口转发最常用搭配。
ssh -T <HOST>禁用伪终端分配,适合测试 Git/服务型 SSH 认证。
连接后立即退出测试
禁用伪终端分配,适合测试 Git/服务型 SSH 认证。
基本语法
ssh -T <HOST>推荐用法
ssh -T git@github.com预期结果
服务端返回认证/欢迎信息后结束。关键边界
-T 不是“测试 TCP 端口”专用参数。