add asn's first draft of obfsproxy webpage. i tweaked it some already.
Roger Dingledine commited on 2012-01-24 03:42:28
Zeige 2 geänderte Dateien mit 223 Einfügungen und 0 Löschungen.
- projects/en/obfsproxy-instructions.wml 000000000..7db1998b3
- projects/en/obfsproxy.wml 000000000..eb8bddd92
| ... | ... |
@@ -0,0 +1,154 @@ |
| 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 » </a> |
|
| 10 |
+ <a href="<page projects/projects>">Projects » </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">Instructions</h1> |
|
| 18 |
+ |
|
| 19 |
+ <h3>Step One: Install necessary dependencies</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 |
+ <h3>Step Two: Install obfsproxy</h3> |
|
| 35 |
+ <br> |
|
| 36 |
+ |
|
| 37 |
+ <p> |
|
| 38 |
+ Clone obfsproxy from its git repository:<br> |
|
| 39 |
+ <tt>$ git clone git://git.torproject.org/obfsproxy.git</tt> <br> |
|
| 40 |
+ |
|
| 41 |
+ The above command should create and populate a directory named |
|
| 42 |
+ 'obfsproxy' in your current directory. </p> |
|
| 43 |
+ |
|
| 44 |
+ <p> |
|
| 45 |
+ Compile obfsproxy: <br> |
|
| 46 |
+ <tt>$ cd obfsproxy</tt> <br> |
|
| 47 |
+ <tt>$ ./autogen.sh && ./configure && make</tt> <br> |
|
| 48 |
+ </p> |
|
| 49 |
+ |
|
| 50 |
+ <p> |
|
| 51 |
+ And then <strong>as root</strong> install obfsproxy in your system: <br> |
|
| 52 |
+ <tt># make install</tt> |
|
| 53 |
+ </p> |
|
| 54 |
+ |
|
| 55 |
+ <h3>Step Three: Install tor</h3> |
|
| 56 |
+ <br> |
|
| 57 |
+ |
|
| 58 |
+ <p> |
|
| 59 |
+ To follow this guide, you will need the current git master. |
|
| 60 |
+ |
|
| 61 |
+ </p> |
|
| 62 |
+ |
|
| 63 |
+ <p> |
|
| 64 |
+ <img align="left" |
|
| 65 |
+ style="margin-top:5px;margin-left:-10px;margin-right:5px" |
|
| 66 |
+ src="$(IMGROOT)/warning.png"> <strong>If you want to set up a Tor |
|
| 67 |
+ bridge with obfsproxy, click <a class="anchor" |
|
| 68 |
+ href="#bridge_instructions">here</a> for bridge instructions, |
|
| 69 |
+ otherwise continue to <a class="anchor" |
|
| 70 |
+ href="#client_instructions">step four.</a></strong> |
|
| 71 |
+ </p> |
|
| 72 |
+ |
|
| 73 |
+ <h3 id="client_instructions">Step Four (client): Configure tor</h3> |
|
| 74 |
+ <br> |
|
| 75 |
+ |
|
| 76 |
+ <p> |
|
| 77 |
+ Set up your tor configuration file:<br><br> |
|
| 78 |
+ <img src="$(IMGROOT)/obfs-torrc_client.png" alt="client torrc"></a> |
|
| 79 |
+ </p> |
|
| 80 |
+ |
|
| 81 |
+ <h3>Step Five (client): Launch tor</h3> |
|
| 82 |
+ <br> |
|
| 83 |
+ |
|
| 84 |
+ <p> |
|
| 85 |
+ Launch tor using the configuration file you made in the previous |
|
| 86 |
+ step. You can do this by using your favorite init script, or by |
|
| 87 |
+ pointing the tor binary to the torrc: |
|
| 88 |
+ </p> |
|
| 89 |
+ |
|
| 90 |
+ <img src="$(IMGROOT)/obfs-spawn_tor_client.png" alt="spawn tor" height="101" width="882"> |
|
| 91 |
+ |
|
| 92 |
+ <p> <br> |
|
| 93 |
+ <img src="$(IMGROOT)/sidenav-arrow.png"> |
|
| 94 |
+ <strong>Congratulations!</strong> Your traffic should now be |
|
| 95 |
+ obfuscated by obfsproxy. You are done! You can now start using Tor. |
|
| 96 |
+ </p> |
|
| 97 |
+ |
|
| 98 |
+ <br> <br> <br> <br> |
|
| 99 |
+ |
|
| 100 |
+ <hr> |
|
| 101 |
+ |
|
| 102 |
+ <br> <br> <br> <br> |
|
| 103 |
+ |
|
| 104 |
+ <h3 id="bridge_instructions">Step Four (bridge): Configure tor</h3> |
|
| 105 |
+ <br> |
|
| 106 |
+ |
|
| 107 |
+ <p> |
|
| 108 |
+ Set up your tor configuration file:<br><br> |
|
| 109 |
+ <img src="$(IMGROOT)/obfs-torrc_bridge.png" alt="bridge torrc"></a> |
|
| 110 |
+ </p> |
|
| 111 |
+ |
|
| 112 |
+ <h3>Step Five (bridge): Launch tor</h3> |
|
| 113 |
+ <br> |
|
| 114 |
+ |
|
| 115 |
+ <p> |
|
| 116 |
+ Launch tor using the configuration file you made in the previous |
|
| 117 |
+ step. You can do this by using your favorite init script, or by |
|
| 118 |
+ pointing the tor binary to the torrc: |
|
| 119 |
+ <p> |
|
| 120 |
+ |
|
| 121 |
+ <p> |
|
| 122 |
+ <img src="$(IMGROOT)/obfs-spawn_tor_bridge.png" alt="spawn tor" height="101" width="882"></a> |
|
| 123 |
+ </p> |
|
| 124 |
+ |
|
| 125 |
+ <h3>Step Six (bridge): Find the TCP ports opened by obfsproxy</h3> |
|
| 126 |
+ <br> |
|
| 127 |
+ |
|
| 128 |
+ <p> |
|
| 129 |
+ Look in your log file for a line similar to this one: <br> |
|
| 130 |
+ <img src="$(IMGROOT)/obfs-log_checking.png" alt="bridge torrc" width="437" height="14"></a> |
|
| 131 |
+ <br> |
|
| 132 |
+ The last number, in this case <em>34545</em>, is the TCP port |
|
| 133 |
+ number that your clients should point their obfsproxy to. |
|
| 134 |
+ </p> |
|
| 135 |
+ |
|
| 136 |
+ <p> |
|
| 137 |
+ <img src="$(IMGROOT)/sidenav-arrow.png"> |
|
| 138 |
+ <strong>Congratulations!</strong> Tell your clients to point their |
|
| 139 |
+ obfsproxy to your IP and to port <em>34545</em>. |
|
| 140 |
+ </p> |
|
| 141 |
+ |
|
| 142 |
+ <br> |
|
| 143 |
+ |
|
| 144 |
+ </div> |
|
| 145 |
+ <!-- END MAINCOL --> |
|
| 146 |
+ <div id = "sidecol"> |
|
| 147 |
+#include "side.wmi" |
|
| 148 |
+#include "info.wmi" |
|
| 149 |
+ </div> |
|
| 150 |
+ <!-- END SIDECOL --> |
|
| 151 |
+</div> |
|
| 152 |
+<!-- END CONTENT --> |
|
| 153 |
+#include <foot.wmi> |
|
| 154 |
+ |
| ... | ... |
@@ -0,0 +1,69 @@ |
| 1 |
+## translation metadata |
|
| 2 |
+# Revision: $Revision$ |
|
| 3 |
+# Translation-Priority: 4-optional |
|
| 4 |
+ |
|
| 5 |
+#include "head.wmi" TITLE="Tor Project: obfsproxy" CHARSET="UTF-8" |
|
| 6 |
+<div id="content" class="clearfix"> |
|
| 7 |
+ <div id="breadcrumbs"> |
|
| 8 |
+ <a href="<page index>">Home » </a> |
|
| 9 |
+ <a href="<page projects/projects>">Projects » </a> |
|
| 10 |
+ <a href="<page projects/obfsproxy>">obfsproxy » </a> |
|
| 11 |
+ </div> |
|
| 12 |
+ <div id="maincol"> |
|
| 13 |
+ <!-- PUT CONTENT AFTER THIS TAG --> |
|
| 14 |
+ |
|
| 15 |
+ <h2>obfsproxy</h2> |
|
| 16 |
+ <div class="underline"></div> |
|
| 17 |
+ |
|
| 18 |
+ <!-- BEGIN SIDEBAR --> |
|
| 19 |
+ <div class="sidebar-left"> |
|
| 20 |
+ </div> |
|
| 21 |
+ <!-- END SIDEBAR --> |
|
| 22 |
+ |
|
| 23 |
+ <p> |
|
| 24 |
+ obfsproxy is a tool that attempts to circumvent censorship, by |
|
| 25 |
+ transforming the Tor traffic between the client and the |
|
| 26 |
+ bridge. This way, censors, who usually monitor traffic between the |
|
| 27 |
+ client and the bridge, will see innocent-looking transformed |
|
| 28 |
+ traffic instead of the actual Tor traffic. |
|
| 29 |
+ |
|
| 30 |
+ <img src="$(IMGROOT)/obfsproxy_diagram.png" alt="client torrc"></a> |
|
| 31 |
+ </p> |
|
| 32 |
+ |
|
| 33 |
+ <p> |
|
| 34 |
+ obfsproxy supports multiple protocols, called pluggable |
|
| 35 |
+ transports, which specify how the traffic is transformed. For |
|
| 36 |
+ example, there might be a HTTP transport which transforms Tor |
|
| 37 |
+ traffic to look like regular HTTP traffic. |
|
| 38 |
+ </p> |
|
| 39 |
+ |
|
| 40 |
+ <p> |
|
| 41 |
+ Even though obfsproxy is a separate application, completely |
|
| 42 |
+ independent from tor, it speaks to tor using an <a |
|
| 43 |
+ href="https://gitweb.torproject.org/torspec.git/blob/HEAD:/proposals/180-pluggable-transport.txt">internal |
|
| 44 |
+ protocol</a> in an attempt minimize necessary end-user |
|
| 45 |
+ configuration. |
|
| 46 |
+ </p> |
|
| 47 |
+ |
|
| 48 |
+ <h2><a class="anchor" href="<page projects/obfsproxy-instructions>#instructions">Installation Instructions</a></h2> |
|
| 49 |
+ |
|
| 50 |
+ <h2><a href="https://gitweb.torproject.org/obfsproxy.git">Download</a></h2> |
|
| 51 |
+ |
|
| 52 |
+ <p> |
|
| 53 |
+ Please open a <a |
|
| 54 |
+ href="https://trac.torproject.org/projects/tor/query?status=accepted&status=assigned&status=needs_information&status=needs_review&status=needs_revision&status=new&status=reopened&component=Pluggable+transport&order=priority&col=id&col=summary&col=status&col=type&col=priority&col=milestone&col=component">ticket</a> |
|
| 55 |
+ on our bug tracker for any bugs you find or features you would |
|
| 56 |
+ like to see added in future releases. |
|
| 57 |
+ </p> |
|
| 58 |
+ |
|
| 59 |
+ </div> |
|
| 60 |
+ <!-- END MAINCOL --> |
|
| 61 |
+ <div id = "sidecol"> |
|
| 62 |
+#include "side.wmi" |
|
| 63 |
+#include "info.wmi" |
|
| 64 |
+ </div> |
|
| 65 |
+ <!-- END SIDECOL --> |
|
| 66 |
+</div> |
|
| 67 |
+<!-- END CONTENT --> |
|
| 68 |
+#include <foot.wmi> |
|
| 69 |
+ |
|
| 0 | 70 |