Tor.rb: Onion Routing for Ruby
This is a Ruby library for interacting with the Tor anonymity network.
- Supports checking whether Tor is installed in the user's current
PATH, and if it is, returning the version number.
- Supports querying the Tor DNS Exit List (DNSEL) to determine whether a particular host is a Tor exit node or not.
require 'rubygems' require 'tor'
Checking whether Tor is installed and which version it is
Tor.available? #=> true Tor.version #=> "0.2.1.25"
Checking whether a particular host is a Tor exit node
Tor::DNSEL.include?("18.104.22.168") #=> true Tor::DNSEL.include?("22.214.171.124") #=> false
The recommended installation method is via RubyGems. To install the latest official release of Tor.rb, do:
% [sudo] gem install tor # Ruby 1.8.7+ or 1.9.x % [sudo] gem install backports tor # Ruby 1.8.1+
To get a local working copy of the development repository, do:
% git clone git://github.com/bendiken/tor-ruby.git
Alternatively, you can download the latest development version as a tarball as follows:
% wget http://github.com/bendiken/tor-ruby/tarball/master
Tor.rb is free and unencumbered public domain software. For more information, see http://unlicense.org/ or the accompanying UNLICENSE file.