https://github.com/juev/tor-relay-scanner-go

Tor Relay availability checker, for using it as a bridge in countries with censorship
https://github.com/juev/tor-relay-scanner-go

golang proxy-checker proxy-scan proxy-scanner tor

Last synced: 2 days ago
JSON representation

Tor Relay availability checker, for using it as a bridge in countries with censorship

• Host: GitHub
• URL: https://github.com/juev/tor-relay-scanner-go
• Owner: juev
• License: mit
• Created: 2023-04-22T08:12:30.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-11-11T14:41:25.000Z (3 days ago)
• Last Synced: 2024-11-11T15:37:17.312Z (3 days ago)
• Topics: golang, proxy-checker, proxy-scan, proxy-scanner, tor
• Language: Go
• Homepage:
• Size: 61.5 KB
• Stars: 6
• Watchers: 3
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Tor Relay Availability Checker

This is golang fork of [ValdikSS/tor-relay-scanner](https://github.com/ValdikSS/tor-relay-scanner).

---

This small program downloads all Tor Relay IP addresses from [onionoo.torproject.org](https://onionoo.torproject.org/) directly and via embedded proxies, and checks whether random Tor Relays are reachable from your Internet connection.

It could be used to find working Relay in a countries with Internet censorship and blocked Tor, and use it as Bridge to connect to Tor network, bypassing standard well-known nodes embedded into Tor code.

## How to use with Tor (daemon)

This utility is capable of generating `torrc` configuration file containing Bridge information. Launch it with the following arguments:

`--torrc --outfile /etc/tor/bridges.conf`

And append:

`%include /etc/tor/bridges.conf`

to the end of `/etc/tor/torrc` file to make Tor daemon load it.

## How to use as a standalone tool

**Windows**: download ***.exe** file from [Releases](https://github.com/juev/tor-relay-scanner-go/releases) and run it in console (`start → cmd`)

**Linux & macOS**: download binary file from [Releases](https://github.com/juev/tor-relay-scanner-go/releases) and run it:  

```bash

./tor-relay-scanner-go

```

Tor-relay-scanner-go gets proxy information from environment. Or you can set it from variables:

```bash

HTTP_PROXY=http://example.com:3128 HTTPS_PROXY=http://example.com:3128 ./tor-relay-scanner-go

```