Fabric 2 默认不提供全局默认 host，需通过 --hosts 命令行参数、SSH 配置或 Shell 封装函数实现免输主机的便捷调用，避免任务本地执行。
fabric 2 默认不提供全局默认 host，需通过 `--hosts` 命令行参数、ssh 配置或 shell 封装函数实现免输主机的便捷调用，避免任务本地执行。
在 Fabric 1 中，可通过 env.hosts 直接设置默认主机；但 Fabric 2 重构了连接模型——它不再隐式创建远程连接，而是仅在显式传入 Connection 对象（如 c）且该对象已绑定远程主机时才执行远程命令。若未指定主机（例如直接运行 fab my_task），Fabric 2 会退化为 Invoke 模式，使用本地 Context，导致 c.run("hostname") 在本机执行，而非目标服务器。
✅ 正确配置默认主机的三种推荐方式
1. 使用 --hosts 命令行参数（最轻量、项目无关）
fab --hosts=user@host my_task
支持多主机（逗号分隔）：
fab --hosts=user@host1,user@host2 my_task
⚠️ 注意：
--hosts必须写在任务名之前（fab --hosts=... task），否则会被忽略。
2. 结合 SSH 配置复用用户与别名（推荐用于日常开发）
在 ~/.ssh/config 中定义主机别名与默认用户：
Host prod HostName 192.168.1.100 User deploy IdentityFile ~/.ssh/id_rsa_prod Host staging HostName staging.example.com User admin
之后即可用简洁命令调用：
fab --hosts=prod my_task # 或封装为 alias（见下文）
3. Shell 函数封装（实现真正 fab my_task 效果）
在 ~/.bashrc 或 ~/.zshrc 中添加：
# 设置默认主机（可按项目切换）
export FAB_DEFAULT_HOST="prod"
# 封装 fab 命令
fab() {
if [ -n "$FAB_DEFAULT_HOST" ]; then
command fab --hosts="$FAB_DEFAULT_HOST" "$@"
else
command fab "$@"
fi
}
重载配置后，即可无参数运行：
source ~/.zshrc fab my_task # 自动等价于 fab --hosts=prod my_task
❌ 为什么不推荐 fabric.yml 的 default 配置？
Fabric 2 的 fabric.yml 不支持 default: 顶层键。其合法结构仅限于 tasks:（自定义任务参数）和 run:/connect_kwargs: 等运行时配置项。以下写法无效：
# ❌ 错误：fabric.yml 不识别 default.host default: host: user@host
正确用法示例（仅影响连接行为，不替代 --hosts）：
# fabric.yml —— 仅补充连接参数，不能定义目标主机 connect_kwargs: connect_timeout: 10 look_for_keys: true
? 最佳实践建议
-
跨项目复用任务：保持
fabfile.py完全无主机硬编码，依赖外部注入（CLI 或环境）； -
环境隔离：通过不同 shell 变量（如
FAB_ENV=staging）配合函数动态解析主机； -
调试技巧：在任务开头加入检查，防止误本地执行：
@task def my_task(c): if not hasattr(c, 'host') or not c.host: raise RuntimeError("This task requires a remote connection. Please use --hosts.") c.run("hostname")
通过以上任一方式，你就能告别重复输入 --hosts，在保留 Fabric 2 灵活性的同时，获得接近 Fabric 1 的简洁体验。
