https://github.com/cyclenerd/network-tester
🕷️ Lightweight, cloud-native network diagnostic tool
https://github.com/cyclenerd/network-tester
container curl dns docker iperf iperf3 network ping
Last synced: 7 months ago
JSON representation
🕷️ Lightweight, cloud-native network diagnostic tool
- Host: GitHub
- URL: https://github.com/cyclenerd/network-tester
- Owner: Cyclenerd
- License: apache-2.0
- Created: 2025-03-21T15:59:27.000Z (7 months ago)
- Default Branch: master
- Last Pushed: 2025-03-21T17:21:07.000Z (7 months ago)
- Last Synced: 2025-03-21T17:39:51.757Z (7 months ago)
- Topics: container, curl, dns, docker, iperf, iperf3, network, ping
- Language: CSS
- Homepage: https://hub.docker.com/r/cyclenerd/network-tester
- Size: 572 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Network Tester
A lightweight, cloud-native network diagnostic tool with a clean web interface.
Container image:
```text
docker.io/cyclenerd/network-tester:latest
```
## Features
- **Real-time Command Output**: Watch network command results as they happen
- **Multiple Network Tools**: Run `ping`, `curl`, `dig`, `traceroute`, and `iperf3` from a single interface
- **Network Configuration Display**: View all network interfaces and their IP addresses
- **Cloud-Native Design**: Containerized for easy deployment in any environment
## Commands Supported
- **ping**: Test basic connectivity to hosts
- **curl**: Test HTTP(s) data transfer
- **dig**: Perform DNS lookups with support for different record types (`A`, `AAAA`, `MX`, `NS`, `TXT`, etc.)
- **traceroute**: Trace network path to target hosts
- **iperf3**: Measure network performance between hosts
## Building from Source with Podman
```bash
# Clone the repository
git clone https://github.com/Cyclenerd/network-tester.git
cd network-tester
# Build the Container image
podman build --tag network-tester:test .
# Run the Container
podman run --privileged -p 8080:8080 network-tester:test
```
## Usage
1. Open your browser and navigate to `http://localhost:8080`
2. Select a command from the dropdown menu
3. Enter the target hostname or IP address
4. Configure any additional options if needed
5. Click "Run Test" to execute the command
6. View the results in real-time in the output panel
## Security Considerations
This tool executes network commands on the host system. When deploying in production:
- Run the container with appropriate security constraints
- Limit access to trusted users only
- Consider network policies to restrict where the container can send traffic
## Acknowledgments
- Built with [Go](https://go.dev/)
- UI inspired by [Dracula Theme](https://draculatheme.com/)
- Uses [Gorilla WebSocket](https://github.com/gorilla/websocket) for real-time communication
## License
All files in this repository are under the [Apache License, Version 2.0](LICENSE) unless noted otherwise.
The favicon was generated using the following graphics from Twitter Twemoji:
- Title: `1f577.svg`
- Author: Copyright 2020 Twitter, Inc and other contributors ()
- Source:
- License: [CC-BY 4.0](https://creativecommons.org/licenses/by/4.0/)