diff options
| author | Roger Dingledine <arma@torproject.org> | 2005-08-17 00:03:45 +0000 |
|---|---|---|
| committer | Roger Dingledine <arma@torproject.org> | 2005-08-17 00:03:45 +0000 |
| commit | 61023e74c53e9bf96da4965e34557f4510a25c77 (patch) | |
| tree | cb54297dcffa5460b15902f728752dde72dc73e4 /doc/tor-doc-unix.html | |
| parent | 5e76bac1dd1daa0ed400613b7f77aecbaab7faff (diff) | |
| download | tor-61023e74c53e9bf96da4965e34557f4510a25c77.tar tor-61023e74c53e9bf96da4965e34557f4510a25c77.tar.gz | |
add a tor-doc-unix file for installing a tor client on linux/bsd/unix/etc
svn:r4791
Diffstat (limited to 'doc/tor-doc-unix.html')
| -rw-r--r-- | doc/tor-doc-unix.html | 201 |
1 files changed, 201 insertions, 0 deletions
diff --git a/doc/tor-doc-unix.html b/doc/tor-doc-unix.html new file mode 100644 index 000000000..9e8eec2a7 --- /dev/null +++ b/doc/tor-doc-unix.html @@ -0,0 +1,201 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" +"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"> + +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> +<head> + <title>Tor Linux/BSD/Unix Install Instructions</title> + <meta name="Author" content="Roger Dingledine" /> + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> + <link rel="stylesheet" type="text/css" href="http://tor.eff.org/stylesheet.css" /> + <link rel="shortcut icon" type="image/x-icon" href="/favicon.ico" /> +</head> + +<body> + +<!-- TITLE BAR & NAVIGATION --> + +<table class="banner" border="0" cellpadding="0" cellspacing="0"> + <tr> + <td class="banner-left"></td> + <td class="banner-middle"> + <a href="/index.html">Home</a> + | <a href="/howitworks.html">How It Works</a> + | <a href="/download.html">Download</a> + | <a href="/documentation.html">Docs</a> + | <a href="/users.html">Users</a> + | <a href="/faq.html">FAQs</a> + | <a href="/volunteer.html">Volunteer</a> + | <a href="/developers.html">Developers</a> + | <a href="/research.html">Research</a> + | <a href="/people.html">People</a> + </td> + <td class="banner-right"></td> + </tr> +</table> + +<!-- END TITLE BAR & NAVIGATION --> + +<div class="center"> + +<div class="main-column"> + +<h1>Running the <a href="http://tor.eff.org/">Tor</a> client on Linux/BSD/Unix</h1> +<br /> + +<p> +<b>Note that these are the installation instructions for running a Tor +client. +If you want to run a server (please do), read the "Configuring a server" section at +<a href="tor-doc.html#server">tor-doc.html</a>.</b> +</p> + +<hr /> +<a id="installing"></a> +<h2><a class="anchor" href="#installing">Step One: Download and Install Tor</a></h2> +<br /> + +<p> +The latest release of Tor can be found on the <a +href="download.html">download</a> page. We have packages for Debian, +Red Hat, Gentoo, *BSD, etc there too. +</p> + +<p>If you're building from source, run <tt>tar xzf tor-0.1.0.14.tar.gz; +cd tor-0.1.0.14</tt>. Then <tt>./configure && make</tt>. Now you +can run tor as <tt>src/or/tor</tt>, or you can run <tt>make install</tt> +(as root if necessary) to install it into /usr/local/, and then you can +start it just by running <tt>tor</tt>. +</p> + +<p>Tor comes configured as a client by default. It uses a built-in +default configuration file, and most people won't need to change any of +the settings. Tor is now installed. +</p> + +<hr /> +<a id="privoxy"></a> +<h2><a class="anchor" href="#privoxy">Step Two: Install Privoxy for Web Browsing</a></h2> +<br /> + +<p>After installing Tor, you need to configure your applications to use it. +</p> + +<p> +The first step is to set up web browsing. Start by installing <a +href="http://www.privoxy.org/">Privoxy</a>: click on 'recent releases' +and pick your favorite package or install from source. Privoxy is a +filtering web proxy that integrates well with Tor. +</p> + +<p>You need to configure Privoxy to use Tor. +Open Privoxy's "config" file (look in /etc/privoxy/ or /usr/local/etc/) +and add the line <br> +<tt>forward-socks4a / localhost:9050 .</tt><br> +to the top of the config file. Don't forget to add the dot at the end. +</p> + +<p>Privoxy keeps a log file of everything passed through it. In +order to stop this you will need to comment out two lines by inserting a +# before the line. The two lines are:<br> +<tt>logfile logfile</tt><br> +and the line <br> +<tt>jarfile jarfile</tt><br> +</p> + +<p>You'll need to restart Privoxy for the changes to take effect.</p> + +<hr /> +<a id="using"></a> +<h2><a class="anchor" href="#using">Step Three: Configure your applications to use Tor</a></h2> +<br /> + +<p>After installing Tor and Privoxy, you need to configure your +applications to use them. The first step is to set up web browsing.</p> + +<p>If you're using Firefox (we recommend it), check out our <a +href="tor-switchproxy.html">Tor SwitchProxy howto</a> to set up +a plugin that makes it easy to switch between using Tor and using a +direct connection.</p> + +<p>Otherwise, you need to manually configure your browser to HTTP proxy +at localhost port 8118. +(That's where Privoxy listens.) +In Mozilla, this is in Edit|Preferences|Advanced|Proxies. +In Opera 7.5x it's Tools|Preferences|Network|Proxy servers. +You should click the "use the same proxy server for all protocols" +button; but see <a +href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#FtpProxy">this +note</a> about Tor and ftp proxies. + +<p>Using privoxy is <strong>necessary</strong> because <a +href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#SOCKSAndDNS">browsers +leak your DNS requests when they use a SOCKS proxy directly</a>, which +is bad for your anonymity. Privoxy also removes certain dangerous +headers from your web requests, and blocks obnoxious ad sites like +Doubleclick.</p> + +<p>To Torify other applications that support HTTP proxies, just +point them at Privoxy (that is, localhost port 8118). To use SOCKS +directly (for instant messaging, Jabber, IRC, etc), you can point +your application directly at Tor (localhost port 9050), but see <a +href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#SOCKSAndDNS">this +FAQ entry</a> for why this may be dangerous. For applications +that support neither SOCKS nor HTTP, take a look at <a +href="http://tsocks.sourceforge.net/">tsocks</a> or <a +href="http://wiki.noreply.org/noreply/TheOnionRouter/TorifyHOWTO#socat">socat</a>. +</p> + +<p>For information on how to Torify other applications, check out the +<a href="http://wiki.noreply.org/wiki/TheOnionRouter/TorifyHOWTO">Torify +HOWTO</a>. +</p> + +<hr /> +<a id="verify"></a> +<h2><a class="anchor" href="#verify">Step Four: Make sure it's working</a></h2> +<br /> + +<p> +<a href="http://ipid.shat.net">ipid.shat.net</a> and +<a href="http://www.showmyip.com/">showmyip.com</a> +are sites that show what IP address and country you appear to be coming +from. +</p> + +<p>If you don't know your current public IP address, this may not be a +very useful test. To learn your IP address, run "<tt>ifconfig</tt>". +If you are behind a NAT or firewall, though, you won't be able +to learn your public IP address. In this case, you should 1) configure +your browser to connect directly (that is, stop using Privoxy), 2) check +your IP address with one of the sites above, 3) point your browser back +to Privoxy, and 4) see whether your IP address has changed. +</p> + +<p>If you have a personal firewall that limits your computer's +ability to connect to itself, be sure to allow connections from +your local applications to local port 8118 and port 9050. If +your firewall blocks outgoing connections, punch a hole so +it can connect to at least TCP ports 80 and 443, and then see <a +href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#FirewalledClient">this +FAQ entry</a>. +</p> + +<p>If it's still not working, look at <a +href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#ItDoesntWork">this +FAQ entry</a> for hints.</p> + +<hr /> + +<p>If you have suggestions for improving this document, please post +them on <a href="http://bugs.noreply.org/tor">our bugtracker</a> in the +website category. Thanks!</p> + + </div><!-- #main --> +</div> + <div class="bottom" id="bottom"> + <i><a href="mailto:tor-webmaster@freehaven.net" + class="smalllink">Webmaster</a></i> - $Id$ + </div> +</body> +</html> + |