Skip to content

fabcj/network-radar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Global Netowrk Radar

Network Radar Demo (Note: Record a 10-second GIF of your globe spinning with traffic and put it here!)

Live Network Radar is a full-stack, real-time packet visualizer. It captures raw network traffic leaving your machine and instantly maps the destination IP addresses to a 3D interactive globe using WebSockets and WebGL.

Tech Stack

  • Backend: Go, gopacket / libpcap
  • Frontend: React, Vite, Deno, react-globe.gl (Three.js)
  • Communication: Real-time WebSockets
  • Infrastructure: Docker & Docker Compose

Features

  • Raw Packet Sniffing: Uses Go and libpcap to read TCP/UDP packets directly from the network interface.
  • Real-Time Geolocation: Resolves IP addresses to physical coordinates using external APIs.
  • 3D Visualization: Renders destination arcs and interactive tooltips dynamically on a WebGL-powered 3D Earth.
  • Optimized Rendering: Deduplicates target nodes and handles state efficiently to prevent Z-fighting and WebGL lag.

Installation & Quick Start

Because this app requires elevated privileges to sniff raw network packets, it is containerized using Docker with host network binding. ALso, note there is an .env.template in the github repo where lan and lon coordinates are expected.

Prerequisites

  • Docker and Docker Compose installed.
  • Ensure your machine supports raw packet sniffing (Linux/macOS default; Windows requires WSL2 or specific configurations).

Running the App

  1. Clone the repository:
    git clone [https://github.com/yourusername/network-radar.git](https://github.com/yourusername/network-radar.git)
    cd network-radar
  2. Setup the containter
    sudo docker-compose up --build
  3. Access the Visualizer Open your browser to localhost:5173

About

Real-time network packet visualizer that maps live TCP/UDP traffic onto a WebGL 3D globe using Go and React.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors