SSH 协议
 +-- 远程 shell            ssh user@host
 +-- 远程命令执行          ssh user@host 'df -h'
 +-- 文件传输              scp / sftp / rsync -e ssh
 +-- 端口转发（隧道）      -L / -R / -D
 +-- Git 传输              git@github.com:...
 +-- VPN（TUN 设备）       -w（很少用）

① 协议协商与密钥交换（Key Exchange）
   - 双方交换支持的算法列表，选出交集里最强的
   - 用 Diffie-Hellman / ECDH 协商出【会话密钥】
   - 之后所有流量用这个对称密钥加密
   v
② 服务器认证（Host Authentication）
   - 服务器出示自己的【host key】（公钥）
   - 客户端查 ~/.ssh/known_hosts 比对指纹
   - 不匹配 -> 报警并拒绝连接    <- "REMOTE HOST IDENTIFICATION HAS CHANGED"
   v
③ 用户认证（User Authentication）
   - 客户端按顺序尝试：publickey -> keyboard-interactive -> password
   - 全部失败 -> "Permission denied"

# 用 -v 观察三个阶段（排查任何 SSH 问题的第一步）
ssh -v user@server
# debug1: kex: algorithm: curve25519-sha256          <- ① 密钥交换
# debug1: Server host key: ssh-ed25519 SHA256:xxx    <- ② 服务器认证
# debug1: Authentications that can continue: publickey,password
# debug1: Offering public key: /home/lhx/.ssh/id_ed25519   <- ③ 用户认证
# debug1: Authentication succeeded (publickey).

Client                              Server
  |                                   |
  |  ① 发起连接，完成密钥交换        |
  |---------------------------------->|
  |                                   |
  |  ② 返回服务器 host key（公钥）   |
  |<----------------------------------|
  |     客户端比对 known_hosts        |
  |                                   |
  |  ③ 在【已加密的通道】里发送密码  |
  |---------------------------------->|
  |                                   |  ④ 与 /etc/shadow 里的哈希比对
  |<-------- 登录成功 / 失败 ---------|

The authenticity of host 'github.com (20.205.243.166)' can't be established.
ED25519 key fingerprint is SHA256:+DiY3wvvV6TuJJhbpZisF/zLDA0zPMSvHdkr4UvCOqU.
Are you sure you want to continue connecting (yes/no/[fingerprint])?

# 在服务器上（通过其他可信途径，如云控制台）打印指纹
ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub
# 256 SHA256:+DiY3wvvV6TuJJhbpZisF/zLDA0zPMSvHdkr4UvCOqU root@server (ED25519)

# 客户端连接时把指纹粘进去，而不是输 yes
# Are you sure you want to continue connecting (yes/no/[fingerprint])? SHA256:+DiY3...
#                                                     ^^^^^^^^^^^^^ 直接输指纹，匹配才连

# 提前把已知的 host key 写进 known_hosts，避免 TOFU 窗口
ssh-keyscan -t ed25519 github.com >> ~/.ssh/known_hosts
# 然后与官方公布的指纹核对
ssh-keygen -lf ~/.ssh/known_hosts | grep github

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@    WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!     @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

# 确认是服务器重装 / IP 复用导致的，才清除旧记录
ssh-keygen -R 192.168.1.100
ssh-keygen -R "[192.168.1.100]:2222"      # 非默认端口的写法

# ❌ 不要不加思考就 -R，那正是中间人攻击想让你做的事

# 看看你的机器被爆破得多厉害
grep "Failed password" /var/log/auth.log | wc -l
# 89234

grep "Failed password" /var/log/auth.log \
  | grep -oE '([0-9]{1,3}\.){3}[0-9]{1,3}' \
  | sort | uniq -c | sort -rn | head -5
#  23891 45.227.xxx.xxx
#  12034 61.177.xxx.xxx

