#binary #traffic #networking #analysis #capture #further #io

bin+lib net-agent

net-agent 是一个二进制 crate,可以运行以捕获网络流量。然后所有捕获的流量都可以加载到 my.netstalker.io 进行进一步分析

3 个版本

0.1.2 2024 年 8 月 20 日
0.1.1 2024 年 7 月 9 日
0.1.0 2024 年 4 月 10 日

917网络编程

Download history 5/week @ 2024-05-21 116/week @ 2024-07-09

每月 153 次下载

Apache-2.0

26KB
425

Net Agent

Crates.io License

Net-agent 是 Net Stalker 项目中的一个独立的二进制 crate,允许您捕获网络流量,然后可以上传到 my.netstalker.io 进行进一步分析。

安装

要安装 net-agent,请使用 Cargo

cargo install net-agent

要求

在运行 net-agent 之前,请确保您已安装操作系统所需的必要依赖项

Linux

  • Ubuntu/Debian

    sudo apt-get install libpcap-dev
    
  • Fedora

    sudo dnf install libpcap-devel
    
  • Arch

    sudo pacman -S libpcap
    

macOS

  • libpcap 应该在 Mac OS X 上默认安装。

Windows

  1. 安装 Npcap

  2. 下载 Npcap SDK

  3. 将 SDK 的 /Lib/Lib/x64 文件夹添加到您的 LIB 环境变量。

用法

您可以使用以下命令行选项运行 net-agent

net-agent [OPTIONS]

可用的选项如下

  • -D, -device-name <DEVICE_NAME>:指定要捕获流量的网络设备。

  • -N, --number-packages <NUMBER_PACKAGES>:指定要捕获的包的数量。

  • -B, --buffer-size <BUFFER_SIZE>:指定捕获包的缓冲区大小。

  • -O, --output-directory <OUTPUT_DIRECTORY>:指定捕获流量的输出目录(默认:“output”)。

注意:选项-C--config-file与其他所有选项冲突。如果指定,配置将从指定的文件加载。

配置

要使用配置文件,请使用-C--config-file选项并传递文件的路径。

  • 模板

    device_name = <DEVICE_NAME>
    number_packages = <NUMBER_PACKAGES>
    buffer_size = <BUFFER_SIZE>
    output_directory = <OUTPUT_DIRECTORY>
    
  • 示例

    device_name = "eth0"
    number_packages = 1000
    buffer_size = 2048
    output_directory = "captured_traffic"
    

故障排除

在Linux上,要使用sudo运行应用程序,通常需要运行

sudo cp ~/.cargo/bin/net-agent /usr/local/bin/

贡献

欢迎对net-agent的所有贡献!如果您发现任何问题或对改进有建议,请在该GitHub存储库上打开一个issue。如果您想为项目贡献代码,请按照以下步骤操作

  1. 克隆存储库并为您的功能或错误修复创建一个新的分支。
  2. 进行您的更改,并确保代码通过所有测试和linting检查。
  3. 提交一个pull request,描述您的更改以及为什么它们应该被合并。

请注意,所有贡献都需由项目维护者进行审查和批准。

许可

net-agent根据Apache License,版本2.0授权。有关更多信息,请参阅LICENSE。

依赖项

~20–33MB
~452K SLoC