[or-cvs] r10009: Get rid of the dangerous instructions to use google as your (website/trunk/docs/en)

[arma@xxxxxxxx]

Author: arma
Date: 2007-04-23 16:52:04 -0400 (Mon, 23 Apr 2007)
New Revision: 10009

Modified:
   website/trunk/docs/en/tor-hidden-service.wml
Log:
Get rid of the dangerous instructions to use google as your
test site for your hidden service. Also some general cleanup.


Modified: website/trunk/docs/en/tor-hidden-service.wml
===================================================================
--- website/trunk/docs/en/tor-hidden-service.wml	2007-04-23 19:48:13 UTC (rev 10008)
+++ website/trunk/docs/en/tor-hidden-service.wml	2007-04-23 20:52:04 UTC (rev 10009)
@@ -12,7 +12,7 @@
 
 <p>Tor allows clients and servers to offer hidden services. That is,
 you can offer a web server, SSH server, etc., without revealing your
-IP to its users. In fact, because you don't use any public address,
+IP address to its users. In fact, because you don't use any public address,
 you can run a hidden service from behind your firewall.
 </p>
 
@@ -50,23 +50,66 @@
 immediately and your browser pops up an alert saying that
 "www.6sxoyfb3h2nvok2d.onion could not be found, please check the name and
 try again" then you haven't configured Tor and Privoxy correctly; see <a
-href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#ItDoesntWork";>this
-FAQ entry</a> for some help.
+href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#ItDoesntWork";>the
+it-doesn't-work FAQ entry</a> for some help.
 </p>
 
 <hr />
 <a id="one"></a>
-<h2><a class="anchor" href="#one">Step One: Configure an example hidden service</a></h2>
+<h2><a class="anchor" href="#one">Step One: Install a web server locally</a></h2>
 <br />
 
-<p>In this step, you're going to configure a hidden service that points
-to www.google.com. This way we can make sure you have this step
-working before we start thinking about setting up a web server locally.
+<p>First, you need to set up a web server locally. Setting up a web
+server can be tricky,
+so we're just going to go over a few basics here. If you get stuck
+or want to do more, find a friend who can help you. We recommend you
+install a new separate web server for your hidden service, since even
+if you already have one installed, you may be using it (or want to use
+it later) for an actual website.
 </p>
 
+<p>If you're on Unix or OS X and you're comfortable with
+the command-line, by far the best way to go is to install <a
+href="http://www.acme.com/software/thttpd/";>thttpd</a>. Just grab the
+latest tarball, untar it (it will create its own directory), and run
+./configure &amp;&amp; make. Then mkdir hidserv, cd hidserv, and run
+"../thttpd -p 5222 -h localhost". It will give you back your prompt,
+and now you're running a webserver on port 5222. You can put files to
+serve in the hidserv directory.
+</p>
+
+<p>If you're on Windows, you might pick <a
+href="http://savant.sourceforge.net/";>Savant</a> or <a
+href="http://httpd.apache.org/";>Apache</a>, and be sure to configure it
+to bind only to localhost. You should also figure out what port you're
+listening on, because you'll use it below.
+</p>
+
+<p>(The reason we bind the web server only to localhost is to make
+sure it isn't publically accessible. If people could get to it directly,
+they could confirm that your computer is the one offering the hidden
+service.)
+</p>
+
+<p>Once you've got your web server set up, make sure it works: open your
+browser and go to <a
+href="http://localhost:5222/";>http://localhost:5222/</a>, where 5222 is
+the port that you picked above. Then try putting a file in the main html
+directory, and make sure it shows up when you access the site.
+</p>
+
+<hr />
+<a id="two"></a>
+<h2><a class="anchor" href="#two">Step Two: Configure your hidden service</a></h2>
+<br />
+
+<p>Next, you need to configure your hidden service to point to your
+local web server.
+</p>
+
 <p>First, open your torrc file in your favorite text editor. (See <a
-href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#torrc";>this
-FAQ entry</a> to learn what this means.) Go to the middle section and
+href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#torrc";>the
+torrc FAQ entry</a> to learn what this means.) Go to the middle section and
 look for the line</p>
 
 <pre>
@@ -89,13 +132,12 @@
 IP address and port for redirecting connections to this virtual port.</li>
 </ul>
 
-<p>In this example, we're going to set up a hidden service that points to
-Google. So add the following lines to your torrc:
+<p>Add the following lines to your torrc:
 </p>
 
 <pre>
 HiddenServiceDir /Library/Tor/var/lib/tor/hidden_service/