Client                                  Server
  |                                       |
  |  ① 声明用户名和要用的公钥指纹        |
  |-------------------------------------->|
  |                                       |  ② 在 ~/.ssh/authorized_keys
  |                                       |     里查找这个公钥
  |  ③ 「我认识公钥，请证明你有私钥」    |     生成随机数据 R
  |<--------------------------------------|
  |                                       |
  |  ④ 用【私钥】对 (R + session_id)     |
  |     计算数字签名，发回                |
  |-------------------------------------->|
  |                                       |  ⑤ 用【公钥】验证签名
  |<----------- 登录成功 / 失败 ----------|

# 方式一：ssh-copy-id（推荐，会自动处理权限）
ssh-copy-id -i ~/.ssh/id_ed25519.pub user@server

# 方式二：手动（ssh-copy-id 不可用时，如目标只允许特定命令）
cat ~/.ssh/id_ed25519.pub | ssh user@server \
  "mkdir -p ~/.ssh && chmod 700 ~/.ssh && \
   cat >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys"

chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
chmod 600 ~/.ssh/id_ed25519          # 私钥
chmod 644 ~/.ssh/id_ed25519.pub      # 公钥可以公开
chmod 644 ~/.ssh/known_hosts
chmod 600 ~/.ssh/config

# 常见报错
# Permissions 0644 for '/home/lhx/.ssh/id_ed25519' are too open.
# It is required that your private key files are NOT accessible by others.

# ~/.ssh/authorized_keys

# 限制这个密钥只能执行一条固定命令（备份专用密钥）
command="/opt/scripts/backup-only.sh",no-port-forwarding,no-agent-forwarding,no-pty ssh-ed25519 AAAA... backup@ci

# 限制来源 IP
from="10.0.0.0/24,192.168.1.5" ssh-ed25519 AAAA... deploy@office

# 只用于 git（禁掉 shell 和转发）
restrict,command="git-shell" ssh-ed25519 AAAA... git@ci

# CI 只需要触发部署，不需要 shell
restrict,command="/opt/deploy.sh" ssh-ed25519 AAAA... ci@jenkins

# 原始命令仍可通过环境变量拿到，用于实现受限的多功能入口
# $SSH_ORIGINAL_COMMAND

# ~/.ssh/config
Host prod-web
    HostName 192.168.1.100
    User ubuntu
    Port 2222
    IdentityFile ~/.ssh/id_ed25519_work

ssh prod-web
# 等价于 ssh -i ~/.ssh/id_ed25519_work -p 2222 ubuntu@192.168.1.100

# ~/.ssh/config

# 具体规则放【前面】
Host prod-*
    User ubuntu
    IdentityFile ~/.ssh/id_ed25519_prod
    ServerAliveInterval 60

Host 10.0.*
    User root
    ProxyJump bastion

# 通用规则放【最后】
Host *
    ServerAliveInterval 60
    ServerAliveCountMax 3
    AddKeysToAgent yes
    HashKnownHosts yes
    Compression no

ssh -G prod-web | head -15
#      ^^ 打印最终解析结果，不实际连接
# host 192.168.1.100
# user ubuntu
# port 2222
# identityfile ~/.ssh/id_ed25519_work
# serveraliveinterval 60

# ~/.ssh/config
Host *
    ControlMaster auto
    ControlPath ~/.ssh/cm-%r@%h:%p
    ControlPersist 10m

原理：
  第一次 ssh -> 建立连接，同时创建一个 Unix socket（ControlPath）
  后续的 ssh/scp/rsync -> 复用这个已有的 TCP 连接和已完成的认证
                          【不需要重新握手、重新认证】
  最后一次连接断开后，主连接再保持 10 分钟（ControlPersist）

# 未开启复用
time ssh prod-web true
# real 0m0.812s        <- 每次都要完整握手 + 认证

# 开启复用后的第二次
time ssh prod-web true
# real 0m0.043s        <- 快 19 倍

# 管理复用连接
ssh -O check prod-web        # 检查主连接是否存在
ssh -O exit prod-web         # 关闭主连接
ls ~/.ssh/cm-*               # 看有哪些复用 socket

# /etc/ssh/sshd_config
# 改完【必须先测试语法】再重启
sshd -t                      # 或 sshd -T 打印最终配置
systemctl restart sshd

# ① 测试语法
sshd -t || { echo "配置有错，不要重启"; exit 1; }

