https://github.com/0xamined/portseeker
This is an advanced port scanner written in Bash that allows you to scan a target host for open or closed ports.
https://github.com/0xamined/portseeker
bash information-gathering netcat port-scanner shell-script
Last synced: about 1 month ago
JSON representation
This is an advanced port scanner written in Bash that allows you to scan a target host for open or closed ports.
- Host: GitHub
- URL: https://github.com/0xamined/portseeker
- Owner: 0xAminED
- License: mit
- Created: 2024-11-28T20:13:08.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-28T20:21:23.000Z (over 1 year ago)
- Last Synced: 2025-03-24T16:11:49.147Z (about 1 year ago)
- Topics: bash, information-gathering, netcat, port-scanner, shell-script
- Language: Shell
- Homepage:
- Size: 4.88 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PortSeeker
This is an advanced port scanner written in **Bash** that allows you to scan a target host for open or closed ports. You can scan a specific port, a range of ports, and specify various parameters like timeout and threads for parallel scanning. It is designed to be fast and flexible for various use cases.
## Features
- **Single Port Scan**: Scan a specific port, e.g., `80`.
- **Range Scan**: Scan a range of ports, e.g., `80-3000`.
- **Parallel Scanning**: Use multiple threads to speed up the scanning process.
- **Custom Timeout**: Adjust the timeout for each port scan.
## Requirements
- **Bash**: The script is written for a Linux environment and requires Bash.
- **Netcat (`nc`)**: Used to check if ports are open.
- **Ping**: Used to verify if the target is reachable.
## Installation
1. **Clone the repository**:
```bash
git clone https://github.com/0xAminED/PortSeeker.git
cd PortSeeker
```
2. **Make the script executable**:
```bash
chmod +x PortSeeker.sh
```
3. **Run the script**:
```bash
./PortSeeker.sh -t -p -T -p
```
Example:
```bash
./PortSeeker.sh -t 192.168.1.1 -p 80 -T 2 -p 10
```
- `-t `: The target IP address or domain name.
- `-p `: A single port (e.g., `80`) or a port range (e.g., `80-3000`).
- `-T `: Timeout in seconds for each port scan (default: 1 second).
- `-p `: The number of threads for parallel scanning (default: 50).
## Example Usage
1. **Scan a single port**:
```bash
./PortSeeker.sh -t 192.168.1.1 -p 80 -T 2 -p 10
```
2. **Scan a range of ports**:
```bash
./PortSeeker.sh -t 192.168.1.1 -p 80-1000 -T 1 -p 20
```
3. **Scan a specific range with a custom timeout and thread count**:
```bash
./PortSeeker.sh -t 192.168.1.1 -p 8000-8100 -T 3 -p 30
```
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Acknowledgments
- Thanks to the contributors for their valuable feedback and improvements.