mirror of
https://gitlab.torproject.org/tpo/core/tor.git
synced 2024-11-20 10:12:15 +01:00
add a tor-doc-unix file for installing a tor client on linux/bsd/unix/etc
svn:r4791
This commit is contained in:
Roger Dingledine
parent
5e76bac1dd
commit
61023e74c5
201
doc/tor-doc-unix.html
Normal file
201
doc/tor-doc-unix.html
Normal file
@ -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>
|
||||
|
||||
Loading…
Reference in New Issue
Block a user