使用Python自动配置网络设备的实战指南

 更新时间:2026年11月20日 09:22:28   作者:用户甲  
本文将教大家使用Python和netmiko实现网络设备自动配置,从基础脚本到批量并发执行,涵盖配置模板、备份回滚、异常处理,让你轻松管理几十上百台交换机路由器,提升效率,告别重复劳动

1. 项目整体设计思路拆解

网络设备配置这件事,放在几年前,大家的第一反应还是“登到设备上敲命令”。即使是批量操作,也无非是开好几个终端窗口,一条命令一条命令地贴进去,再瞪大眼睛比对回显有没有报错。这套流程应付三五台设备还能忍,设备一上规模,比如几十台上百台,或者配置需要反复调整,人的精力和注意力就成了最大的瓶颈——漏一条命令、错一个参数、漏看一行报错,可能就把整批配置带进沟里。

用Python做网络设备自动配置,本质上是把“人对着设备敲命令”这件事,拆解成“程序替人对着设备敲命令”。听起来好像只是把手工操作自动化了,但实际落地之后你会发现,真正的价值远不止省时间,而是把整个配置过程变成了可重复、可审计、可回滚的工程化流程。手工操作时,某台设备配置到一半断线了,配置状态是什么?没人说得清。但脚本执行时,每一步都有日志、有退出码、有状态记录,出了问题可以精确回溯到具体哪一步、哪条命令、哪个参数。

这个项目解决的核心痛点有三个:

  • 批量一致性 :几十台设备的配置相同或近似,手工操作不可避免会出现细微差异,脚本可以保证同模板下每台设备的配置完全一致。
  • 变更可追溯 :每次自动配置产生的日志、备份、时间戳,都能关联到具体批次和操作人,这在后续排障和责任回溯时极其重要。
  • 人力释放 :把重复性配置工作交给脚本,网络工程师才有精力去做架构优化、故障排查这些更有价值的事情。

适合参考这个项目的读者,主要是有一定网络基础、想引入自动化手段的运维或网络工程师,以及刚入门网工、想拓宽技能树的开发人员。我不建议纯零基础的人从这篇文章直接开始——你需要先知道什么是SSH、什么是命令行接口、路由器交换机大概怎么登录,否则后面的配置可能会看得一头雾水。但如果这些基础你已经具备,这篇文章能帮你把整个自动配置系统的骨架搭起来。

2. 技术方案选型与核心依赖解析

2.1 为什么选择Python作为自动化语言

说实话,能实现网络设备自动配置的语言不止Python一种,Shell脚本、Go、甚至C语言都能干,但Python在这件事上有几个其他语言很难替代的优势。

首先是生态。Python的netmiko、paramiko、scrapli这三个库,基本把网络设备自动化这个细分领域的需求给包圆了。你不需要从零开始实现SSH协议、处理命令回显的差异、适配不同厂商的设备特性,社区已经把坑填得差不多了。其次是上手门槛,Python的语法天然适合快速写脚本,一个几百行的自动化脚本从构思到跑通,可能只需要一个下午。第三是运维领域的存量积累,现在很多运维工具、监控系统、CI/CD平台都提供了Python API或原生Python支持,你写好的设备配置脚本很容易嵌入到现有的工作流里。

当然,如果你的场景极其简单——就是每天定时执行几条命令,那用Shell配合expect脚本也能做。但如果涉及设备类型多、配置逻辑复杂、需要对接工单系统或CMDB,Python的组织能力会强得多。

2.2 关键技术库的选择与取舍

库选型是整个项目里最需要想清楚的一步。选对了,后面所有代码都顺;选错了,光调适配就能磨掉你大半精力。

paramiko 是Python下最底层的SSH实现库,它封装了SSH协议本身,支持连接、执行命令、传输文件。它的优点是纯粹的SSH能力,不掺入任何网络设备相关的逻辑,优点同时也是缺点——你需要在代码里自己处理设备登录后的交互、回显读取、超时判断这些事。适合做定制开发或者学习SSH原理的人。

netmiko 是在paramiko之上的封装,专门针对网络设备做了多厂商适配,支持思科、华为、华三、瞻博、Arista等主流厂商,它解决了网络设备登录和交互中的很多共性细节:比如不同设备的登录提示符不同、命令分页导致回显被截断(就是--More--)、退出时的确认交互等。如果你面对的是多厂商混合环境,netmiko几乎是必须的。

scrapli 是后来居上的新选择,性能比netmiko更好,异步支持更完善,底层可以直接走paramiko或者ssh2-python。但它的社区生态和文档成熟度目前还略逊netmiko,如果你不想折腾,先从netmiko上手会更平稳。

我这个项目的建议是:主用netmiko,底层原理也不需要完全忽略。一旦遇到netmiko适配不了的老设备,你至少知道可以退回paramiko自己写交互逻辑。

注意:不要一上来就追求“一个库吃遍天”。设备厂商、系统版本差别很大,自动化的第一步永远是先弄清楚你的设备环境,再选择适配方案。最忌讳的是代码写好了才发现设备不在支持列表里,返工成本极高。

2.3 项目运行环境与依赖安装

这个项目对硬件几乎没有要求,普通电脑即可,甚至树莓派也行。Python版本建议3.9及以上,太老的版本有些库的新特性跑不了。

建议使用虚拟环境来隔离项目依赖,避免和系统环境冲突。安装依赖只需要一行命令:

pip install netmiko

底层会自动把paramiko一起装上。如果是批量并发执行,可能还需要concurrent.futures之类的标准库,这些直接import就行,不需要额外安装。

如果你后续想加配置备份、审计报表这些能力,可以把openpyxl(生成Excel表格)、schedule(定时任务)、Flask(Web界面)陆续纳入技术栈。但这篇先聚焦核心,把“自动配置”这条主链路跑通,其他能力可以后续慢慢加。

3. 核心配置脚本实操拆解

3.1 最基础的登录与命令执行脚本

先把最小可用的骨架搭出来,这个脚本实现的是:SSH登录一台设备、执行一条命令、打印回显、断开连接。别看功能简单,它是整个自动化体系的基石。

from netmiko import ConnectHandler

device = {
    "device_type": "huawei",          # 设备厂商类型,netmiko支持的关键字
    "ip": "192.168.10.1",             # 设备的IP地址
    "username": "admin",              # 登录用户名
    "password": "Admin@123",          # 登录密码
    "port": 22,                       # SSH端口,默认22,按需修改
}

try:
    connection = ConnectHandler(**device)
    print("设备连接成功")
    
    # 执行一条普通查看命令
    output = connection.send_command("display version")
    print(output)
    
    connection.disconnect()
    print("已断开连接")
except Exception as e:
    print(f"连接或执行失败:{e}")

写这段代码的时候有几个细节值得展开说。

device_type这个参数非常关键,netmiko就是靠它来决定用什么方式跟设备交互的。不同的设备类型,登录时的shell类型、命令行提示符、退出方式可能都不一样。huawei、cisco_ios、hp_comware这些都是netmiko内置支持的设备类型关键字,具体列表可以在netmiko的官方文档里查。如果你用了错误的device_type,最常见的报错是认证失败或登录后提示符识别不对。此时不要急着怀疑密码,先检查device_type是不是匹配了真实的设备平台。

send_command执行的是非交互式命令,也就是不需要设备再回问你的命令。如果你要执行的命令会进入交互式对话(比如升级系统时确认是否继续),那就得用send_command_timing或者配合“expect_string”参数来匹配提示符,这部分我会在后面讲。

另外必须强调的是,设备密码这类敏感信息 绝不能 硬编码在脚本里。上面的代码只是为了演示写进代码了,但实际项目中需要用配置文件、环境变量、或者专门的密钥管理系统来保存账号密码。

3.2 配置模板的设计与参数化

有了基础连接后,下一步就是把配置做成“模板+参数”的结构。为什么要做模板?举个例子,你要给30台交换机配置管理地址,每台的接口号可能不一样、IP地址不一样、甚至主机名都不一样。如果每条命令都写死在脚本里,30台设备你就要写30份代码。

