Debian Codegraph @

README

raw
1 #### DESCRIPTION
2
3 The dnsproxy daemon is a proxy for DNS queries. It forwards these queries
4 to two previously configured nameservers: one for authoritative queries
5 and another for recursive queries. The received answers are sent back to
6 the client unchanged. No local caching is done and only UDP queries are
7 supported.
8
9 Primary motivation for this project was the need to replace Bind servers
10 with djbdns in an ISP environment. These servers got recursive queries
11 from customers and authoritative queries from outside at the same IP
12 address. Now it was possible to run dnscache and tinydns on the same
13 machine with queries dispatched by dnsproxy.
14
15 Other scenarios are firewalls where you want to proxy queries to the real
16 servers in your DMZ. Or internal nameservers behind firewalls, or...
17
18 Some features:
19 - Secure. Runs chrooted and without root privileges.
20 - Fast. Able to process hundreds of queries per second.
21 - Easy to setup. Simple configuration file.
22
23 #### INSTALLATION
24
25 If you run any current UNIX-like operating system, only the following
26 steps should be necessary:
27 ```
28 ./configure
29 make
30 make install
31 ```
32 Unlike earlier releases this release does not include the libevent
33 library. It should now also be available from your operating systems
34 ports/packages/rpm/deb repository or as always from the source at
35 http://libevent.org/. If it is not found by the configure script
36 you may specify the directory prefix of your libevent installation
37 with:
38 ```
39 ./configure --with-libevent=/usr/local
40 ```
41
42 #### CONFIGURATION
43
44 At startup dnsproxy reads a configuration file specified via the -c
45 option or at the default location of /etc/dnsproxy.conf. The syntax of
46 this configuration file is of the form "keyword value" and looks like:
47 ```
48 authoritative 127.0.0.1 # Authoritative server. Required.
49 authoritative-port 53001 # It's port. Defaults to 53.
50 authoritative-timeout 10 # Seconds to wait for answers.
51
52 recursive 127.0.0.1 # Recursive server. Required.
53 recursive-port 53002 # It's port. Defaults to 53.
54 recursive-timeout 90 # Seconds to wait for answers.
55
56 listen 192.168.168.1 # Dnsproxy's listen address.
57 port 53 # Dnsproxy's port address.
58
59 chroot /var/empty # Directory to chroot dnsproxy.
60 user nobody # Unprivileged user to run as.
61
62 internal 192.168.168.0/24 # Only internal IP addresses are
63 internal 127.0.0.1 # allowed to do recursive queries.
64
65 statistics 3600 # Print statistics every hour.
66 ```
67
68 #### COMPATIBILITY
69
70 This package should build and run on OpenBSD, FreeBSD, Solaris, Linux.
71 Other POSIX environments should work also. Please drop me a mail if
72 you run dnsproxy on an unlisted system.
73
74 #### LICENSE
75
76 This software is released under an OSI approved MIT-style license.
77