https://github.com/knightchaser/geotracert

Easily track and geographically visualize the traceroute request.
https://github.com/knightchaser/geotracert

amchart5 amcharts fastapi network traceroute visualization

Last synced: about 2 months ago
JSON representation

Easily track and geographically visualize the traceroute request.

• Host: GitHub
• URL: https://github.com/knightchaser/geotracert
• Owner: KnightChaser
• Created: 2024-05-03T07:43:29.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-05-06T09:10:56.000Z (about 2 years ago)
• Last Synced: 2025-03-23T10:25:39.834Z (over 1 year ago)
• Topics: amchart5, amcharts, fastapi, network, traceroute, visualization
• Language: JavaScript
• Homepage: https://en.wikipedia.org/wiki/Traceroute
• Size: 540 KB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# geotracert

![Python](https://img.shields.io/badge/python-3670A0?style=for-the-badge&logo=python&logoColor=ffdd54)

![FastAPI](https://img.shields.io/badge/FastAPI-005571?style=for-the-badge&logo=fastapi)

![JavaScript](https://img.shields.io/badge/javascript-%23323330.svg?style=for-the-badge&logo=javascript&logoColor=%23F7DF1E)

### **Geographically and visually track** `traceroute`(`tracert`) opreation, and get some insight how international Internet network is wired each other. Built with `amChart5`.

### Preview

- Yet simple and intuitive UI

- **Live update** of tracked traceroutes on the interactive global map

- **Live update** of traceroute statistics, and status

- Full log of traceroute hops and detailed information provided by IP-API's OpenAPI.

![example_image_1](./_readme_pictures/geotracert_1.png)

![example_imgae_2](./_readme_pictures/geotracert_2.png)

### Run

- Prepare Python3-installed environment. (Note that this service developed on Windows platform)

- Install required Python3 packages described in `requirements.txt`

```powershell

pip install -r ./requirements.txt

```

- Boot up the FastAPI server. As default, `127.0.0.1:8000` will be the access point.

```powershell

uvicorn main:app --relaod

```

### Why not docker?

It looks like the traceroute operation within Dockerized environment that uses **ICMP(Internet Control Message Protocol)** for outbound traffic isn't technnically supported. Thus, I couldn't dockerize the service and I ask your generosity for this inconvenience.

### Why did you make it?

I was bored, and this idea seemed to be fun, even though I suck at HTML/JS/CSS things.