参数化模板的思路是:配置命令本身是固定的框架,只有变量部分(比如IP、名称)需要按设备替换。下面是一个简化的示例:

# 配置模板
def generate_config(hostname, vlan_id, vlan_name, mgmt_ip, gateway_ip):
    config_lines = [
        f"system-view",                                    # 进入系统视图
        f"sysname {hostname}",                             # 设置主机名
        f"vlan {vlan_id}",                                 # 创建VLAN
        f"name {vlan_name}",                               # 为VLAN设置名称
        f"interface Vlanif {vlan_id}",                     # 进入VLAN接口
        f"ip address {mgmt_ip} 255.255.255.0",             # 配置IP地址
        f"quit",
        f"ip route-static 0.0.0.0 0.0.0.0 {gateway_ip}",   # 配置默认路由
        f"return",                                         # 返回用户视图
    ]
    return config_lines

这个函数接收设备差异化的参数,返回一个配置命令清单。调用的时候,再用一张设备信息表(可以是Excel、CSV、或者Python字典)来循环执行:

devices_info = [
    {"hostname": "ACC-SW-01", "ip": "192.168.10.11", "vlan_id": 100, "mgmt_ip": "10.10.10.11", "gateway_ip": "10.10.10.254"},
    {"hostname": "ACC-SW-02", "ip": "192.168.10.12", "vlan_id": 100, "mgmt_ip": "10.10.10.12", "gateway_ip": "10.10.10.254"},
]

for device in devices_info:
    config_lines = generate_config(device["hostname"], device["vlan_id"], ...)
    # 连接设备,下发配置

到这一步,你已经实现了“一份模板,批量套用”的效果。新加一台设备,只需要在设备清单里加一行记录,不用改代码。

有一点值得提醒:生成配置清单时要严格区分“配置模式”和“用户视图模式”下的命令。很多设备在system-view(系统视图)和直接在用户视图下,命令语法是不同的。上面我用system-view进入之后才敲配置命令,最后用return退出到用户视图,这是华为设备的习惯。如果你操作的是思科设备,对应的是configure terminal和end。这些差异要在模板设计阶段就考虑进去。

3.3 实现对命令行交互场景的处理

实际运维中,很多配置流程不是一条命令走到底的,中途会遇到设备反问你“Are you sure?”或者等待你输入时出现“---- More ----”分页符。这类交互是自动化最容易卡壳的地方,也是新手最容易翻车的环节。

netmiko提供了几个专门应对这些场景的方法。

send_command_timing :纯粹按时间间隔发送命令,读取设备输出后,等待设定的延迟时间后再发送下一条命令。适合那些输出不固定、但你知道“过一会儿提示符肯定会回来”的情况。

send_command 配合expect_string:send_command本身就可以指定expect_string参数,意思是netmiko会一直读取设备回显,直到匹配到指定的字符串再继续。这个字符串通常就是命令执行完成后的提示符。

send_expect 进化版其实是send_command的底层逻辑,它会持续匹配期望的提示符。更常见的是在配置命令列表的最后加上模拟确认的命令:

假如某条命令执行后设备会问“Are you sure to continue? (y/n)[n]”,你就需要预估到这个交互,在配置清单里插入一条“y”:

config_lines = [
    "system-view",
    "undo startup saved-configuration",
    "y",           # 回应设备的确认提问
    "return",
]

这个“y”看起来简陋,但它是确保流程连贯的关键。你不加它,脚本就停在那里一直等输入,直到超时报错。所有涉及已知交互的命令,都要预设好回答内容。

实操心得:交互处理的终极原则是“能避则避”。如果某条命令会触发交互确认,优先看有没有不交互的替代命令。比如某些设备支持 force 或 noword 之类的参数跳过确认,抱着“少一个交互少一个坑”的心态去设计配置流程,会省很多排错时间。

3.4 配置前先备份,给自己的操作上保险