-HiddenServicePort 80 www.google.com:80
+HiddenServicePort 80 127.0.0.1:5222
 </pre>
 
 <p>You're going to want to change the HiddenServiceDir line, so it points
@@ -105,21 +147,20 @@
 username in place of "username". On Windows you might pick:</p>
 <pre>
 HiddenServiceDir C:\Documents and Settings\username\Application Data\hidden_service\\
-HiddenServicePort 80 www.google.com:80
+HiddenServicePort 80 127.0.0.1:5222
 </pre>
 
 <p>Now save the torrc, shut down
-your Tor, and then start it again.  (See <a
-href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#Restarting";>this
-FAQ entry</a> for tips on restarting Tor.)
+your Tor, and then start it again.
 </p>
 
 <p>If Tor starts up again, great. Otherwise, something is wrong. Look
 at your torrc for obvious mistakes like typos. Then double-check
 that the directory you picked is writeable by you. If it's still
 not working, you should look at the Tor logs for hints. (See <a
-href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#Logs";>this
-FAQ entry</a> if you don't know how to enable or find your log file.)
+href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#Logs";>the
+logging FAQ entry</a> if you don't know how to enable or find your
+log file.)
 </p>
 
 <p>When Tor starts, it will automatically create the HiddenServiceDir
@@ -148,73 +189,16 @@
 </p>
 
 <p>Try it now: paste the contents of the hostname file into your web
-browser. If it works, you'll get the google frontpage, but the URL in your
-browser's window will be your hidden service hostname. If it doesn't work,
-look in your logs for some hints, and keep playing with it until it works.
+browser. If it works, you'll get the html page you set up in step one.
+If it doesn't work, look in your logs for some hints, and keep playing
+with it until it works.
 </p>
 
 <hr />
-<a id="two"></a>
-<h2><a class="anchor" href="#two">Step Two: Now install a web server locally</a></h2>
-<br />
-
-<p>Now that you have hidden services working on Tor, you need to
-set up your web server locally. Setting up a web server is tricky,
-so we're just going to go over a few basics here. If you get stuck
-or want to do more, find a friend who can help you. We recommend you
-install a new separate web server for your hidden service, since even
-if you already have one installed, you may be using it (or want to use
-it later) for an actual website.
-</p>
-
-<p>If you're on Unix or OS X and you're comfortable with
-the command-line, by far the best way to go is to install <a
-href="http://www.acme.com/software/thttpd/";>thttpd</a>. Just grab the
-latest tarball, untar it (it will create its own directory), and run
-./configure &amp;&amp; make. Then mkdir hidserv, cd hidserv, and run
-"../thttpd -p 5222 -h localhost". It will give you back your prompt,
-and now you're running a webserver on port 5222. You can put files to
-serve in the hidserv directory.
-</p>
-
-<p>If you're on Windows, you might pick <a
-href="http://savant.sourceforge.net/";>Savant</a> or <a
-href="http://httpd.apache.org/";>Apache</a>, and be sure to configure it
-to bind only to localhost. You should also figure out what port you're
-listening on, because you'll use it below.
-</p>
-
-<p>(The reason we bind the web server only to localhost is to make
-sure it isn't publically accessible. If people could get to it directly,
-they could confirm that your computer is the one offering the hidden
-service.)
-</p>
-
-<p>Once you've got your web server set up, make sure it works: open your
-browser and go to <a
-href="http://localhost:5222/";>http://localhost:5222/</a>, where 5222 is
-the port that you picked above. Then try putting a file in the main html
-directory, and make sure it shows up when you access the site.
-</p>
-
-<hr />
 <a id="three"></a>
-<h2><a class="anchor" href="#three">Step Three: Connect your web server to your hidden service</a></h2>
+<h2><a class="anchor" href="#three">Step Three: More advanced tips</a></h2>
 <br />
 
-<p>This part is very simple. Open up your torrc again, and change the
-HiddenServicePort line from "www.google.com:80" to "localhost:5222".
-Then <a
-href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#Restarting";>restart
-Tor</a>. Make sure that it's working by reloading your hidden
-service hostname in your browser.
-</p>
-
-<hr />
-<a id="four"></a>
-<h2><a class="anchor" href="#four">Step Four: More advanced tips</a></h2>
-<br />
-
 <p>If you plan to keep your service available for a long time, you might
 want to make a backup copy of the private_key file somewhere.
 </p>