mirror of
https://github.com/pi-hole/dnsmasq.git
synced 2025-12-19 10:18:25 +00:00
130 lines
5.7 KiB
HTML
130 lines
5.7 KiB
HTML
<HTML>
|
||
<HEAD>
|
||
<TITLE> Dnsmasq - a DNS forwarder for NAT firewalls.</TITLE>
|
||
<link rel="icon"
|
||
href="http://www.thekelleys.org.uk/dnsmasq/images/favicon.ico">
|
||
</HEAD>
|
||
<BODY BGCOLOR="WHITE">
|
||
<table width="100%" border="0" cellpadding="0" cellspacing="0">
|
||
<tr>
|
||
<td align="left" valign="middle"><img border="0" src="http://www.thekelleys.org.uk/dnsmasq/images/icon.png" /></td>
|
||
<td align="middle" valign="middle"><h1>Dnsmasq</h1></td>
|
||
<td align="right" valign="middle"><img border="0" src="http://www.thekelleys.org.uk/dnsmasq/images/icon.png" /></td></tr>
|
||
</table>
|
||
|
||
Dnsmasq is a lightweight, easy to configure DNS forwarder and DHCP
|
||
server. It is designed to provide DNS and, optionally, DHCP, to a
|
||
small network. It can serve the names of local machines which are
|
||
not in the global DNS. The DHCP server integrates with the DNS
|
||
server and allows machines with DHCP-allocated addresses
|
||
to appear in the DNS with names configured either in each host or
|
||
in a central configuration file. Dnsmasq supports static and dynamic
|
||
DHCP leases and BOOTP/TFTP/PXE for network booting of diskless machines.
|
||
<P>
|
||
Dnsmasq is targeted at home networks using NAT and
|
||
connected to the internet via a modem, cable-modem or ADSL
|
||
connection but would be a good choice for any smallish network (up to
|
||
1000 clients is known to work) where low
|
||
resource use and ease of configuration are important.
|
||
<P>
|
||
Supported platforms include Linux (with glibc and uclibc), Android, *BSD,
|
||
Solaris and Mac OS X.
|
||
Dnsmasq is included in at least the following Linux distributions:
|
||
Gentoo, Debian, Slackware, Suse, Fedora,
|
||
Smoothwall, IP-Cop, floppyfw, Firebox, LEAF, Freesco, fli4l,
|
||
CoyoteLinux, Endian Firewall and
|
||
Clarkconnect. It is also available as FreeBSD, OpenBSD and NetBSD ports and is used in
|
||
Linksys wireless routers (dd-wrt, openwrt and the stock firmware) and the m0n0wall project.
|
||
<P>
|
||
Dnsmasq provides the following features:
|
||
<DIR>
|
||
|
||
<LI>
|
||
The DNS configuration of machines behind the firewall is simple and
|
||
doesn't depend on the details of the ISP's dns servers
|
||
<LI>
|
||
Clients which try to do DNS lookups while a modem link to the
|
||
internet is down will time out immediately.
|
||
</LI>
|
||
<LI>
|
||
Dnsmasq will serve names from the /etc/hosts file on the firewall
|
||
machine: If the names of local machines are there, then they can all
|
||
be addressed without having to maintain /etc/hosts on each machine.
|
||
</LI>
|
||
<LI>
|
||
The integrated DHCP server supports static and dynamic DHCP leases and
|
||
multiple networks and IP ranges. It works across BOOTP relays and
|
||
supports DHCP options including RFC3397 DNS search lists.
|
||
Machines which are configured by DHCP have their names automatically
|
||
included in the DNS and the names can specified by each machine or
|
||
centrally by associating a name with a MAC address in the dnsmasq
|
||
config file.
|
||
</LI>
|
||
<LI>
|
||
Dnsmasq caches internet addresses (A records and AAAA records) and address-to-name
|
||
mappings (PTR records), reducing the load on upstream servers and
|
||
improving performance (especially on modem connections).
|
||
</LI>
|
||
<LI>
|
||
Dnsmasq can be configured to automatically pick up the addresses of
|
||
its upstream nameservers from ppp or dhcp configuration. It will
|
||
automatically reload this information if it changes. This facility
|
||
will be of particular interest to maintainers of Linux firewall
|
||
distributions since it allows dns configuration to be made automatic.
|
||
</LI>
|
||
<LI>
|
||
On IPv6-enabled boxes, dnsmasq can both talk to upstream servers via IPv6
|
||
and offer DNS service via IPv6. On dual-stack (IPv4 and IPv6) boxes it talks
|
||
both protocols and can even act as IPv6-to-IPv4 or IPv4-to-IPv6 forwarder.
|
||
</LI>
|
||
<LI>
|
||
Dnsmasq can be configured to send queries for certain domains to
|
||
upstream servers handling only those domains. This makes integration
|
||
with private DNS systems easy.
|
||
</LI>
|
||
<LI>
|
||
Dnsmasq supports MX and SRV records and can be configured to return MX records
|
||
for any or all local machines.
|
||
</LI>
|
||
</DIR>
|
||
|
||
<H2>Get code.</H2>
|
||
|
||
<A HREF="http://www.thekelleys.org.uk/dnsmasq/">Download</A> dnsmasq here.
|
||
The tarball includes this documentation, source, and manpage.
|
||
There is also a <A HREF="CHANGELOG"> CHANGELOG</A> and a <A HREF="FAQ">FAQ</A>.
|
||
|
||
Dnsmasq has a git repository which contains the complete release
|
||
history of version 2 and development history from 2.60. You can
|
||
<A HREF="http://thekelleys.org.uk/gitweb/?p=dnsmasq.git;a=summary">browse</A>
|
||
the repo, or get a copy using git protocol with the command
|
||
|
||
<PRE><TT>git clone git://thekelleys.org.uk/dnsmasq.git </TT></PRE>
|
||
|
||
<H2>License.</H2>
|
||
Dnsmasq is distributed under the GPL. See the file COPYING in the distribution
|
||
for details.
|
||
|
||
<H2>Contact.</H2>
|
||
There is a dnsmasq mailing list at <A
|
||
HREF="http://lists.thekelleys.org.uk/mailman/listinfo/dnsmasq-discuss">
|
||
http://lists.thekelleys.org.uk/mailman/listinfo/dnsmasq-discuss</A> which should be the
|
||
first location for queries, bugreports, suggestions etc.
|
||
Dnsmasq was mainly written and is maintained by Simon Kelley. You can contact me at <A
|
||
HREF="mailto:simon@thekelleys.org.uk">simon@thekelleys.org.uk</A>.
|
||
|
||
<H2>Donations.</H2>
|
||
For most of its life, dnsmasq has been a spare-time project. These days I'm working on it as my main activity.
|
||
I don't have an employer or anyone who pays me regularly to work on dnsmasq. If you'd like to make
|
||
a contribution towards my expenses, please use the donation button below.
|
||
<form action="https://www.paypal.com/cgi-bin/webscr" method="post" target="_top">
|
||
<input type="hidden" name="cmd" value="_s-xclick">
|
||
<input type="hidden" name="hosted_button_id" value="V3X9GVW5GX6DA">
|
||
<input type="image" src="https://www.paypalobjects.com/en_US/GB/i/btn/btn_donateCC_LG.gif" border="0" name="submit" alt="PayPal – The safer, easier way to pay online.">
|
||
<img alt="" border="0" src="https://www.paypalobjects.com/en_GB/i/scr/pixel.gif" width="1" height="1">
|
||
</form>
|
||
|
||
|
||
</BODY>
|
||
|