Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/IntelligenceX/ip2tor

IP2Tor allows to determine whether an IP address is a Tor exit node.
https://github.com/IntelligenceX/ip2tor

Last synced: about 2 months ago
JSON representation

IP2Tor allows to determine whether an IP address is a Tor exit node.

Awesome Lists containing this project

README

        

# IP2Tor

IP2Tor allows to check if an IP address is a Tor exit node. This can be used to identify and block traffic from the Tor network. IPv4 and IPv6 addresses are supported.

It will run a daemon to download the Tor list from below sources and update it according to the time specified. It optionally uses a local file to cache the last results and allow continuous operation even after restart of your application.

Tor node lists:
* https://check.torproject.org/torbulkexitlist
* https://www.dan.me.uk/tornodes

It was observed that those lists only match about 72%, so they are both used as source by this package.

## Usage

It is a Go package with no external dependencies. To download it:

```shell
go get -u github.com/IntelligenceX/ip2tor
```

Then use it like this:

```go
package main

import (
"github.com/IntelligenceX/ip2tor"
)

func init() {
// Only download exit nodes, refetch the list every 2 hours.
// Cache it to the file "tor-ips.txt".
ip2tor.Init(1, time.Hour*2, "tor-ips.txt")
}

func main() {
ip := net.ParseIP("1.2.3.4")

ip2tor.IsTor(ip) // returns true or false
}
```