必须安装 fabric 1.19.1 才能使用 fab 命令，因 2.x/3.x 已移除 cli；需配 fabfile.py、env.hosts 列表、ssh 密钥或密码，并注意常见连接报错的对应解法。
Fabric 本身不支持现代 SSH 协议（如 OpenSSH 9.8+ 的默认配置），直接 pip install fabric 后跑不通是常态，不是你环境有问题。
为什么 fabric 安装后 fab 命令根本不存在
你装的很可能是 fab 已被移除的 Fabric 2.x 或 3.x —— 它们彻底拆分了 API 和 CLI：
-
fabric包只提供 Python 库（from fabric import Connection），不再带fab命令行工具 -
fab命令现在属于独立包patchwork的遗留物，或需手动用invoke配合写tasks.py - 如果你要的是传统“写好 fabfile.py 就能
fab deploy”的体验，必须降级到 Fabric 1.19.1（最后稳定版）
如何让 fab 命令立即可用（Fabric 1.x 实操）
别碰 2.x/3.x，直接锁定旧版本并绕过 pip 的默认升级逻辑：
- 运行
pip install fabric==1.19.1（注意双等号） - 确认安装成功：
fab --version应输出1.19.1 -
fabfile.py必须在当前目录，且函数名需以def开头、无参数（或仅env）、用@task装饰器（可选但推荐） - 连接目标前，先确保本地
~/.ssh/config里已配好 Host 别名，Fabric 1.x 不自动读取密钥密码，得用env.password或env.key_filename
示例 fabfile.py：
from fabric.api import task, run, env
env.hosts = ['web01']
env.user = 'deploy'
env.key_filename = '/path/to/id_rsa'
@task
def uptime():
run('uptime')
然后执行 fab uptime 即可。
连接失败常见报错及对应解法
看到这些错误，基本不用查网络，先改配置：
-
AuthenticationException: Authentication failed.→ 检查env.key_filename路径是否真实存在，权限是否为600；若用密码登录，加env.password = 'xxx'（不推荐） -
ValueError: Invalid host string→env.hosts不能是字符串，必须是列表，哪怕只有一个主机也要写成['host.example.com'] -
SSHException: Error reading SSH protocol banner→ 目标机器 SSH 服务未启动，或防火墙拦截了 22 端口，用nc -zv host 22先测通 -
TimeoutError或卡住不动 → 默认超时太短，加env.timeout = 10（单位秒）
比 fab 更轻、更稳的替代方案
如果只是偶尔执行几条命令，真没必要引入 Fabric：
- 用原生
ssh+bash -c：例如ssh user@host 'cd /var/www && git pull && systemctl restart nginx' - 用
pdsh（Parallel Distributed Shell）批量发命令，比 Fabric 多机执行更直接，不依赖 Python 环境 - 如果已有 Ansible，
ansible all -m shell -a "uptime"一行搞定，且 inventory 复用率高
Fabric 1.x 的价值只在「Python 逻辑嵌入远程操作」这个窄场景里还活着——比如需要 for 循环遍历本地文件列表，再逐个 scp 到不同主机并触发不同命令。其余情况，它既不如原生命令快，也不如 Ansible 可维护。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
