Netmiko：Python多厂商网络设备SSH自动化库

Wed, 19 Nov 2025 19:44:31 +0800

Netmiko 是一个基于 Paramiko 的 Python 库，专门用于简化网络设备的 SSH 管理。它支持 Cisco、Juniper、Arista、HP、华为、Fortinet 等 100+ 平台，提供统一的 API 接口，让网络工程师可以用一套代码管理不同厂商的设备。

安装

pip install netmiko

基本用法

建立 SSH 连接

from netmiko import ConnectHandler

device = {
 'device_type': 'cisco_xe',
 'host': '192.168.1.1',
 'username': 'admin',
 'password': 'password',
}

net_connect = ConnectHandler(**device)
print(net_connect.find_prompt()) # 输出: cisco5#

device_type 指定设备厂商和型号，常见值包括：

device_type	厂商/平台
cisco_ios	Cisco IOS
cisco_xe	Cisco IOS XE
cisco_nxos	Cisco NX-OS
juniper_junos	Juniper JunOS
arista_eos	Arista EOS
huawei	华为
hp_comware	H3C Comware
fortinet	Fortinet

执行 show 命令

output = net_connect.send_command('show ip arp')
print(output)

Netmiko 会自动处理输出分页（terminal length 0），并去除命令回显和提示符，只返回纯净的命令输出。

对于耗时较长的命令，可以指定超时时间：

output = net_connect.send_command('show tech-support', delay_factor=5, max_loops=500)

执行配置命令

config_commands = [
 'interface GigabitEthernet0/1',
 'description Uplink-to-Core',
 'ip address 10.0.0.1 255.255.255.0',
 'no shutdown',
]

output = net_connect.send_config_set(config_commands)
print(output)

# 保存配置
net_connect.save_config()

send_config_set() 会自动进入配置模式、逐条执行命令、退出配置模式。

批量管理多台设备

from netmiko import ConnectHandler

devices = [
 {'device_type': 'cisco_xe', 'host': '192.168.1.1', 'username': 'admin', 'password': 'pass1'},
 {'device_type': 'cisco_xe', 'host': '192.168.1.2', 'username': 'admin', 'password': 'pass2'},
 {'device_type': 'cisco_xe', 'host': '192.168.1.3', 'username': 'admin', 'password': 'pass3'},
]

for device in devices:
 try:
 conn = ConnectHandler(**device)
 output = conn.send_command('show version')
 print(f'{device["host"]}: {output[:100]}...')
 conn.disconnect()
 except Exception as e:
 print(f'{device["host"]}: 连接失败 - {e}')

高级用法

使用配置文件管理设备信息

import yaml
from netmiko import ConnectHandler

with open('devices.yaml') as f:
 devices = yaml.safe_load(f)

for device in devices:
 conn = ConnectHandler(**device)
 conn.send_command('show running-config')
 conn.disconnect()

devices.yaml 示例：

- device_type: cisco_xe
 host: 192.168.1.1
 username: admin
 password: secret
- device_type: juniper_junos
 host: 192.168.1.2
 username: admin
 password: secret

配置回滚

# 备份当前配置
backup = net_connect.send_command('show running-config')

# 应用新配置
net_connect.send_config_set(new_config)

# 如果出错，回滚
net_connect.send_config_set(backup.split('\n'))

多线程批量操作

from concurrent.futures import ThreadPoolExecutor
from netmiko import ConnectHandler

def run_command(device, command):
 conn = ConnectHandler(**device)
 output = conn.send_command(command)
 conn.disconnect()
 return device['host'], output

with ThreadPoolExecutor(max_workers=10) as executor:
 futures = [executor.submit(run_command, d, 'show version') for d in devices]
 for future in futures:
 host, output = future.result()
 print(f'{host}: {output[:80]}...')

最佳实践

始终使用 try/except 处理连接异常：网络环境不稳定，设备可能不可达
使用配置文件管理设备信息：不要硬编码 IP 和密码
批量操作使用多线程：串行执行效率低，多线程可大幅提升速度
操作前备份配置：配置变更前先 show running-config 保存
合理设置超时参数：大设备或复杂命令需要增加 delay_factor 和 max_loops
及时断开连接：操作完成后调用 disconnect() 释放资源

总结

Netmiko 是网络自动化的利器，用 Python 替代手工 SSH 登录设备执行命令，大幅提升运维效率。配合配置文件管理和多线程，可以轻松实现数百台设备的批量配置和巡检。

Netmiko on HiDa