/ip/dhcp-server/lease

lease

Leases of the DHCP servers. Dynamic leases are created when clients get an address from a pool; static leases give a specific client a fixed address, a pool, or its own settings. For details, see DHCP Server.


ip/dhcp-server/lease

Type: Directory

DHCP 服务器的租约。动态租约在客户端从池中获得地址时创建;静态租约为特定客户端提供固定地址、池或其自己的设置。详情参见 DHCP 服务器。

标志名称描述
Xdisabled租约已禁用。
Rradius租约由 RADIUS 服务器分配。
Ddynamic租约是动态的:在客户端从池中获得地址时创建。使用 make-static 将其转换为静态租约。
Bblocked客户端被阻止(block-access=yes),服务器不会向其回复。
参数类型描述
addressalt { ip-address: ipAddr , pool: enum }静态租约的 IP 地址,或用于向客户端分配地址的 IP 池名称。使用 0.0.0.0 时,使用服务器的地址池。
mac-addressmacAddr静态租约所属客户端的 MAC 地址。
use-src-macbool是否通过客户端数据包的源 MAC 地址而不是 DHCP 消息的客户端硬件地址字段(chaddr)来识别客户端。
client-idstring静态租约所属客户端的客户端标识符(选项 61),格式如 active-client-id 所示,例如 1:4e:97:a1:4c:d1:38。
rate-limitstring客户端的带宽限制,格式为 rx-rate[/tx-rate] [rx-burst-rate[/tx-burst-rate] [rx-burst-threshold[/tx-burst-threshold] [rx-burst-time[/tx-burst-time]]]]。速率单位为比特每秒,带可选 k 或 M 后缀,缺失的 tx 值取自 rx 值。仅静态租约可以有速率限制。 服务器为租约地址创建一个名为 dhcp-ds<hostname/MAC> 的动态简单队列,将此限制作为 limit-at 和 max-limit。
routesobject { route: composite { dst-address: address (flags=4/) , gateway: [ composite { gateway: address (flags=46ivL) , distance: [ num [1 .. 255]] }] } }租约绑定期间服务器添加的路由,格式为 dst-address/mask gateway distance 条目,用逗号分隔,例如 10.77.0.0/24 172.31.255.105 5。
insert-queue-beforeenum (bottom | first) { bottom:0xffffffff, first:0 }为此租约创建的动态简单队列的位置:first(默认)位于 /queue/simple 顶部,bottom 位于末尾,或指定队列之前。
parent-queueenum (none) { none:0 }为此租约创建的动态简单队列的父队列。默认值:none。
queue-typeenum为此租约创建的动态简单队列的队列类型。
address-listsmulti { array-id, address-list: string }租约绑定期间将租约地址添加到的防火墙地址列表。
serverenum (all) { all:0 }租约所属的 DHCP 服务器。使用 all 时,静态租约在所有服务器上有效。
block-accessbool是否阻止客户端:服务器不应答该客户端,租约获得 B 标志。默认值:no。
allow-dual-stack-queuebool此租约和同一客户端的 DHCPv6 绑定是否共享一个动态简单队列,该队列随后同时包含 IPv4 和 IPv6 地址。默认值:yes。
lease-timetime此客户端的租约时间。未设置或设置为 0s 时,使用服务器的 lease-time。
always-broadcastbool是否向此客户端广播回复,即使它未设置广播标志。默认值:no。
dhcp-optionmulti { array-id, option: enum }要发送给此客户端的选项(/ip/dhcp-server/option)。它们优先于服务器和网络的选项。
dhcp-option-setenum (none)要发送给此客户端的选项集(/ip/dhcp-server/option/sets)。它优先于服务器和网络的选项。
agent-circuit-idstring设置后,租约匹配中继代理信息(选项 82)包含此 circuit ID 的请求,即使 MAC 地址或客户端 ID 不同。
agent-remote-idstring设置后,租约匹配中继代理信息(选项 82)包含此 remote ID 的请求,即使 MAC 地址或客户端 ID 不同。
只读参数类型描述
statusenum (waiting | testing | declined | offered | bound | authorizing | conflict) { waiting:0, testing:1, declined:2, offered:3, bound:4, authorizing:5 }租约状态: - waiting - 未使用的静态租约。 - testing - 服务器正在检查地址冲突(conflict-detection)。 - offered - 服务器已提供地址,正在等待客户端的请求。 - bound - 客户端正在使用该地址。 - authorizing - 服务器正在等待 RADIUS 服务器的回复。 - conflict - 另一台主机已在使用该地址。租约在租约时间内保留该地址不使用;当另一台主机不再应答时,check-status 会释放它。 - declined - 客户端通过 DHCPDECLINE 消息拒绝了该地址。
expires-aftertime租约过期前的时间。
last-seenalt { symbolic-names: enum (never | sometime) { never:0xffffffff, sometime:0xfffffffe } , time: time }自服务器上次收到客户端请求以来的时间,或 never。
agetime自租约创建以来的时间。
active-addressipAddr客户端使用的 IP 地址。
active-mac-addressmacAddr使用该租约的客户端的 MAC 地址。
active-client-idstring使用该租约的客户端的客户端标识符(选项 61)。
active-serverenum为客户端提供服务的 DHCP 服务器。
active-agent-circuit-idstring客户端请求的中继代理信息(选项 82)中的 Circuit ID,十六进制形式。
active-agent-remote-idstring客户端请求的中继代理信息(选项 82)中的 Remote ID,十六进制形式。
active-agent-circuit-id-asciistring客户端请求的中继代理信息(选项 82)中的 Circuit ID,文本形式。
active-agent-remote-id-asciistring客户端请求的中继代理信息(选项 82)中的 Remote ID,文本形式。
host-namestring客户端发送的主机名(选项 12)。
class-idstring最后收到的 DHCP 请求中的 DHCP 选项 60
src-mac-addressmacAddr客户端最后一次请求的源 MAC 地址。
reconfigure-keystring服务器在客户端绑定时于回复中提供给客户端的密钥,用于验证 Reconfigure 消息(RFC 6704,HMAC-MD5)。需要服务器上的 use-reconfigure。
reconfigure-last-sentstring发送给客户端的最后一条 Reconfigure 消息的重放检测计数器。它随每条 Reconfigure 消息递增。
reconfigure-statusstring