本文详解如何通过 Fabric 远程调用 EdgeOS（VyOS/UniFi USG/ER 系列）的 CLI 配置命令，解决因非交互式 Shell 导致 configure、show 等命令不可用的问题，并提供可落地的脚本示例与关键注意事项。
本文详解如何通过 fabric 远程调用 edgeos（vyos/unifi usg/er 系列）的 cli 配置命令，解决因非交互式 shell 导致 `configure`、`show` 等命令不可用的问题，并提供可落地的脚本示例与关键注意事项。
EdgeOS（基于 VyOS）的管理命令（如 configure、show、commit）默认仅在交互式 Bash 会话中可用，其原理是通过 /etc/bash_completion.d/vyatta-* 补全脚本动态注入命令别名与函数，并依赖 $PS1 判断是否启用环境初始化。而 Fabric 默认以非交互模式（-T）建立 SSH 连接，此时 $PS1 为空，.bashrc 中的初始化逻辑被跳过，导致 configure 命令根本未注册——因此报错 command not found (exit code 127)。
根本解法不是“修复 Shell 环境”，而是绕过 Shell 查找机制，直接调用配置命令的绝对路径。 在 EdgeOS 中，configure 实际是一个 Python 脚本（位于 /opt/vyatta/sbin/configure），它会启动一个带完整上下文的 CLI 子进程。你可在交互式 SSH 会话中快速确认路径：
$ type configure configure is /opt/vyatta/sbin/configure
✅ 正确做法：使用 run() 执行该绝对路径，并将多行配置指令通过 stdin 或分号连接方式传入。由于 configure 启动后进入交互式子 shell（提示符为 [edit]#），必须确保命令能被一次性读取并退出，否则会阻塞。
以下为推荐的 Fabric 3.x（fabric>=2.0）实现方案：
立即学习“Python免费学习笔记（深入）”；
from fabric import Connection
c = Connection(
host="192.168.1.1",
user="ubnt",
connect_kwargs={"password": "your_password"} # 或使用密钥认证
)
# ✅ 方案一：单行命令链（推荐，简洁可靠）
result = c.run(
"/opt/vyatta/sbin/configure; "
"set interfaces ethernet eth2 vif 20 disable; "
"commit; "
"save; "
"exit",
hide=True,
warn=True # 允许失败但不抛异常，便于检查结果
)
print("Exit code:", result.exited)
print("Stdout:", result.stdout.strip())
if result.stderr:
print("Stderr:", result.stderr.strip())
# ✅ 方案二：使用 heredoc 风格（更清晰，适合复杂配置）
config_script = """cat << 'EOF'
set interfaces ethernet eth2 vif 20 disable
commit
save
exit
EOF"""
# 通过管道将脚本输入到 configure
c.run(f"/opt/vyatta/sbin/configure < /dev/stdin", stdin=config_script, hide=True, warn=True)⚠️ 关键注意事项：
- 不要尝试 source /etc/bash_completion.d/vyatta-cfg：该文件定义的是 Bash 补全函数，而非命令本身；且非交互式 Shell 中函数无法持久生效。
- 避免 c.run("configure") 后跟独立 c.run("set ...")：每次 run() 是独立的 Shell 进程，configure 启动的编辑会话会在命令结束时立即退出，后续命令无意义。
- 务必显式调用 exit：防止 CLI 子进程残留或超时中断。
- 生产环境强烈建议使用密钥认证：禁用密码登录，提升安全性与自动化稳定性。
- 批量操作前先测试 show configuration commands：验证目标命令语法是否兼容当前 EdgeOS 版本（如 vif 子接口语法在较新版本中可能需调整为 vlan）。
通过直接调用 /opt/vyatta/sbin/configure 并内联执行配置指令，你就能稳定、高效地将 EdgeOS 配置纳入 Python 自动化流水线，无需修改路由器系统文件或依赖交互式终端模拟。
