SNMP 转发协议设计文档

一、协议定位与目标

1.1 核心定位

本协议旨在实现SNMP 协议与其他工业协议（如 Modbus、MQTT、OPC UA）的数据转发与转换，解决异构网络设备的协议互通问题。通过标准化的数据转发流程，将传统 SNMP 设备（如路由器、交换机）的数据转换为目标协议格式，支持边缘计算节点与云端平台的无缝对接。

1.2 技术目标

多协议适配：支持 SNMPv1/v2c/v3 与 Modbus RTU/TCP、MQTT 等协议的双向转换；
数据映射灵活：通过配置文件或 API 动态定义 SNMP OID 与目标协议地址的映射规则；
实时性保障：数据转发延迟控制在 100ms 以内（局域网环境）；
安全可靠：支持 SNMPv3 安全认证、数据加密传输与边缘节点故障容错。

二、协议栈架构设计

2.1 分层协议模型

2.1.1 SNMP 协议层

功能：解析 SNMP 请求（Get/Set/Trap），提取 OID 与数据值；
协议支持：
- SNMPv1/v2c：基于团体名的简单认证；
- SNMPv3：USM 安全模型（支持 SHA/AES 加密）。

2.1.2 目标协议层

功能：封装目标协议（如 Modbus、MQTT）的请求与响应；
协议插件机制：
- 定义统一接口ProtocolAdapter，包含Connect、Read、Write方法；

2.1.3 协议转换层

OID 映射引擎：
- 维护 SNMP OID 与目标协议地址的映射表（如1.3.6.1.4.1.24027.1.1.1.1.4.1.57.0 → Modbus 3902寄存器）；
- 支持批量映射规则导入（JSON/Excel 格式）。
数据格式转换器：
- 类型转换：SNMP Integer → Modbus Float、OctetString → MQTT String；
- 协议 PDU 转换：SNMP PDU → Modbus ADU、SNMP Trap → MQTT Message。

三、数据转发流程设计

3.1 SNMP 到 Modbus 转发流程

3.1.1 读取操作（SNMP Get → Modbus Read）

3.1.2 关键代码逻辑

go 复制代码

// SNMP Get处理函数
func handleSNMPGet(oid string) (interface{}, error) {
    // 查询映射表
    mapping, exists := oidMapper.GetMapping(oid)
    if !exists {
        return nil, fmt.Errorf("OID not mapped: %s", oid)
    }

    // 调用目标协议插件读取数据
    adapter := protocolManager.GetAdapter(mapping.Protocol)
    value, err := adapter.Read(mapping.TargetAddress)
    if err != nil {
        return nil, err
    }

    // 转换为SNMP数据类型
    return convertToSNMPType(value, mapping.SNMPType), nil
}

3.2 Modbus 到 SNMP 转发流程

3.2.1 写入操作（Modbus Write → SNMP Set）

四、协议配置与管理

4.1 插件系统实现

4.1.1 插件接口定义

go 复制代码

// ProtocolAdapter 定义协议适配器接口
type ProtocolAdapter interface {
    Connect(config map[string]interface{}) error
    Read(address string) (interface{}, error)
    Write(address string, value interface{}) error
    Close() error
}

// 插件注册函数签名
type RegisterFunc func() ProtocolAdapter

4.1.2 插件加载机制（编译时依赖）

go 复制代码

// plugins/modbus_adapter.go
package modbus_adapter

import "github.com/goburrow/modbus"

type ModbusAdapter struct {
    client modbus.Client
}

func (m *ModbusAdapter) Connect(config map[string]interface{}) error {
    // 实现Modbus连接逻辑
    host, ok := config["host"].(string)
    if !ok {
        return errors.New("missing host configuration")
    }
    m.client = modbus.TCPClient(host)
    return nil
}

// 实现Read、Write、Close方法...

// 注册函数
func Register() ProtocolAdapter {
    return &ModbusAdapter{}
}

4.1.3 插件管理（静态加载）

go 复制代码

// plugin_manager.go
var adapters = make(map[string]func() ProtocolAdapter)

func RegisterAdapter(name string, factory func() ProtocolAdapter) {
    adapters[name] = factory
}

func GetAdapter(name string) ProtocolAdapter {
    factory, exists := adapters[name]
    if !exists {
        return nil
    }
    return factory()
}

// 初始化内置插件
func init() {
    RegisterAdapter("modbus", modbus_adapter.Register)
    RegisterAdapter("mqtt", mqtt_adapter.Register)
}

五、协议安全设计

5.1 认证与加密

SNMPv3 安全认证：

支持 USM 用户认证（用户名 + 密码 + 加密算法）；

配置示例：

css 复制代码

usmUser := gosnmp.UsmSecurityParameters{
    UserName:                 "admin",
    AuthenticationProtocol:   gosnmp.SHA,
    PrivacyProtocol:          gosnmp.AES,
    AuthenticationPassphrase: "secure_auth",
    PrivacyPassphrase:        "secure_priv",
}

传输层加密：
- 支持 TLS/SSL（如 SNMP over TLS、MQTT over SSL）；
- 边缘节点与云端通信使用双向证书认证。

5.2 访问控制

白名单机制：仅限预注册的 IP 地址或设备 MAC 地址访问 SNMP 服务；
权限分级：区分读权限（Read-Only）与写权限（Read-Write）用户。

六、性能优化策略

6.1 数据缓存

缓存策略：
- 使用sync.Map缓存热点 OID 映射规则与 Modbus 寄存器值；
- 缓存过期时间配置：热点数据默认缓存 30 秒，冷数据默认缓存 5 分钟。

示例代码：

go 复制代码

var cache = struct {
    sync.RWMutex
    items map[string]cacheItem
}{items: make(map[string]cacheItem)}

type cacheItem struct {
    value      interface{}
    expireTime time.Time
}

func getFromCache(oid string) (interface{}, bool) {
    cache.RLock()
    item, exists := cache.items[oid]
    cache.RUnlock()
    if !exists || time.Now().After(item.expireTime) {
        return nil, false
    }
    return item.value, true
}

6.2 批量操作

SNMP 批量请求 ：使用GetBulk一次性获取多个 OID 值，减少网络交互次数；
Modbus 批量读写：支持一次操作多个寄存器（如 Modbus 批量写入 100 个寄存器）。