命令行与文本处理 / 知识点
SSH / SCP / SFTP 命令速查手册
SSH 客户端配置
ssh -G <HOST>解析 Host/Match 后打印最终客户端配置并退出。
查看最终生效配置
解析 Host/Match 后打印最终客户端配置并退出。
基本语法
ssh -G <HOST>推荐用法
ssh -G prod-api | head -80预期结果
stdout 显示 hostname、user、port、identityfile 等最终值。关键边界
排查“为什么这个 Host 走了错误密钥/代理/端口”时第一选择。
ssh -F <FILE> <HOST>使用指定客户端配置文件。
指定额外配置文件
使用指定客户端配置文件。
基本语法
ssh -F <FILE> <HOST>推荐用法
ssh -F ./ssh_config <HOST>预期结果
连接按给定文件解析配置。关键边界
指定 -F 时系统/默认配置读取行为会变化;自动化中要明确控制。
ssh -o <KEY>=<VALUE> <HOST>在命令行临时设置任意 ssh_config 选项。
临时覆盖 ssh_config 参数
在命令行临时设置任意 ssh_config 选项。
基本语法
ssh -o <KEY>=<VALUE> <HOST>推荐用法
ssh -o ConnectTimeout=5 <USER>@<HOST>预期结果
本次连接采用覆盖值。关键边界
适合排障;稳定配置应写进 Host 块。
chmod 600 ~/.ssh/config限制客户端配置仅当前用户读写。
配置文件设置安全权限
限制客户端配置仅当前用户读写。
基本语法
chmod 600 ~/.ssh/config推荐用法
chmod 600 ~/.ssh/config预期结果
文件权限为 600。关键边界
配置可能包含跳板地址、用户名和命令等敏感基础设施信息。
跳板机与代理连接
ssh -J <JUMP> <TARGET>通过 ProxyJump 先连接跳板机,再转发到目标主机。
通过跳板机连接
通过 ProxyJump 先连接跳板机,再转发到目标主机。
基本语法
ssh -J <JUMP> <TARGET>推荐用法
ssh -J <JUMP_USER>@<JUMP_HOST> <USER>@<TARGET_HOST>预期结果
用户最终进入 TARGET_HOST 会话。关键边界
比把私钥复制到跳板机安全;通常不需要 Agent Forwarding。
ssh -J <JUMP1>,<JUMP2> <TARGET>按顺序经过多个跳板机访问内网主机。
多级跳板连接
按顺序经过多个跳板机访问内网主机。
基本语法
ssh -J <JUMP1>,<JUMP2> <TARGET>推荐用法
ssh -J <JUMP1>,<JUMP2> <USER>@<TARGET_HOST>预期结果
SSH 依次建立代理链到最终目标。关键边界
链越长越难排障,建议写入 ssh_config。
ssh -J <USER>@<HOST>:<PORT> <TARGET>跳板机 SSH 服务不在 22 时显式指定端口。
跳板机指定端口
跳板机 SSH 服务不在 22 时显式指定端口。
基本语法
ssh -J <USER>@<HOST>:<PORT> <TARGET>推荐用法
ssh -J <JUMP_USER>@<JUMP_HOST>:<PORT> <USER>@<TARGET_HOST>预期结果
通过指定端口进入跳板。关键边界
目标端口仍由目标 Host 配置决定。
ssh -o ProxyCommand='<COMMAND>' <HOST>使用自定义命令建立到目标的底层连接。
使用 ProxyCommand
使用自定义命令建立到目标的底层连接。
基本语法
ssh -o ProxyCommand='<COMMAND>' <HOST>推荐用法
ssh -o 'ProxyCommand=nc -X connect -x <PROXY_HOST>:<PROXY_PORT> %h %p' <HOST>预期结果
ssh 通过 ProxyCommand 提供的 stdin/stdout 传输 SSH 协议。关键边界
现代 SSH 跳板优先 -J;ProxyCommand 留给特殊代理/兼容场景。
端口转发与隧道
ssh -L <LOCAL_PORT>:<TARGET_HOST>:<TARGET_PORT> <SSH_HOST>把本地端口经 SSH 隧道转到 SSH 服务器可访问的目标地址。
本地端口转发
把本地端口经 SSH 隧道转到 SSH 服务器可访问的目标地址。
基本语法
ssh -L <LOCAL_PORT>:<TARGET_HOST>:<TARGET_PORT> <SSH_HOST>推荐用法
ssh -N -L 127.0.0.1:<LOCAL_PORT>:<TARGET_HOST>:<TARGET_PORT> <USER>@<SSH_HOST>预期结果
访问 `127.0.0.1:<LOCAL_PORT>` 即通过隧道访问目标服务。关键边界
显式绑定 127.0.0.1 可避免把本地隧道暴露给局域网。
ssh -L 本地端口:数据库地址:数据库端口通过 SSH 安全访问仅内网开放的数据库。
访问远程数据库
通过 SSH 安全访问仅内网开放的数据库。
基本语法
ssh -L 本地端口:数据库地址:数据库端口推荐用法
ssh -N -L 127.0.0.1:13306:10.0.0.10:3306 <USER>@<SSH_HOST>预期结果
本机连接 `127.0.0.1:13306` 即转发到远端 MySQL 3306。关键边界
隧道只解决网络可达性,数据库仍需自己的认证和 TLS 策略。
ssh -R <REMOTE_PORT>:<LOCAL_HOST>:<LOCAL_PORT> <SSH_HOST>让远端 SSH 服务器上的端口反向访问本地服务。
远程端口转发
让远端 SSH 服务器上的端口反向访问本地服务。
基本语法
ssh -R <REMOTE_PORT>:<LOCAL_HOST>:<LOCAL_PORT> <SSH_HOST>推荐用法
ssh -N -R 127.0.0.1:<REMOTE_PORT>:127.0.0.1:<LOCAL_PORT> <USER>@<SSH_HOST>预期结果
远端访问指定 REMOTE_PORT 时流量经 SSH 回到本机。关键边界
是否允许对外绑定取决于服务器 GatewayPorts;默认只绑定 loopback 更安全。
ssh -D <LOCAL_PORT> <HOST>让 SSH 客户端在本地提供 SOCKS4/5 代理。
动态 SOCKS 代理
让 SSH 客户端在本地提供 SOCKS4/5 代理。
基本语法
ssh -D <LOCAL_PORT> <HOST>推荐用法
ssh -N -D 127.0.0.1:1080 <USER>@<HOST>预期结果
应用配置 SOCKS5 `127.0.0.1:1080` 后经远端 SSH 主机访问网络。关键边界
默认只绑定 loopback;不要轻易监听 0.0.0.0。
ssh -g -L ... <HOST>允许远程/局域网主机连接本地转发端口。
允许其他主机访问本地转发
允许远程/局域网主机连接本地转发端口。
基本语法
ssh -g -L ... <HOST>推荐用法
ssh -g -N -L <LOCAL_PORT>:<TARGET_HOST>:<TARGET_PORT> <USER>@<SSH_HOST>预期结果
转发监听可被其他机器访问。关键边界
显著扩大暴露面;除非明确需要并有防火墙保护,否则不要启用。
ssh -o ExitOnForwardFailure=yes -N -L ... <HOST>要求端口转发监听建立失败时 SSH 直接退出。
转发失败则退出
要求端口转发监听建立失败时 SSH 直接退出。
基本语法
ssh -o ExitOnForwardFailure=yes -N -L ... <HOST>推荐用法
ssh -o ExitOnForwardFailure=yes -N -L 127.0.0.1:<LOCAL_PORT>:<TARGET_HOST>:<TARGET_PORT> <USER>@<SSH_HOST>预期结果
端口被占用等情况返回非 0,而不是留下“连接在但隧道没起来”的假成功。关键边界
长期隧道和 systemd 托管时非常推荐。
ssh-agent 与密钥加载
eval "$(ssh-agent -s)"启动认证代理并设置当前 Shell 所需环境变量。
启动 ssh-agent
启动认证代理并设置当前 Shell 所需环境变量。
基本语法
eval "$(ssh-agent -s)"推荐用法
eval "$(ssh-agent -s)"预期结果
输出 agent PID,SSH_AUTH_SOCK 可用。关键边界
桌面系统通常已有 agent,不要重复启动大量孤儿 agent。
ssh-add -l列出 ssh-agent 当前加载的身份指纹。
查看 agent 中的密钥
列出 ssh-agent 当前加载的身份指纹。
基本语法
ssh-add -l推荐用法
ssh-add -l预期结果
输出 key size、fingerprint 和 comment。关键边界
无身份时返回相应提示。
ssh-add <PRIVATE_KEY>将私钥加入 ssh-agent。
加载私钥到 agent
将私钥加入 ssh-agent。
基本语法
ssh-add <PRIVATE_KEY>推荐用法
ssh-add ~/.ssh/id_ed25519预期结果
成功后 `ssh-add -l` 可看到对应 identity。关键边界
带 passphrase 的私钥只需在加入时解锁。
ssh-add -t <SECONDS> <KEY>让密钥只在 agent 中缓存指定时间。
设置 agent 密钥有效期
让密钥只在 agent 中缓存指定时间。
基本语法
ssh-add -t <SECONDS> <KEY>推荐用法
ssh-add -t 3600 ~/.ssh/id_ed25519预期结果
1 小时后 identity 自动移除。关键边界
共享或高风险终端环境建议设置生命周期。
ssh-add -d <KEY>移除指定 identity。
从 agent 删除指定密钥
移除指定 identity。
基本语法
ssh-add -d <KEY>推荐用法
ssh-add -d ~/.ssh/id_ed25519预期结果
对应密钥不再由 agent 提供。关键边界
只影响 agent,不删除磁盘私钥。
ssh-add -D移除 agent 中所有身份。
清空 agent 密钥
移除 agent 中所有身份。
基本语法
ssh-add -D推荐用法
ssh-add -D预期结果
agent identities 列表变空。关键边界
共享工作站离开前可执行。