src/config/torrc.sample.in

   1 ## Configuration file for a typical Tor user
   2 ## Last updated 12 April 2009 for Tor 0.2.1.14-rc.
   3 ## (May or may not work for much older or much newer versions of Tor.)
   4 ##
   5 ## Lines that begin with "## " try to explain what's going on. Lines
   6 ## that begin with just "#" are disabled commands: you can enable them
   7 ## by removing the "#" symbol.
   8 ##
   9 ## See 'man tor', or https://www.torproject.org/tor-manual.html,
  10 ## for more options you can use in this file.
  11 ##
  12 ## Tor will look for this file in various places based on your platform:
  13 ## https://wiki.torproject.org/noreply/TheOnionRouter/TorFAQ#torrc
  14
  15
  16 ## Replace this with "SocksPort 0" if you plan to run Tor only as a
  17 ## relay, and not make any local application connections yourself.
  18 SocksPort 9050 # what port to open for local application connections
  19 SocksListenAddress 127.0.0.1 # accept connections only from localhost
  20 #SocksListenAddress 192.168.0.1:9100 # listen on this IP:port also
  21
  22 ## Entry policies to allow/deny SOCKS requests based on IP address.
  23 ## First entry that matches wins. If no SocksPolicy is set, we accept
  24 ## all (and only) requests from SocksListenAddress.
  25 #SocksPolicy accept 192.168.0.0/16
  26 #SocksPolicy reject *
  27
  28 ## Logs go to stdout at level "notice" unless redirected by something
  29 ## else, like one of the below lines. You can have as many Log lines as
  30 ## you want.
  31 ##
  32 ## We advise using "notice" in most cases, since anything more verbose
  33 ## may provide sensitive information to an attacker who obtains the logs.
  34 ##
  35 ## Send all messages of level 'notice' or higher to @LOCALSTATEDIR@/log/tor/notices.log
  36 #Log notice file @LOCALSTATEDIR@/log/tor/notices.log
  37 ## Send every possible message to @LOCALSTATEDIR@/log/tor/debug.log
  38 #Log debug file @LOCALSTATEDIR@/log/tor/debug.log
  39 ## Use the system log instead of Tor's logfiles
  40 #Log notice syslog
  41 ## To send all messages to stderr:
  42 #Log debug stderr
  43
  44 ## Uncomment this to start the process in the background... or use
  45 ## --runasdaemon 1 on the command line. This is ignored on Windows;
  46 ## see the FAQ entry if you want Tor to run as an NT service.
  47 #RunAsDaemon 1
  48
  49 ## The directory for keeping all the keys/etc. By default, we store
  50 ## things in $HOME/.tor on Unix, and in Application Data\tor on Windows.
  51 #DataDirectory @LOCALSTATEDIR@/lib/tor
  52
  53 ## The port on which Tor will listen for local connections from Tor
  54 ## controller applications, as documented in control-spec.txt.
  55 #ControlPort 9051
  56 ## If you enable the controlport, be sure to enable one of these
  57 ## authentication methods, to prevent attackers from accessing it.
  58 #HashedControlPassword 16:872860B76453A77D60CA2BB8C1A7042072093276A3D701AD684053EC4C
  59 #CookieAuthentication 1
  60
  61 ############### This section is just for location-hidden services ###
  62
  63 ## Once you have configured a hidden service, you can look at the
  64 ## contents of the file ".../hidden_service/hostname" for the address
  65 ## to tell people.
  66 ##
  67 ## HiddenServicePort x y:z says to redirect requests on port x to the
  68 ## address y:z.
  69
  70 #HiddenServiceDir @LOCALSTATEDIR@/lib/tor/hidden_service/
  71 #HiddenServicePort 80 127.0.0.1:80
  72
  73 #HiddenServiceDir @LOCALSTATEDIR@/lib/tor/other_hidden_service/
  74 #HiddenServicePort 80 127.0.0.1:80
  75 #HiddenServicePort 22 127.0.0.1:22
  76
  77 ################ This section is just for relays #####################
  78 #
  79 ## See https://www.torproject.org/docs/tor-doc-relay for details.
  80
  81 ## Required: what port to advertise for incoming Tor connections.
  82 #ORPort 9001
  83 ## If you want to listen on a port other than the one advertised
  84 ## in ORPort (e.g. to advertise 443 but bind to 9090), uncomment the
  85 ## line below too. You'll need to do ipchains or other port forwarding
  86 ## yourself to make this work.
  87 #ORListenAddress 0.0.0.0:9090
  88
  89 ## A handle for your relay, so people don't have to refer to it by key.
  90 #Nickname ididnteditheconfig
  91
  92 ## The IP address or full DNS name for your relay. Leave commented out
  93 ## and Tor will guess.
  94 #Address noname.example.com
  95
  96 ## Define these to limit how much relayed traffic you will allow. Your
  97 ## own traffic is still unthrottled. Note that RelayBandwidthRate must
  98 ## be at least 20 KBytes.
  99 #RelayBandwidthRate 100 KBytes  # Throttle traffic to 100KB/s (800Kbps)
 100 #RelayBandwidthBurst 200 KBytes # But allow bursts up to 200KB/s (1600Kbps)
 101
 102 ## Contact info to be published in the directory, so we can contact you
 103 ## if your relay is misconfigured or something else goes wrong. Google
 104 ## indexes this, so spammers might also collect it.
 105 #ContactInfo Random Person <nobody AT example dot com>
 106 ## You might also include your PGP or GPG fingerprint if you have one:
 107 #ContactInfo 1234D/FFFFFFFF Random Person <nobody AT example dot com>
 108
 109 ## Uncomment this to mirror directory information for others. Please do
 110 ## if you have enough bandwidth.
 111 #DirPort 9030 # what port to advertise for directory connections
 112 ## If you want to listen on a port other than the one advertised
 113 ## in DirPort (e.g. to advertise 80 but bind to 9091), uncomment the line
 114 ## below too. You'll need to do ipchains or other port forwarding yourself
 115 ## to make this work.
 116 #DirListenAddress 0.0.0.0:9091
 117 ## Uncomment to return an arbitrary blob of html on your DirPort. Now you
 118 ## can explain what Tor is if anybody wonders why your IP address is
 119 ## contacting them. See contrib/tor-exit-notice.html for a sample.
 120 #DirPortFrontPage /etc/tor/exit-notice.html
 121
 122 ## Uncomment this if you run more than one Tor relay, and add the identity
 123 ## key fingerprint of each Tor relay you control, even if they're on
 124 ## different networks. You declare it here so Tor clients can avoid
 125 ## using more than one of your relays in a single circuit. See
 126 ## https://wiki.torproject.org/noreply/TheOnionRouter/TorFAQ#MultipleServers
 127 #MyFamily $keyid,$keyid,...
 128
 129 ## A comma-separated list of exit policies. They're considered first
 130 ## to last, and the first match wins. If you want to _replace_
 131 ## the default exit policy, end this with either a reject *:* or an
 132 ## accept *:*. Otherwise, you're _augmenting_ (prepending to) the
 133 ## default exit policy. Leave commented to just use the default, which is
 134 ## described in the man page or at
 135 ## https://www.torproject.org/documentation.html
 136 ##
 137 ## Look at https://www.torproject.org/faq-abuse.html#TypicalAbuses
 138 ## for issues you might encounter if you use the default exit policy.
 139 ##
 140 ## If certain IPs and ports are blocked externally, e.g. by your firewall,
 141 ## you should update your exit policy to reflect this -- otherwise Tor
 142 ## users will be told that those destinations are down.
 143 ##
 144 #ExitPolicy accept *:6660-6667,reject *:* # allow irc ports but no more
 145 #ExitPolicy accept *:119 # accept nntp as well as default exit policy
 146 #ExitPolicy reject *:* # no exits allowed
 147 #
 148 ## Bridge relays (or "bridges") are Tor relays that aren't listed in the
 149 ## main directory. Since there is no complete public list of them, even if an
 150 ## ISP is filtering connections to all the known Tor relays, they probably
 151 ## won't be able to block all the bridges. Also, websites won't treat you
 152 ## differently because they won't know you're running Tor. If you can
 153 ## be a real relay, please do; but if not, be a bridge!
 154 #BridgeRelay 1
 155 #ExitPolicy reject *:*
 156