doc/tor-switchproxy.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
   2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
   3
   4 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
   5 <head>
   6   <title>Tor SwitchProxy Install Instructions</title>
   7   <meta name="Author" content="Roger Dingledine" />
   8   <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
   9   <link rel="stylesheet" type="text/css" href="stylesheet.css" />
  10   <link rel="shortcut icon" type="image/x-icon" href="/favicon.ico" />
  11 </head>
  12
  13 <body>
  14
  15 <!-- TITLE BAR & NAVIGATION -->
  16
  17 <table class="banner" border="0" cellpadding="0" cellspacing="0">
  18     <tr>
  19         <td class="banner-left"></td>
  20         <td class="banner-middle">
  21 <a href="/">Home</a>
  22 <a href="/overview">Overview</a>
  23 <a href="/download">Download</a>
  24 <a href="/documentation">Docs</a>
  25 <a href="/volunteer">Volunteer</a>
  26 <a href="/people">People</a>
  27 <a href="/donate">Donate!</a>
  28         </td>
  29         <td class="banner-right"></td>
  30     </tr>
  31 </table>
  32
  33 <!-- END TITLE BAR & NAVIGATION -->
  34
  35 <div class="center">
  36
  37 <div class="main-column">
  38
  39 <h1>Installing SwitchProxy for <a href="http://tor.eff.org/">Tor</a></h1>
  40 <hr />
  41
  42 <p>
  43 SwitchProxy is a Firefox plugin that makes it easy for you to switch
  44 between using a proxy and connecting to websites directly.</p>
  45
  46 <p>In this howto, you'll set up SwitchProxy to let you change
  47 between using Tor and a direct connection. We assume you already
  48 have Firefox installed and working.</p>
  49
  50 <p>The screenshots here are oriented towards Windows users, but
  51 SwitchProxy works anywhere Firefox works. Hopefully everybody else can
  52 follow along just fine.</p>
  53
  54 <hr />
  55 <a id="zero"></a>
  56 <h2><a class="anchor" href="#zero">Step Zero: Download and Install Tor and Privoxy</a></h2>
  57 <br />
  58
  59 <p>Before you start, you need to make sure 1) Tor is up and running,
  60 2) Privoxy is up and running, and 3) Privoxy is configured to point
  61 to Tor.</p>
  62
  63 <p>Windows users need to do <a
  64 href="http://tor.eff.org/doc/tor-doc-win32.html#installing">step one</a>
  65 of the Windows Tor installation howto, and Mac OS X users need to do <a
  66 href="http://tor.eff.org/doc/tor-doc-osx.html#installing">step one</a>
  67 of OS X Tor installation howto, since our Win32 and OS X packages include
  68 Privoxy and configure it already. Linux/BSD/Unix users should do <a
  69 href="http://tor.eff.org/doc/tor-doc-unix.html#installing">step one</a>
  70 and <a href="http://tor.eff.org/doc/tor-doc-unix.html#privoxy">step
  71 two</a> of the Unix Tor installation howto.
  72 </p>
  73
  74 <hr />
  75 <a id="one"></a>
  76 <h2><a class="anchor" href="#one">Step One: Download and Install SwitchProxy</a></h2>
  77 <br />
  78
  79 <p>SwitchProxy is a Firefox plugin, so you need to go through
  80 the process of installing a new plugin. First, go to the <a
  81 href="https://addons.mozilla.org/extensions/moreinfo.php?application=firefox&id=125">
  82 SwitchProxy</a> web page. If you're using Firefox 1.5, you might need to
  83 download SwitchProxy <a href="http://www.roundtwo.com/product/switchproxy">from
  84 here</a> instead.
  85 Turn on JavaScript for now and click "Install Now":</p>
  86
  87 <img alt="switchproxy web page"
  88 src="http://tor.eff.org/img/screenshot-switchproxy-webpage.jpg" />
  89
  90 <p>It will pop up a window asking for permission to install the plugin.
  91 Click on the "Install Now" button:
  92 </p>
  93
  94 <img alt="firefox plugin warning"
  95 src="http://tor.eff.org/img/screenshot-switchproxy-plugin-starting.jpg" />
  96
  97 <p>Once the installer is finished, you should close all of your Firefox
  98 windows and restart Firefox.</p>
  99
 100 <img alt="firefox plugin finished"
 101 src="http://tor.eff.org/img/screenshot-switchproxy-plugin-finished.jpg" />
 102
 103 <hr />
 104 <a id="two"></a>
 105 <h2><a class="anchor" href="#two">Step Two: Configure SwitchProxy</a></h2>
 106 <br />
 107
 108 <p>When you restart Firefox, you'll notice there's a new toolbar
 109 that lets you control your proxies. Now we're going to set up a proxy
 110 configuration for Tor. Click on "Add" in the new Proxy toolbar:</p>
 111
 112 <img alt="new toolbar"
 113 src="http://tor.eff.org/img/screenshot-switchproxy-toolbar.jpg" />
 114
 115 <p>It will ask you to select a proxy type. Choose
 116 "Standard." (There's also an "anonymous" proxy type that
 117 uses an ad hoc set of anonymous proxies out there. You
 118 don't want this, because those other "anonymous" proxies <a
 119 href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#ComparisonProxyAggregators">give
 120 you much weaker security than Tor</a>.)
 121 </p>
 122
 123 <img alt="standard proxy"
 124 src="http://tor.eff.org/img/screenshot-switchproxy-proxytype.jpg" />
 125
 126 <p>Now it will show you the standard proxy config window for Firefox.
 127 Give this configuration a proxy label of "tor". Then fill in "localhost"
 128 and "8118" for all four entries, as shown here. (Even
 129 though Privoxy doesn't support FTP and Gopher, <a
 130 href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#FtpProxy">you
 131 should set them up anyway</a>.) Then click "OK":</p>
 132
 133 <img alt="proxy config"
 134 src="http://tor.eff.org/img/screenshot-switchproxy-proxyconfig.jpg" />
 135
 136 <p>Now you've created the "tor" proxy label, but you're not using it yet.
 137 Click on the pull-down list and select tor, as shown here:</p>
 138
 139 <img alt="switch to tor"
 140 src="http://tor.eff.org/img/screenshot-switchproxy-switch.jpg" />
 141
 142 <p>Almost done. Click "Apply" to make your change take effect:</p>
 143
 144 <img alt="apply"
 145 src="http://tor.eff.org/img/screenshot-switchproxy-apply.jpg" />
 146
 147 <p>Done! Firefox will reload your current page. In
 148 this example screenshot, it reloaded the page and <a
 149 href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#GoogleLanguage">happened
 150 to get a German exit node</a>:</p>
 151
 152 <img alt="german google"
 153 src="http://tor.eff.org/img/screenshot-switchproxy-german.jpg" />
 154
 155 <hr />
 156 <a id="three"></a>
 157 <h2><a class="anchor" href="#three">Step Step Three: Check if it works</a></h2>
 158 <br />
 159
 160 <p>Now Firefox is using Privoxy as an HTTP proxy, Privoxy is using Tor as
 161 a socks4a proxy, and Tor is making your connections to the Internet.</p>
 162
 163 <p>In the above example, it was clear that it worked because the web
 164 page showed up in a different language. In other cases, though,
 165 you'll want to verify that your setup is working. Do
 166 <a href="http://tor.eff.org/doc/tor-doc-win32.html#verify">step three</a>
 167 of the Windows Tor installation howto, or
 168 <a href="http://tor.eff.org/doc/tor-doc-osx.html#verify">step three</a>
 169 of the OS X Tor installation howto.</p>
 170
 171 <p>You should be aware of one anonymity gotcha: when you switch from
 172 using Tor to a direct connection (or vice versa), by default the page
 173 that's currently active will be reloaded through the new proxy setting.
 174 So make sure you're on a page that isn't sensitive, before switching.
 175 (You can also change this behavior in SwitchProxy's "Options |
 176 Preferences" menu.)</p>
 177
 178 <hr />
 179
 180 <p>If you have suggestions for improving this document, please <a
 181 href="/contact">send them to us</a>. Thanks!</p>
 182
 183   </div><!-- #main -->
 184 </div>
 185   <div class="bottom" id="bottom">
 186      <i><a href="/contact"
 187      class="smalllink">Webmaster</a></i> - $Id$
 188   </div>
 189 </body>
 190 </html>
 191