tor-tb-manual.git

@@ -0,0 +1,152 @@

+

+<page xmlns="http://projectmallard.org/1.0/"

+  type="topic"

+  id="bridges">

+

+<info>

+  <desc>What bridges are and how to use them.</desc>

+  <title type='sort'>04 Bridges</title>

+  <link type="guide" xref="index" />

+</info>

+

+<title>Bridges</title>

+

+<p>

+Bridges are quiet gateways into the Tor Network. Like Tor relays, they are run

+by volunteers. Unlike relays, they are not listed publicly. Using bridges

+disguise the fact that one is using Tor.  

+</p>

+

+<p>

+Currently there are five bridge types, or transports, available. More are 

+being developed. 

+</p>

+<table frame='all' rules='all'>

+  <tr>

+    <td>

+      <p>

+      ORPort

+      </p>

+    </td>

+    <td>

+      <p>

+      Requesting 'bridges' without specifying the bridge type, will return 

+      ORPort bridges, also called Vanilla bridges. ORPort bridges are NOT 

+      reliable for circumventing censorship or national firewalls. ORPort 

+      bridges can be useful as trusted entry points into the Tor network. 

+      </p>

+    </td>

+  </tr>

+  <tr>

+    <td>

+      <p>

+      obfs2

+      </p> 

+    </td>

+    <td>

+      <p>

+      Censors have learned how to identify obfs2 bridges. This transport 

+      is being deprecated.

+      </p>

+    </td>

+  </tr>

+  <tr>

+    <td>

+      <p>

+      obfs3

+      </p>

+    </td>

+    <td>

+      <p>

+      Obfsproxy disguises Tor traffic as random noise. obfs3 bridges work 

+      almost everywhere. A few obfs3 bridges have been blocked. 

+      </p>

+    </td>

+  </tr>

+  <tr>

+    <td>

+      <p>

+      Scramblesuit

+      </p>

+    </td>

+    <td>

+      <p>

+      Scramblesuit is an additional tool for the obfsproxy transport. 

+      Scramblesuit bridges are designed to be hard to identify and hard to 

+      block. 

+      </p>

+    </td>

+  </tr>

+  <tr>

+    <td>

+      <p>

+      FTE

+      </p>

+    </td>

+    <td>

+      <p>

+      Format-Transforming Encryption disguises Tor traffic as web (HTTP) 

+      traffic or other types of internet traffic. FTE bridges are 

+      effective, but in limited supply. 

+      </p>

+    </td>

+  </tr>

+</table>

+

+<p>

+(Note that flashproxy is a Pluggable Transport, but does not rely on bridges.)

+</p>

+

+<p>

+There are four ways to get a bridge. 

+</p>

+

+<steps>

+  <item>

+    <p>

+    Visit <link href='https://bridges.torproject.org/'>https://bridges.torproject.org/</link> and follow the instructions.

+    </p>

+  </item>

+  <item>

+    <p>

+    Email bridges@bridges.torproject.org from a gmail or yahoo 

+    email address. Put <cmd>get bridges</cmd> in the body for ORPort bridges 

+    or <cmd>transport=obfs3</cmd> for obfs3 bridges. 

+    </p>

+  </item>

+  <item>

+    <p>

+    Politely ask a human at help@rt.torproject.org if you cannot access 

+    either of the first two methods. 

+    </p>

+  </item>

+  <item>

+    <p>

+    Install and configure a Tor instance to be bridge  

+    for yourself. The computer acting as a bridge must have uncensored internet 

+    access to the Tor network. A full installation guide can be found at

+    <link href='https://www.torproject.org/projects/obfsproxy-debian-instructions.html.en'>https://www.torproject.org/projects/obfsproxy-debian-instructions.html.en</link>

+    </p>

+  </item>

+</steps>

+

+<p>

+Enter the bridge information you get from any of the above steps in 

+Tor-launcher.

+</p>

+

+<p>

+Choose yes when asked if your Internet Service Provider blocks connections to 

+the Tor network. Select 'Use custom bridges' and enter each bridge identifier 

+on its own line.

+</p>

+

+<media type="image" src="imgs/tor-launcher-custom-bridges_en-US.png" />

+

+<p>

+Click Connect. Using bridges slow down the connection. If the connection fails,

+the bridges you received may be down. Get more and try again. 

+</p>

+

+</page>

+

@@ -0,0 +1,46 @@

+

+<page xmlns="http://projectmallard.org/1.0/"

+  type="topic"

+  id="circumvention">

+

+<info>

+  <title type='sort'>03 Circumvention</title>

+  <desc>What to do if the Tor network is blocked.</desc>

+  <link type="guide" xref="index" />

+</info>

+

+<title>Circumvention</title>

+

+<p>

+Some firewalls can detect and block connections to Tor. The Tor Browser 

+includes some circumvention tools for getting around blocking firewalls. 

+These circumvention tools are called Pluggable Transports. To turn them on, 

+click "Configure" in the Tor launcher window. 

+</p>

+

+<media type="image" src="imgs/tor-launcher-configure_en-US.png" />

