https://github.com/mrghostlyorb/network-scan
A simple CLI and web-based tool to scan a subnet for available ports on reachable devices.
https://github.com/mrghostlyorb/network-scan
go golang ip ipv4 network networking
Last synced: 9 months ago
JSON representation
A simple CLI and web-based tool to scan a subnet for available ports on reachable devices.
- Host: GitHub
- URL: https://github.com/mrghostlyorb/network-scan
- Owner: MrGhostlyOrb
- Created: 2025-07-12T08:06:03.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-07-12T14:28:43.000Z (12 months ago)
- Last Synced: 2025-07-12T16:21:55.167Z (12 months ago)
- Topics: go, golang, ip, ipv4, network, networking
- Language: Go
- Homepage:
- Size: 2.93 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🕵️♂️ Go Network Scan
A simple CLI and web-based tool to scan a subnet for available ports on reachable devices.
## 📦 Features
- 🔍 Scans a subnet for IPs with open ports
- 🌐 Web interface for user-friendly scanning
- 💻 CLI mode for quick terminal use
## 🚀 Usage
### CLI Mode
Run with 2 arguments: ` `
```bash
go run main.go 8000 1
```
This will scan 192.168.1.0/24 for anything broadcasting on port 8000.
### Web Mode
Start the server:
```bash
go run main.go
```
Then open your browser and navigate to:
http://localhost:8009
Use the form to scan a given port and subnet (e.g., port 8000, subnet 1).
## 🧠 Examples
CLI Output:
```
Running in CLI mode...
Valid addresses:
192.168.1.12
192.168.1.21
```
Web Output:
Results are shown as a list of clickable IP addresses.
## 🔧 Configuration
|Parameter|Description|
|---|---|
|port|Port to check (e.g. 8000)|
|subnet|Subnet octet (e.g. 1 for 192.168.1.x)|
## 📜 License
MIT — use freely, contribute gladly!
```
Let me know if you want badges, contribution guidelines, or Docker instructions added.
```