netadmin 🐱🐯

华为和思科交换机的 Web 管理工具 — 不用记命令，打开浏览器就能用。

pip install netadmin
netadmin

浏览器打开 http://localhost:8099 → 开始管理你的交换机。

---

这是什么？

netadmin 是一个给不会/不想记命令的人用的交换机管理工具。
你只需要知道设备的 IP 和密码，剩下的事情都在浏览器里点点按钮。

能做什么？

功能	怎么做
添加设备	在网页上填 IP、用户名、密码，不用编辑 YAML
测试连接	点一下「测试连接」就知道能不能连上
设备巡检	点「设备巡检」看 CPU/内存/温度，好坏一目了然
执行命令	在文本框里敲命令，结果直接显示在页面上
配置备份	点「配置备份」，当前配置存下来，以后可以对比
配置克隆	从一台配好的设备学配置，改改就能批量部署到别的设备
定时备份	设置每天/每小时自动备份
Web 仪表盘	所有设备的状态一目了然

快速开始

安装

# 安装 netadmin（含 Web 界面）
pip install "netadmin[web]"

启动

# 启动后浏览器打开 http://localhost:8099
netadmin

不需要记子命令！不传参数默认启动 Web。

添加第一台设备

1. 浏览器打开 http://localhost:8099
2. 在「添加新设备」表单里填：
   • IP 地址（比如 192.168.1.100）
   • 用户名和密码（SSH 登录用的）
   • 厂商（华为或思科）
3. 点「添加设备」
4. 在设备卡片上点「测试连接」，看到绿色提示就成功了

支持的设备

厂商	型号系列
华为 Huawei	S 系列、CE 系列、CloudEngine
思科 Cisco	Catalyst、ISR、ASR、Nexus

还想用命令行？

所有子命令也都保留：

netadmin --help           # 查看所有命令
netadmin connect 10.0.1.1    # 测试连接
netadmin backup run          # 全量备份
netadmin check --all         # 全量巡检
netadmin web                 # 启动 Web（跟 netadmin 效果一样）

环境变量

变量	说明
NETADMIN_CONFIG	配置文件路径，默认自动查找 config.yaml
NETADMIN_WEB_USER	Web 登录用户名（可选）
NETADMIN_WEB_PASS	Web 登录密码（可选）
NETADMIN_PASS_10_0_1_1	单台设备的密码覆盖（IP 的点换成下划线）

项目结构

netadmin/
├── netadmin/
│   ├── cli.py          # CLI 入口（默认启动 Web）
│   ├── web/
│   │   ├── app.py      # Web 应用（FastAPI）
│   │   └── templates/  # 页面模板
│   ├── connector.py    # SSH 连接（Netmiko）
│   ├── commands.py     # 厂商命令映射
│   ├── backup.py       # 配置备份 + 版本管理
│   ├── learn.py        # 照猫 — 学习配置
│   ├── apply.py        # 画虎 — 部署配置
│   ├── checker.py      # 健康检查 + 安全审计
│   ├── scheduler.py    # 定时备份调度
│   ├── notifier.py     # 告警通知（Telegram/钉钉）
│   └── ...
├── config.yaml         # 设备清单
└── tests/

License

MIT

---

Made by @yhan1203 ⭐ 好用就点个 Star

关键词： 网络自动化 · 华为交换机管理 · 思科交换机管理 · 配置备份 · 配置克隆 · 安全审计 · 网络设备发现 · CLI 运维工具 · Web 仪表盘 · 定时备份 · 告警通知