+

+<p>

+Select yes when asked if your internet service provider blocks connections 

+to Tor." 

+</p>

+

+<media type="image" src="imgs/tor-launcher-wizard_en-US.png" />

+

+<p>

+Select "Connect with provided bridges". Tor Browser has three Pluggable 

+Transports to choose from. If one fails to get you online, try selecting a 

+different transport. 

+</p>

+

+<media type="image" src="imgs/tor-launcher-provided-bridges_en-US.png" />

+

+<p>

+If you try all three transports, and none of them get you online, select 

+"Enter custom bridges", and enter bridges manually. Read the <link 

+xref='bridges'>Getting Bridges</link> section for instructions on getting 

+custom bridges. 

+</p>

+

+</page>

+

@@ -0,0 +1,38 @@

+<page xmlns="http://projectmallard.org/1.0/"

+      type="topic"

+      id="how-tor-works">

+

+  <info>

+    <title type='sort'>01 Tor</title>

+    <desc>How Tor works.</desc>

+    <link type="guide" xref="index"/>

+  </info>

+

+  <title>Tor</title>

+  <p>

+    Tor is a network of virtual tunnels that allows you to improve your

+    privacy and security on the Internet. Tor works by sending your

+    traffic through three random servers (also known as <em>relays</em>)

+    in the Tor network, before the traffic is sent out onto the public

+    Internet

+  </p>

+  <media type="image" src="imgs/how-tor-works.png" />

+  <p>

+    The image above illustrates a user browsing to different websites

+    over Tor. The green monitors represent relays in the Tor network,

+    while the three keys represent the layers of encryption between the

+    user and each relay.

+  </p>

+  <p>

+    Tor will anonymize the origin of your traffic, and it will encrypt

+    everything between you and the Tor network. Tor will also encrypt

+    your traffic inside the Tor network, but it cannot encrypt your

+    traffic between the Tor network and its final destination.

+  </p>

+  <p>

+    If you are communicating sensitive information, for example when

+    logging on to a website with a username and password, make sure that

+    you are using HTTPS (e.g.  <input><em>https</em>://torproject.org/</input>,

+    not <input><em>http</em>://torproject.org/</input>).

+  </p>

+</page>

@@ -0,0 +1,6 @@

+<page xmlns="http://projectmallard.org/1.0/"

+type="guide"

+id="index">

+<title>Tor Browser Help</title>

+</page>

+

@@ -0,0 +1,55 @@

+

+<page xmlns="http://projectmallard.org/1.0/"

+  type="topic"

+  id="troubleshooting">

+

+<info>

+  <title type="sort">02 Troubleshooting</title>

+  <desc>What to do if Tor Browser doesn't work.</desc>

+  <link type="guide" xref="index"/>

+</info>

+

+<title>Troubleshooting</title>

+

+<p>

+The Tor Browser should get you online automatically after clicking the 

+"Connect" button on the start up screen. 

+</p>

+

+<media type="image" src="imgs/tor-launcher-connect_en-US.png" />

+

+<p>

+If it doesn't connect, there may be a simple fix. Try each of the following: 

+</p>

+

+<list>

+  <item>

+    <p>Make sure another Tor Browser is not already running. If you're 

+       not sure if Tor Browser is running, restart your computer.</p>

+  </item>

+  <item>

+    <p>'Allow' Tor in your antivirus program.</p>

+  </item>

+  <item>

+    <p>Temporarily disable your firewall.</p>

+  </item>

+  <item>

+    <p>Delete Tor Browser and install it again. If updating, do not overwrite 

+       your previous Tor Browser files.</p>

+  </item>

+</list>

+

+<p>

+If you still can't connect, your internet service provider might be censoring 

+connections to Tor. Follow the instructions in the <link 

+xref='circumvention'>Circumvention</link> section.

+</p>

+

+<p>

+If the above steps do not address your problem, email help@rt.torproject.org 

+with your operating system, the details of your problem, and what you've 

+already tried.

+</p>

+

+</page>

+

@@ -0,0 +1,41 @@

+

+<page xmlns="http://projectmallard.org/1.0/"

+  type="topic"

+  id="uninstalling">

+

+<info>

+  <desc>How to remove Tor Browser from your system.</desc>

+  <title type='sort'>05 Uninstalling</title>

+  <link type="guide" xref="index"/>

+</info>

+

+<title>Uninstalling</title>

+

+<p>

+The Tor Browser does not affect any of the existing software 

+or settings on your computer. Uninstalling Tor Browser will not affect your 

+system's software or settings either.  

+</p>

+

+<p>

+Removing the Tor Browser from your system is simple:

+</p>

+

+<steps>

+  <item>

+    <p>Locate your Tor Browser folder. The default location is your Desktop.</p>

+ </item>

+  <item>

+    <p>Delete the Tor Browser folder.</p>

+  </item>

+  <item>

+    <p>Empty your Trash</p>

+  </item>

+</steps>

+

+<p>

+Note that your operating system's standard "Uninstall" utility is not used.

+</p>

+

+</page>

+