Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/SkuldNorniern/fluere

Fluere is a powerful and versatile tool designed for network monitoring and analysis. It is capable of capturing network packets in pcap format and converting them into NetFlow data, providing a comprehensive view of network traffic. It also Provides Terminal User Interface.
https://github.com/SkuldNorniern/fluere

cross-platform flowlogs fluere hacktoberfest netflow netflow-exports netflow-v5 network-analysis network-capture network-monitoring network-security packet packet-capture packet-sniffer packets pcap rust security security-scanner security-tools

Last synced: 3 months ago
JSON representation

Host: GitHub
URL: https://github.com/SkuldNorniern/fluere
Owner: SkuldNorniern
License: apache-2.0
Created: 2022-12-28T04:57:47.000Z (almost 2 years ago)
Default Branch: main
Last Pushed: 2024-07-26T05:47:54.000Z (4 months ago)
Last Synced: 2024-07-26T06:51:26.792Z (4 months ago)
Topics: cross-platform, flowlogs, fluere, hacktoberfest, netflow, netflow-exports, netflow-v5, network-analysis, network-capture, network-monitoring, network-security, packet, packet-capture, packet-sniffer, packets, pcap, rust, security, security-scanner, security-tools
Language: Rust
Homepage:
Size: 2.72 MB
Stars: 32
Watchers: 4
Forks: 3
Open Issues: 14
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md

Awesome Lists containing this project

README

# Fluere

[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2FSkuldNorniern%2Ffluere.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2FSkuldNorniern%2Ffluere?ref=badge_shield)
[![Rust](https://github.com/SkuldNorniern/fluere/actions/workflows/rust.yml/badge.svg)](https://github.com/SkuldNorniern/fluere/actions/workflows/rust.yml)
[![Drone Build Status](https://drone.nornity.com/api/badges/SkuldNorniern/fluere/status.svg)](https://drone.nornity.com/SkuldNorniern/fluere)

## Your Comprehensive Network Monitoring and Analysis Tool

Fluere is a robust tool designed for comprehensive network monitoring and analysis. It facilitates the capture of network packets in pcap format and their conversion into NetFlow data, offering a detailed view of network traffic dynamics. With support for both live and offline data capture, Fluere stands as a versatile solution suitable for a myriad of use cases.

- AWS flow logging using AWS Traffic Mirroring
- Local Server's Active firewall implementation using a plugin
- Logging your Server's Flows

### Key Features:
- Cross-platform support (Windows, macOS, Linux)
- Live and offline NetFlow data capture and conversion
- Packet capture in pcap format
- Terminal User Interface (TUI) for real-time feedback during live capture

Windows, MacOS, and Linux are All Supported! YAY!

Public IPs are masked to prevent privacy issues (except for DNS & Local broadcast)

## Technical Overview

Fluere is built with Rust and leverages the `libpcap` library for packet capture. The core functionalities are encapsulated within the `main.rs` file, which defines the command-line interface and handles various commands and options.

## Command Line Arguments

Customize your Fluere experience using the following command-line arguments:

| Argument | Description | Usage Example |
|----------------|--------------------------------------|------------------------|
| `csv` | Title of the exported CSV file | `-c` or `--csv` |
| `list` | List available network interfaces | `-l` or `--list` |
| `interface` | Select network interface to use | `-i` or `--interface` |
| `duration` | Set capture duration (in ms) | `-d` or `--duration` |
| `timeout` | Set flow timeout (in ms) | `-t` or `--timeout` |
| `useMACaddress`| Use MAC address as key value | `-M` or `--useMAC` |
| `interval` | Set export interval (in ms) | `-I` or `--interval` |
| `sleep_windows`| Set thread pause interval for Windows| `-s` or `--sleep` |
| `verbose` | Set verbosity level | `-v` or `--verbose` |

## Getting Started

### Prerequisites

Before installing Fluere, ensure to install `libpcap` (Linux/macOS) or `npcap` (Windows) in winpcap compatible mode.

### Installation

Install Fluere using the following command:

```sh
cargo install fluere
```

## Usage Examples

Explore the diverse functionalities of Fluere with the following examples:

1. **Live NetFlow Capture and Conversion**
```sh
fluere online -i eth0 -d 1000 -t 600000 -I 1800000 -v 1
```

2. **Offline pcap to NetFlow Conversion**
```sh
fluere offline -f input.pcap -c output
```

3. **Packet Capture in pcap Format**
```sh
fluere pcap -i eth0 -d 1000
```

4. **Live Fluereflow Capture and Conversion**
```sh
fluere live -i eth0 -d 1000 -t 600000 -I 1800000 -v 1
```

For more detailed information and guidance, refer to the [Fluere Wiki](https://github.com/SkuldNorniern/fluere/wiki).