/ip/dhcp-client

官方原文约 9 分钟阅读

dhcp-client

The DHCP client gets an IPv4 address and network settings for an interface from a DHCP server. For an overview and configuration examples, see DHCP Client. For how DHCP works, see DHCP.

ip/dhcp-client

Type: Directory

DHCP 客户端从 DHCP 服务器为接口获取 IPv4 地址和网络设置。概述和配置示例参见 DHCP 客户端。DHCP 的工作原理参见 DHCP。

标志	名称	描述
`X`	disabled	DHCP 客户端已禁用。
`I`	invalid	DHCP 客户端配置无效。
`D`	dynamic	DHCP 客户端是动态创建的。

参数	类型	描述
`name`	string	DHCP 客户端名称。如果未设置，RouterOS 会生成名称，例如 `client1`。
`interface` *	iface_enum	DHCP 客户端运行的接口。收到的 IP 地址将作为动态地址添加到此接口。
`add-default-route`	enum (no \| yes \| special-classless)	要从 DHCP 服务器收到的哪些路由添加到路由表。 - `yes`（默认）- 当服务器发送无类静态路由（选项 121）时添加它们，否则通过收到的网关（选项 3）添加默认路由。存在选项 121 时，忽略选项 3 的网关。 - `special-classless` - 同时添加无类静态路由和通过收到网关的默认路由。 - `no` - 不添加路由。
`default-route-distance`	num	客户端添加的路由的距离。默认值：1。
`default-route-tables`	object { table: alt { table-distance: composite { table: alt { table-default: enum (default) { default:0xffffffff } , table: enum } , distance: num [1 .. 255] } , table: alt { table-default: enum (default) { default:0xffffffff } , table: enum } } }	要添加路由的路由表，格式为 `table` 或 `table:distance` 条目。此处给定的距离会覆盖该表的 `default-route-distance`。`default` 是主路由表；当客户端接口属于 VRF 时，则是该 VRF 路由表。默认值：default。
`check-gateway`	enum (none \| arp \| ping \| bfd)	客户端添加的路由上设置的网关检查（`none`、`arp`、`ping` 或 `bfd`），因此路由仅在其网关响应时使用。参见网关可达性。默认值：none。
`use-peer-dns`	bool	是否使用从 DHCP 服务器收到的 DNS 服务器。它们会添加到 DNS 解析器的动态服务器（`/ip/dns`）。默认值：yes。
`use-peer-ntp`	bool	是否使用从 DHCP 服务器收到的 NTP 服务器。它们作为动态条目添加到 NTP 客户端服务器（`/system/ntp/client/servers`）。默认值：yes。
`allow-reconfigure`	bool	是否接受来自 DHCP 服务器的 Reconfigure（FORCERENEW）消息。启用后，客户端在绑定时请求 reconfigure 密钥，服务器在其回复中发送该密钥。密钥用于验证服务器的 Reconfigure 消息（RFC 6704，HMAC-MD5）。收到 Reconfigure 消息时，客户端立即续订租约。服务器只能向启用了此设置后绑定的客户端发送 Reconfigure 消息。默认值：no。
`vlan-priority`	num	客户端发送的数据包 VLAN 头中设置的优先级代码点（PCP，0-7）。仅在客户端运行于 VLAN 接口时适用。
`dscp`	num	客户端发送的数据包 IP 头中设置的 DSCP 值（0-63）。未设置时，数据包以 DSCP 0 发送。
`use-broadcast`	enum (always \| never \| both)	客户端是否在 DHCPDISCOVER 和 DHCPREQUEST 消息中设置广播标志，要求服务器广播其回复。续订请求以单播发送，且从不设置该标志。 - `both`（默认）- 在获取地址的前 15 秒设置该标志，然后不使用它继续。 - `always` - 始终设置该标志。 - `never` - 从不设置该标志。
`dhcp-options`	multi { array-id, option: enum }	客户端发送到 DHCP 服务器的选项，从 `/ip/dhcp-client/option` 按名称选择。预定义的 `clientid` 和 `clientid_duid` 选项都使用代码 61：`clientid` 通过其接口的 MAC 地址标识客户端，`clientid_duid` 通过路由器的 DUID（RFC 4361）标识客户端，与 DHCPv6 客户端使用相同的 DUID。默认值：hostname,clientid。
`script`	alt { script: string }	客户端获得租约以及丢失或释放租约时运行的脚本。脚本接收以下变量： - `bound` - 获得租约时为 `1`，丢失或释放时为 `0`。 - `server-address` - DHCP 服务器的 IP 地址。 - `lease-address` - 租约中的 IP 地址。 - `interface` - 客户端接口名称。 - `gateway-address` - 从服务器收到的网关。 - `vendor-specific` - 从服务器收到的供应商特定信息选项（选项 43）的值。 - `lease-options` - 从服务器收到的选项数组，按选项代码索引。二进制选项的值为十六进制字符串。

只读参数	类型	描述
`custom-source-mac-address`	macAddr	DHCP 客户端使用的自定义源 MAC 地址。
`custom-hostname-suffix`	string	附加到发送给 DHCP 服务器的主机名后的后缀。
`status`	enum (stopped \| searching... \| requesting... \| bound \| renewing... \| rebinding... \| error) { stopped:0, searching...:1, requesting...:2, bound:3, renewing...:4, rebinding...:5, error:6 }	客户端当前状态： - `searching...` - 发送 DHCPDISCOVER 消息并等待提供。 - `requesting...` - 请求提供的地址。 - `bound` - 客户端拥有租约。 - `renewing...` - 从租约时间的一半开始，向签发租约的服务器续订。 - `rebinding...` - 服务器未应答续订。从租约时间的 87.5% 开始，向任意服务器请求租约。 - `stopped` - 客户端已禁用。 - `error` - 客户端无法运行。
`address`	composite { address: ipAddr , netmask: num [ .. 32] }	从 DHCP 服务器收到的 IP 地址和前缀长度。
`netmask`	ipAddr	从 DHCP 服务器收到的子网掩码。
`gateway`	ipAddr	从 DHCP 服务器收到的网关（选项 3）。
`dhcp-server`	ipAddr	签发租约的 DHCP 服务器的 IP 地址。
`primary-dns`	ipAddr	从 DHCP 服务器收到的第一个 DNS 服务器。
`secondary-dns`	ipAddr	从 DHCP 服务器收到的第二个 DNS 服务器。
`primary-ntp`	ipAddr	从 DHCP 服务器收到的第一个 NTP 服务器。
`secondary-ntp`	ipAddr	从 DHCP 服务器收到的第二个 NTP 服务器。
`cmr-address`	ipAddr
`caps-managers`	multi { ip: ipAddr }	从 DHCP 服务器收到的 CAPsMAN 地址（选项 138）。
`reconfigure-key`	string	从 DHCP 服务器收到的密钥，用于验证其 Reconfigure 消息（RFC 6704，HMAC-MD5）。仅在启用 `allow-reconfigure` 时设置。
`reconfigure-last-counter`	string	从 DHCP 服务器接受的最后一条 Reconfigure 消息的重放检测计数器。客户端绑定时从 0 开始，并随每条 Reconfigure 消息递增。
`expires-after`	time	租约过期前的时间。