cyberreboot/poseidon

Poseidon（软件定义网络态势感知工具）

https://img.shields.io/badge/License-Apache%202.0-blue.svg](https://opensource.org/licenses/Apache-2.0) https://travis-ci.org/CyberReboot/poseidon.svg?branch=master](https://travis-ci.org/CyberReboot/poseidon) https://img.shields.io/docker/pulls/cyberreboot/poseidon.svg](https://hub.docker.com/r/cyberreboot/poseidon/)

镜像概述

Poseidon由Cyber Reboot与Lab41联合开发，是一款基于软件定义网络(SDN)和机器学习的网络态势感知工具。它通过SDN控制器获取网络流量，利用机器学习模型分析流量特征，识别网络设备类型与行为，支持离线pcap文件分析，适用于网络监控、安全检测等场景。

核心功能

1. SDN集成：支持Faucet（≥v1.8.6）和Big Cloud Fabric(BCF)控制器，动态捕获网络流量。
2. 机器学习分析：提取流量特征并通过训练模型分类，识别设备角色与异常行为。
3. 多场景支持：既支持SDN环境的实时监控，也可通过pcap文件进行离线分析。
4. 可视化对接：兼容CRviz工具，直观展示网络拓扑与设备状态。

使用场景

• 企业网络监控：实时识别网络中的设备类型与流量模式。
• 安全分析：检测未授权设备或异常流量行为。
• 运维优化：辅助管理员理解网络结构，优化资源配置。

配置说明

前提条件

• Docker（支持Compose文件格式3）、Docker Compose。
• Curl、jq工具。
• 支持的SDN控制器（Faucet或BCF）。
• ≥10GB可用磁盘空间。

安装步骤

1. 下载Poseidon脚本：

   bash
   curl -L https://raw.githubusercontent.com/CyberReboot/poseidon/master/bin/poseidon -o /usr/local/bin/poseidon
   chmod +x /usr/local/bin/poseidon
   

2. 创建配置目录并复制配置文件：

   bash
   sudo mkdir /opt/poseidon
   sudo cp config/poseidon.config /opt/poseidon
   

3. 编辑/opt/poseidon/poseidon.config，设置关键参数：
   • controller_type：选择控制器类型（faucet/bcf）。
   • collector_nic：连接交换机镜像端口的网卡名称。
   • controller_mirror_ports：交换机镜像端口信息。

启动命令

• 同时启动Poseidon与Faucet：

  bash
  poseidon start
  

• 使用已有SDN控制器（BCF或自定义Faucet）：

  bash
  poseidon start --standalone
  

常用操作

bash
poseidon help    # 查看帮助文档
poseidon logs    # 查看运行日志
poseidon update  # 更新Poseidon版本
poseidon stop    # 停止服务

SDN控制器配置

Faucet配置

• 设置环境变量：

  bash
  export FAUCET_EVENT_SOCK=1
  export FAUCET_CONFIG_STAT_RELOAD=1
  

• 允许Poseidon通过SSH访问Faucet主机，修改/etc/faucet/faucet.yaml。

BCF配置

• 配置span-fabric与interface-group（参考官方文档示例），提供控制器API地址与管理员凭证。