当 Cloudflare One Appliance 被配置为 LAN 的 DHCP 服务器时,您可以向它发出的租约中附加自定义 DHCP 选项。这通常用于:
- 使用 PXE、PXELINUX 或 iPXE 对工作站或自助终端进行 网络引导(选项 43、60、66、67、175、209 和 210)。
- VoIP 电话配置(选项 66 — TFTP 服务器)。
- 特定于供应商的客户端配置(选项 43 及其供应商子选项)。
仅当设备充当 DHCP 服务器时,才能配置 DHCP 选项。当设备处于 DHCP 中继 模式时,它们不起作用。
- 转到 Connectors(连接器) 页面。
- 转到 Appliances(设备) 选项卡 > Profiles(配置文件)。
- 选择您的 Cloudflare One Appliance > Edit(编辑)。
- 选择 Network Configuration(网络配置)。
- 在 LAN configuration(LAN 配置) 中,选择 Add LAN(添加 LAN) 以创建新 LAN,或选择现有 LAN > Edit(编辑)。
- 确保已选中 This is a DHCP server(这是 DHCP 服务器)。
- 在 DHCP server options(DHCP 服务器选项) 中,选择 Add DHCP option(添加 DHCP 选项)。
- 选择列出的常用选项之一,或选择 Add custom option(添加自定义选项) 以输入您自己的选项代码、类型和值。
- 选择 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 WriteMagic Transit Write
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 选项配置之前,设备将:
- 将更改暂存到临时配置文件中。
- 与底层 DHCP 服务器一起验证语法。
- 成功时,原子地将暂存的配置替换到位并重新加载 DHCP 服务器,而不会中断服务。
- 失败时,放弃更改并将底层验证错误返回给调用者——在仪表板中显示为字段错误,或在 API 和 Terraform 调用者的 API 响应中显示。永远不会使用未经验证的配置重新启动实时 DHCP 服务。
这意味着格式错误的选项将在应用时被拒绝,而不是破坏 LAN 上客户端的 DHCP 服务。