Cloudflare IPv6 怎么关闭或开启?开关灰色、API 与验证排查
简答:Cloudflare IPv6 Compatibility 默认开启:在控制台进入 Network 页面即可查看并开启;但官方资料显示 Free、Pro、Business 可使用却不能自定义关闭,只有 Enterprise 可关闭。若源站只支持 IPv4,通常不要直接关闭,而应保留 IPv6 Compatibility 并配置 Pseudo IPv4。
定义:Cloudflare IPv6 Compatibility 是面向代理记录的区域网络设置,用于让 IPv6 客户端通过 Cloudflare 访问网站;开启时 Cloudflare 会自动生成并宣告相应 AAAA 记录。
先判断:你要关闭的是 IPv6 Compatibility,还是要阻断所有 IPv6 流量?
本文为独立整理,非 Cloudflare 官方,引用页面仅作参考,与本站无合作关系。先区分两个目标:关闭 IPv6 Compatibility,主要是不再由 Cloudflare 为代理记录自动生成并宣告 AAAA;彻底阻断 IPv6 流量,则还要处理可能经由其他路径到达的请求。Cloudflare 官方明确说明,即使 IPv6 Compatibility 已关闭,域名仍可能收到部分 IPv6 流量,例如来自 Tor 网络的流量。Cloudflare IPv6 Compatibility 文档
| 你的实际问题 | 优先方案 | 不要先做什么 |
|---|---|---|
| 源站程序只识别 IPv4 地址 | 保持 IPv6 Compatibility 开启,配置 Pseudo IPv4 | 不要因为源站日志显示 IPv6 就立即关闭整个功能 |
| Free、Pro 或 Business 账户想关闭开关 | 先查看 API 返回的 editable,确认是否受计划限制 | 不要反复刷新页面或误以为开关灰色是浏览器故障 |
| 希望所有 IPv6 请求都被拒绝 | 关闭 Onion Routing,并使用 WAF 自定义规则阻断 IPv6 | 不要把关闭 IPv6 Compatibility 当成彻底封锁 |
| 只有某个访客网络访问异常 | 分别测试 IPv4、IPv6、DNS 和源站连接 | 不要只凭一个客户端的访问结果判断全站配置 |
Cloudflare 官方列出的账户可用性是:Free、Pro、Business、Enterprise 都可使用 IPv6 Compatibility,但“可自定义关闭”标注为仅 Enterprise。具体到你的区域,仍应以控制台开关状态和 API 返回的 editable 字段为准。
控制台怎么开启或关闭 Cloudflare IPv6?
- 登录 Cloudflare Dashboard,选择目标域名。
- 进入 Network 页面。
- 找到 IPv6 Compatibility。
- Enterprise 账户可按需要切换开关;其他计划如果显示不可编辑,应转到 Pseudo IPv4 或保留开启。
- 保存后不要只看页面状态,继续用下方 DNS、API 和强制 IPv4/IPv6 测试核对结果。
开启时,Cloudflare 会对覆盖在代理 DNS 记录上的域名和子域名提供 IPv6 兼容能力,并自动生成、宣告 AAAA 记录。关闭时,Cloudflare 不再自动生成和宣告这些 AAAA 记录,但 DNS-only 记录仍由其自身的 DNS 内容决定。对于灰云 DNS-only 记录,公共 DNS 查询通常会返回记录中的实际源站地址,而不是 Cloudflare 代理地址;这一点可参考Cloudflare Proxy status 文档。
如果域名通过托管合作伙伴接入,或使用 CNAME setup(Partial),官方文档提示 IPv6 Compatibility 不适用于 apex 域名。Partial setup 保留原权威 DNS,同时只代理指定子域名,因此应先确认权威 DNS 中哪些主机名实际指向 Cloudflare,再判断开关影响范围。可查看Cloudflare CNAME setup(Partial)文档。
免费版不能关闭时:用 Pseudo IPv4 兼容 IPv4-only 源站
如果问题是源站、旧版应用、日志系统或风控组件只接受 IPv4 格式地址,关闭 IPv6 Compatibility 往往不是最佳第一步。Cloudflare 官方建议非 Enterprise 用户保持 IPv6 Compatibility 开启,并配置 Pseudo IPv4,让 IPv6-only 客户端仍可访问 IPv4-only 源站。Cloudflare Pseudo IPv4 文档
- 进入目标域名的 Network 页面。
- 找到 Pseudo IPv4 设置。
- 按你的源站程序处理方式选择对应配置,并保存。
- 再次测试应用日志、客户端真实地址识别和登录、风控等功能。
| 对比项 | 关闭 IPv6 Compatibility | 配置 Pseudo IPv4 |
|---|---|---|
| 适用账户 | 官方文档标注为 Enterprise 可自定义关闭 | Free、Pro、Business、Enterprise 均可使用 |
| IPv6-only 客户端 | 可能无法通过自动生成的 AAAA 访问 | 可继续通过 IPv6 连接到 Cloudflare,再兼容 IPv4-only 源站 |
| 主要解决的问题 | 减少 Cloudflare 自动提供的 IPv6 入口 | 让只会处理 IPv4 格式的源站或应用继续工作 |
| 验证重点 | AAAA 是否消失、API 值是否为 off | 源站日志和应用是否能正确处理转换后的地址 |
用 API 查询和修改 ipv6 设置:PowerShell 安全写法
Cloudflare API 的区域设置 ID 是 ipv6。官方 API 支持用 API Token 作为首选认证方式,读取设置至少需要 Zone Settings Read,修改设置至少需要 Zone Settings Write。查询结果中的 value 表示当前状态,editable 表示该区域是否允许修改。Get zone setting API 文档 Edit zone setting API 文档
下面的 Windows PowerShell 写法不把 SecureString 直接写入环境变量,也不依赖 PowerShell 5.1 调用 curl.exe 时的 JSON 引号转义行为:
$secure = Read-Host 'Cloudflare API Token' -AsSecureString
$ptr = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($secure)
try {
$token = [Runtime.InteropServices.Marshal]::PtrToStringBSTR($ptr)
}
finally {
[Runtime.InteropServices.Marshal]::ZeroFreeBSTR($ptr)
}
$zoneName = 'example.com'
$headers = @{ Authorization = "Bearer $token" }
$zoneResponse = Invoke-RestMethod `
-Method Get `
-Uri "https://api.cloudflare.com/client/v4/zones?name=$zoneName" `
-Headers $headers
$zoneId = $zoneResponse.result[0].id
# 查询当前 IPv6 Compatibility 状态
$current = Invoke-RestMethod `
-Method Get `
-Uri "https://api.cloudflare.com/client/v4/zones/$zoneId/settings/ipv6" `
-Headers $headers
$current.result | Format-List id,value,editable,modified_on
# 修改为关闭;开启时把 off 改为 on
$body = @{ value = 'off' } | ConvertTo-Json
$changed = Invoke-RestMethod `
-Method Patch `
-Uri "https://api.cloudflare.com/client/v4/zones/$zoneId/settings/ipv6" `
-Headers $headers `
-ContentType 'application/json' `
-Body $body
$changed.result | Format-List id,value,editable,modified_on
# 用完清理会话变量
Remove-Variable secure,ptr,token,zoneName,headers,zoneResponse,zoneId,current,body,changed -ErrorAction SilentlyContinue如果返回 editable: false,说明该区域当前不能按 API 修改;这与“开关灰色”是一致的权限信号。不要把 Global API Key 放进脚本、命令历史或日志;官方 API 文档将 API Token 列为首选认证方式,并把 API Email + API Key 标为旧认证方式。
关闭或开启后怎么验证:DNS、curl 和交叉测试
- 先查公共 DNS:分别查看目标主机名的 A 和 AAAA 记录。代理记录返回的是 Cloudflare 边缘地址,不是控制台中填写的源站地址;不要拿两者直接比较来判断源站配置是否正确。
- 再做协议交叉测试:用
curl -4强制 IPv4,用curl -6强制 IPv6,比较连接是否成功、HTTP 状态和失败位置。 - 最后查询 API:确认
result.value是on还是off,同时记录editable。 - 若只有一个网络失败,再换一条 Wi-Fi、手机热点或另一台设备复测,避免把本地 IPv6 路由问题误判成 Cloudflare 区域设置问题。
# DNS 查询示例
nslookup -type=A www.example.com
nslookup -type=AAAA www.example.com
# Linux、macOS 或已安装 curl 的环境
curl -4 -I https://www.example.com/
curl -6 -I https://www.example.com/
# Windows PowerShell:明确调用 curl.exe
curl.exe -4 -I https://www.example.com/
curl.exe -6 -I https://www.example.com/| 现象 | 优先解释 | 下一步 |
|---|---|---|
| API 为 off,AAAA 仍存在 | 可能是手动 AAAA、DNS-only 记录、缓存或接入方式不同 | 检查 DNS 记录来源、代理状态和权威 DNS |
| 代理主机名有 AAAA,但地址不是源站 IPv6 | 通常是 Cloudflare 边缘地址,不代表源站配置错误 | 改用 API、源站日志和代理状态核对 |
curl -4 成功、curl -6 失败 | 可能是客户端到边缘、IPv6 路由或 DNS 路径问题 | 更换网络复测,再保留 traceroute 或系统网络诊断结果 |
| API 返回 editable 为 false | 当前账户或区域不允许自定义修改 | 使用 Pseudo IPv4,或按账户权限选择可行方案 |
如果你还在排查解析记录不生效,可继续阅读站内的Cloudflare DNS 解析不生效排查指南;如果需要区分访问链路和测试结果,可参考Cloudflare Speed Test 结果与网络异常排查。
想彻底阻断 IPv6 流量时的额外步骤
关闭 IPv6 Compatibility 只处理 Cloudflare 自动生成和宣告 AAAA 的行为,并不等于所有 IPv6 请求都会被拒绝。Cloudflare 官方给出的彻底阻断思路包括:关闭 Onion Routing;再创建 WAF 自定义规则,使用 ip.src in {::/0} 匹配 IPv6 来源并执行阻断;如果站点使用 Workers,还应按官方示例加入 and cf.worker.upstream_zone == "",避免误伤 Workers 子请求。IPv6 Compatibility 官方阻断说明
- 先确认你确实要拒绝 IPv6-only 用户,因为阻断后这类客户端可能无法访问。
- 在域名的网络设置中关闭 Onion Routing。
- 进入安全规则,创建区域级 WAF Custom Rule。
- 使用官方给出的 IPv6 匹配表达式;对生产域名直接使用 Block 前,先通过安全事件观察命中情况,或在单独测试主机名上用 Managed Challenge 小范围验证。
- 启用后用
curl -6、安全事件和应用日志复核,不要只看 DNS 的 AAAA 结果。
Cloudflare 的 Custom Rules 文档说明,区域级自定义规则可在控制台或 API 创建,并可使用 Block 或 Managed Challenge 等动作;规则按顺序评估,前面的阻断规则可能使后续规则不再执行。Cloudflare Custom Rules 文档
常见问题
Cloudflare IPv6 Compatibility 默认是开启的吗?
是。Cloudflare 官方文档说明,该功能默认开启,并适用于代理 DNS 记录覆盖的域名和子域名。开启后 Cloudflare 会自动生成并宣告 AAAA 记录。
为什么 Free 版的 IPv6 开关不能关闭?
官方可用性表将 Free、Pro、Business、Enterprise 都列为可使用,但“Can customize”仅列 Enterprise。因此 Free、Pro、Business 显示不可编辑通常是计划权限限制,不是 PowerShell 或浏览器问题。可通过 API 查询 editable 再确认。
源站只有 IPv4,需要关闭 Cloudflare IPv6 吗?
不一定。Cloudflare 官方建议保留 IPv6 Compatibility,并配置 Pseudo IPv4,使 IPv6-only 客户端仍可连接 IPv4-only 源站。只有在明确需要减少 Cloudflare IPv6 入口且账户权限允许时,才考虑关闭。
关闭后为什么还能看到 IPv6 请求?
因为关闭 IPv6 Compatibility 不等于阻断所有 IPv6 流量。官方特别提到仍可能通过 Tor 等路径收到 IPv6 流量;需要同时处理 Onion Routing 和 WAF 自定义规则。
代理记录查询到的 AAAA 是不是源站 IPv6?
通常不是。代理记录的公共 DNS 响应指向 Cloudflare 边缘地址;DNS-only 记录才会解析到记录中的实际源站地址。请结合代理状态、API 设置、源站日志和强制 IPv4/IPv6测试判断。
API 修改失败时先看什么?
先检查 Token 是否有 Zone Settings Write 权限、Zone ID 是否属于目标域名,再看 API 返回的 editable 是否为 false。若不可编辑,应改用 Pseudo IPv4 或按账户权限处理,不要重复发送相同 PATCH 请求。
常见问题
Cloudflare IPv6 Compatibility 默认开启吗?
是。官方文档说明默认开启,并会对代理 DNS 记录自动生成和宣告 AAAA 记录。
免费版为什么不能关闭 IPv6?
官方资料显示 Free、Pro、Business、Enterprise 都可使用该功能,但可自定义关闭仅列 Enterprise;可通过 API 的 editable 字段确认当前区域权限。
源站只有 IPv4,是否应该关闭 IPv6?
通常不应先关闭。Cloudflare 建议保留 IPv6 Compatibility 并配置 Pseudo IPv4,让 IPv6-only 客户端仍可连接 IPv4-only 源站。
关闭后为什么还会收到 IPv6 流量?
关闭 IPv6 Compatibility 不等于阻断所有 IPv6 流量。还可能存在 Onion Routing 等路径,需要结合 WAF 自定义规则处理。