Ticket #12844: tor2web_rp_instructions.txt

File tor2web_rp_instructions.txt, 2.4 KB (added by asn, 5 years ago)
Line 
1==Guide to using Tor2webRendezvousPoints==
2
3To use Tor2webRendezvousPoints on the Tor2Web machine, we are going to
4set up two Tors.
5
6One Tor is going to be acting as the Tor2Web RP, and the other Tor is
7going to be the Tor2Web client. Hence, the latter Tor will need to be
8compiled with tor2web support and the bug12844 branch. The former Tor
9can just be your regular vanilla Tor.
10
11The easiest way to do that, is to compile tor twice and place the
12binaries in a dedicated directory. So for example inside the Tor
13directory, you do:
14
15$ ./configure --enable-tor2web-mode
16$ make
17$ cp src/or/tor tor_binaries/tor-tor2web
18
19and then
20
21$ make clean
22$ ./configure
23$ make
24$ cp src/or/tor tor_binaries/tor-vanilla
25
26Now, start up 'tor-vanilla' using torrc 'torrc-rp' (see below) and let
27it bootstrap as a relay. You can do this like this:
28$ ./tor_binaries/tor-vanilla -f ./torrc-rp
29
30Let the RP simmer for two hours or so till it appears in the next
31consensus. Now, check its logs and find the line that references its
32identity fingerprint (in this case a bunch of "X"s):
33
34         Sep 15 16:43:37.000 [notice] Your Tor server's identity key fingerprint is 'Tor2WebRP XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
35
36Save that fingerprint, and write it in 'torrc-tor2web' in the
37Tor2webRendezvousPoints line.
38
39Now start up 'tor-tor2web using torrc 'torrc-tor2web':
40$ ./tor_binaries/tor-tor2web -f ./torrc-tor2web
41and tor2web should work again! All HS circuits should now go through
42your RP.
43
44To test that it actually works as intended, check your info-level
45logfile for lines that look like this:
46[info] choose_good_exit_server(): Picked new RP: $XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX~Tor2WebRP at <ip address>
47
48I now inline two sample torrc. You will need to modify them a bit to
49suit your needs. For example, you will need to specify the SocksPort
50that tor2web expects in torrc-tor2web. You will also want to change
51the paths to DataDirectory and Log.
52
53Hope it works for you :)
54
55===== torrc-tor2web
56ORPort 0
57
58DataDirectory /home/f/virgl_test/tor_tor2web/tor_data
59
60Tor2webMode 1
61Tor2webRendezvousPoints XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
62SocksPort 8888
63
64Log info file /home/f/virgl_test/tor_tor2web/info.log
65Log notice stdout
66=====
67
68===== torrc-rp
69SocksPort 0
70
71ORPort 6969
72DirPort 9696
73ExitPolicy reject *:*
74Nickname Tor2WebRP
75
76DataDirectory /home/f/virgl_test/tor_rp/tor_data
77
78Log info file /home/f/virgl_test/tor_rp/info.log
79Log notice stdout
80=====
81