自动配置最怕什么?配置推到一半,发现命令有误,设备处于一种半新半旧的混乱状态。更惨的是配置完全推错了,设备配置被冲掉,连不上网,想回滚都没有基线版本。

所以在做任何配置变更前,一定要先备份设备的当前配置。这一步手工操作时很多人会偷懒,但自动化脚本里绝对不能省。backup就是项目里的“安全带”,也许大多数时候用不上,但真出事的时候能救命。

用netmiko备份设备配置的代码如下:

def backup_config(device, backup_dir="backup/"):
    timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
    
    connection = ConnectHandler(**device)
    
    if device["device_type"].startswith("huawei"):
        config = connection.send_command("display current-configuration")
    elif device["device_type"].startswith("cisco"):
        config = connection.send_command("show running-config")
    else:
        config = connection.send_command("display current-configuration")
    
    # 保存到本地文件,文件名包含设备IP和时间戳
    filename = f"{backup_dir}/{device['ip']}_{timestamp}.cfg"
    with open(filename, "w") as f:
        f.write(config)
    
    connection.disconnect()
    return filename

在备份文件上,建议用“设备IP_时间戳.cfg”的命名方式,这样后续如果要对比不同时间点的配置差异,按文件名排序就能找到时间线。

有了备份之后,即使配置推错了,你可以用脚本来做恢复:

def restore_config(device, backup_file):
    connection = ConnectHandler(**device)
    # 进入配置模式,逐行下发备份文件中的配置命令
    with open(backup_file, "r") as f:
        config_lines = f.readlines()
    output = connection.send_config_set(config_lines)
    print(output)
    connection.disconnect()

这里用到了send_config_set方法,它会自动处理进入配置模式、逐条下发命令、退出配置模式的过程。比起你自己手动拼接enter和命令,这个方法更安全,因为netmiko会在每条命令之间等待设备回显,不易出现命令粘连。

4. 批量自动化与并发执行实现

4.1 串行批量配置的基础实现

备份和配置的单个操作写好后,批量自然就是套一层循环。最简单的串行版本如下:

def deploy_configuration(device, config_lines):
    connection = ConnectHandler(**device)
    output = connection.send_config_set(config_lines)
    connection.disconnect()
    return output

devices_list = [...]  # 设备信息列表

for device in devices_list:
    config_lines = generate_config(device["hostname"], ...)
    # 先备份
    backup_path = backup_config(device)
    print(f"{device['ip']} 备份完成,文件:{backup_path}")
    
    # 再配置
    output = deploy_configuration(device, config_lines)
    print(f"{device['ip']} 配置完成")
    
    # 最后验证
    verify_output = connection.send_command("display current-configuration | include sysname")
    print(verify_output)

串行执行的好处是逻辑简单、不容易出并发问题,设备处理能力弱或者网络带宽有限时必须用这种方式。但缺点就是慢。假设一台设备连配置带备份需要40秒,50台设备就是2000秒,半小时以上了。如果是几十台网络设备同时上线,这个速度很难接受。

这里就引出了“并发执行”和“执行节奏控制”之间的矛盾——并发了就快,但网络设备毕竟是并发能力有限的专用设备,而且同一个管理IP下还有系统登录数限制。

4.2 基于concurrent.futures的并发控制

并发并不是越多线程越好。网络设备的管理接口为SSH连接数,往往有上限,比如同时只允许5个SSH会话。并发太高会导致登录失败或者设备响应异常慢。

推荐的方案是用concurrent.futures.ThreadPoolExecutor控制最大并发数,避免一次性全部冲上去:

from concurrent.futures import ThreadPoolExecutor, as_completed

def process_device(device):
    device_ip = device["ip"]
    print(f"[{device_ip}] 开始处理")
    try:
        config_lines = generate_config(...)
        backup_path = backup_config(device)
        output = deploy_configuration(device, config_lines)
        return device_ip, "success", output
    except Exception as e:
        return device_ip, "failed", str(e)

