b86a7a535eb6ecf81a2804894b436a82c19477be
TailScan
Self-hosted web app to manage Tailscale exit nodes and scan the LAN at each remote site — all from a browser.
How it works
- The server running TailScan is the Tailscale client
- Selecting an exit node in the UI runs
tailscale set --exit-node=<ip>on the server - All scans (nmap, WAN IP, geolocation) run from the server through the exit node
- Access the UI via the server's Tailscale IP — so exit node switches can never lock you out
Quick Start
1. Prerequisites
- Linux machine with Tailscale installed and running
- Python 3.11+
- Git
2. Install
git clone https://github.com/PizzaCow/TailScan /opt/tailscan
cd /opt/tailscan
chmod +x start.sh update.sh
./start.sh
# First run creates .env — edit it, then run ./start.sh again
4. Configure .env
PASSWORD_HASH=<sha256 of your password>
SECRET_KEY=<random 32-char string>
TAILNET=your-tailnet-name
Generate values:
# Password hash
python3 -c "import hashlib; print(hashlib.sha256(b'yourpassword').hexdigest())"
# Secret key
python3 -c "import secrets; print(secrets.token_hex(32))"
5. Launch
./start.sh
Access at http://<tailscale-ip>:8080
Run as a service (optional)
cp tailscan.service /etc/systemd/system/
# Edit WorkingDirectory in the service file if you installed somewhere other than /opt/tailscan
systemctl daemon-reload
systemctl enable tailscan
systemctl start tailscan
Update
cd /opt/tailscan
./update.sh
Features
- Password login — simple password auth, session cookie keeps you signed in for 7 days
- Exit node selector — see all tailnet devices, click to connect
- LAN scan — nmap ping sweep auto-detects subnet, shows IP, hostname, ping, MAC, vendor
- WAN + Geo — WAN IP, city, region, country, lat/lon, ISP, timezone via ip-api.com
- Auto-refresh — scans every 30s while connected
- Dark UI — clean dark theme
Security
- UI is only served on port 8080 — keep it on Tailscale, don't expose to public internet
- Auth via Tailscale SSO — only your tailnet members can log in
- Switching exit nodes affects all server traffic — use on a dedicated machine
Stack
- Python + FastAPI
- nmap for LAN scanning
- ip-api.com for WAN geolocation (free, no key needed)
- Tailscale OAuth for auth
- Zero JS frameworks — plain HTML/CSS/JS frontend
Description
Fast LAN scanner for Tailscale networks — discover hosts and ports via exit nodes
1.1 MiB
0 Stars
1 Watchers
0 Forks
Languages
JavaScript
89.3%
CSS
5.3%
Python
3.4%
HTML
1.9%