Docker环境下snmpd代理加载自定义MIB失败，求排查方案

问题背景 #

我在Docker中使用polinux/snmpd:alpine镜像运行snmpd，想加载一个包含多种数据类型OID的自定义测试MIB文件。该MIB已通过两个在线工具验证无语法错误，但无论是snmpwalk还是snmptranslate都无法识别对应的OID和模块。我已经尝试过：

• 向snmpd传递-m <mib文件>和/或-M <mib目录>参数，无效；
• 在snmpd.conf中添加配置：

mibdirs +/etc/snmpd/
mibs +ALL

同样无效。

自定义MIB内容如下：

MY-MIB DEFINITIONS ::= BEGIN

IMPORTS
    MODULE-IDENTITY,
    OBJECT-TYPE,
    Counter32,
    Counter64,
    Gauge32,
    TimeTicks,
    IpAddress
        FROM SNMPv2-SMI
        DisplayString, TimeStamp
        FROM SNMPv2-TC
        OBJECT-GROUP
        FROM SNMPv2-CONF;

myMIB MODULE-IDENTITY
    LAST-UPDATED "202310110000Z"
    ORGANIZATION "My Organization"
    CONTACT-INFO "contact@example.com"
    DESCRIPTION "Example Custom MIB"
    REVISION "202310110000Z"
    DESCRIPTION "Initial revision"
    ::= { iso(1) identified-organization(3) dod(6) internet(1) private(4) enterprises(1) 9999 }
    
myObjects OBJECT IDENTIFIER ::= { myMIB 1 }
    
myObjectGroup OBJECT-GROUP
    OBJECTS { myBits,
              myCounter32,
              myCounter64,
              myGauge,
              myInteger,
              myIpAddress,
              myOctetString,
              myString,
              myTimeTicks }
    STATUS current
    DESCRIPTION
        "A group of my objects."
    ::= { myMIB 2 }

myString OBJECT-TYPE
    SYNTAX      DisplayString
    MAX-ACCESS  read-write
    STATUS      current
    DESCRIPTION "Example scalar object"
    DEFVAL { "example" }
    ::= { myObjects 1 }


myInteger OBJECT-TYPE
    SYNTAX      INTEGER
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION "Example integer object"
    DEFVAL { 1 }
    ::= { myObjects 2 }


myCounter32 OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION "Example counter object"
    ::= { myObjects 3 }


myCounter64 OBJECT-TYPE
    SYNTAX      Counter64
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION "Example counter object"
    ::= { myObjects 4 }


myGauge OBJECT-TYPE
    SYNTAX      Gauge32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION "Example gauge object"
    DEFVAL { 1 }
    ::= { myObjects 5 }


myTimeTicks OBJECT-TYPE
    SYNTAX      TimeTicks
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION "Example timeticks object"
    DEFVAL { 1 }
    ::= { myObjects 6 }


myIpAddress OBJECT-TYPE
    SYNTAX IpAddress
    MAX-ACCESS read-write
    STATUS current
    DESCRIPTION "My IPADDRESS object"
    DEFVAL { 'c0210415'H } -- 192.33.4.21
    ::= { myObjects 7 }


myOctetString OBJECT-TYPE
    SYNTAX OCTET STRING (SIZE(0..255))
    MAX-ACCESS read-write
    STATUS current
    DESCRIPTION "My OCTET STRING object"
    DEFVAL { "255" }
    ::= { myObjects 8 }


myBits OBJECT-TYPE
    SYNTAX BITS {
                bit1(0),
                bit2(1),
                bit3(2)
            }
    MAX-ACCESS read-write
    STATUS current
    DESCRIPTION "My BITS object"
    DEFVAL { { bit1 } }
    ::= { myObjects 9 }


END

可能的原因与解决步骤 #

1. MIB文件的命名与路径问题 #

• Alpine镜像中snmp默认MIB目录为/usr/share/snmp/mibs/，而非你配置的/etc/snmpd/。需将MIB文件放置在正确目录，比如/usr/share/snmp/mibs/MY-MIB.txt（文件名要与MIB模块名一致，后缀用.txt或.mib均可）。
• 若使用自定义目录，需确保容器启动时该目录已挂载，且snmpd进程有读取权限。

2. 核心问题：仅定义MIB结构不足以被snmpd响应 #

你的MIB只是定义了OID的结构，但snmpd不会自动为这些OID实例化值。必须在snmpd.conf中为每个自定义OID配置实际的数据源或固定值，否则snmpd不会处理这些OID的查询请求。

比如，为你的自定义OID添加如下配置（写入snmpd.conf）：

# 用OID直接配置固定值
myString .1.3.6.1.4.1.9999.1.1 s "custom-example"
myInteger .1.3.6.1.4.1.9999.1.2 i 42
myCounter32 .1.3.6.1.4.1.9999.1.3 C 0
myCounter64 .1.3.6.1.4.1.9999.1.4 C 0
myGauge .1.3.6.1.4.1.9999.1.5 G 100
myTimeTicks .1.3.6.1.4.1.9999.1.6 T 12345
myIpAddress .1.3.6.1.4.1.9999.1.7 a 192.168.1.100
myOctetString .1.3.6.1.4.1.9999.1.8 x "FF"
myBits .1.3.6.1.4.1.9999.1.9 b 0x01

如果MIB已正确加载，也可以用模块名简化配置：

myString MY-MIB::myString s "custom-example"
myInteger MY-MIB::myInteger i 42

3. 容器启动参数配置 #

启动容器时，需确保传递正确的MIB加载参数，示例命令如下：

docker run -d \
  -v /本地路径/MY-MIB.txt:/usr/share/snmp/mibs/MY-MIB.txt \
  -v /本地路径/snmpd.conf:/etc/snmp/snmpd.conf \
  polinux/snmpd:alpine \
  snmpd -f -Lo -m +MY-MIB -M /usr/share/snmp/mibs/

其中：

• -f让snmpd前台运行，方便查看日志；
• -Lo将日志输出到stdout；
• -m +MY-MIB指定加载自定义MIB；
• -M指定MIB文件所在目录。

4. 验证MIB加载状态 #

进入容器内部，执行以下命令确认MIB是否被识别：

# 检查snmptranslate能否解析MIB模块
snmptranslate -m +MY-MIB -IR MY-MIB::myString

# 查看snmpd加载的MIB列表
snmpd -Dmib_init -H 2>&1 | grep MY-MIB

如果snmptranslate能返回对应OID，说明MIB已被客户端工具识别；如果snmpd的调试日志中出现MY-MIB，说明服务端已加载该MIB。

5. 权限检查 #

确保挂载到容器内的MIB文件和配置文件权限正确，snmpd进程（通常以snmp用户运行）有读取权限。可在容器内执行以下命令调整权限：

chown snmp:snmp /usr/share/snmp/mibs/MY-MIB.txt /etc/snmp/snmpd.conf

总结 #

核心问题是你仅定义了MIB的结构，但未在snmpd中为OID配置实际的实例值，导致snmpd不会响应这些OID的查询。同时需确保MIB文件的路径、命名、权限以及容器启动参数配置正确，才能让snmpd正确加载并处理自定义MIB的请求。

内容的提问来源于stack exchange，提问作者Egor Baranov