def batch_run(devices_list, max_workers=5):
    results = {}
    with ThreadPoolExecutor(max_workers=max_workers) as executor:
        future_map = {executor.submit(process_device, device): device["ip"] for device in devices_list}
        for future in as_completed(future_map):
            device_ip = future_map[future]
            try:
                ip, status, detail = future.result()
                results[ip] = {"status": status, "detail": detail}
            except Exception as e:
                results[device_ip] = {"status": "exception", "detail": str(e)}
    return results

max_workers具体怎么定,我的建议是先从3或者5开始,观察设备侧和网络侧的负荷,再逐步调大。设备型号不同、管理口性能不同,并发上限也不同。这个需要实际测试,不要照搬别人的参数。

4.3 并发环境的坑与队列节奏控制

并发执行时,有几个隐蔽的问题很容易被忽视。

第一个是 共享变量安全 。如果你用了全局变量来收集结果或者计数器,多个线程同时写就会出现数据错乱。上面代码用了返回结果的模式,让每个线程把结果带回来,再由主线程统一处理,就规避了这个问题。

第二个是 日志混杂 。多个线程同时在print,控制台的输出会互相穿插,排错的时候非常痛苦。建议每条日志都加上设备IP前缀,并且配合线程锁输出。实际上日志就不会乱套。可以用Python内置的logging模块,它是线程安全的,打印到文件也比较合理。

第三个是 设备侧的资源占用 。有些网络设备CPU很弱,同时收到5个SSH连接请求,登录过程就会明显变慢。如果你发现并发执行时单台设备的连接时间比串行时长了非常多,甚至频繁超时,那就是并发太激进,要往小调。

4.4 重试机制与失败回滚决策

批量执行的现实是:总会有一两台设备会出意外。可能这条命令执行时设备恰好重启,可能是网络闪断导致连接断开,也可能是设备上的AAA认证策略限制了你这个账号的并发连接数。

因此在批量脚本里加入重试机制是必须的,但重试也要有策略,不能无脑重复:

def execute_with_retry(func, retry_times=2, delay=5):
    for attempt in range(1, retry_times + 1):
        try:
            result = func()
            return result, "success"
        except Exception as e:
            print(f"第 {attempt} 次执行失败:{e}")
            if attempt < retry_times:
                time.sleep(delay)
    return None, "failed"

重试的操作应该限定在“连接设备”和“执行无副作用命令”这类场景。危险配置命令的重试要慎重,比如删除类的命令,第一次执行可能确实没成功,但也不排除部分命令已经下发成功。如果无脑重试,可能带来灾难性的重复配置效果。所以我的建议是: 只有不可变命令(比如查询、备份)才允许自动重试,配置类命令失败后应终止该流程并人工介入确认 。

配置失败的设备,脚本应当记录失败原因,汇总输出一份报告,而不是静默跳过。整个批次的配置报告可以包含:成功列表、失败列表、失败原因、备份文件路径。后续不管是你自己排查还是跟其他同事交接,这份报告都是重要的依据。

5. 安全加固与代码健壮性提升

5.1 账号密码的安全管理模式

做自动化最忌讳的事就是把明文密码写在脚本里。原因不用多说:脚本一旦泄露,等于把你的设备管理权限直接交给了拿到脚本的人。

更安全的方案是把认证信息放到环境变量、独立配置文件(权限设为600),或者在启动脚本时交互式输入。以配置文件方案为例:

# credentials.yaml,注意该文件权限要设置为仅本人可读
device_spec:
  username: admin
  password: "仅在此处配置一次"
  secret: "enable密码(如果有)"

然后在代码中读取:

import yaml

with open("credentials.yaml", "r") as f:
    creds = yaml.safe_load(f)

device = {
    "device_type": "huawei",
    "ip": "192.168.10.1",
    "username": creds["device_spec"]["username"],
    "password": creds["device_spec"]["password"],
}

还是临时使用的话,可以用getpass模块在终端提示输入密码,完全不把密码落盘。当然这种方式更适合手动执行脚本的场景,定时任务还是得靠配置文件或者专门的密钥管理服务。

