tor-webwml.git

1) ## translation metadata
2) # Revision: $Revision$
3) # Translation-Priority: 4-optional
4) 
5) #include "head.wmi" TITLE="obfsproxy: Installation instructions" CHARSET="UTF-8"
6) 
7) <div id="content" class="clearfix">
8)   <div id="breadcrumbs">
9)     <a href="<page index>">Home &raquo; </a>
10)     <a href="<page projects/projects>">Projects &raquo; </a>
11)     <a href="<page projects/obfsproxy>">obfsproxy</a>
12)   </div>
13)   <div id="maincol">
14) 
15)     <!-- PUT CONTENT AFTER THIS TAG -->
16) 

17)     <h1 id="instructions">Obfsproxy Instructions</h1>

18) 

19)     <h3>Step 1: Install dependencies, obfsproxy, and Tor</h3>

20)     <br>
21) 
22)     <p>
23)     You will need a C compiler (<em>gcc</em>), the <em>Autotools</em>
24)     build system, the <em>git</em> revision control system,
25)     <em>libevent-2</em> and the development headers of
26)     <em>OpenSSL</em>.
27)      </p>
28) 
29)     <p>
30)     In a Linux system using the APT package manager you could do: <br>
31)     <tt># apt-get install autotools gcc git libevent-2.0-5 libevent-openssl-2.0-5 libssl-dev</tt>
32)     </p>
33) 
34)     <p>
35)     Clone obfsproxy from its git repository:<br>

36)     <tt>$ git clone https://git.torproject.org/obfsproxy.git</tt> <br>

37) 
38)     The above command should create and populate a directory named
39)     'obfsproxy' in your current directory.  </p>
40) 
41)     <p>
42)     Compile obfsproxy: <br>
43)     <tt>$ cd obfsproxy</tt> <br>
44)     <tt>$ ./autogen.sh && ./configure && make</tt> <br>
45)     </p>
46) 
47)     <p>
48)     And then <strong>as root</strong> install obfsproxy in your system: <br>
49)     <tt># make install</tt>
50)     </p>
51) 
52)     <p>

53)     You will need Tor 0.2.3.11-alpha or later.

54)     </p>
55) 

56)     <hr>

57) 

58)     <h3 id="client_instructions">Step 2a: If you're the client...</h3>

59)     <br>
60) 
61)     <p>

62)     Set up your Tor configuration file:<br><br>

63)     <img src="$(IMGROOT)/obfs-torrc_client.png" alt="client torrc"></a>
64)     </p>
65) 
66)     <p>

67)     Launch Tor using this configuration file. You can do this by using
68)     your favorite init script, or by pointing the Tor binary to the
69)     torrc file:

70)     </p>
71) 
72)     <img src="$(IMGROOT)/obfs-spawn_tor_client.png" alt="spawn tor" height="101" width="882">
73) 
74)     <p> <br>
75)     <img src="$(IMGROOT)/sidenav-arrow.png">
76)     <strong>Congratulations!</strong> Your traffic should now be
77)     obfuscated by obfsproxy. You are done! You can now start using Tor.
78)     </p>
79) 
80)     <br> <br> <br> <br>
81) 
82)     <hr>
83) 
84)     <br> <br> <br> <br>
85) 

86)     <h3 id="bridge_instructions">Step 2b: If you're the bridge...</h3>

87)     <br>
88) 
89)     <p>

90)     Set up your Tor configuration file:<br><br>

91)     <img src="$(IMGROOT)/obfs-torrc_bridge.png" alt="bridge torrc"></a>
92)     </p>
93) 
94)     <p>

95)     Launch Tor using this configuration file. You can do this by using
96)     your favorite init script, or by pointing the Tor binary to the
97)     torrc file:

98)     <p>
99) 
100)     <p>
101)     <img src="$(IMGROOT)/obfs-spawn_tor_bridge.png" alt="spawn tor" height="101" width="882"></a>
102)     </p>
103) 
104)     <p>

105)     Next, Find the TCP port opened by obfsproxy. Look in your log file
106)     for a line similar to this one: <br>

107)     <img src="$(IMGROOT)/obfs-log_checking.png" alt="bridge torrc" width="437" height="14"></a>
108)     <br>
109)     The last number, in this case <em>34545</em>, is the TCP port
110)     number that your clients should point their obfsproxy to.
111)     </p>
112) 
113)     <p>
114)     <img src="$(IMGROOT)/sidenav-arrow.png">
115)     <strong>Congratulations!</strong> Tell your clients to point their

116)     obfsproxy to your IP address and to port <em>34545</em>.