| 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 |
|