命令行与文本处理 / 知识点
SSH / SCP / SFTP 命令速查手册
SFTP 文件传输
cd <REMOTE_DIR>改变远端当前工作目录。
SFTP 切换远端目录
改变远端当前工作目录。
基本语法
cd <REMOTE_DIR>推荐用法
cd /var/log预期结果
`pwd` 显示新的远端目录。关键边界
本地目录切换用 lcd。
lcd <LOCAL_DIR>改变 SFTP 客户端本地工作目录。
SFTP 切换本地目录
改变 SFTP 客户端本地工作目录。
基本语法
lcd <LOCAL_DIR>推荐用法
lcd ./downloads预期结果
`lpwd` 显示新的本地目录。关键边界
不会改变远端目录。
sftp -b <BATCH_FILE> <HOST>从文件读取一组 SFTP 命令,适合自动化。
SFTP 批处理模式
从文件读取一组 SFTP 命令,适合自动化。
基本语法
sftp -b <BATCH_FILE> <HOST>推荐用法
sftp -b ./transfer.sftp <USER>@<HOST>预期结果
按 batch 文件顺序执行 get/put/rename 等命令。关键边界
批处理应使用非交互认证,避免等待密码输入;默认某些命令失败会中止。
连接复用与长期隧道
ssh -M -S <SOCKET> <HOST>建立 ControlMaster 主连接供后续会话复用。
启动 SSH 主连接
建立 ControlMaster 主连接供后续会话复用。
基本语法
ssh -M -S <SOCKET> <HOST>推荐用法
ssh -M -S ~/.ssh/cm-%r@%h:%p <USER>@<HOST>预期结果
生成控制 socket 并保持主 SSH 连接。关键边界
长期配置更适合写 ControlMaster/ControlPath/ControlPersist。
ssh -S <SOCKET> -O check <HOST>检查 ControlMaster 是否存活。
检查复用主连接
检查 ControlMaster 是否存活。
基本语法
ssh -S <SOCKET> -O check <HOST>推荐用法
ssh -S ~/.ssh/cm-%r@%h:%p -O check <USER>@<HOST>预期结果
存活时输出 master running 及 PID 信息。关键边界
socket 路径必须与主连接一致。
ssh -S <SOCKET> -O exit <HOST>请求 ControlMaster 正常退出。
关闭复用主连接
请求 ControlMaster 正常退出。
基本语法
ssh -S <SOCKET> -O exit <HOST>推荐用法
ssh -S ~/.ssh/cm-%r@%h:%p -O exit <USER>@<HOST>预期结果
主连接关闭,控制 socket 被清理。关键边界
不要直接 rm socket 代替正常关闭,除非确认 master 已不存在。
ssh -fN -o ExitOnForwardFailure=yes -L ... <HOST>认证并确认转发成功后把隧道放入后台。
后台建立长期本地隧道
认证并确认转发成功后把隧道放入后台。
基本语法
ssh -fN -o ExitOnForwardFailure=yes -L ... <HOST>推荐用法
ssh -fN -o ExitOnForwardFailure=yes -L 127.0.0.1:<LOCAL_PORT>:<TARGET_HOST>:<TARGET_PORT> <USER>@<SSH_HOST>预期结果
本地端口监听成功,ssh 进程后台保持。关键边界
生产长期隧道更推荐 systemd 托管,并设置 ServerAlive 机制。
诊断、安全与故障排查
ssh -v <HOST>显示连接、配置、KEX、Host Key、认证尝试等调试信息。
开启详细调试日志
显示连接、配置、KEX、Host Key、认证尝试等调试信息。
基本语法
ssh -v <HOST>推荐用法
ssh -v <USER>@<HOST>预期结果
stderr 出现 `debug1:` 等日志。关键边界
认证失败、选错密钥、跳板、算法问题先用 -v。
ssh -vvv <HOST>输出最高常用级别的客户端诊断日志。
开启更详细调试
输出最高常用级别的客户端诊断日志。
基本语法
ssh -vvv <HOST>推荐用法
ssh -vvv <USER>@<HOST>预期结果
stderr 出现 debug1/debug2/debug3。关键边界
日志包含用户名、主机、文件路径、算法信息,分享前脱敏。
ssh -E <FILE> -vv <HOST>把调试日志追加到指定文件。
把 SSH 调试写入文件
把调试日志追加到指定文件。
基本语法
ssh -E <FILE> -vv <HOST>推荐用法
ssh -E ./ssh-debug.log -vv <USER>@<HOST>预期结果
生成 ssh-debug.log。关键边界
日志可能包含基础设施信息,按敏感日志管理。
ssh -o ConnectTimeout=<SECONDS> <HOST>限制建立 TCP/SSH 连接阶段等待时间。
设置连接超时
限制建立 TCP/SSH 连接阶段等待时间。
基本语法
ssh -o ConnectTimeout=<SECONDS> <HOST>推荐用法
ssh -o ConnectTimeout=5 <USER>@<HOST>预期结果
无法在规定时间建立连接时 ssh 返回非 0。关键边界
它不是整个远程命令的总超时。
ssh -o ServerAliveInterval=<SEC> -o ServerAliveCountMax=<N> <HOST>由 SSH 客户端通过加密通道周期发送存活探测。
发送客户端保活
由 SSH 客户端通过加密通道周期发送存活探测。
基本语法
ssh -o ServerAliveInterval=<SEC> -o ServerAliveCountMax=<N> <HOST>推荐用法
ssh -o ServerAliveInterval=30 -o ServerAliveCountMax=3 <USER>@<HOST>预期结果
连接长时间无响应时客户端主动断开。关键边界
与 TCPKeepAlive 不同;长期隧道非常有用。
ssh -o PasswordAuthentication=no <HOST>验证目标能否完全依赖密钥等非密码方式登录。
关闭密码认证测试密钥登录
验证目标能否完全依赖密钥等非密码方式登录。
基本语法
ssh -o PasswordAuthentication=no <HOST>推荐用法
ssh -o PasswordAuthentication=no <USER>@<HOST>预期结果
密钥认证可用则成功,否则直接失败而不提示密码。关键边界
在服务器关闭密码登录前先做此测试,避免把自己锁在外面。
ssh -o BatchMode=yes <HOST>禁止密码、passphrase 等交互提示。
关闭交互认证用于自动化
禁止密码、passphrase 等交互提示。
基本语法
ssh -o BatchMode=yes <HOST>推荐用法
ssh -o BatchMode=yes <USER>@<HOST> 'true'预期结果
认证材料不可用时立即失败并返回非 0。关键边界
CI、cron、健康检查强烈推荐。
ssh -o IdentitiesOnly=yes -i <KEY> <HOST>避免 agent 中密钥太多导致服务端在正确密钥前就达到 MaxAuthTries。
排查认证失败次数过多
避免 agent 中密钥太多导致服务端在正确密钥前就达到 MaxAuthTries。
基本语法
ssh -o IdentitiesOnly=yes -i <KEY> <HOST>推荐用法
ssh -vv -o IdentitiesOnly=yes -i <KEY> <USER>@<HOST>预期结果
仅尝试明确指定的 identity。关键边界
先从 -vv 日志确认实际 offered keys。
nc -vz <HOST> <PORT>在 SSH 协议之前先确认网络层端口是否可达。
测试 TCP 端口是否可达
在 SSH 协议之前先确认网络层端口是否可达。
基本语法
nc -vz <HOST> <PORT>推荐用法
nc -vz <HOST> 22预期结果
成功通常显示连接建立;失败显示 refused/timeout。关键边界
这是网络排障辅助,不是 SSH 身份或加密测试。
ss -lntp | grep ssh在服务器本机确认 sshd 是否监听预期地址和端口。
查看服务端 SSH 监听端口
在服务器本机确认 sshd 是否监听预期地址和端口。
基本语法
ss -lntp | grep ssh推荐用法
sudo ss -lntp | grep -E 'sshd|:22\b'预期结果
输出 LISTEN socket、地址、端口及进程。关键边界
若完全无监听,再检查 sshd 服务状态和配置。
sshd -t在重启/重载 sshd 前验证服务端配置语法。
检查 sshd 配置语法
在重启/重载 sshd 前验证服务端配置语法。
基本语法
sshd -t推荐用法
sudo sshd -t预期结果
配置正确时通常无输出且退出码 0。关键边界
修改远程 SSH 配置后必须先做语法检查,并保留现有会话作为回退。
sshd -T输出 sshd 解析后的有效配置。
查看 sshd 最终配置
输出 sshd 解析后的有效配置。
基本语法
sshd -T推荐用法
sudo sshd -T | head -80预期结果
显示 port、passwordauthentication、pubkeyauthentication 等最终值。关键边界
Match 条件相关结果还需结合连接上下文评估。
sshd -t && systemctl reload sshd先验证语法,成功后再无中断重载 SSH 服务配置。
安全修改 sshd 后重载
先验证语法,成功后再无中断重载 SSH 服务配置。
基本语法
sshd -t && systemctl reload sshd推荐用法
sudo sshd -t && sudo systemctl reload sshd预期结果
语法正确才执行 reload。关键边界
发行版服务名可能是 ssh 而不是 sshd;远程操作时保留至少一个已登录会话。