# ② 在【新端口】上另起一个 sshd 实例测试，不动现有服务
/usr/sbin/sshd -D -p 2223 -f /etc/ssh/sshd_config_new &

# ③ 用新端口连接验证
ssh -p 2223 user@localhost

# ④ 验证通过后才重启主服务
systemctl restart sshd

# ⑤ 【保持当前会话不要退出】，另开一个终端验证能连上
#    确认无误后再关闭旧会话

# ---------- 网络 ----------
Port 22
ListenAddress 0.0.0.0
AddressFamily inet                    # 只用 IPv4

# ---------- 认证 ----------
PermitRootLogin no                    # 禁止 root 直接登录
PubkeyAuthentication yes
PasswordAuthentication no             # 关闭密码登录（核心加固项）
KbdInteractiveAuthentication no       # 新名字，旧名 ChallengeResponseAuthentication
PermitEmptyPasswords no
MaxAuthTries 3                        # 认证失败次数上限
LoginGraceTime 30                     # 认证超时（秒）
MaxSessions 10
MaxStartups 10:30:60                  # 防 DoS：未认证连接数限制

# ---------- 访问控制 ----------
AllowUsers deploy ubuntu              # 白名单（比 DenyUsers 更安全）
AllowGroups sshusers
# DenyUsers root guest

# ---------- 会话保活 ----------
ClientAliveInterval 300               # 服务端主动探测客户端
ClientAliveCountMax 2                 # 探测失败 2 次就断开

# ---------- 功能开关 ----------
AllowTcpForwarding no                 # 不需要端口转发就关掉
AllowAgentForwarding no
X11Forwarding no
PermitTunnel no
GatewayPorts no                       # 远程转发是否监听所有网卡

# ---------- 其他 ----------
UseDNS no                             # 关掉反向 DNS 查询，加速登录
PrintLastLog yes
Banner /etc/ssh/banner
Subsystem sftp internal-sftp

# 验证是不是 DNS 导致的慢
ssh -v user@server 2>&1 | ts -i '%.s'      # 看哪一步耗时最长
# 或者直接对比
time ssh -o UseDNS=no ...    # 服务端选项，需在服务端改

# 客户端侧
Host *
    GSSAPIAuthentication no

# 对特定用户/组/来源应用不同规则
Match User deploy
    PasswordAuthentication no
    AllowTcpForwarding no
    ForceCommand /opt/deploy.sh

Match Group sftponly
    ChrootDirectory /data/sftp/%u      # 限制在自己的目录里
    ForceCommand internal-sftp
    AllowTcpForwarding no
    X11Forwarding no

Match Address 10.0.0.0/8
    PasswordAuthentication yes          # 内网允许密码，公网不允许

ssh -L [本地监听地址:]本地端口:目标地址:目标端口 user@ssh服务器

本机:3306 --加密隧道--> ssh服务器 --明文--> 目标地址:3306

# 服务器上的 MySQL 只监听 127.0.0.1:3306（第 13 篇讲的常见配置）
ssh -L 3306:127.0.0.1:3306 user@db-server

# 之后在本机像访问本地 MySQL 一样操作
mysql -h 127.0.0.1 -P 3306 -u root -p

# 目标地址是【从 ssh 服务器视角】可达的地址
ssh -L 8080:10.0.0.100:80 user@bastion
# 本机 localhost:8080 -> bastion -> 内网 10.0.0.100:80

# 让局域网其他机器也能用这个隧道（默认只监听 127.0.0.1）
ssh -L 0.0.0.0:8080:10.0.0.100:80 user@bastion
#        ^^^^^^^ 显式指定监听地址

ssh -R [远端监听地址:]远端端口:目标地址:目标端口 user@ssh服务器

公网服务器:8080 --加密隧道--> 本机 --> localhost:3000

# 本机没有公网 IP，想让外部访问本机的 3000 端口服务
ssh -R 8080:localhost:3000 user@public-server
# 外部访问 public-server:8080 -> 隧道 -> 本机:3000

# /etc/ssh/sshd_config
GatewayPorts yes             # 或 clientspecified（更安全，由客户端指定）

