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)     <h3>Step 1: Install dependencies, obfsproxy, and Tor</h3>

22)     <br>
23) 
24)     <p>
25)     You will need a C compiler (<em>gcc</em>), the <em>Autotools</em>
26)     build system, the <em>git</em> revision control system,
27)     <em>libevent-2</em> and the development headers of
28)     <em>OpenSSL</em>.
29)      </p>
30) 
31)     <p>
32)     In a Linux system using the APT package manager you could do: <br>

33)     <tt># apt-get install autotools-dev gcc git libevent-2.0-5 libevent-openssl-2.0-5 libssl-dev</tt>

34)     </p>
35) 
36)     <p>
37)     Clone obfsproxy from its git repository:<br>

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

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

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

56)     </p>
57) 

58)     <hr>

59) 

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

61)     <br>
62) 
63)     <p>

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

68)     </p>
69) 

70)     <p>
71)     <tt> UseBridges 1 </tt> <br>

72)     <tt> Bridge obfs2 128.31.0.34:1051 </tt> <br>

73)     <tt> ClientTransportPlugin obfs2 exec /usr/local/bin/obfsproxy --managed </tt>
74)     </p>
75) 
76)     <p>

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

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

79)     </p>
80) 
81)     <p> <br>
82)     <img src="$(IMGROOT)/sidenav-arrow.png">
83)     <strong>Congratulations!</strong> Your traffic should now be
84)     obfuscated by obfsproxy. You are done! You can now start using Tor.
85)     </p>
86) 
87)     <br> <br> <br> <br>
88) 
89)     <hr>
90) 
91)     <br> <br> <br> <br>
92) 

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

94)     <br>
95) 
96)     <p>

97)     Add the appropriate lines to your <a href="<page docs/faq>#torrc">tor
98)     configuration file</a>:

99)     </p>
100) 
101)     <p>

102)     <tt> ORPort 9001 </tt> <br>

103)     <tt> BridgeRelay 1 </tt> <br>
104)     <tt> ServerTransportPlugin obfs2 exec /usr/local/bin/obfsproxy --managed </tt>

105)     </p>
106) 
107)     <p>

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

111)     <p>
112) 
113)     <p>

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

115)     </p>
116) 
117)     <p>

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

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

120)     <img src="$(IMGROOT)/obfs-log_checking.png" alt="bridge torrc" width="437" height="14"></a>
121)     <br>
122)     The last number, in this case <em>34545</em>, is the TCP port
123)     number that your clients should point their obfsproxy to.
124)     </p>
125) 
126)     <p>
127)     <img src="$(IMGROOT)/sidenav-arrow.png">
128)     <strong>Congratulations!</strong> Tell your clients to point their

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