netsampler/goflow2

GoFlow2 Docker镜像文档

镜像概述与主要用途

GoFlow2 是一个基于 Go 语言开发的高性能网络流数据收集器，支持 NetFlow、IPFIX 及 sFlow 协议。其核心功能是从网络设备（如路由器、交换机）收集流量信息（包括 IP 地址、网络接口、路由路径等），并将多协议数据统一序列化为通用格式，为网络监控、流量分析、安全审计等场景提供标准化数据输入。

核心功能与特性

• 多协议支持：兼容 NetFlow V9、IPFIX 及 sFlow 等主流网络流协议，覆盖大多数网络设备的流量数据输出需求。
• 高性能处理：基于 Go 语言的并发特性，可高效处理大规模网络流量数据，适用于高带宽环境。
• 数据标准化：将不同协议的原始流量数据统一序列化为通用格式，简化下游分析、存储或可视化流程。
• 轻量级部署：通过 Docker 容器化封装，支持快速部署与扩展，降低环境依赖复杂度。

使用场景与适用范围

• 企业网络监控：实时收集内部网络流量数据，监控带宽使用、异常流量及设备性能。
• 数据中心流量分析：跟踪数据中心内服务器、交换机间的流量分布，优化资源调度。
• 网络安全审计：捕获异常连接（如端口扫描、DDoS 流量），为安全事件溯源提供数据支持。
• ISP/运营商网络管理：监控用户流量特征，辅助流量计费、QoS 保障及网络规划。

使用方法与配置说明

基本运行命令

通过 Docker 快速启动 GoFlow2，默认监听 sFlow（6343/udp）和 NetFlow/IPFIX（2055/udp）端口，并在终端输出 JSON 格式的流量样本：

bash
sudo docker run -p 6343:6343/udp -p 2055:2055/udp -ti netsampler/goflow2:latest

参数说明：

• -p 6343:6343/udp：映射容器内 sFlow 默认端口（6343/udp）到主机，接收 sFlow 流量。
• -p 2055:2055/udp：映射容器内 NetFlow/IPFIX 默认端口（2055/udp）到主机，接收 NetFlow V9/IPFIX 流量。
• -ti：以交互模式运行容器，并分配终端，便于实时查看输出日志。

高级配置

GoFlow2 支持通过命令行参数或环境变量自定义配置（如输出格式、目标地址、协议参数等）。更多配置参数可参考 https://github.com/netsampler/goflow2%E3%80%82

Docker Compose 部署示例

官方仓库的 https://github.com/netsampler/goflow2/tree/main/compose 提供了多种场景的部署示例。以下为基础示例（docker-compose.yml）：

yaml
version: '3'
services:
  goflow2:
    image: netsampler/goflow2:latest
    ports:
      - "6343:6343/udp"  # sFlow 端口
      - "2055:2055/udp"  # NetFlow/IPFIX 端口
    restart: unless-stopped
    # 可添加环境变量或命令行参数自定义配置，例如：
    # command: --format=json --target=kafka:9092

启动命令：

bash
docker-compose up -d

注意事项

• 端口映射：根据实际网络设备的流数据输出端口调整 -p 参数，确保容器能接收目标流量。
• 性能调优：高流量场景下，可通过调整容器 CPU/内存资源限制（如 --cpus、--memory）优化性能。
• 数据持久化：如需将流量数据持久化存储，可通过 -v 参数挂载主机目录，或配置输出至 Kafka、数据库等外部存储（参考官方文档）。

参考链接

• 官方仓库：https://github.com/netsampler/goflow2
• Docker Compose 示例：https://github.com/netsampler/goflow2/tree/main/compose