Browse Source

and the first cut of a tor osx installation howto

svn:r3298
Roger Dingledine 19 years ago
parent
commit
041edf8754
1 changed files with 143 additions and 0 deletions
  1. 143 0
      doc/tor-doc-osx.html

+ 143 - 0
doc/tor-doc-osx.html

@@ -0,0 +1,143 @@
+
+<html>
+<head>
+<title>Tor Mac OS X Install Instructions</title>
+<meta name="Author" content="Thomas Hardly">
+<meta name="Author" content="Roger Dingledine">
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<link rel="stylesheet" type="text/css" href="tor-doc.css">
+</head>
+
+<body>
+
+<h1>Running <a href="http://tor.eff.org/">Tor</a> on Mac OS X</h1>
+
+<a name="installing"></a>
+<h2>Step One: Download and Install Tor</h2>
+
+<p>
+The latest beta release of Tor for Macintosh OS X is <a
+href="http://tor.eff.org/dist/osx/Tor 0.0.9.2 Bundle.dmg">0.0.9.2</a>.
+Download it by clicking the link. You may be able to find experimental versions
+<a href="http://tor.freehaven.net/dist/osx/">here</a>, if you're looking for
+new features and new bugs.
+</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 not configured to run at startup.
+<!--We highly recommend that you enable that feature, however. -->
+You can enable this by selecting "Customize" in the Installer.</p>
+
+<img alt="select components to install"
+src="http://tor.eff.org/img/screenshot-osx-installer-customize.png"
+border="1">
+
+<P>
+And then checking the "Tor Startup Script" box as shown below.
+Be sure to leave the other boxes checked.
+</p>
+
+<img alt="select components to install"
+src="http://tor.eff.org/img/screenshot-osx-installer-components.png"
+border="1">
+
+<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, and 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>
+
+<a name="using"></a>
+<h2>Step Two: Configure your applications to use Tor</h2>
+
+<p>After installing Tor, you need to configure your applications to use
+it. The first step is to set up web browsing.
+Change your browser to HTTP proxy at localhost port 8118.
+(That's where Privoxy listens.) For Safari you need to change your
+Network Settings. Other web browers allow you to change proxy settings
+individually.</p>
+
+<p>In Mozilla, this is in Mozilla|Preferences|Advanced|Proxies.
+In Firefox it's Firefox|Preferences|General|ConnectionSettings</p>
+
+<P>You should set both your Web Proxy (HTTP) and your Secure Web Proxy
+(HTTPS) to the same thing, to hide your SSL traffic. For Safari, this
+looks something like:</p>
+
+<img alt="LAN settings in IE"
+src="http://tor.eff.org/img/screenshot-osx-choose-network.png"
+border="1">
+
+<p>
+Select your Network Preferences from the Apple | Location menu.</p>
+
+<img alt="Proxy settings in IE"
+src="http://tor.eff.org/img/screenshot-osx-choose-interface.png"
+border="1">
+<P>
+
+<p>Select the Network Interface you want to enable Tor on. If you use
+more than one Interface you must change the proxie settings for each
+individually.</p>
+
+<img alt="Proxy settings in IE"
+src="http://tor.eff.org/img/screenshot-osx-proxy-settings.png"
+border="1">
+
+<p>Select and enter localhost and port 8118 for both Web Proxy (HTTP)
+and your Secure Web Proxy (HTTPS)</p>
+
+<p>Using privoxy is <strong>necessary</strong> because <a
+href="http://tor.eff.org/cvs/tor/doc/CLIENTS">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 test if it's working, go to <a
+href="http://peertech.org/privacy-knoppix/">this site</a> and see
+what IP it says you're coming from. (If it's down, you can try the
+<a href="http://www.junkbusters.com/cgi-bin/privacy">junkbusters</a>
+site instead.)</p>
+
+<p>
+If you have a personal firewall, be sure to allow local connections to
+port 8118 and port 9050. If your firewall blocks outgoing connections,
+punch a hole so it can connect to TCP ports 80, 443, and 9001-9033.
+For more troubleshooting suggestions, see <a
+href="http://wiki.noreply.org/wiki/TheOnionRouter/TorFAQ">the FAQ</a>.
+</p>
+
+<p>To Torify another application that supports HTTP, just point
+it at Privoxy (that is, localhost port 8118). To use SOCKS
+directly (for example, for instant messaging, Jabber, IRC, etc),
+point your application directly at Tor (localhost port 9050). 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>.  Let us know if
+you get them working so we can add better instructions here.</p>
+
+<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>
+
+</body>
+</html>
+