DHCP 和 DNS 配置文件：/etc/config/dhcp

相关内容参阅： DHCP and DNS examples, dnsmasq, odhcpd

OpenWrt 默认使用 dnsmasq 和 odhcpd 提供 DNS/DHCP 和 DHCPv6 服务。

Dnsmasq 向DHCP客户端通告自己是DNS服务器。这在本地网络中可以更好地管理DNS功能。其中未命中的DNS请求会被转发到上游DNS服务器。

常用的 DHCP 配置内容如下面所示。 不是所有类型的参数都会在文件里出现，大多参数仅在特定功能时才需要设置。 常用的是：Common Options 称为基本配置，DHCP Pools 称为DHCP 地址池，以及 Static Leases 称为静态租约。

默认配置指定 DNS 和守护进程相关的选项，以及一个或多个 DHCP 地址池，用于定义在网络接口上提供 DHCP 服务的方式。

config dnsmasq 的内容用于指定每个 dnsmasq 实例的相关值和选项，这些值和选项涉及该 dnsmasq 实例的整体运行以及其所服务的所有接口上的 DHCP 选项。 下面表格展示了所有可用选项及其默认值，以及 dnsmasq 命令行选项。详情内容参阅 the dnsmasq man page。

选项及其默认值如下：

config dnsmasq
	option domainneeded '1'
	option boguspriv '1'
	option filterwin2k '0'
	option localise_queries '1'
	option rebind_protection '1'
	option rebind_localhost '1'
	option local '/lan/'
	option domain 'lan'
	option expandhosts '1'
	option nonegcache '0'
	option cachesize '1000'
	option authoritative '1'
	option readethers '1'
	option leasefile '/tmp/dhcp.leases'
	option resolvfile '/tmp/resolv.conf.d/resolv.conf.auto'
	option nonwildcard '1'
	option localservice '1'
	option ednspacket_max '1232'
	option filter_aaaa '0'
	option filter_a '0'

选项：

• local 和 domain 启用后 dnsmasq 可以解析 /etc/hosts 中的内容, 也包括在 lan 域下的DHCP 客户端主机名。
• domainneeded, boguspriv, localise_queries, 和 expandhosts 确保对本地主机名的查询不会被转发到上游 DNS 服务器，而是在本地解析或直接处理。
• authoritative 将路由器成为该网络中唯一的 DHCP 服务器；客户端因此能更快地获得 IP 地址租约。
• leasefile 将 DHCP 租约保存到文件中，以便在 dnsmasq 重启后能够恢复之前的分配记录，避免客户端重复获取 IP。
• resolvfile dnsmasq 使用指定文件来获取上游 DNS 服务器地址；该文件由 WAN 口的 DHCP 客户端或 PPP 客户端在联网时自动生成。
• enable_tftp 和 tftp_root 前者启用TFTP服务器，后者指定目录供TFTP服务器使用。
  • 在某些情况下，可能需要在客户端手动设置服务器的 IP 地址，可通过设置环境变量 serverip (e.g. setenv serverip 192.168.1.10).

config dhcp 用于为每个网络接口指定 IP 地址池及相关参数，以处理 DHCP 请求。 通常，在 /etc/config/dhcp 中至少有一个，用于为 lan 接口提供 DHCP 服务。

通过在相应配置段中设置 ignore 选项，来禁用某个特定网络接口的 DHCP 地址池。

以下是 dhcp 部分的最简示例：

config dhcp 'lan'
	option interface 'lan'
	option start '100'
	option limit '150'
	option leasetime '12h'

• lan 指定该 DHCP 地址池所服务的 OpenWrt 网络接口。
• 100 是网络地址开始的偏移值，在默认配置中意味着 DHCP 将从 192.168.1.100 开始分配 IP 地址。
• 150 表示最多可分配的 IP 地址数量，在默认配置中意味着地址池的结束地址为 192.168.1.249
• 12h 是所分配 IP 租约的有效期，本例有效期为12小时。
• server 设置 IPv6 工作模式 (RA & DHCPv6)

以下是 dhcp 中所有可用选项的列表。

Name	Type	Required	Default	Description
dhcp_option	list of strings	no	(none)	The ID dhcp_option here must be with written with an underscore. OpenWrt will translate this to --dhcp-option, with a hyphen, as ultimately used by dnsmasq. Multiple option values can be given for this network-id, with a a space between them and the total string between “”. E.g. '26,1470' or 'option:mtu, 1470' that can assign an MTU per DHCP. Your client must accept MTU by DHCP for this to work. Or “3,192.168.1.1 6,192.168.1.1” to give out gateway and DNS server addresses. A list of options can be found here (note that dnsmasq does not support all options listed there). A list of the symbolic option names that dnsmasq recognises can be found by running dnsmasq --help dhcp.
dhcp_option_force	list of strings	no	(none)	Exactly the same as dhcp_option (note the underscores), but it will be translated to --dhcp-option-force, meaning that the DHCP option will be sent regardless on whether the client requested it. dhcp_option_force available since 18.06
dynamicdhcp	boolean	no	1	Dynamically allocate client addresses, if set to 0 only clients present in the ethers files are served
force	boolean	no	0	Forces DHCP serving on the specified interface even if another DHCP server is detected on the same network segment
ignore	boolean	no	0	Specifies whether dnsmasq should ignore this pool if set to 1
dhcpv4	string	no	(none)	Specifies whether DHCPv4 server should be enabled (server) or disabled (disabled)
dhcpv6	string	no	(none)	Specifies whether DHCPv6 server should be enabled (server), relayed (relay) or disabled (disabled)
dns	list	no	<local address>	DNS servers to announce on the network. Only IPv6 addresses are accepted. To configure IPv4 DNS servers, use dhcp_option.
dns_service	boolean	no	1	Announce the IPv6 address of interface as DNS service if the list of dns option is empty. dns_service available since 21.02
ra	string	no	(none)	Specifies whether Router Advertisements should be enabled (server), relayed (relay) or disabled (disabled)
ra_default	integer	no	0	Default router lifetime in the RA message will be set if default route is present and a global IPv6 address (0) or if default route is present but no global IPv6 address (1) or neither of both conditions (2)
ra_flags	list of strings	no	other-config	List of RA flags to be advertised in RA messages: managed-config - get address and other information from DHCPv6 server. If this flag is set, other-config flag is redundant. other-config - get other configuration from DHCPv6 server (such as DNS servers). See here for details. home-agent - see here for details. none. OpenWrt since version 21.02 configures managed-config and other-config by default.
ra_slaac	boolean	no	1	Announce SLAAC for a prefix (that is, set the A flag in RA messages).
ra_management	integer	no	1	This option is deprecated. Use ra_flags and ra_slaac options instead. RA management mode : no M-Flag but A-Flag (0), both M and A flags (1), M flag but not A flag (2)
ra_offlink	bool	no	0	Announce prefixes as offlink (1) in RAs
ra_preference	string	no	medium	Announce routes with either high (high), medium (medium) or low (low) priority in RAs
ra_mininterval	integer	no	200	Minimum time interval between RAs (in seconds)
ra_maxinterval	integer	no	600	Maximum time interval between RAs (in seconds)
ra_lifetime	integer	no	1800	Advertised router lifetime (in seconds)
ra_useleasetime	bool	no	0	Limit the preferred and valid lifetimes of the prefixes in the RA messages to the configured DHCP leasetime
ra_hoplimit	integer	no	0	Advertised current hop limit (0-255)
ra_reachabletime	integer	no	0	Advertised reachable time (in milliseconds) (0-3600000)
ra_retranstime	integer	no	0	Advertised NS retransmission time (in milliseconds) (0-60000)
ra_mtu	integer	no	(none)	Maximum advertised MTU
ra_dns	boolean	no	1	Announce DNS configuration in RA messages (RFC8106)
ndp	string	no	(none)	Specifies whether NDP should be relayed (relay) or disabled (disabled)
ndproxy_routing	bool	no	1	Learn routes from NDP
ndproxy_slave	bool	no	0	Ignore neighbor messages on slave enabled (1) interfaces
master	boolean	no	0	Specifies whether DHCPv6, RA and NDP in relay mode is a master interface or not.
interface	logical interface name	yes	(none)	Specifies the interface associated with this DHCP address pool; must be one of the interfaces defined in /etc/config/network.
leasetime	string	yes	12h	Specifies the lease time of addresses handed out to clients, for example 12h or 30m
limit	integer	yes	150	Specifies the size of the address pool (e.g. with start=100, limit=150, maximum address will be .249)
networkid	string	no	(value of interface)	The dhcp functionality defined in the dhcp section is limited to the interface indicated here through its network-id. In case omitted the system tries to know the network-id via the interface setting in this dhcp section, through consultation of /etc/config/network. Some IDs get assigned dynamically, are not provided by network, but still can be set here.
start	integer	yes	100	Specifies the offset from the network address of the underlying interface to calculate the minimum address that may be leased to clients. It may be greater than 255 to span subnets.
instance	dnsmasq instance	no	(none)	Dnsmasq instance to which the dhcp section is bound; if not specified the section is valid for all dnsmasq instances.
tag	list of tag names	no	(none)	List of tags that dnsmasq needs to match to use with --dhcp-range.

注意:

• interface 指的是逻辑网络接口的名称，例如 lan, wan, wifi 等 (在 /etc/config/network 内), 而不是网络设备名称，例如 eth0, eth1, wlan0 等 ( ifname IDs 在 /etc/config/network).。
• networkid 是网络设备名称，例如 eth0, eth1, wlan0 等, 而不是逻辑网络接口名称 (lan, wan, wifi 等)。

/etc/config/network 和 /etc/config/wireless中 ifname 和 network 的用法不同, 因此请务必仔细核对配置，避免混淆！

使用config host根据设备的 MAC（硬件）地址，为其分配固定的 IP 地址。 该配置中的各项参数将被用来构造 dnsmasq 的 -G 命令行选项，以实现静态地址分配。

