tonimoreno/snmpcollector

snmpcollector Docker镜像文档

镜像概述

snmpcollector是一个通用的SNMP数据收集工具，提供完整的Web管理界面，专门用于从网络设备、服务器及IoT设备收集SNMP数据，并将其存储到InfluxDB数据库中。该镜像集成了数据采集、配置管理和可视化功能，简化了网络监控系统的部署流程。

核心功能和特性

• 多设备支持：可同时监控多个网络设备，支持SNMPv1、SNMPv2c和SNMPv3协议
• 自定义OID采集：允许用户配置特定的SNMP OID进行数据采集，满足个性化监控需求
• 数据处理能力：支持数据聚合、转换和过滤，确保存储到InfluxDB的数据准确性
• Web管理界面：提供直观的Web UI，用于配置设备、采集规则和查看采集状态
• 灵活配置：支持通过配置文件或环境变量进行参数设置，便于容器化部署
• 日志记录：详细记录采集过程和错误信息，便于问题排查

使用场景和适用范围

• 网络设备监控：监控交换机、路由器、防火墙等网络设备的性能指标（如带宽、端口状态、CPU使用率）
• 服务器监控：收集服务器的硬件状态（如温度、风扇转速）和系统指标
• IoT设备数据采集：从支持SNMP的IoT设备中收集传感器数据
• 企业级监控系统：作为InfluxDB生态的一部分，构建完整的网络监控解决方案

使用方法

基本部署（docker run）

bash
docker run -d \
  --name snmpcollector \
  -p 8080:8080 \
  -e INFLUXDB_URL=http://influxdb:8086 \
  -e INFLUXDB_DB=snmp_data \
  -e WEB_LISTEN_ADDR=0.0.0.0:8080 \
  -v /path/to/config:/app/config \
  toni-moreno/snmpcollector

Docker Compose配置

yaml
version: '3'
services:
  snmpcollector:
    image: toni-moreno/snmpcollector
    container_name: snmpcollector
    ports:
      - "8080:8080"
    environment:
      - INFLUXDB_URL=http://influxdb:8086
      - INFLUXDB_USER=admin
      - INFLUXDB_PASSWORD=secret
      - INFLUXDB_DB=snmp_data
      - WEB_LISTEN_ADDR=0.0.0.0:8080
    volumes:
      - ./config:/app/config
    depends_on:
      - influxdb

  influxdb:
    image: influxdb:1.8
    container_name: influxdb
    ports:
      - "8086:8086"
    environment:
      - INFLUXDB_DB=snmp_data
      - INFLUXDB_ADMIN_USER=admin
      - INFLUXDB_ADMIN_PASSWORD=secret
    volumes:
      - influxdb_data:/var/lib/influxdb

volumes:
  influxdb_data:

访问Web界面

部署完成后，通过浏览器访问 http://<容器IP>:8080 即可打开Web管理界面，默认用户名/密码为 admin/admin（首次登录需修改密码）。

配置参数说明

环境变量

数据卷挂载

• /app/config：配置文件目录，包含设备配置、采集规则等，建议挂载本地目录以持久化配置

注意事项

• 确保InfluxDB服务已提前部署并可被snmpcollector容器访问
• 首次使用需通过Web界面添加SNMP设备并配置OID采集规则
• 对于SNMPv3设备，需在Web界面中正确配置认证参数（用户名、认证协议、加密协议等）
• 高并发场景下建议调整容器资源限制（CPU/内存）以确保采集性能