5.2 超时与异常分支处理逻辑

网络自动化脚本常在半夜跑批,半夜处理一次登录超时,就能知道早把事情处理完的重要性。如果你的脚本没有超时机制,一条连接卡死,整个批次的设备都会被拖住,第二天到公司发现一半设备没配,脚本还卡着挂着,那种感觉真的是很糟糕。

netmiko连接时可以通过timeout参数来控制连接阶段的超时时间,send_command也有timeout参数控制命令响应超时:

device = {
    "device_type": "huawei",
    "ip": "192.168.10.1",
    "username": "admin",
    "password": "password",
    "timeout": 20,                            # 连接等待秒数
}

output = connection.send_command(
    "display current-configuration",
    read_timeout=30,                          # 命令读取超时秒数
)

关于超时的设置,既不能太小,也不能太大。网络设备执行“display current-configuration”这类命令时,如果配置内容很长,输出也要花点时间,超时设太短会导致误判失败。建议是连接阶段15到30秒,命令执行阶段根据命令复杂度设定,普通命令10秒左右足够,耗时的备份命令可以放到30秒以上。

捕获异常时,不要只写一个笼统的except Exception。要区分连接超时、认证失败、命令执行错误这几种情况。认证失败说明账号密码配置有问题,重试也没用;命令执行错误说明模板语法有问题,重试同样没用。把这些情况分门别类,排错时会轻松很多。

5.3 配置后的自动验证机制

配置下发完成不等于任务完成,配置生效需要靠验证。这是整个自动配置流程里最容易被忽略、但实际价值最大的环节。

最朴素的验证方式是执行查询命令,从回显里抓关键信息做断言:

def verify_config(device, hostname, vlan_id):
    connection = ConnectHandler(**device)
    version_output = connection.send_command("display current-configuration | include sysname")
    vlan_output = connection.send_command(f"display vlan {vlan_id}")

    is_hostname_ok = hostname in version_output
    is_vlan_ok = "success" in vlan_output.lower()  # 具体根据设备返回定制

    connection.disconnect()
    return is_hostname_ok, is_vlan_ok

验证的核心思路是:不只看“命令有没有执行”,而是看“配置有没有生效”。在View层推完一条ACL规则后,还要从所有可能的查询接口去确认规则确实存在且顺序正确,这才能叫真正的完成。

5.4 台账并更与日志收集建议

自动化配置之后,如果没有同步更新资产台账,就是新的技术应用的惯例缺失。我建议每跑完一批配置,就把执行结果写回一个执行日志表,包含设备、操作时间、执行内容、结果状态、备份文件路径。如果你们有CMDB系统,还可以通过API把变更记录推送过去,保持配置管理的一致性。

def write_execution_log(result, log_file="execution_log.csv"):
    with open(log_file, "a", newline="") as f:
        writer = csv.writer(f)
        writer.writerow([
            datetime.now().isoformat(),
            result["ip"],
            result["status"],
            result["detail"],
            result.get("backup_file", ""),
        ])

顺便提醒一句:如果涉及线上设备的配置变更,最好把变更方案、变更步骤、变更时间窗、回滚方案事先整理清楚,并且经过评审。自动化只是工具,流程把关仍然需要人来完成。这也是把运维做好和做坏的分水岭。

6. 常见故障与排错经验实录

6.1 连接超时类问题

现象:脚本执行到连接步骤时长时间无响应,最终报timeout错误。

排查思路按优先级来:

  • 先确认网络通畅性,用ping验证管理IP是否可达
  • 再确认设备SSH服务是否正常开启,测试手工SSH能否登录
  • 继续查看设备的管理ACL,你的源IP是否在允许列表内
  • 然后确认并发数是否超过设备限制,并发太高会导致部分连接被拒绝
  • 最后,如果配置了AAA认证,检查账号是否被锁定或过期

这类问题大多和环境相关,脚本本身往往没有逻辑错误。关键是要把设备的“会话限制数”和“登录失败策略”提前测一遍,做到心里有数。