ssh -D 1080 user@server
# 然后把浏览器/系统代理设为 SOCKS5 127.0.0.1:1080
# 所有流量经 server 出去，相当于简易 VPN

# 命令行工具走这个代理
curl --socks5-hostname 127.0.0.1:1080 https://internal.example.com
export ALL_PROXY=socks5h://127.0.0.1:1080

# 后台建立隧道，不执行远程命令
ssh -fNL 3306:127.0.0.1:3306 user@server
#     ||+- 本地转发
#     |+-- N: 不执行远程命令（只做转发）
#     +--- f: 后台运行

# 生产级的隧道命令：加保活和失败检测
ssh -fN \
    -L 3306:127.0.0.1:3306 \
    -o ServerAliveInterval=30 \
    -o ServerAliveCountMax=3 \
    -o ExitOnForwardFailure=yes \
    user@server

autossh -M 0 -fN -L 3306:127.0.0.1:3306 \
    -o ServerAliveInterval=30 -o ServerAliveCountMax=3 \
    -o ExitOnForwardFailure=yes user@server
#       ^^^^ -M 0 表示不用额外的监控端口，靠 ServerAlive 检测

# /etc/systemd/system/tunnel-db.service
[Unit]
Description=SSH tunnel to database
After=network-online.target
Wants=network-online.target

[Service]
User=tunnel
# 注意不加 -f，让 ssh 在前台跑，由 systemd 管理生命周期
ExecStart=/usr/bin/ssh -N \
    -o ServerAliveInterval=30 -o ServerAliveCountMax=3 \
    -o ExitOnForwardFailure=yes -o StrictHostKeyChecking=yes \
    -L 3306:127.0.0.1:3306 user@db-server
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

ssh -A user@bastion       # 转发 ssh-agent，让跳板机能用本机的私钥

# 攻击者在跳板机上
ls -l /tmp/ssh-*/agent.*         # 找到你的 agent socket
SSH_AUTH_SOCK=/tmp/ssh-XXX/agent.1234 ssh victim@other-server
#                                     <- 用你的身份登录别处

# ~/.ssh/config
Host inner
    HostName 10.0.0.50
    User root
    ProxyJump bastion

-A（Agent Forwarding）：
  本机 --认证--> bastion --【借用本机 agent 认证】--> inner
                    ^ bastion 能滥用你的 agent

ProxyJump：
  本机 --认证--> bastion（仅转发 TCP）
  本机 ---------- 直接认证 ----------> inner
                    ^ bastion 只看到加密流量，无法滥用

# 命令行
ssh -J user@bastion user@inner
ssh -J user@jump1,user@jump2 user@target        # 多级

# config（推荐）
Host inner
    HostName 10.0.0.50
    User root
    ProxyJump bastion

Host bastion
    HostName 1.2.3.4
    User ubuntu
    IdentityFile ~/.ssh/id_ed25519_work

ssh inner            # 自动经过跳板机
scp file inner:/tmp/ # scp、rsync 也自动走跳板机

# ProxyJump（7.3+，推荐）
ProxyJump bastion

# 等价的 ProxyCommand 写法（老，但更灵活）
ProxyCommand ssh -W %h:%p bastion

# 需要用 nc 的极老写法（不推荐，依赖目标机有 nc）
ProxyCommand ssh bastion nc %h %p

scp file.txt user@server:/path/           # 上传
scp user@server:/path/file.txt ./         # 下载
scp -r ./mydir user@server:/path/         # 递归
scp -P 2222 file.txt user@server:/path/   # 注意是大写 -P
scp file.txt prod:/tmp/                   # 用 config 别名
scp -3 host1:/f host2:/f                  # 两台远端之间传（经本机中转）

# 增量同步，只传输差异部分
rsync -avz --progress ./src/ user@server:/dst/

# 通过跳板机
rsync -avz -e 'ssh -J bastion' ./src/ user@inner:/dst/

# 断点续传大文件
rsync -avzP --partial ./bigfile user@server:/dst/

# 镜像（危险：会删除目标端多余的文件）
rsync -avz --delete ./src/ user@server:/dst/

