跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

DHCP 服务器选项

最后更新 查看 MarkdownAgent 设置

当 Cloudflare One Appliance 被配置为 LAN 的 DHCP 服务器时,您可以向它发出的租约中附加自定义 DHCP 选项。这通常用于:

  • 使用 PXE、PXELINUX 或 iPXE 对工作站或自助终端进行 网络引导(选项 43、60、66、67、175、209 和 210)。
  • VoIP 电话配置(选项 66 — TFTP 服务器)。
  • 特定于供应商的客户端配置(选项 43 及其供应商子选项)。

仅当设备充当 DHCP 服务器时,才能配置 DHCP 选项。当设备处于 DHCP 中继 模式时,它们不起作用。

配置 DHCP 选项

  1. 转到 Connectors(连接器) 页面。
前往 Connectors(连接器) ↗
  1. 转到 Appliances(设备) 选项卡 > Profiles(配置文件)。
  2. 选择您的 Cloudflare One Appliance > Edit(编辑)。
  3. 选择 Network Configuration(网络配置)。
  4. 在 LAN configuration(LAN 配置) 中,选择 Add LAN(添加 LAN) 以创建新 LAN,或选择现有 LAN > Edit(编辑)。
  5. 确保已选中 This is a DHCP server(这是 DHCP 服务器)。
  6. 在 DHCP server options(DHCP 服务器选项) 中,选择 Add DHCP option(添加 DHCP 选项)。
  7. 选择列出的常用选项之一,或选择 Add custom option(添加自定义选项) 以输入您自己的选项代码、类型和值。
  8. 选择 Save(保存)。

您也可以通过 API 和 Terraform,使用 LAN 的 dhcp_server 配置中的 dhcp_options 字段来配置 DHCP 选项。发送 PUT 请求 以更新要配置 DHCP 选项的 LAN:

Required API token permissions

At least one of the following token permissions is required:
  • Magic WAN Write
  • Magic Transit Write
Update Site LANbash
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/magic/sites/$SITE_ID/lans/$LAN_ID" \
	--request PUT \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"lan": {
				"static_addressing": {
						"dhcp_server": {
								"dhcp_options": [
										{
												"code": 67,
												"type": "text",
												"value": "boot/x64/pxelinux.0"
										}
								]
						}
				}
		}
	}'

选项格式

每个选项由三个字段定义:

字段 描述 示例
code DHCP 选项代码(1–254)。 67
type 值编码:text、hex、ip、byte、short、integer。 text
value 选项值,根据 type 进行编码。 boot/x64/pxelinux.0

值类型编码

类型 格式 示例值
text UTF-8 字符串(最多 255 字节)。 boot/x64/pxelinux.0
hex 冒号分隔的十六进制字节序列,用于子选项(最多 255 字节)。 01:04:aa:bb:cc
ip 点分十进制 IPv4 地址。 10.20.30.40
byte 无符号 8 位整数(0–255)。 1
short 无符号 16 位整数(0–65535)。 512
integer 无符号 32 位整数(0–4294967295)。 0

受限选项代码

  • 选项 0 和 255 由 RFC 2132 ↗ 保留,无法配置。
  • 选项 3、6 和 51 由 Cloudflare One Appliance 管理,无法配置,因为它们与连接器管理的配置(默认网关、DNS 服务器和租约时间)冲突。
  • 每个选项代码在每个 LAN 中只能使用一次。重复的选项代码将被拒绝。

常见的网络引导选项

最常用的网络引导选项包括:

选项 类型 用途
43 hex 特定于供应商的信息。子选项布局由供应商定义。
60 text 供应商类别标识符,通常为 PXEClient。
66 text TFTP 服务器名称。
67 text 引导文件名,例如 ipxe.pxe 或 undionly.kpxe。iPXE 也接受 URI,例如用于 iPXE 脚本的 HTTP URL。
175 hex Etherboot 和 iPXE 使用的客户端特定封装选项。IANA 将此选项列为暂定分配,并且不定义其负载。
209 text PXELINUX 配置文件名或路径,通过 TFTP 加载。
210 text PXELINUX TFTP 路径前缀,会前置到选项 209。

有关标准 DHCP 选项代码的完整列表,请参阅 IANA BOOTP/DHCP 参数注册表 ↗。

验证与应用行为

在应用新的 DHCP 选项配置之前,设备将:

  1. 将更改暂存到临时配置文件中。
  2. 与底层 DHCP 服务器一起验证语法。
  3. 成功时,原子地将暂存的配置替换到位并重新加载 DHCP 服务器,而不会中断服务。
  4. 失败时,放弃更改并将底层验证错误返回给调用者——在仪表板中显示为字段错误,或在 API 和 Terraform 调用者的 API 响应中显示。永远不会使用未经验证的配置重新启动实时 DHCP 服务。

这意味着格式错误的选项将在应用时被拒绝,而不是破坏 LAN 上客户端的 DHCP 服务。

这篇文档对您有帮助吗?