net-snmp 使用说明：从 snmpwalk 到 snmpset 的实战指南

简介这份资源是面向网络运维人员与Linux系统管理员的Net-SNMP使用说明文档针对SNMP代理配置与设备信息查询这一常见需求帮助读者快速掌握snmpd进程运行及管理工具查询的基本方法。压缩包内共1个docx文件约29KB以图文与命令示例结合的方式组织内容便于边看边练。文档围绕snmpwalk等常用查询命令展开给出完整命令格式与参数含义并以.1.3.6.1.2.1.1这一OID为例演示如何获取sysDescr、sysObjectID、sysUpTimeInstance等系统信息同时说明-v2c版本、-c community及代理地址等选项的用法还提及snmpget、snmpset等扩展命令帮助读者建立从环境准备到结果解读的完整认知。目前已有1071人学习适合需要排查网络设备状态或入门SNMP监控的读者参考。1. net-snmp 使用说明从 snmpwalk 到 snmpset 的落地路径机房半夜告警一台交换机 CPU 飙到 90%你手头没有图形化网管只有一台跳板机和一条 SSH 会话。这时候能救场的往往就是 net-snmp 这套命令行工具。它把 SNMP 协议封装成 snmpget、snmpwalk、snmpset、snmptranslate 等几条命令让你直接跟设备上的 OID 对话取指标、改配置、做巡检脚本都靠它。这篇 net-snmp 使用说明面向的是需要真刀真枪采集设备数据的运维和开发从装包、选版本、跑通第一条 snmpwalk到批量采集、写回参数、排查超时和乱码我会把参数怎么设、坑在哪讲清楚。读完你应该能独立搭起一套基于 net-snmp 的采集链路而不是只会复制一条命令。2. 装好 net-snmp 并跑通第一条 snmpwalk2.1 选包与安装不同发行版装的东西不一样net-snmp 在 Linux 上通常拆成几个包主程序、MIB 文件、Perl/Python 绑定。很多人装完发现 snmpwalk 能用但 snmptranslate 报找不到 MIB就是漏装了 MIB 包。常见做法是按发行版分别处理。Debian/Ubuntu 系# 主程序 MIB 文件 开发头文件一次装齐 apt-get update apt-get install -y snmp snmp-mibs-downloader libsnmp-devRHEL/CentOS/Rocky 系# net-snmp-utils 提供 snmpwalk/snmpget 等命令 yum install -y net-snmp net-snmp-utils net-snmp-libs装完后先确认版本和命令是否齐全snmpwalk --version snmptranslate --version逻辑说明snmp或net-snmp是守护进程包snmp-mibs-downloader/net-snmp-utils才是命令行工具来源。参数上没什么可调的关键是别只装守护进程包就以为有 snmpwalk。如果snmptranslate提示找不到模块检查/usr/share/snmp/mibs是否存在Debian 系还要在/etc/snmp/snmp.conf里把mibs :这行的注释去掉否则默认不加载任何 MIB。2.2 版本选择v2c 和 v3 的取舍SNMP 有三个常用版本v1、v2c、v3。v1 功能弱、64 位计数器支持差基本不用v2c 用 community 字符串认证配置简单内网采集首选v3 支持用户认证和加密适合跨不可信网络或合规要求高的场景。选型上我的习惯是内网设备巡检用 v2c跨机房或对外暴露的采集链路一律 v3。v2c 的调用形式# -v 2c 指定版本-c 指定 community最后是目标 IP 和 OID snmpwalk -v 2c -c public 192.168.1.1 1.3.6.1.2.1.1v3 的调用形式# -u 用户名-l 安全级别-a 认证算法-A 认证密码 snmpwalk -v 3 -u monitor -l authPriv -a SHA -A AuthPass123 \ -x AES -X PrivPass123 192.168.1.1 1.3.6.1.2.1.1参数说明-l有 noAuthNoPriv、authNoPriv、authPriv 三档authPriv 才是认证加加密-a/-A管认证-x/-X管加密。注意密码里如果有特殊字符要加引号否则 shell 会先吃掉。v3 配置繁琐但值得v2c 的 community 明文传输等于把口令写在明信片上。2.3 第一条 snmpwalk从系统组开始拿到设备先别急着 walk 全表从1.3.6.1.2.1.1system 组开始最稳它包含设备名、描述、运行时间、联系人、位置能快速确认连通性和权限。# 只取 system 子树-On 让输出用数字 OID避免 MIB 缺失导致报错 snmpwalk -v 2c -c public -On 192.168.1.1 1.3.6.1.2.1.1如果返回一串iso.3.6.1.2.1.1.1.0 STRING: ...说明通了。-On的作用是把符号名强制转成数字 OID排查阶段特别有用因为很多设备厂商的私有 MIB 没导入符号解析会失败。想反过来把数字 OID 翻译成名字用 snmptranslate# 把数字 OID 翻译成可读名称 snmptranslate -On 1.3.6.1.2.1.1.5.0 # 反向从名字查 OID snmptranslate -IR sysName逻辑说明-IR表示允许模糊匹配名称sysName会被解析成1.3.6.1.2.1.1.5。这一步是后面写采集脚本的基础你得先知道要采的指标对应哪个 OID才能用 snmpget 精确取值。3. snmpget、snmpwalk、snmpset 的实战用法3.1 snmpget 精确取值与批量采集snmpwalk 适合摸清设备有哪些 OID日常采集用 snmpget 更高效因为它只取指定 OID不遍历整棵子树。# 一次取多个 OID用空格分隔 snmpget -v 2c -c public 192.168.1.1 \ 1.3.6.1.2.1.1.3.0 \ 1.3.6.1.2.1.1.5.0 \ 1.3.6.1.2.1.2.2.1.10.1参数说明OID 末尾的.0表示标量对象的实例漏掉.0会报No Such Instance这是新手最常见的翻车点。1.3.6.1.2.1.2.2.1.10.1是接口 1 的入流量计数器末尾的1是接口索引不是.0因为接口表是表格对象。标量加.0、表格加索引这条规则记牢能省一半排查时间。批量采集时把 OID 写进文件配合 shell 循环#!/bin/bash # 从 oids.txt 逐行读取 OID 并取值 HOST192.168.1.1 COMMUNITYpublic while read -r oid; do # 跳过空行和注释 [[ -z $oid || $oid \#* ]] continue snmpget -v 2c -c $COMMUNITY -Oqv $HOST $oid done oids.txt逻辑说明-Oqv是输出控制组合-Oq去掉 OID 前缀只留值-Ov只输出值本身适合喂给监控系统。参数上要注意-Oqv和-On的区别前者管输出格式后者管 OID 显示方式别混用。3.2 snmpset 写回参数与类型匹配snmpset 用来修改设备上的可写 OID比如改接口描述、关端口、设系统位置。它的语法比 get 多一个类型和值。# 修改系统位置类型是字符串 s snmpset -v 2c -c private 192.168.1.1 \ 1.3.6.1.2.1.1.6.0 s Beijing-IDC-Rack12 # 关闭接口 1类型是整数 i值 2 表示 down snmpset -v 2c -c private 192.168.1.1 \ 1.3.6.1.2.1.2.2.1.7.1 i 2参数说明类型字符必须和 OID 定义一致常见的有i整数、s字符串、aIP 地址、x十六进制、d十进制字符串。类型写错会返回Bad value或Wrong type。写操作要用有写权限的 community很多设备读用 public、写用 private别拿读的口令去 set。另外接口 up/down 的值1 是 up2 是 down3 是 testing这个映射记错会把端口关成奇怪状态。3.3 snmptranslate 与 MIB 加载snmptranslate 是排查 OID 的利器但它的效果完全取决于 MIB 是否加载正确。# 指定 MIB 目录并加载全部 MIB export MIBDIRS/usr/share/snmp/mibs export MIBSALL snmptranslate -Td 1.3.6.1.2.1.2.2.1.10-Td会输出该 OID 的详细定义包括类型、描述、父节点。如果只想看 OID 树结构用-Tp# 打印以该 OID 为根的子树 snmptranslate -Tp 1.3.6.1.2.1.2逻辑说明MIBSALL会加载 MIBDIRS 下所有文件启动稍慢但省心生产脚本里建议只加载需要的 MIB减少解析开销。厂商私有 MIB 要手动放到 MIBDIRS 目录文件名大小写敏感放错位置 snmptranslate 就找不到。4. 避坑与排查net-snmp 最常见的五类翻车4.1 超时Timeout: No Response from 目标现象命令卡几秒后报Timeout: No Response from 192.168.1.1。原因三种可能——设备没开 SNMP、community 不对、防火墙挡了 UDP 161。也可能是设备 ACL 只允许特定源 IP。解决先用snmpget取 system 组确认基本连通换-c试常见 community在设备侧确认 SNMP 已启用且 ACL 放行你的源 IP。排查网络层用nc -u -v 192.168.1.1 161看 UDP 是否可达。如果设备响应慢加-t 5 -r 2把超时调到 5 秒、重试 2 次。4.2 No Such ObjectOID 不存在现象No Such Object available on this agent at this OID。原因OID 写错、设备不支持该 MIB、或者标量漏了.0。解决先用 snmpwalk 从父节点往下走确认设备实际暴露了哪些子节点。标量对象一定带.0表格对象带索引。厂商私有 OID 要对照该型号的 MIB 文档别拿别的型号的 OID 硬套。4.3 中文乱码STRING 显示成问号或十六进制现象接口描述里的中文显示为??或0x...。原因net-snmp 默认按 ASCII 解析 OCTET STRING中文是 UTF-8 多字节解析就乱。解决加-Oe或-Ox控制输出编码或者用-Oqv拿到原始值后在脚本里按 UTF-8 解码。Python 里用 pysnmp 或 subprocess 调 net-snmp 时注意把输出按 bytes 处理再 decode(utf-8)别直接当 str。4.4 v3 认证失败Authentication failure现象v3 命令报Authentication failure (incorrect password, community or key)。原因用户名、认证算法、认证密码、加密算法、加密密码五者任一不匹配或者设备只支持 authNoPriv 而你用了 authPriv。解决逐项核对-u -a -A -x -X先用-l authNoPriv只测认证通了再加加密。注意算法名大小写SHA 和 sha 在部分版本里不等价。密码里的特殊字符要转义。4.5 采集脚本性能差walk 全表拖垮设备现象脚本跑一次要几分钟设备 CPU 升高。原因snmpwalk 默认逐条 GETNEXTOID 多时请求次数爆炸。解决用snmpbulkwalk替代 snmpwalk它用 GETBULK 一次取多条。参数-Cr控制每次请求的重复数一般设 10 到 25# 用 bulkwalk 加速-Cr 20 表示每次取 20 条 snmpbulkwalk -v 2c -c public -Cr 20 192.168.1.1 1.3.6.1.2.1.2注意-Cr不是越大越好太大有些老设备会丢包或截断从 10 开始试稳定了再往上加。5. 把 net-snmp 接进监控链路的一个具体技巧单条命令跑通只是起点真正省事的是把 net-snmp 输出直接喂给监控系统。我常用的做法是用 snmpbulkwalk 采接口流量配合 shell 算出速率再推给时序库。下面这段脚本把接口入流量计数器转成 bps逻辑是两次采样求差再除以时间间隔。#!/bin/bash # 采集接口 1 的入流量输出 bps HOST192.168.1.1 COMMpublic OID1.3.6.1.2.1.2.2.1.10.1 # ifInOctets.1 # 第一次采样 v1$(snmpget -v 2c -c $COMM -Oqv $HOST $OID) sleep 10 # 第二次采样 v2$(snmpget -v 2c -c $COMM -Oqv $HOST $OID) # 计数器回绕保护v2 小于 v1 说明 32 位计数器翻转了 if [ $v2 -lt $v1 ]; then diff$((4294967295 - v1 v2)) else diff$((v2 - v1)) fi # 字节转比特再除以间隔秒数 bps$((diff * 8 / 10)) echo ifInOctets.1 ${bps} bps逻辑说明-Oqv保证只拿到纯数字方便算术。32 位计数器最大 4294967295高速接口几十秒就可能翻转回绕判断不能省。参数上sleep 10是采样间隔间隔越短精度越高但对设备压力越大一般 10 到 60 秒。如果设备支持 64 位计数器ifHCInOctetsOID 是1.3.6.1.2.1.31.1.1.1.6优先用它基本不会回绕脚本里那段保护逻辑就可以去掉。验证方法手动跑两次 snmpget 对比数值是否递增再用iftop或设备自带流量统计交叉验证 bps 是否合理。如果数值明显偏大或偏小先检查 OID 是不是取错了接口索引接口索引和 ifIndex 不一定等于端口号用snmpwalk ... 1.3.6.1.2.1.2.2.1.2查 ifDescr 对照。我踩过最深的一个坑是拿 32 位计数器做长周期统计结果每到流量高峰就出现负值查了半天才反应过来是计数器翻转。从那以后我的习惯是只要设备支持 64 位计数器一律用 HC 版本省掉回绕判断这块后悔药。希望帮到你。本文还有配套的精品资源点击获取