[tor-commits] r25863: {website} Add instructions for setting up obfsbridges on Debianoids. (in website/trunk: . projects/en)
George Kadianakis
asn at torproject.org
Tue Nov 6 22:39:22 UTC 2012
Author: asn
Date: 2012-11-06 22:39:22 +0000 (Tue, 06 Nov 2012)
New Revision: 25863
Added:
website/trunk/projects/en/obfsproxy-debian-instructions.wml
Modified:
website/trunk/.gitignore
website/trunk/projects/en/obfsproxy-instructions.wml
Log:
Add instructions for setting up obfsbridges on Debianoids.
Modified: website/trunk/.gitignore
===================================================================
--- website/trunk/.gitignore 2012-11-06 22:36:54 UTC (rev 25862)
+++ website/trunk/.gitignore 2012-11-06 22:39:22 UTC (rev 25863)
@@ -67,6 +67,7 @@
press/press.html.en
projects/arm.html.en
projects/gettor.html.en
+projects/obfsproxy-debian-instructions.html.en
projects/obfsproxy-instructions.html.en
projects/obfsproxy.html.en
projects/projects.html.en
Added: website/trunk/projects/en/obfsproxy-debian-instructions.wml
===================================================================
--- website/trunk/projects/en/obfsproxy-debian-instructions.wml (rev 0)
+++ website/trunk/projects/en/obfsproxy-debian-instructions.wml 2012-11-06 22:39:22 UTC (rev 25863)
@@ -0,0 +1,149 @@
+## translation metadata
+# Revision: $Revision$
+# Translation-Priority: 4-optional
+
+#include "head.wmi" TITLE="obfsproxy: Installation instructions" CHARSET="UTF-8"
+
+<div id="content" class="clearfix">
+ <div id="breadcrumbs">
+ <a href="<page index>">Home » </a>
+ <a href="<page projects/projects>">Projects » </a>
+ <a href="<page projects/obfsproxy>">obfsproxy</a>
+ </div>
+ <div id="maincol">
+
+ <!-- PUT CONTENT AFTER THIS TAG -->
+
+ <h1 id="instructions">Obfsproxy Bridge Instructions on Debian/Ubuntu</h1>
+
+ <img src="$(IMGROOT)/obfsproxy_diagram.png" alt="obfsproxy diagram"></a>
+
+ <p>
+ This guide will help you setup an obfuscated bridge on a Debian/Ubuntu system.
+ </p>
+
+ <h3>Step 0: Add Tor repositories to APT</h3>
+ <br>
+
+ <p>
+ You need
+ to <a href="https://www.torproject.org/docs/debian#development">install
+ the experimental official Tor Project APT repositories</a>,
+ because a fresh version of Tor (0.2.4.x) is required (Older
+ versions of Tor don't report their bridge addresses to BridgeDB).
+ </p>
+
+ <h3>Step 1: Install Tor and obfsproxy</h3>
+ <br>
+
+ <p>
+ Now install tor and obfsproxy:
+ </p>
+
+ <pre style="margin: 1.5em 0 1.5em 2em">
+\# apt-get update
+\# apt-get install obfsproxy tor
+ </pre>
+
+ <p>
+ Note that obfsproxy requires
+ libevent2 and your distribution (e.g. Debian stable) might not
+ have it in its repos. You can
+ <a href="https://trac.torproject.org/projects/tor/ticket/5009#comment:9">try
+ our experimental backport libevent2 debs</a>,
+ or <a href="https://trac.torproject.org/projects/tor/ticket/5009#comment:17">build
+ libevent2 from source</a>.
+ </p>
+
+ <h3>Step 2: Set up Tor</h3>
+ <br>
+
+ <p>
+ You will need an appropriate
+ Tor <a href="<page docs/faq>#torrc">configuration file</a>
+ (usually at <i>/etc/tor/torrc</i>):
+ </p>
+
+ <pre style="margin: 1.5em 0 1.5em 2em">
+SocksPort 0
+ORPort auto
+BridgeRelay 1
+Exitpolicy reject *:*
+
+\## CHANGEME_1 -> provide a nickname for your bridge, can be anything you like.
+Nickname CHANGEME_1
+\## CHANGEME_2 -> If you want others to be able to contact you uncomment this line and put your GPG fingerprint for example.
+\#ContactInfo CHANGEME_2
+
+ServerTransportPlugin obfs2 exec /usr/bin/obfsproxy --managed
+ </pre>
+
+ <p>
+ Don't forget to edit the <i>CHANGEME</i> fields!
+ </p>
+
+ <h3>Step 3: Launch Tor and verify that it works</h3>
+ <br>
+
+ <p>
+ Restart Tor for the the new configuration file to be in effect:
+ </p>
+
+ <pre style="margin: 1.5em 0 1.5em 2em">
+service tor restart
+ </pre>
+
+ <p>
+ Now check <i>/var/log/tor/log</i> and you should see something
+ like this:
+ </p>
+
+ <pre style="margin: 1.5em 0 1.5em 2em">
+Nov 05 16:40:45.000 [notice] We now have enough directory information to build circuits.
+Nov 05 16:40:45.000 [notice] Bootstrapped 80%: Connecting to the Tor network.
+Nov 05 16:40:46.000 [notice] Bootstrapped 85%: Finishing handshake with first hop.
+Nov 05 16:40:46.000 [notice] Bootstrapped 90%: Establishing a Tor circuit.
+Nov 05 16:40:48.000 [notice] Tor has successfully opened a circuit. Looks like client functionality is working.
+Nov 05 16:40:48.000 [notice] Bootstrapped 100%: Done.
+ </pre>
+
+ <p>
+ If Tor is earlier in the bootstrapping phase, wait till it gets to
+ 100%.
+ </p>
+
+ <p>
+ Now you need to find the address on which obfsproxy is
+ listening. To do this, check your Tor logs for a line similar to
+ this one:
+
+ <pre style="margin: 1.5em 0 1.5em 2em">
+Oct 05 20:00:41.000 [notice] Registered server transport 'obfs2' at '0.0.0.0:26821
+ </pre>
+
+ <p>
+ The last number, in this case <i>26821</i>, is the TCP port number
+ that your clients should point their obfsproxy to. So for example,
+ if your public IP is 1.2.3.4, your clients should put <i>Bridge
+ obfs2 1.2.3.4:26821</i> in their configuration file.
+ </pre>
+ </p>
+
+ <p>
+ <img width="7%" height="7%" style="float: left;" src="$(IMGROOT)/icon-Obfsproxy.jpg">
+ <b>Don't forget!</b> If you are behind a NAT, you should <b>port
+ forward</b> the port that obfsproxy is listening on. In the
+ example above you would have to forward port <i>26821</i>.
+ </p>
+
+ </div>
+ <!-- END MAINCOL -->
+ <div id = "sidecol">
+#include "side.wmi"
+#include "info.wmi"
+ </div>
+ <!-- END SIDECOL -->
+</div>
+<!-- END CONTENT -->
+#include <foot.wmi>
+
Modified: website/trunk/projects/en/obfsproxy-instructions.wml
===================================================================
--- website/trunk/projects/en/obfsproxy-instructions.wml 2012-11-06 22:36:54 UTC (rev 25862)
+++ website/trunk/projects/en/obfsproxy-instructions.wml 2012-11-06 22:39:22 UTC (rev 25863)
@@ -18,6 +18,16 @@
<img src="$(IMGROOT)/obfsproxy_diagram.png" alt="client torrc"></a>
+ <p>
+ <img width="7%" height="7%" style="float: left;" src="$(IMGROOT)/icon-Obfsproxy.jpg">
+ <b> Hey! </b>
+ Are you looking for the guide on how to set up an obfuscated
+ bridge on a Debian system?
+ <a href="../projects/obfsproxy-debian-instructions.html.en">Check
+ this out</a>.
+ </p>
+ <br><br>
+
<h3>Step 1: Install dependencies, obfsproxy, and Tor</h3>
<br>
More information about the tor-commits
mailing list