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)     <img src="$(IMGROOT)/obfsproxy_diagram.png" alt="client torrc"></a>
20) 

21)     <p>
22)     <img width="7%" height="7%" style="float: left;" src="$(IMGROOT)/icon-Obfsproxy.jpg">
23)     <b> Hey! </b>
24)     Are you looking for the guide on how to set up an obfuscated
25)     bridge on a Debian system?
26)     <a href="../projects/obfsproxy-debian-instructions.html.en">Check
27)     this out</a>.
28)     </p>
29)     <br><br>
30) 

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

32)     <br>
33) 
34)     <p>

35)     You will need a C compiler (<em>gcc</em>), the <em>autoconf</em>
36)     and <em>autotools</em> build system, the <em>git</em> revision
37)     control system, <em>pkg-config</em> and <em>libtool</em>,
38)     <em>libevent-2</em> and its headers, and the development headers of

39)     <em>OpenSSL</em>.
40)      </p>
41) 
42)     <p>

43)     On Debian testing or Ubuntu oneiric, you could do: <br>
44)     <tt># apt-get install autoconf autotools-dev gcc git pkg-config libtool libevent-2.0-5 libevent-dev libevent-openssl-2.0-5 libssl-dev</tt>
45)     </p>
46) 

47)     <p>
48)     If you're on a more stable Linux, you can either <a

49)     href="https://trac.torproject.org/projects/tor/ticket/5009#comment:9">try

50)     our experimental backport libevent2 debs</a> or <a
51)     href="https://trac.torproject.org/projects/tor/ticket/5009#comment:17">build
52)     libevent2 from source</a>.

53)     </p>
54) 
55)     <p>
56)     Clone obfsproxy from its git repository:<br>

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

58) 
59)     The above command should create and populate a directory named

60)     'obfsproxy' in your current directory.
61)     </p>

62) 
63)     <p>
64)     Compile obfsproxy: <br>
65)     <tt>$ cd obfsproxy</tt> <br>
66)     <tt>$ ./autogen.sh && ./configure && make</tt> <br>
67)     </p>
68) 
69)     <p>

70)     Optionally, <strong>as root</strong> install obfsproxy in your
71)     system: <br>

72)     <tt># make install</tt>
73)     </p>
74) 

75)     <p>
76)     If you prefer not to install obfsproxy as root, you can instead
77)     just modify the Transport lines in your torrc file (explained below)
78)     to point to your obfsproxy binary.
79)     </p>
80) 

81)     <p>

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

83)     </p>
84) 

85)     <hr>

86) 

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

88)     <br>
89) 
90)     <p>

91)     First, you need to learn the address of a bridge that supports
92)     obfsproxy. If you don't know any, try asking a friend to set one
93)     up for you. Then the appropriate lines to your <a href="<page
94)     docs/faq>#torrc">tor configuration file</a>:

95)     </p>
96) 

97)     <p>

98)     <tt>UseBridges 1</tt> <br>
99)     <tt>Bridge obfs2 128.31.0.34:1051</tt> <br>
100)     <tt>ClientTransportPlugin obfs2 exec /usr/local/bin/obfsproxy --managed</tt>

101)     </p>
102) 
103)     <p>

104)     Don't forget to replace <em>128.31.0.34:1051</em> with the IP address

105)     and port that the bridge's obfsproxy is listening on.

106)     </p>
107) 
108)     <p> <br>
109)     <img src="$(IMGROOT)/sidenav-arrow.png">
110)     <strong>Congratulations!</strong> Your traffic should now be
111)     obfuscated by obfsproxy. You are done! You can now start using Tor.
112)     </p>
113) 
114)     <br> <br> <br> <br>
115) 
116)     <hr>
117) 
118)     <br> <br> <br> <br>
119) 

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

121)     <br>
122) 
123)     <p>

124)     Configure your Tor to <a href="<page docs/bridges>#RunningABridge">be
125)     a bridge</a> (e.g. by setting "ORPort 9001" and "BridgeRelay 1"). Then
126)     add this new line to your <a href="<page docs/faq>#torrc">tor

127)     configuration file</a>:

128)     </p>
129) 
130)     <p>

131)     <tt>ServerTransportPlugin obfs2 exec /usr/local/bin/obfsproxy --managed</tt>

132)     </p>
133) 
134)     <p>

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

138)     <p>
139) 
140)     <p>

141)     <img src="$(IMGROOT)/obfs-spawn_tor_bridge.png" alt="spawn tor" height="117" width="879"></a>

142)     </p>
143) 
144)     <p>

145)     Next, find the TCP port opened by obfsproxy. Look in your log file

146)     for a line similar to this one: <br>

147)     <img src="$(IMGROOT)/obfs-log_checking.png" alt="bridge torrc" width="437" height="14"></a>
148)     <br>
149)     The last number, in this case <em>34545</em>, is the TCP port
150)     number that your clients should point their obfsproxy to.
151)     </p>
152) 
153)     <p>
154)     <img src="$(IMGROOT)/sidenav-arrow.png">
155)     <strong>Congratulations!</strong> Tell your clients to point their

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