mirror of
https://github.com/Av0idD4rk/packmate.git
synced 2026-10-23 14:31:01 +00:00
63 lines
2.2 KiB
Markdown
63 lines
2.2 KiB
Markdown
<div align="center">
|
|
|
|
# Packmate
|
|
</div>
|
|
|
|
### [EN | [RU](README.md)]
|
|
Advanced network traffic flow analyzer for A/D CTFs.
|
|
|
|
#### Features:
|
|
* Can monitor live traffic or analyze pcap files
|
|
* Supports binary and textual services
|
|
* Can highlight found patterns in packets
|
|
* Substring
|
|
* Regular expression
|
|
* Binary substring
|
|
* Can automatically delete streams with content that you don't need
|
|
* Can make certain streams favorite and show only favorite streams
|
|
* Supports several simultaneous services, can show streams for a specific service or pattern
|
|
* Allows navigating streams using shortcuts
|
|
* Has the option to copy packet content in various formats
|
|
* Can concatenate adjacent packets
|
|
* Can urldecode text automatically
|
|
* Can automatically decompress GZIPed HTTP
|
|
* Can automatically deflate WebSockets with permessages-deflate extension
|
|
* Can automatically decrypt TLS with RSA using given private key (like Wireshark)
|
|
* Bounded and resumable retention cleanup for long running `LIVE` captures
|
|
|
|
|
|
|
|
Cleanup settings and the PostgreSQL stress test are documented in [docs/CLEANUP.md](docs/CLEANUP.md).
|
|
|
|
An optional MCP service provides bounded traffic/IP search, payload reads, favorites, shared service
|
|
and pattern management, and historical highlighting. One token grants all tools. Setup and limits:
|
|
[docs/MCP.md](docs/MCP.md) (Russian).
|
|
Client setup and agent workflow: [inst.md](inst.md) (Russian).
|
|
|
|
## Quick Start
|
|
|
|
Docker Engine and the Docker Compose plugin are required. The repository contains both backend and
|
|
frontend sources, so a regular clone is enough and no git submodules are needed:
|
|
|
|
```bash
|
|
git clone https://github.com/Av0idD4rk/packmate.git
|
|
cd packmate
|
|
cp .env.example .env
|
|
${EDITOR:-nano} .env
|
|
docker compose up --build -d
|
|
```
|
|
|
|
For `LIVE` mode, set `PACKMATE_INTERFACE` and `PACKMATE_LOCAL_IP` in `.env`, and change the
|
|
passwords. See [docs/SETUP_EN.md](docs/SETUP_EN.md) for all modes and settings.
|
|
|
|
If everything went fine, Packmate will be available on port `65000` from any host.
|
|
Database with listen on port 65001, but will only accept connections from localhost.
|
|
|
|
## Usage
|
|
[Instructions](docs/USAGE_EN.md)
|
|
|
|
<div align="right">
|
|
|
|
*desu~*
|
|
</div>
|