SNMP Agent 命令行实战MIB、发 Trap、配白名单
做被网管的设备,SNMP Agent 怎么配?本文用芯祥联 Agent SDK 演示 Demo,把设备端的运行状态、共同体、v3 用户、MIB 管理、Trap 上报、IP 白名单用一条条命令讲清楚。
建议 CSDN 标题:SNMP Agent 开发实战:MIB 注册、v3 用户管理、Trap 上报、IP 白名单命令示例
CSDN 标签:SNMP Agent、SNMP 设备端、MIB、SNMPv3、Trap、嵌入式、XXLSNMP
一、Agent CLI 能干什么
Agent Demo(xxl_snmp_agent_demo.c)通过 snmp_agent_api.h 把设备端能力封装成 CLI:
| 分类 | 命令 | 对应 API | 作用 |
|---|---|---|---|
| 运行状态 | status / stop / start | agent_snmp_get_state / stop / start | 查询状态、临时停/启 |
| 共同体 | comm | agent_snmp_get_community | 查读写共同体 |
| v3 | engineid / seteng [hex] | get/set_engine_id | 查/动态设引擎 ID |
| v3 用户 | usercnt / userget / deladmin | agent_snmp_v3_* | 用户统计/查询/删除 |
| MIB | mibcnt / mibdel [oid] / refresh | mib_get_count / unregister / refresh | 查/删/刷新节点 |
| 告警 | trap [ip] / inform [ip] | trap_custom / inform_custom | 手动单发 |
| 白名单 | wladd/wldel/wlclear/wlcnt | whitelist_add/remove/clear/count | NMS IP 访问控制 |
| 日志 | log0~log3 | set_log_level | DEBUG/INFO/WARN/ERROR |
二、温度告警自动上报规则
Demo 内置温度分级告警:
- > 80℃:自动发 Trap(普通告警)
- > 85℃:自动发 Inform(严重告警,等 NMS 确认)
- 与上次温差 ≥ 2℃ 才上报,避免抖动
自动上报默认关闭,用 trapauto 1 / informauto 1 开启。业务 APP 也可以直接调 agent_snmp_trap_custom() / agent_snmp_inform_custom() 主动上报。
三、seteng 动态改引擎 ID
seteng 通过 agent_snmp_set_engine_id() 动态改 v3 引擎 ID(十六进制字符串)。改完 SDK 自动为所有 v3 用户重新派生密钥(基于新引擎 ID),不用重启 Agent,适合设备序列号、部署批次变更场景。
四、IP 白名单加固内网
wladd a.b.c.d 加允许访问的 NMS IP,白名单之外的请求直接拒绝。适合内网安全加固。最多 8 条。
五、Agent 主循环结构
agent_snmp_init(&cfg); // 初始化:共同体/引擎ID/端口
agent_snmp_mib_register(...); // 注册业务 OID + 读写回调
agent_snmp_start(); // 启动 UDP 监听
while (running) {
agent_snmp_loop(); // 裸机 10ms 轮询;多线程 OS 自动调度
// 温度采集:>80 Trap,>85 Inform
}
agent_snmp_stop();
agent_snmp_deinit(); // 有序释放全部资源
XXLSNMP 是芯祥联科技自研的国产 SNMP 协议栈 SDK,Agent SDK 原生支持 STM32/RISC-V/RTOS:
- SNMP 产品页:xxltech.cn/promo/snmp-…
- SNMP 下载中心:xxltech.cn/promo/snmp-…
- 合作邮箱:hezuo@xxltech.cn