123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269 |
- <!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 Mac OS X Install Instructions</title>
- <meta name="Author" content="Roger Dingledine" />
- <meta name="Author" content="Thomas Hardly" />
- <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
- <link rel="stylesheet" type="text/css" href="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="/home">Home</a>
- <a href="/overview">Overview</a>
- <a href="/download">Download</a>
- <a href="/documentation">Docs</a>
- <a href="/volunteer">Volunteer</a>
- <a href="/people">People</a>
- <a href="/donate">Donate!</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 Mac OS X</h1>
- <br />
- <p>
- <b>Note that these are the installation instructions for running a Tor client on
- Mac OS X. If you want to relay traffic for others to help the network
- grow (please do), read the <a
- href="tor-doc-server.html">Configuring a server</a> guide.</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 stable and experimental releases of Tor for Macintosh
- OS X bundle <a href="http://tor.eff.org/">Tor</a> and <a
- href="http://www.privoxy.org">Privoxy</a> (a filtering web proxy)
- into one package, with Privoxy pre-configured to proxy through Tor.
- <a href="http://tor.eff.org/download">Download one from the download
- page</a>.
- </p>
- <p>Our Tor installer should make everything pretty simple. Below is a
- screenshot of the setup page:
- </p>
- <img alt="tor installer splash page"
- src="http://tor.eff.org/img/screenshot-osx-installer-splash.png"
- border="1">
- <p>
- By default, Tor is configured to run at startup. If you do not want Tor to
- run on startup, you can disable this by selecting "Customize" in the
- Installer, and then un-checking the "Tor Startup Script" box. Be sure to
- leave the other boxes checked.
- </p>
- <p>Once the installer is finished and your computer restarts, Tor will
- start automatically. Tor comes configured as a client by default. It
- uses a built-in default configuration file in <tt>/Library/Tor/torrc</tt>,
- but most people won't need to change any of the settings. Tor is now
- installed.</p>
- <p>Privoxy is installed as part of the Tor bundle package
- installer. Privoxy is a filtering web proxy that integrates well with
- Tor. Once it's installed, it will start automatically when your computer
- is restarted.
- </p>
- <p>You do not need to configure Privoxy to use Tor. A custom Privoxy
- configuration for Tor has been installed as part of the installer package.
- </p>
- <hr />
- <a id="using"></a>
- <h2><a class="anchor" href="#using">Step Two: 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 Mozilla|Preferences|Advanced|Proxies.
- You should set both your Web Proxy (HTTP) and your Secure Web Proxy
- (HTTPS or SSL) to localhost port 8118, to hide your SSL traffic too.
- You should consider configuring your "FTP Proxy" too; see <a
- href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#FtpProxy">this
- note</a> about Tor and ftp proxies.
- </p>
- <p>If you want to use Tor with Safari, you need to change your
- Network Settings. Select your Network Preferences from the Apple |
- Location menu:</p>
- <img alt="Network settings"
- src="http://tor.eff.org/img/screenshot-osx-choose-network.png"
- border="1">
- <p>Select the Network Interface on which you want to enable Tor. If you use
- more than one Interface you must change the proxy settings for each
- individually.</p>
- <img alt="Network preferences"
- src="http://tor.eff.org/img/screenshot-osx-choose-interface.png"
- border="1">
- <p>
- <p>Select and enter 127.0.0.1 and port 8118 for both
- Web Proxy (HTTP) and your Secure Web Proxy (HTTPS).
- You should also do this for "FTP Proxy" and "Gopher Proxy"; see <a
- href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#FtpProxy">this
- note</a> about Tor and ftp proxies. Leave your Use Passive FTP Mode
- (PASV) setting as is.</p>
- <img alt="Proxy settings"
- src="http://tor.eff.org/img/screenshot-osx-proxy-settings.png"
- border="1">
- <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://www.taiyo.co.jp/~gotoh/ssh/connect.html">connect</a> or
- <a href="http://www.dest-unreach.org/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 Three: Make sure it's working</a></h2>
- <br />
- <p>
- Next, you should try using your browser with Tor and make
- sure that your IP address is being anonymized. Click on the <a
- href="http://serifos.eecs.harvard.edu/cgi-bin/ipaddr.pl?tor=1">Tor
- detector</a> and see whether it thinks you're using Tor or not.
- (If that site is down, see <a
- href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#IsMyConnectionPrivate">this
- FAQ entry</a> for more suggestions on how to test your Tor.)
- </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 />
- <a id="server"></a>
- <h2><a class="anchor" href="#server">Step Four: Configure it as a server</a></h2>
- <br />
- <p>The Tor network relies on volunteers to donate bandwidth. The more
- people who run servers, the faster the Tor network will be. If you have
- at least 20 kilobytes/s each way, please help out Tor by configuring your
- Tor to be a server too. We have many features that make Tor servers easy
- and convenient, including rate limiting for bandwidth, exit policies so
- you can limit your exposure to abuse complaints, and support for dynamic
- IP addresses.</p>
- <p>Having servers in many different places on the Internet is what
- makes Tor users secure. <a
- href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#ServerAnonymity">You
- may also get stronger anonymity yourself</a>,
- since remote sites can't know whether connections originated at your
- computer or were relayed from others.</p>
- <p>Read more at our <a href="tor-doc-server.html">Configuring a server</a>
- guide.</p>
- <hr />
- <a id="uninstall"></a>
- <h2><a class="anchor" href="#uninstall">How To Uninstall Tor and Privoxy</a></h2>
- <br />
- <p>The Tor 0.1.0.x series does not come with an uninstaller; this feature
- will be added in the 0.1.1.x series. If you want to remove Tor on OSX,
- here's how:</p>
- <p>Change your application proxy settings back to their original values.
- If you just want to stop using Tor, you can end at this point.</p>
- <p>To stop Tor and Privoxy from running on startup</b>, remove the
- /Library/StartupItems/Tor and /Library/StartupItems/Privoxy directories
- respectively. If you just want to stop Tor from running, you can end at this
- point.</p>
- <p>To erase all remaining Tor and Privoxy files from your computer, delete
- the following:
- <ul>
- <li>/Library/Tor</li>
- <li>/Library/Privoxy</li>
- <li>/usr/bin/tor</li>
- <li>/usr/bin/tor_resolve</li>
- <li>/var/log/tor</li>
- <li>/usr/share/man/man1/tor.1</li>
- <li>/usr/share/man/man1/tor-resolve.1</li>
- <li>/usr/share/man/man1/torify.1</li>
- <li>/Library/Receipts/Privoxy.pkg/</li>
- <li>/Library/Receipts/privoxyconf.pkg/</li>
- <li>/Library/Receipts/Tor.pkg/</li>
- <li>/Library/Receipts/torstartup.pkg/</li>
- </ul>
- </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>
|