6.2 提示符识别错误类问题

netmiko执行命令后,需要等待设备的提示符出现才认为执行完毕。如果提示符识别逻辑混乱,脚本行为就会很怪异——明明命令执行成功了,脚本却报错说读取超时。

这种情况通常发生在设备厂商系统版本比较特殊,或者修改过人机交互界面的机器上。解决办法有两种:

  • 在netmiko连接参数里指定设备类型时,用更精确的变体(比如从cisco_ios改成cisco_xe)
  • 用session_preparation字段自定义登录后的初始化过程,对齐提示符,让netmiko能够正确识别

还有一个小概率事件:设备的提示符里带了控制字符或转义序列,肉眼看不出来但正则匹配不到。这种情况可以用调试模式打开日志,看看netmiko实际接收到的字符串是什么,再针对性调整。

6.3 命令回显中的隐藏分页符

很多设备的CLI默认分页显示,每次输出一段之后会显示“--More--”等待用户按空格继续。如果脚本在执行长命令(比如查看完整路由表、完整配置)时没有处理好分页,回显内容就会被截断,脚本以为命令还没执行完,就会一直等下去直到超时。

netmiko在多数字设备类型下,默认会自动关闭分页,具体做法是发送命令时将终端长度设置为0或者禁用分页。但总有某些老设备或者特殊配置环境会漏掉这一层,导致脚本卡住。

解决手段是在连接建立后,手动发送一次关闭分页的命令。在华为设备上是:

connection.send_command("screen-length 0 temporary")

在思科设备上是:

connection.send_command("terminal length 0")

养成这个习惯,每次连接建立后第一件事就是关闭分页,可以少踩很多坑。

6.4 配置下发后设备重启的风险

自动配置里有一类操作要格外谨慎:涉及保存配置、重启设备、或者加载新版本系统镜像的命令。

如果脚本误发了reboot命令,结果是灾难性的。尤其夜间批量执行,设备一连串重启,立刻触发大面积网络中断。所以我的铁律是: 自动配置脚本中严禁出现重启、删除启动配置、格式化管理介质这一类的危险命令 。如确实有需要,也必须有独立的流程、增加人工二次确认环节、有严格的执行窗口。

如果必须做升级重启,建议单独设计升级脚本,别跟日常配置脚本混在一起。升级脚本里要加入重启前的配置保存校验、重启后的存活探测、回退触发机制,整体复杂度高得多。

6.5 常见故障速查表

故障现象可能原因排查动作解决办法
连接超时网络不通、SSH未开启、ACL限制ping、telnet测试、查看设备会话日志放通ACL、开启SSH、检查网络路径
认证失败密码错误、账号过期手工SSH登录一次更新密码或账号状态
读取回显超时分页符未关闭、命令执行时间过长打开调试日志,确认回显末尾关闭分页、增大read_timeout
设备类型报错device_type与实际平台不匹配核对设备实际系统修改device_type
命令执行报错模板命令语法不正确手工逐条执行模板命令修正模板、确认设备版本
并发大量失败并发数过高导致设备拒绝查看设备连接日志调低max_workers、错峰执行

注意:所有配置变更类操作,尽量选择业务低峰期执行。自动配置脚本跑得顺利不代表没有风险,留足出问题的缓冲时间,是运维最基本的安全意识。

7. 项目扩展方向与个人体会

核心的自动配置能力打通之后,这个项目的扩展空间其实是很大的。我自己实际做过几个延伸,差异都不太大,但每个都值得琢磨。

7.1 扩展成配置合规检查工具

基于自动连接设备的能力,你可以定期抓取设备配置,然后和后端保存的基准配置做对比。比如安全基线要求所有设备开启日志记录、关闭telnet服务、配置NTP同步。用脚本定期扫描全部设备,把不合规项自动整理出来,这就是一个非常实用的合规巡检工具。

