From Gentoo Wiki
Jump to:navigation Jump to:search
This page is a translated version of the page Dnsmasq and the translation is 76% complete.

dnsmasq は1000 クライアント以下のローカルネットワークで使用できるシンプルな DHCP/DNS サーバです。主な特徴は設定の簡単さと軽量さです。IPv6 にも対応しています。


USE フラグ

適切な USE フラグを選択してください:

USE flags for net-dns/dnsmasq Small forwarding DNS server

auth-dns Add support for acting as an authorative DNS server.
conntrack Add support for Linux conntrack connection marking.
dbus Enable dbus support for anything that needs it (gpsd, gnomemeeting, etc)
dhcp Enable support for acting as a DHCP server.
dhcp-tools Install extra command line tools for manually managing DHCP leases.
dnssec Enable support DNSSEC validation and caching.
dumpfile Include code to dump packets to a libpcap-format file for debugging
id Whether report *.bind CHAOS info to clients, otherwise forward such requests upstream instead
idn Enable support for Internationalized Domain Names
inotify Enable inotify filesystem monitoring support
ipv6 Add support for IP version 6
libidn2 Enable support for Internationalized Domain Names, via net-dns/libidn2 rather than net-dns/libidn
loop Include functionality to probe for and remove DNS forwarding loops
lua Enable Lua scripting support
nettlehash Use hashing functions from dev-libs/nettle
nls Add Native Language Support (using gettextGNU locale utilities)
script Enable support for calling scripts when leases change.
selinux !!internal use only!! Security Enhanced Linux support, this must be set by the selinux profile or breakage will occur
static !!do not set this during bootstrap!! Causes binaries to be statically linked instead of dynamically
tftp Enables built in TFTP server for netbooting.


次に、net-dns/dnsmasq パッケージをインストールしてください:

root #emerge --ask net-dns/dnsmasq


dnsmasq の振る舞いを変えるには、さまざまなリソースを変更することで行えます。これには以下が含まれます。

  • /etc/conf.d/dnsmasq を通じて提供されるコマンドラインオプション
  • メインの設定ファイル (/etc/dnsmasq.conf)



自動的に開始する必要がある場合は、dnsmasq を default ランレベルに追加してください:

root #rc-update add dnsmasq default


root #rc-service dnsmasq start


/etc/conf.d/dnsmasq では、dnsmasq デーモンの起動時に渡されるコマンドラインオプションを設定できます。

ファイル /etc/conf.d/dnsmasqdnsmasq サービス設定の例
DNSMASQ_OPTS="--user=dnsmasq --group=dnsmasq -H /srv/virt/gentoo/hosts --max-cache-ttl=10"


dnsmasq の主な設定は /etc/dnsmasq.conf 設定ファイルを通じて行われます。このファイルは キー[=値] の構文を使用しています。パッケージにより提供されるファイルはよく文書化されており、通しで読むことをおすすめします。ファイルの中で、あるいはコマンドラインオプションを通じて、(DHCP hosts ファイル等の) 追加のリソースに言及されているかもしれません。


ファイル /etc/dnsmasq.conf
# このインターフェースだけで listen する
# mac アドレスに基づいて名前を割り当てる
# 他の DHCP リクエストはこの範囲から ip を取得する
# TFTP サーバを有効化し、TFTP からアクセスできるファイルのルートディレクトリを設定する。


root #/etc/init.d/dnsmasq restart

hosts ファイル

dnsmasq アプリケーションは -h (--no-hosts) コマンドライン引数を渡されない限り、DNS サービスを提供するために /etc/hosts ファイルを情報源のひとつとして使用します。

/etc/hosts ファイルが更新されたら、dnsmasq サービスはその設定を再読み込みするために SIGHUP シグナルを受信する必要があります。これは init スクリプトの reload コマンドを通しても対応しています:

root #/etc/init.d/dnsmasq reload

この挙動は設定ファイルで no-hosts パラメータを利用して無効化することもできます。

追加の hosts ファイル

