README-zh-Hans.md

English ∙ 简体中文

Netis Cloud Probe

什么是Netis Cloud Probe?

Netis Cloud probe（曾用名 Packet Agent）是一个用于解决如下问题的开源项目：设备A上抓取的数据包，之后在设备B上使用分析。在很多时候，当你希望监控网络的流量，但是并没有可用的设备，例如：

• 物理环境中不存在TAP和SPAN设备。
• 虚拟环境中，Virtual Switch Flow Table不支持SPAN功能。

因此，该项目提供一套低开销但是高性能的抓包工具，用于应对上述困难。

• pktminerg是第一个发布的工具。该工具可以轻松地在网卡上抓数据包，用GRE头进行封装并发送到远端的设备，来进行数据包监控和分析。

此外，还有另外4个工具：

• pcapcompare用于比较两个pcap文件
• gredump根据特定的过滤规则抓取GRE数据包，并存储为pcap文件。
• gredemo是一个demo应用程序，可以从pcap文件读取数据包，然后把它们发送到远端网卡。这个程序只能通过源代码编译生成。
• probeDaemon是pktminerg的管理程序（从v0.7.0）.它可以拉起和停止pktminerg,并且设定命令行的参数。该模块需要和CPM（Cloud Probe Mananger）.CPM提供了用户界面，可以对pktminerg的策略进行配置，同时还可以图形化显示pktminerg上报的统计数据。您可以联系Netis获取关于CPM的进一步支持，或者可以开发自己的CPM。目前Windows版本尚无该模块，后面将会发布windows版本。

开始

安装

CentOS 7/8和RedHat 7

1. 下载并安装RPM包。您可以从这个地址获取最新版本的软件包。

wget https://github.com/Netis/cloud-probe/releases/download/v0.7.0/netis-cloud-probe-0.7.0.x86_64_centos.rpm
rpm -ivh netis-cloud-probe-0.7.0.x86_64_centos.rpm

SUSE12

1. 下载并安装RPM包。您可以从这个地址获取最新版本的软件包。

wget https://github.com/Netis/cloud-probe/releases/download/v0.7.0/netis-cloud-probe-probe-0.7.0.x86_64_suse.rpm
rpm -ivh netis-cloud-probe-probe-0.7.0.x86_64_suse.rpm

Ubuntu 18.04LTS

1. 下载并安装DEB包。您可以从这个地址获取最新版本的软件包。

wget https://github.com/Netis/cloud-probe/releases/download/v0.7.0/netis-cloud-probe-0.7.0_amd64.deb
sudo dpkg -i netis-cloud-probe-0.7.0_amd64.deb

** 如果安装过程中提示libboost库的版本号不正确，请下载安装boost_1_59_0或者之后的版本。如果问题依然无法解决，可以尝试从源代码直接编译安装。
** 现在仅支持 CentOS 6/7版本和RedHat 7, SUSE12和Ubuntu 18.04 LTS版本

Windows 2019 server

1. 下载并安装WinPcap
2. 下载并安装Microsoft Visual C++ Redistributable for Visual Studio 2017 x64
3. 从zip文件解压pktminerg和其他utilities，并在命令行界面运行（需管理员模式）.https://github.com/Netis/cloud-probe/releases/download/v0.7.0/netis-cloud-probe-0.7.0.Windows.AMD64.zip

使用

备注：请确保防火墙允许向目标发送GRE数据包. https://lartc.org/howto/lartc.tunnel.gre.html提供验证是否允许向目标发送GRE数据包的方法.

# Capture packet from NIC "eth0", encapsulate with GRE header and send to 172.16.1.201
pktminerg "-i eth0 -r 172.16.1.201"

# compare 2 pcap files
pcapcompare --lpcap /path/to/left_file.pcap --rpcap /path/to/right_file.pcap

# Capture packet from NIC "eth0" and save them to gredump_output.pcap
gredump -i eth0 -o /path/to/gredump_output.pcap

# Capture packets from NIC "eth0", forward to 172.16.1.201 with GRE encapsulated and capture packets from "eth1", forward to 10.1.2.123 with vni encapsulated
pktminerg "-i eth0 -r 172.16.1.201 -k 12" "-i eth1 -r 10.1.2.123 -n 12"

完整的使用说明，请参阅这篇文档（仅英文版）.

在Docker中使用packet-agent，请参阅这篇文档（仅英文版）.

从源代码安装

您可以从Github上克隆本项目的源代码进行编译，之后到"/path/to/packet-agent/bin"下查看所有的binary.
完整的构建条件及步骤，请参阅这篇文档（仅英文版）.

文档/ 链接

• 安装和使用（仅英文版）。
• 构建条件及步骤（仅英文版）。
• Packet-Agent 云平台性能评测（仅中文版）。
• Packet-Agent libpcap 缓存与最大支持流量评测（仅中文版）。

贡献

您可以fork本项目并提交Pull Request。我们欢迎所有开源社区的同学提交自己的贡献。

许可证

Copyright (c) 2018 - 2020 Netis.
本项目库遵循下列许可证：

• BSD-3-Clause.

联系方式

• 您可以给我们发邮件到[email protected]。
• 您也可以在GitHub issues直接报告问题和建议。

issue模板

• 在您提出issue时，请使用该模板 （issue_report_template.md）