"hash is a sometimes comment, not an all the time comment."
[tor.git] / doc / FAQ
blob9af43acb950d56c98521076ae8408712207549d0
1 [This file is obsolete. Check out the online FAQ at the wiki
2 for more accurate and complete questions and answers:
3 http://wiki.noreply.org/wiki/TheOnionRouter/TorFAQ
5 The Onion Routing (TOR) Frequently Asked Questions
6 --------------------------------------------------
8 1. General.
10 1.1. What is Tor?
12 Tor is an implementation of version 2 of Onion Routing.
13 Go read the tor-design.pdf for the details.
15 In brief, Onion Routing is a connection-oriented anonymizing communication
16 service. Users choose a source-routed path through a set of nodes, and
17 negotiate a "virtual circuit" through the network, in which each node
18 knows its predecessor and successor, but no others. Traffic flowing down
19 the circuit is unwrapped by a symmetric key at each node, which reveals
20 the downstream node.
22 Basically Tor provides a distributed network of servers ("onion
23 routers"). Users bounce their tcp streams (web traffic, ftp, ssh, etc)
24 around the routers, and recipients, observers, and even the routers
25 themselves have difficulty tracking the source of the stream.
27 1.2. Why's it called Tor?
29 Because Tor is the onion routing system. I kept telling people I was
30 working on onion routing, and they said "Neat. Which one?" Even if onion
31 routing has become a standard household term, this is the actual onion
32 routing project, started out of the Naval Research Lab.
34 (Theories about recursive acronyms are ok too. It's also got a fine
35 translation into German.)
37 1.3 Is there a backdoor in Tor?
39 Not right now, but if this answer changes we probably won't be allowed
40 to tell you. You should always check the source (or at least the diffs
41 since the last release) for suspicious things; and if we don't give you
42 source, that's a sure sign something funny could be going on.
44 2. Compiling and installing.
46 [Read the README file for now; check back here once we've got packages/etc
47 for you.]
50 3. Running Tor.
52 3.1. What kind of server should I run?
54 The same executable functions as both client and server, depending on
55 which ports are specified in the configuration file. You can specify:
56 * SocksPort: client applications (eg privoxy, Mozilla) can speak socks to
57   this port.
58 * ORPort: other onion routers connect to this port
59 * DirPort: onion proxies and onion routers speak http to this port, to
60   pull down a directory of which nodes are currently available.
62 3.2. So I can just run a full onion router and join the network?
64 No. Users should run just an onion proxy. If you have sufficient
65 bandwidth (>= 1MBit both ways) you can consider running a router,
66 but just to use the network you don't need to.  Note that you won't
67 be used by clients much unless you are verified properly by the
68 directory administrators (see next question).
70 3.3. How do I join the network then?
72 If you just want to use the onion routing network, you can run a proxy
73 and you're all set. If you want to run a router, you can do so by
74 enabling ORPort, which will make your router get used for some things.
75 However, in order to get used for everything, you must become a "verified"
76 router.  Simply convince the directory server operators (mail
77 tor-ops@freehaven.net) that you have a stable machine with enough bandwidth.
78 From there, the operators add you to the directory, which propagates out
79 to the rest of the network. All nodes will know about you within a half
80 hour.  Once you are verified clients will pick you as entry and exit nodes.
82 3.4. Can I just set DirPort and be a directory server?
84 If you are an onion router and set DirPort then you will serve the
85 directory to other clients.  This takes some load off the authoritative
86 dirservers.  Your node will not generate its own directory, instead
87 it will provide the one it fetched from an authoritative dirserver.
89 If you run a very reliable node, you plan to be around for a long time,
90 and you want to spend some time ensuring that router operators do in
91 fact have enough bandwidth and stable machines, we may want you to run
92 an authoritative directory server too. We must manually add you to the
93 'dirservers' file that's part of the distribution; users will only know
94 about you when they upgrade to a new version.
97 4. Development.
99 4.1. Who's doing this?
101 4.2. Can I help?
103 4.3. I've got a bug.
106 5. Anonymity.
108 5.1. So I'm totally anonymous if I use Tor?
112 5.2. Where can I learn more about anonymity?
114 5.3. What attacks remain against onion routing?
118 6. Comparison to related projects.
120 6.1. Onion Routing.
122 Tor *is* onion routing.
124 6.2. Freedom.
127 7. Protocol and application support.
129 7.1. http? ftp? udp? socks? mozilla?