https://github.com/tamper000/tor-scanner
Easily Find Working Bridges for Tor
https://github.com/tamper000/tor-scanner
golang security security-tools tor
Last synced: about 1 month ago
JSON representation
Easily Find Working Bridges for Tor
- Host: GitHub
- URL: https://github.com/tamper000/tor-scanner
- Owner: tamper000
- Created: 2025-11-15T08:14:52.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2026-05-08T05:02:03.000Z (2 months ago)
- Last Synced: 2026-05-08T07:11:20.826Z (2 months ago)
- Topics: golang, security, security-tools, tor
- Language: Go
- Homepage:
- Size: 433 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README-en.md
Awesome Lists containing this project
README
# Tor-scanner
**Tor-scanner** is a fast and simple tool to find working bridges for Tor.
It checks a list of bridges for availability and selects only those that respond quickly and reliably.
Suitable for users living in censored regions who need reliable bridges to connect to Tor.
---
## 🚀 How to Use
Run the application with the desired parameters:
```bash
tor-scanner \
--count 10 \
--threads 20 \
--ping 1000 \
--country ru,es,us \
--output tor.conf \
--input bridges.list
```
### Parameters:
| Parameter | Description |
|----------|-------------|
| `--count` | Number of working bridges to find (default: 5) |
| `--threads` | Number of concurrent requests (default: 50) — higher values mean faster scanning |
| `--ping` | Maximum delay (in milliseconds) for a bridge to be considered responsive (default: 250) |
| `--country` | Filter bridges by country codes. Example: `ru,es,us` — checks only bridges from these countries |
| `--output` | File to save found bridges (e.g., `bridges.txt`) |
| `--input` | URL or path to a file containing a list of bridges. Uses the official list by default |
---
## 💡 Examples
### Find 15 fast bridges from Russia and USA, save to file:
```bash
tor-scanner --count 15 --threads 100 --ping 100 --country ru,us --output tor.conf
```
### Check a list of bridges and save only working ones:
```bash
tor-scanner --input my-bridges.list --output working-bridges.txt --ping 200
```
or
```bash
tor-scanner --input "https://onionoo.torproject.org/details?type=relay&running=true&fields=fingerprint,or_addresses,country" --output working-bridges.txt --ping 200
```
---
## 🛠️ How to Build
Make sure you have Go (1.19+) installed:
```bash
git clone https://github.com/tamper000/tor-scanner.git
cd tor-scanner
go build -o tor-scanner cmd/main.go
```
Done! Now you can run `./tor-scanner`.
[🐳 Using Docker](docker/howto-en.md)