Docs
产品简介
认识 SwitchOps 交换机自动化巡检工具的功能、适用场景、工作流程和安全边界。
SwitchOps 交换机自动化巡检工具
switch-ops-netmiko 是一个基于 Python、Netmiko 的交换机只读巡检工具，面向需要批量检查院内或园区网络设备的运维人员。它支持华为 VRP 和华三 Comware 设备，既可以通过 Windows 图形界面操作，也可以通过命令行接入日常自动化流程。
工具会自动登录交换机、执行预设的只读命令、保存完整原始回显，并生成 Excel 巡检报告。巡检结果还可以写入 SQLite 历史库，用于查看设备状态变化趋势。
主要能力
| 能力 | 说明 |
|---|---|
| 批量巡检 | 一次巡检全部启用设备，也可以只巡检指定或勾选的设备。 |
| 多厂商支持 | 内置华为 VRP、华三 Comware 命令模板。 |
| 只读采集 | 仅允许 display、show、screen-length 等查询或分页命令。 |
| 实时查询 | 支持单设备 ARP、MAC 地址表和接口状态查询。 |
| 重点端口监控 | 可为核心上联、服务器或防火墙互联口配置专项状态检查。 |
| Excel 报告 | 自动生成巡检汇总、失败设备清单和端口台账。 |
| 原始数据留存 | 每台设备保存完整命令回显，解析不完整时仍可人工复核。 |
| 历史趋势 | 巡检结果写入 SQLite，可按设备查看最近 CPU、内存、接口和结论。 |
| Windows 交付 | 可通过 PyInstaller 打包为单文件 EXE，方便一线运维人员使用。 |
工作流程
适用场景
- 医院、学校、园区或企业内网的日常交换机巡检。
- 批量采集设备版本、运行时间、CPU、内存和环境状态。
- 维护交换机端口台账，快速查看接口 up/down 数量。
- 定期监控核心上联口、服务器口等重点接口。
- 根据 IP、设备名称查询 ARP、MAC 或单个接口回显。
- 保留巡检历史，为故障复盘和趋势对比提供数据。
支持范围
当前内置以下设备类型：
| 厂商/平台 | 推荐 vendor | 推荐 device_type | 命令模板 |
|---|---|---|---|
| 华为 VRP | huawei | huawei | huawei |
| 华三 Comware | h3c | hp_comware | h3c 或 h3c_comware |
其他设备可以通过增加命令模板尝试接入，但 Netmiko 的 device_type、设备回显格式和解析规则都需要单独验证。
安全边界
SwitchOps 当前定位是只读巡检工具。不要在
commands.yaml 中加入保存、重启、删除或下发配置等命令。程序会主动拒绝非只读命令，但部署时仍应使用最小权限的专用巡检账号，并先在测试设备上验证。当前版本不提供配置备份。display current-configuration 会被只读安全校验拒绝，后续如需开放，应单独评估配置敏感信息、权限和存储安全。