def check_compliance(device, baseline_rules):
    connection = ConnectHandler(**device)
    running_config = connection.send_command("display current-configuration")
    
    for rule in baseline_rules:
        keyword = rule["keyword"]
        must_exist = rule["must_exist"]
        exists = keyword in running_config
        status = "PASS" if exists == must_exist else "FAIL"
        print(f"{device['ip']} 检查项 {keyword} => {status}")

设备多了以后,这个工具比人肉巡检可靠太多,也更公平——因为规则是统一的。

6.2 配合配置管理平台做自助化

如果你想把自动化能力开放给更多人使用,可以包一层Web界面,或者接入现有的工单系统。用户填单申请IP资源变更,后端自动调用配置脚本去执行,执行结果自动反馈到工单。这就从“工程师手写脚本”升级到了“平台化的自动配置服务”,整个流程更规范、更可控、也更可审计。

6.3 最后想分享的一点体会

我做网络自动化这几年,最深的感触是:工具再强大,也替代不了对网络本身的理解。脚本只是把你的意图变成设备配置,但意图对不对、风险点在哪里、出了问题怎么处理——这些还是要靠人的判断。

所以我给新人的建议是:先熟练手工配置,再把重复操作脚本化,最后才谈批量自动化。不要一上来就追求“全自动”,先把对设备的掌控感建立起来,自动化才会是真正的利器,而不是一个随时可能引爆的定时炸弹。

写脚本时多想想几件事:你的操作会不会影响线上业务?失败之后能不能回滚?执行日志是否完整?如果你对这三个问题的答案都有把握,那这项目就已经到了可以放心上线的状态了。

以上就是使用Python自动配置网络设备的实战指南的详细内容,更多关于Python网络设备配置的资料请关注脚本之家其它相关文章!

相关文章

  • python中列表添加元素的几种方式(+、append()、extend())

    python中列表添加元素的几种方式(+、append()、extend())

    本文主要介绍了python中列表添加元素的几种方式(+、append()、extend()),文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2022-08-08
  • Jupyter Notebook输出矢量图实例

    Jupyter Notebook输出矢量图实例

    这篇文章主要介绍了Jupyter Notebook输出矢量图实例,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-04-04
  • 解决pyqt中ui编译成窗体.py中文乱码的问题

    解决pyqt中ui编译成窗体.py中文乱码的问题

    下面小编就为大家带来一篇解决pyqt中ui编译成窗体.py中文乱码的问题。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2016-12-12
  • 浅谈python中的错误与异常

    浅谈python中的错误与异常

    写Python代码的小伙伴不可避免地会遇到代码执行错误和异常,这次就来详细的总结一下python中的错误和异常
    2021-06-06
  • pycharm 主题theme设置调整仿sublime的方法

    pycharm 主题theme设置调整仿sublime的方法

    今天小编就为大家分享一篇pycharm 主题theme设置调整仿sublime的方法,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-05-05
  • 基于django micro搭建网站实现加水印功能

    基于django micro搭建网站实现加水印功能

    这篇文章主要介绍了基于django micro搭建网站实现加水印功能,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-05-05
  • Python实现批量检测HTTP服务的状态

    Python实现批量检测HTTP服务的状态

    本文给大家分享的是一个使用python实现的批量检测web服务可用性的脚本代码,主要功能有测试一组url的可用性(可以包括HTTP状态、响应时间等)并统计出现不可用情况的次数和频率等。
    2016-10-10
  • pytorch 实现在测试的时候启用dropout

    pytorch 实现在测试的时候启用dropout

    这篇文章主要介绍了pytorch 实现在测试的时候启用dropout的操作,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-05-05
  • python实现简单的购物程序代码实例

    python实现简单的购物程序代码实例

    这篇文章主要介绍了python实现简单的购物程序代码实例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-03-03
  • 从基础到高级详解Python中文件操作的全攻略实战指南

    从基础到高级详解Python中文件操作的全攻略实战指南

    在Python编程中,文件操作是连接程序与外部存储的桥梁,本文将从基础读写讲起,逐步深入到高效处理、异常管理、二进制操作等高级场景,希望对大家有所帮助
    2025-10-10

最新评论