Skip to content
This repository has been archived by the owner on Apr 19, 2021. It is now read-only.

TOR Setup OBFS4

Harris Brakmić edited this page Aug 23, 2018 · 1 revision

OBFS4 Proxy Setup

To run the Wallet with obfs4 enabled one must install the obfs4proxy package first. Also don't forget to close your Wallet or daemon before starting to change configuration files below.

Install obfs4proxy (Ubuntu, Debian)

sudo apt-get install obfs4proxy

Activate obfs4 functionality in Actinium.conf

Open your Actinium.conf and add those two lines:

torplugin=obfs4
torpluginpath=OBFS4PROXY_PATH (e.g. c:\bin\obfs4proxy.exe or /usr/bin/obfs4proxy)

To find the full path of the obfs4proxy executable you can also use those commands under Windows respective Linux/Mac:

where obfs4proxy.exe

which obfs4proxy

Find available Bridges

Visit this website to get a list of Bridges which you'll insert into the torrc file under your datadir.

Edit tor configuration file

Your datadir depends on the OS you're using. Possible locations of the torrc are:

  • Windows - %APPDATA%/Roaming/Actinium/tor
  • Linux - ~/.actinium/tor
  • Mac - ~/Library/Application Support/Actinium/tor

Open torrc and remove any lines that begin with Bridge. Now add the bridges you got from the above website with the keyword Bridge prepended.

Here's an example (Dummy data! Do not copy them!):

Bridge 1.2.3.4:80 312D64274C456DF4567DCCBAF7656865FA3CC10C
Bridge 5.5.6.6:8553 FC5D6558344479BBABDFABDF56789C8CEB8BA6E32DAD
Bridge 17.2.1.99:443 99AAAAABBBB6DD6F6775626E6A3BCC5D9ABCDABCD

If you're editing this file under Windows, please take care of saving it as torrc only. Usually, Windows appends a file extension, like txt, which must be avoided. Therefore it's recommended to use an editor like Notepad++. On saving the file you can select the option "All files" to save with the file name only.

Start your wallet, or daemon if running headless, and trace your tor's logfile with:

tail -f YOUR_DATADIR/tor/tor.log

You should see entries similar to those below:

Jan 28 20:31:14.000 [notice] Bootstrapped 0%: Starting
Jan 28 20:31:15.000 [notice] Starting with guard context "bridges"
Jan 28 20:31:15.000 [notice] new bridge descriptor 'piratepartei0' (cached): $312D64274C29156005843EECB19C6865FA3CC10C~piratepartei0 at 80.92.79.70
Jan 28 20:31:15.000 [notice] Bridge 'dax' has both an IPv4 and an IPv6 address.  Will prefer using its IPv4 address (178.63.28.14:443) based on the configured Br
idge address.
Jan 28 20:31:15.000 [notice] new bridge descriptor 'dax' (cached): $88CB40E536DD6F6775626E6A3BCC5D9C0B7BAFEA~dax at 178.63.28.14
Jan 28 20:31:15.000 [notice] Bootstrapped 80%: Connecting to the Tor network
Jan 28 20:31:15.000 [notice] Bootstrapped 85%: Finishing handshake with first hop
Jan 28 20:31:16.000 [notice] Bootstrapped 90%: Establishing a Tor circuit
Jan 28 20:31:16.000 [notice] Tor has successfully opened a circuit. Looks like client functionality is working.
Jan 28 20:31:16.000 [notice] Bootstrapped 100%: Done

Windows Installation

As Windows has no default Package Manager there are several ways to get obfs4proxy.exe. One could simply install the Tor-Browser manually and put the provided obfs4proxy.exe into the directory of your Actinium installation.

There are also some open-source Package Managers for Windows available, like choclolatey for example. As obfs4proxy.exe is a portable executable any of the possible ways is correct and it's up to the user to decide.

Installation with Chocolatey

Install Chocolatey package manager and then open a new DOS console. Type in the following command (adapt the Tor version accordingly)

choco install tor-browser --version 7.0.2

Installation with Tor-Browser

Download the Tor-Browser installation package and run it..

Getting obfs4proxy.exe & making it available

After you've installed Tor search for obfs4proxy.exe within Tor/PluggableTransports inside your Tor-Browser's installation directory.

pluggable-transports-dir

Copy this file to your Wallet's installation directory. Restart the Wallet. It will automatically find the file.