注意：必须至少指定以下其中一个 mac (支持使用通配符), duid 或 name 。

也可以在dnsmasq 中启用 readethers 选项，使其在 /etc/ethers 文件中添加 MAC 地址与 IP 地址的对应条目，以实现静态 IP 分配。

一些设备支持通过网络启动（PXE 启动）。 boot 选项用于指定如何通过 DHCP/BOOTP 告知客户端应加载哪个引导文件，以及从哪台服务器获取该文件。 每个客户端只能接收一组引导文件名和服务器地址选项。 如果不同设备需要加载不同的文件，或从不同服务器启动，可以使用 tags 或 network-ids 将不同的引导选项精确地分配给对应的客户端。

你需要通过 dhcp_option 设置额外的 DHCP 选项，以便支持网络启动过程中的后续阶段。 查阅 dnsmasq 的手册了解 O 选项的语法详情。

这些配置生成了dnsmasq中的 -M 选项

*注意*: odhcp 目前不支持设置 root-path 。 如果你需要此功能，禁用 odhcpd 改用 dnsmasq 。

Name	Type	Required	Default	Description
dhcp_option	list of strings	no	(none)	Additional options to be added for this network-id. If you specify this, you also need to specify the network-id.
filename	string	yes	(none)	The filename the host should request from the boot server.
networkid	string	no	(none)	The tag (aka network-id) these boot options should apply to. Applies to all clients if left unspecified.
serveraddress	string	yes	(none)	The IP address of the boot server.
servername	string	yes	(none)	The hostname of the boot server.
force	bool	no	(none)	dhcp_option will always be sent even if the client does not ask for it in the parameter request list. This is sometimes needed, for example when sending options to PXELinux.
instance	dnsmasq instance	no	(none)	Dnsmasq instance to which the boot section is bound. If not specified the section is valid for all dnsmasq instances.

DHCP 还有其他功能，例如域名访问、NTP服务器、网络启动功能等。 某些设置适用于网络段中的所有主机，但其他配置则更具针对性——可能仅适用于特定主机组，甚至只针对单个设备。 dnsmasq 通过内部称为networkid的字母数字标识tag对DHCP选项及其值进行分组，实现仅向标记对应网络标识的主机发送特定配置选项的功能。

在OpenWrt系统中，您可以通过以下方式标记主机：按DHCP地址范围( dhcp )划分，或根据客户端在DHCP请求中发送的若干选项进行标识。 在每个分类配置段中，可使用dhcp_option列表为具有特定tag（或networkid）的主机添加专属DHCP选项。

以下选项对客户端区分：

每个区分项 (除了 tag) 有个配置选项: 被分配那个tag。

例如 一个包含与您的以太网MAC完全匹配的 mac 条目的 mac 部分，以及一个 tag (也称为 networkid) 为 green ，将被标记为 green。

tag 有个配置选项： 将 DHCP options 的值分配给该 tag 。

例如：沿用上面的例子， 如果存在一个tag条目，其tag值为green，且同时提供了一个dhcp_option列表并设置了force，那么带有green标签的 DHCP 客户端可以被有选择地强制接收一个dhcp_option。

仅 dnsmasq-full 支持

dnsmasq可以自动将指定域名的解析地址填充到Netfilter IP集合中。此功能可以通过ipset选项在dnsmasq部分启用，或者使用更便捷的语法，通过专门的ipset部分启用。每个ipset部分都包含要填充的IP集合的名称（name，一个部分中可以指定多个IP集合名称），以及其解析地址应添加到指定IP集合中的域名（domain）。 示例：

dhcp ipset
	list name 'ss_rules_dst_forward'
	list name 'ss_rules6_dst_forward'
	list domain 'linkedin.com'
	list domain 'telegram.org'

如果您在两个接口之间进行路由（即它们未被桥接），那么您会发现网络远端发送DHCP请求的客户端得不到任何响应，因为DHCP广播无法在接口之间进行路由。 通过将dnsmasq配置为DHCP中继，可以无需为远端子网设置独立的DHCP服务器来解决此问题。 在此配置中，它会像正常情况一样监听DHCP请求，将这些请求转发到上游DHCP服务器，然后将接收到的任何响应广播回原始子网。

截至2021年10月，LuCI没有相关的界面，因此必须手动编辑配置文件。 DHCP 中继配置示例：

config relay 'id'
	option interface 'lan'
	option local_addr '1.1.1.1'
	option server_addr '2.2.2.2'

如果您希望特定域名（或子域名）解析到特定IP，一种方法是在dnsmasq的/etc/config/dhcp中为其添加一个hostrecord来实现。

示例：

config hostrecord
	option name 'example.com'
	option ip '192.168.1.2'

这个示例表示，example.com 会解析到 192.168.1.2，但 subdomain.example.com 仍会以常规方式解析。 请注意，这与使用dnsmasq的address选项不同，后者指示dnsmasq将整个域（包括任何子域）解析为特定的IP地址。