DNS クエリのための情報源として使用するために、(追加の) hosts ファイルを渡すこともできます。これを行うには、-H /path/to/hostsfile (--addn-hosts=/path/to/hostsfile) コマンドラインオプションを追加してください。ディレクトリを渡すこともでき、その場合はディレクトリ内のすべてのファイルが追加の hosts ファイルとして扱われるでしょう。

通常の hosts ファイルと同様に、SIGHUP シグナルでファイルを再読み込みします。

この挙動は設定ファイルで addn-hosts パラメータを利用して設定することもできます。


dnsmasq はデフォルトでは、/etc/resolv.conf で指定されたネームサーバを上流のネームサーバとして利用します。

-r (--resolv-file) コマンドラインオプションを介して、異なるファイルを利用することもできます。

この挙動は設定ファイルで resolv-file パラメータを利用して設定することもできます。


dnsmasq は DNS、TFTP、PXE、ルータ広告と DHCP サービスに対応しています。そのため、小〜中規模のネットワークのための多目的なネットワーク管理ツールとなっています。

DNS サービス

In order to (only) provide DNS services, first identify the upstream nameserver to use. If this is the same nameserver as specified in /etc/resolv.conf then no additional steps need to be taken. Otherwise, point dnsmasq to the proper resolv.conf file through the -r (--resolv-file) command line. Its syntax is the one used by the /etc/resolv.conf file, although dnsmasq only looks at the nameserver definitions.


root #echo "nameserver" >> /etc/dnsmasq.conf.resolv

Next point dnsmasq to this file through the configuration file:

ファイル /etc/dnsmasq.confカスタム resolv ファイルの設定

To verify that the service is running (after restarting as the configuration file has just been changed), use the dig command (provided through net-dns/bind-tools), asking the DNS server (running on localhost in the following example) to resolve a local or remote address:

user $dig @localhost +short www.gentoo.org


Dnsmasq can validate DNSSEC data while passing through data. This can be accomplished by adding these lines to the config file:

ファイル /etc/dnsmasq.confDNSSEC を有効にする
# DNSSEC setup

The trusted anchor can be found on the iana.org site. After this change dnsmasq will return SERVFAIL and no DNS data if the validation fails. If the validation succeeds it sets the ad flag. In case the domain does not support DNSSEC dnsmasq behaves as before.

DHCP サービス

In order to enable the DHCP services of dnsmasq, use the dhcp-range configuration setting.

For instance, to enable IPv6 address configuration through router advertisement (RA) with infinite lease time, and IPv4 address configuration also with infinite lease time:

ファイル /etc/dnsmasq.confEnabling IPv6 and IPv4 leases

It is possible to use static definitions for known hosts, either through the main configuration file (dhcp-host= settings) or through a separate file. If a separate file is used, point dnsmasq to it through the --dhcp-hostsfile command line option. The advantage of the latter approach is that it is sufficient to send a SIGHUP signal (or reload the service) in order to reread the entries, whereas definitions in the configuration file require a full service restart.

For more information about the syntax of the dhcp-host parameter please refer to the manual page or configuration file as its syntax is very extensive.


This section covers various usage scenarios (maintenance and operational tasks) for the dnsmasq service.


Clients that had a network interface update which results in a different MAC address might not get the intended IP address immediately. This is because the dnsmasq service has provided this IP address to the old MAC address, and will wait until the lease of this address has expired before re-assigning it.

The dnsmasq service stores its leases in /var/lib/misc/dnsmasq.leases. If the lease needs to be removed faster, shut down the dnsmasq service, remove the lease from the dnsmasq.leases file and start the service again.

root #/etc/init.d/dnsmasq stop
root #nano -w /var/lib/misc/dnsmasq.leases
root #/etc/init.d/dnsmasq start

Reloading non-main configuration settings

Next to the dnsmasq.conf file, the dnsmasq service can use external definitions for the following services:

  • DHCP host configuration entries (through --dhcp-hostsfile command line option)
  • DHCP options (through --dhcp-optsfile command line option)

When these files are modified, a SIGHUP signal has dnsmasq reload these configuration files.

The resolv.conf files are by default polled by dnsmasq; changes on these files are automatically picked up unless the -n (--no-poll) command line option is set or the no-poll configuration parameter is used.