Tor Request

light Tor proxy wrapper for request library
Alternatives To Tor Request
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
3 months ago67gpl-2.0C
proxychains - a tool that forces any TCP connection made by any given application to follow through proxy like TOR or any other SOCKS4, SOCKS5 or HTTP(S) proxy. Supported auth-types: "user/pass" for SOCKS4/5, "basic" for HTTP.
15 days ago5March 08, 202278gpl-3.0Go
A censorship circumvention tool to evade detection by authoritarian state adversaries
Tun2socks1,630215 hours ago26April 06, 202218gpl-3.0Go
tun2socks - powered by gVisor TCP/IP stack
Rotating Proxy979
4 months ago22unlicenseRuby
Rotating TOR proxy with Docker
14 days ago17gpl-3.0Shell
Create multiple TOR instances with a load-balancing.
10 months ago1gpl-3.0Shell
Transparent proxy through Tor for Kali Linux OS
Awesome Anti Censorship718
7 months ago4mit
curated list of open-source anti-censorship tools
a month ago161agpl-3.0Python
Tor2web is an HTTP proxy software that enables access to Tor Hidden Services by mean of common web browsers
a year ago3apache-2.0Java
mirror of
Awesome Network Stuff463
3 years ago1
Resources about network security, including: Proxy/GFW/ReverseProxy/Tunnel/VPN/Tor/I2P, and MiTM/PortKnocking/NetworkSniff/NetworkAnalysis/etc。More than 1700 open source tools for now. Post incoming.
Alternatives To Tor Request
Select To Compare

Alternative Project Comparisons

tor-request - Simple HTTP client through Tor network

npm npm npm

Simple to use

var tr = require('tor-request');
tr.request('', function (err, res, body) {
  if (!err && res.statusCode == 200) {
    console.log("Your public (through Tor) IP is: " + body);



A very simple and light wrapper around the fantastic request library to send http(s) requests through Tor.


Tor communicates through the SOCKS Protocol so we need to create and configure appropriate SOCKS Agent objects for Node's http and https core libraries using the socks library.


from npm

npm install tor-request

from source

git clone
cd tor-request
npm install


A Tor client.

It's highly recommended you run the official client yourself, either locally or otherwise. Tor is available for most systems often just a quick one-line install away.

On Debian/Ubuntu you can install and run a relatively up to date Tor with.

apt install tor # should auto run as daemon after install

Misc Linux Command for running Tor as daemon --RunAsDaemon 1 thanks @knoxcard

/usr/bin/tor --RunAsDaemon 1

On OSX you can install with homebrew

brew install tor
tor # run tor

If you'd like to run it as a background process you can add & at the end of the command tor &. I like to have it running on a separate terminal window/tab/tmux/screen during development in order to see what's going on.

On Windows download the tor expert bundle (not the browser), unzip it and run tor.exe inside the Tor/ directory.

download link: Windows Expert Bundle

./Tor/tor.exe # --default-torrc PATH_TO_TORRC

See for detailed installation guides for all platforms.

The Tor client by default runs on port 9050. This is also the default address tor-request uses. You can change it if needed.

tr.setTorAddress(ipaddress, port); // "" and 9050 by default

(Optional) Configuring Tor, enabling the ControlPort

You need to enable the Tor ControlPort if you want to programmatically refresh the Tor session (i.e., get a new proxy IP address) without restarting your Tor client.

Configure tor by editing the torrc file usually located at /etc/tor/torrc, /lib/etc/tor/torrc, ~/.torrc or /usr/local/etc/tor/torrc - Alternatively you can supply the path yourself with the --default-torrc PATH command line argument. See Tor Command-Line Options

Generate the hash password for the torrc file by running tor --hash-password SECRETPASSWORD.

tor --hash-password giraffe

The last line of the output contains the hash password that you copy paste into torrc

Jul 21 13:08:50.363 [notice] Tor v0.2.6.10 (git-58c51dc6087b0936) running on Darwin with Libevent 2.0.22-stable, OpenSSL 1.0.2h and Zlib 1.2.5.
Jul 21 13:08:50.363 [notice] Tor can't help you if you use it wrong! Learn how to be safe at

Copy the generated hash password and add it to your torrc file

# sample torrc file
ControlPort 9051
HashedControlPassword 16:AEBC98A6777A318660659EC88648EF43EDACF4C20D564B20FF244E81DF

Lastly tell tor-request the password to use

var tr = require('tor-request')
tr.TorControlPort.password = 'giraffe'


// index.js
module.exports = {
   * This is a light wrapper function around the famous request nodeJS library, routing it through
   * your Tor client.
   * Use it as you would use the request library - see their superb documentation.
  request: function (url || opts, function (err, res, body))
   * @param {string} ipaddress - ip address of tor server ("" by default)
   * @param {number} port - port of the tor server (by default tor runs on port 9050)
  setTorAddress: function (ipaddress, port) // defaults to "" on port 9050
   * Helper object to communicate with the tor ControlPort. Requires an enabled ControlPort on tor.
  TorControlPort: {
    password: "", // default ControlPort password
    host: "", // default address
    port: 9051, // default ControlPort
     * @param {Array.string} commands - signals that are sent to the ControlPort
    send: function (commands, done(err, data))
   * A set of predefined TorControlPort commands to request and verify tor for a new session (get a new ip to use).
   * @param {function} done - the callback function to tell you when the process is done
   * @param {object} err - null if tor session renewed successfully
  newTorSession: function ( done(err) ) // clears and renews the Tor session (i.e., you get a new IP)

Custom headers

Refer to the request/request to specify your own headers ( like User-Agent ).


tr.request({ url: '', headers: { 'user-agent': 'giraffe' }}, function ( err, response, body ) { /*...*/ })

Request Pipe Streaming

 url: '',
 strictSSL: true,
 agentClass: require('socks5-https-client/lib/Agent'),
 agentOptions: {
   socksHost: 'my-tor-proxy-host', // Defaults to 'localhost'.
   socksPort: 9050, // Defaults to 1080.
   // Optional credentials
   socksUsername: 'proxyuser',
   socksPassword: '[email protected]',
}, function(err, res) {
 console.log(err || res.body);


Tests the original request library by connecting to - returning your ip. Then makes a few additional requests, now through tor-request, and makes sure the ip's are different (went through tor).

mocha test/test.js



Popular Proxy Projects
Popular Tor Projects
Popular Networking Categories

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.