snmpset 是 SNMP (Simple Network Management Protocol) 工具包中的一个核心命令，用于向网络设备（如路由器、交换机、服务器、打印机等）的 SNMP 代理发送一个 SET 请求，SET 请求的作用是 修改或设置 设备上 MIB (Management Information Base) 对象的值。
如果你想让一个支持 SNMP 的设备执行某个操作或改变某个配置状态，snmpset 就是你要使用的工具。
基本语法
snmpset 命令的基本语法结构如下：
snmpset [选项] <SNMP版本> <目标设备> <共同体字符串> <OID> <数据类型> <新值>
参数详解
让我们逐一解析每个部分：
选项
常用的选项包括：
-v <version>: 指定 SNMP 版本，通常是1,2c或3，这是必选的。-c <community>: 指定 SNMP 共同体字符串，在 SNMPv1 和 SNMPv2c 中使用，用于认证，这是必选的（除非使用-u选项）。-u <user>: 指定 SNMPv3 的用户名。-l <level>: 指定 SNMPv3 的安全级别，常用值：noAuthNoPriv: 无认证,无加密。authNoPriv: 认证,无加密。authPriv: 认证,加密。
-a <authproto>: 指定认证协议，通常是MD5或SHA。-A <authpass>: 指定认证密码。-x <privproto>: 指定加密协议，通常是DES或AES。-X <privpass>: 指定加密密码。-Cw: 在写入值时，MIB 对象是只读的，snmpset默认会失败，此选项可以强制写入,但通常不建议使用。-C i: 忽略错误，继续尝试设置下一个 OID。-O n: 以纯数字形式显示 OID,而不是解析成可读的名称。
目标设备
指定你要设置配置的网络设备,可以是：
- 主机名:
myrouter.example.com - IP 地址:
168.1.1 - IPv6 地址:
[2001:db8::1]
共同体字符串
这是 SNMPv1/v2c 的“密码”，用于验证请求的合法性，通常分为 public（只读）和 private（读写），要执行 set 操作，必须使用具有写入权限的共同体字符串，private。
OID (Object Identifier)
这是要设置值的 MIB 对象的唯一标识符，一个常见的 OID 是 3.6.1.2.1.1.5.0，它代表系统的 sysName（主机名），你也可以使用 MIB 模块中定义的名称，如 SNMPv2-MIB::sysName.0。
数据类型
这是非常重要的部分，它告诉代理你要设置什么类型的值。snmpset 需要明确的数据类型来正确地转换和设置值。
| 数据类型 | 缩写 | 描述 | 示例 |
|---|---|---|---|
| Integer | i |
32位整数 | 42 |
| Octet String | s |
字符串（需要加引号） | "My New Hostname" |
| Object Identifier | o |
另一个 OID | 3.6.1.2.1.1.1.0 |
| IpAddress | a |
IPv4 地址 | 168.1.1 |
| Counter32 | u |
32位计数器（只增不减） | 12345 |
| Gauge32 | U |
32位 gauge（可增可减） | 100 |
| TimeTicks | t |
百分之一秒的时间 | 12345678 |
| Opaque | O |
任意数据 | <hex string> |
| Counter64 | I |
64位计数器 | 1234567890 |
新值
你希望设置的具体值,值的格式必须与前面指定的数据类型匹配。
实用示例
假设我们要管理一台 IP 地址为 168.1.254 的路由器，它使用 SNMPv2c，读写共同体字符串为 admin。
示例 1：设置系统主机名 (SNMPv2c)
这是一个非常常见的用例，我们要设置 SNMPv2-MIB::sysName.0 这个 OID。
# 设置主机名为 "Core-Switch-01" snmpset -v2c -c admin 192.168.1.254 SNMPv2-MIB::sysName.0 s "Core-Switch-01"
命令分解:
snmpset: 执行设置命令。-v2c: 使用 SNMP 版本 2c。-c admin: 使用共同体字符串admin进行认证。168.1.254: 目标路由器的 IP 地址。SNMPv2-MIB::sysName.0: 要设置的对象标识符（系统主机名）。s: 指定数据类型为 Octet String。"Core-Switch-01": 要设置的新主机名。
如果成功，命令会返回类似以下的输出，表示设置成功：
SNMPv2-MIB::sysName.0 = STRING: "Core-Switch-01"
示例 2：设置接口描述 (SNMPv2c)
假设我们要设置设备上第 2 个接口（ifIndex=2）的描述。
# 设置接口2的描述为 "Link to Server Room" snmpset -v2c -c admin 192.168.1.254 IF-MIB::ifDescr.2 s "Link to Server Room"
注意: IF-MIB::ifDescr.2 通常是只读的，你需要设置 IF-MIB::ifAlias.2，这个对象是专门用于设置接口别名的,并且通常是可写的。
# 正确的做法：设置接口别名 snmpset -v2c -c admin 192.168.1.254 IF-MIB::ifAlias.2 s "Link to Server Room"
示例 3：禁用一个接口 (SNMPv2c)
要启用或禁用接口，我们需要设置 IF-MIB::ifAdminStatus 这个 OID。
1表示up(启用)。2表示down(禁用)。
# 禁用接口2 snmpset -v2c -c admin 192.168.1.254 IF-MIB::ifAdminStatus.2 i 2
示例 4：使用 SNMPv3 进行安全设置
SNMPv3 提供了更强大的安全认证和加密功能，假设设备配置了一个名为 myuser 的 SNMPv3 用户，使用 SHA 认证和 AES 加密。
# 使用 SNMPv3 设置主机名 snmpset -v3 -u myuser -l authPriv -a SHA -A "my_auth_password" -x AES -X "my_enc_password" 192.168.1.254 SNMPv2-MIB::sysName.0 s "Secure-Switch-01"
命令分解:
-v 3: 使用 SNMP 版本 3。-u myuser: 用户名。-l authPriv: 安全级别为认证和加密。-a SHA: 认证协议为 SHA。-A "my_auth_password": 认证密码。-x AES: 加密协议为 AES。-X "my_enc_password": 加密密码。
重要注意事项和最佳实践
-
安全性:
- 绝对不要在生产环境中使用
public作为共同体字符串，尤其是在可写 (-c private) 的情况下,这会让任何人都可以轻松地修改你的设备配置。 - 优先使用 SNMPv3，它提供了基于用户名/密码的认证和可选的加密，比 SNMPv1/v2c 安全得多。
- 为 SNMPv3 创建专用的、权限受限的用户,不要使用管理员账户。
- 绝对不要在生产环境中使用
-
只读与可写:
- 并非所有的 MIB 对象都可以被修改，尝试设置一个只读的 OID 会导致错误，在执行
set操作前，最好先用snmpget确认 OID 是否存在及其当前值。
- 并非所有的 MIB 对象都可以被修改，尝试设置一个只读的 OID 会导致错误，在执行
-
权限:
- 执行
snmpset命令的用户（在 Linux/Unix 系统上）需要有执行snmpset二进制文件的权限，并且网络需要有权限访问目标设备的 SNMP UDP 端口（通常是 161）。
- 执行
-
MIB 文件:
snmpset无法将 OID 解析成可读的名称（如SNMPv2-MIB::sysName.0），你可能需要安装相应的 MIB 文件，并配置snmpset去加载它们，这通常通过MIBS环境变量或配置文件来完成。
-
测试环境:
- 在对生产设备进行任何配置更改之前，务必先在测试环境或实验室环境中验证你的
snmpset命令,错误的设置可能导致网络中断或服务中断。
- 在对生产设备进行任何配置更改之前，务必先在测试环境或实验室环境中验证你的
snmpset 是一个功能强大但需要谨慎使用的命令，它是自动化网络配置和监控的关键工具，掌握它的使用方法，特别是理解 SNMP 版本差异、共同体字符串、OID 和数据类型，对于网络管理员来说至关重要，始终将安全放在第一位，优先考虑使用 SNMPv3。