# 打包并直接通过管道传输（不落地临时文件）
tar czf - ./mydir | ssh user@server "tar xzf - -C /dst/"

# 反向：从远端拉取
ssh user@server "tar czf - /remote/dir" | tar xzf - -C ./local/

# 单个文件
ssh user@server "cat /etc/nginx/nginx.conf" > nginx.conf

# 传输并显示进度（需要 pv）
tar czf - ./mydir | pv | ssh user@server "tar xzf - -C /dst/"

# ---------- 服务端 /etc/ssh/sshd_config ----------
# ① 关闭密码登录（最重要的一项）
PasswordAuthentication no
KbdInteractiveAuthentication no
PermitEmptyPasswords no

# ② 禁止 root 直接登录
PermitRootLogin no
# 或者只允许密钥登录 root（自动化场景）
# PermitRootLogin prohibit-password

# ③ 白名单限制用户
AllowUsers deploy ubuntu
AllowGroups sshusers

# ④ 限制认证尝试
MaxAuthTries 3
LoginGraceTime 30
MaxStartups 10:30:60

# ⑤ 关掉不需要的功能
AllowTcpForwarding no
AllowAgentForwarding no
X11Forwarding no
PermitTunnel no

# ⑥ 加速与减少信息泄露
UseDNS no

# ---------- 网络层 ----------
# 改端口（只能减少扫描噪音，不是真正的安全措施）
Port 22222

# 用防火墙限制来源（第 13 篇）—— 比改端口有效得多
iptables -A INPUT -p tcp --dport 22 -s 10.0.0.0/8 -j ACCEPT
iptables -A INPUT -p tcp --dport 22 -j DROP

# 或者干脆只允许通过跳板机访问，业务机不开公网 22

apt install fail2ban

# /etc/fail2ban/jail.local
cat > /etc/fail2ban/jail.local <<'EOF'
[DEFAULT]
bantime  = 1h
findtime = 10m
maxretry = 5
# 白名单：不要把自己封了
ignoreip = 127.0.0.1/8 10.0.0.0/8

[sshd]
enabled = true
port    = 22
backend = systemd
EOF

systemctl enable --now fail2ban

# 查看状态
fail2ban-client status sshd
# Status for the jail: sshd
# |- Currently failed: 3
# |- Total failed:     8923
# `- Banned IP list:   45.227.xxx.xxx 61.177.xxx.xxx

# 手动解封（把自己封了的时候）
fail2ban-client set sshd unbanip 1.2.3.4

# 密钥 + TOTP 双因素（高安全要求场景）
apt install libpam-google-authenticator
google-authenticator            # 为当前用户生成密钥和二维码

# /etc/ssh/sshd_config
KbdInteractiveAuthentication yes
AuthenticationMethods publickey,keyboard-interactive
#                     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 逗号 = 【都要满足】

# /etc/pam.d/sshd 里加
# auth required pam_google_authenticator.so

AuthenticationMethods publickey,keyboard-interactive    # 密钥 AND 验证码
AuthenticationMethods publickey password                # 密钥 OR 密码

# 生成绑定硬件的密钥（需要插入 YubiKey 等设备）
ssh-keygen -t ed25519-sk -C "yubikey"
# 每次使用需要触摸设备确认

# 常驻型（密钥存在设备里，可在任何机器上用）
ssh-keygen -t ed25519-sk -O resident -O verify-required

# 第一步永远是 -v
ssh -v user@server 2>&1 | grep -A2 -i "offering\|authentications"
# debug1: Authentications that can continue: publickey
# debug1: Offering public key: /home/lhx/.ssh/id_ed25519 ED25519 SHA256:xxx
# debug1: Authentications that can continue: publickey
#         ^ 提供了密钥但被拒绝

# ① 服务端权限不对（最常见）
ssh user@server "ls -ld ~/.ssh ~/.ssh/authorized_keys"
# drwx------ ~/.ssh                    <- 必须 700
# -rw------- ~/.ssh/authorized_keys    <- 必须 600
# 家目录本身也不能是 group/other 可写！
ssh user@server "ls -ld ~"
# drwxr-xr-x <- 正确；drwxrwxr-x 会导致 SSH 拒绝

# ② 公钥没正确写入
ssh-keygen -lf ~/.ssh/id_ed25519.pub                      # 本地公钥指纹
ssh user@server "ssh-keygen -lf ~/.ssh/authorized_keys"   # 服务端记录的
# 对比指纹是否一致

# ③ 用错了密钥（本地有多个密钥时）
ssh -v ... | grep "Offering"          # 看实际提供了哪个
# 解法见第 17 篇的 IdentitiesOnly

# ④ 服务端配置
sshd -T | grep -iE "pubkeyauth|authorizedkeysfile|permitrootlogin|allowusers"

# ⑤ SELinux（RHEL 系）
ssh user@server "restorecon -Rv ~/.ssh"
ausearch -m avc -ts recent | grep ssh

# ⑥ 服务端日志（最直接的答案）
ssh other-way-in "sudo journalctl -u sshd -n 20"
# Authentication refused: bad ownership or modes for directory /home/user
#                         ^^^^^^^^^^^^^^^^^^^^^^^^^^^ 明确说了原因

# 用 -v 看卡在哪一步
ssh -vv user@server 2>&1 | ts -i '%.s' | sort -rn | head -5

# 客户端侧的快速缓解
ssh -o GSSAPIAuthentication=no -o PreferredAuthentications=publickey user@server

# 客户端主动保活（推荐）
# ~/.ssh/config
Host *
    ServerAliveInterval 60        # 每 60 秒发一个心跳
    ServerAliveCountMax 3         # 3 次无响应才断开

# 服务端也可以配（对所有客户端生效）
# /etc/ssh/sshd_config
ClientAliveInterval 60
ClientAliveCountMax 3

ServerAliveInterval  -> 客户端配置，客户端主动探测服务器
ClientAliveInterval  -> 服务端配置，服务器主动探测客户端

# 「使用密钥仍然要输密码」
# -> 输的是【私钥的 passphrase】，不是系统密码
ssh-add ~/.ssh/id_ed25519        # 加入 agent，只需输一次（详见第 17 篇）

# 「Too many authentication failures」
# -> 本地密钥太多，agent 逐个尝试超过了 MaxAuthTries
ssh -o IdentitiesOnly=yes -i ~/.ssh/specific_key user@server

# 「kex_exchange_identification: Connection closed by remote host」
# -> 可能是 fail2ban 封了你，或 MaxStartups 限流
fail2ban-client status sshd | grep -A2 Banned

# 「no matching host key type found」（连老设备时）
# -> 老设备只支持已废弃的算法，OpenSSH 8.8+ 默认禁用了 ssh-rsa
ssh -o HostKeyAlgorithms=+ssh-rsa -o PubkeyAcceptedAlgorithms=+ssh-rsa user@old-device

# 执行远程命令，不进入交互
ssh user@server "df -h; free -m"

# 需要 sudo 时强制分配终端
ssh -t user@server "sudo systemctl restart nginx"
#     ^^ 不加 -t 会报 "sudo: no tty present"

# 批量在多台机器执行（简单场景够用，复杂的用 Ansible）
for h in web1 web2 web3; do
    echo "===== $h ====="
    ssh -o ConnectTimeout=5 "$h" "uptime" 2>&1
done

# 并行执行（第 5 篇的 xargs -P）
echo "web1 web2 web3" | tr ' ' '\n' | \
    xargs -P 8 -I{} sh -c 'echo "== {} =="; ssh {} uptime'

# 测试连接是否可用（不执行命令）
ssh -T git@github.com
# Hi username! You've successfully authenticated...

# 只测试认证能否成功
ssh -o BatchMode=yes -o ConnectTimeout=5 user@server true && echo "OK"
#      ^^^^^^^^^^^^^ 禁止任何交互提示，适合脚本

# 在远端保持任务运行（第 6 篇讲的 tmux）
ssh -t user@server "tmux new -As work"
#                          ^^^^ 存在就 attach，不存在就创建

# 看 SSH 登录记录
last -n 20                        # 成功登录
lastb -n 20                       # 失败登录
journalctl -u sshd --since today | grep -i accepted
who                               # 当前在线用户