BigBearCasaOS Server Finder
Table of Contents
Overview
This shell script helps you discover CasaOS servers on your local network. It scans for open web ports and checks for the presence of CasaOS on those ports.
Features
-
Automatically detects available subnets on your network
-
Scans common web server ports (80, 8080, 8888, etc.)
-
Identifies CasaOS instances by checking for the CasaOS signature
-
Provides a clean, interactive interface with progress indicators
-
Parallel processing for faster scanning
-
Detailed logging for troubleshooting
Prerequisites
-
Linux system (Debian/Ubuntu recommended)
-
nmap
andiproute2
packages installed -
Run with sufficient privileges to perform network scans
-
Internet access for initial script download
Installation
Quick Install
bash -c "$(wget -qLO - https://raw.githubusercontent.com/bigbeartechworld/big-bear-scripts/master/bigbear-casaos-server-finder/run.sh)"
Manual Installation
- Install required packages:
sudo apt-get update
sudo apt-get install nmap iproute2
- Download the script:
wget https://raw.githubusercontent.com/bigbeartechworld/big-bear-scripts/master/bigbear-casaos-server-finder/run.sh
chmod +x run.sh
Usage
Run the script with:
./run.sh
The script will:
-
Detect available networks
-
Prompt you to select a network to scan
-
Scan for open ports
-
Check each found service for CasaOS signature
-
Display results
How It Works
-
The script first detects all available subnets on your system using
ip
command -
You can choose to scan all networks or select a specific one
-
It performs a port scan on common web server ports using
nmap
-
For each open port found, it checks for the CasaOS signature using
curl
-
Displays all found CasaOS servers with their IP addresses and ports
Troubleshooting
Common Issues
- Missing dependencies:
sudo apt-get install nmap iproute2
- Permission denied:
Run the script with elevated privileges:
sudo ./run.sh
- No networks found:
-
Ensure your network interfaces are up
-
Check your network configuration with
ip addr
- Slow scanning:
-
Select a specific network instead of scanning all
-
Reduce the number of ports scanned by editing the
PORTS_TO_SCAN
variable in the script
Example Output
Successful Scan
Discovering available networks...
Found networks: 192.168.1.0/24 192.168.2.0/24
Do you want to select a specific network to scan? (Faster) (y/N): y
Available networks:
[1] 192.168.1.0/24
[2] 192.168.2.0/24
Select network to scan [1-2]: 1
Scanning network: 192.168.1.0/24
Scanning for open ports (80,81,8080,8888,8000,8001,8008,8081,8880,3000,5000,5050)...
Checking for CasaOS servers...
Found CasaOS server at: 192.168.1.100:8080
Found CasaOS server at: 192.168.1.150:8888
Scan complete!
No Servers Found
Discovering available networks...
Found networks: 192.168.1.0/24
Do you want to select a specific network to scan? (Faster) (y/N): n
Scanning all discovered networks...
Scanning for open ports (80,81,8080,8888,8000,8001,8008,8081,8880,3000,5000,5050)...
Checking for CasaOS servers...
No CasaOS servers found.
Scan complete!
Notes
-
Network scanning may take some time depending on your network size
-
Ensure your network allows port scanning
-
The script only scans your local network(s)
-
Results are logged to
/tmp/bigbear-casaos-server-finder.log
for debugging