SNMP Agent 命令行实战:设备端怎么暴露 MIB、发 Trap、配白名单

0 阅读2分钟

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 / startagent_snmp_get_state / stop / start查询状态、临时停/启
共同体commagent_snmp_get_community查读写共同体
v3engineid / seteng [hex]get/set_engine_id查/动态设引擎 ID
v3 用户usercnt / userget / deladminagent_snmp_v3_*用户统计/查询/删除
MIBmibcnt / mibdel [oid] / refreshmib_get_count / unregister / refresh查/删/刷新节点
告警trap [ip] / inform [ip]trap_custom / inform_custom手动单发
白名单wladd/wldel/wlclear/wlcntwhitelist_add/remove/clear/countNMS IP 访问控制
日志log0~log3set_log_levelDEBUG/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: