# 【问题反馈】Cloudflare 非顶级 Zone 无法同步,导致免费证书续签失败
## 概述
当 Cloudflare 中托管的 Zone 本身是某个公共后缀域名的子域名时,宝塔会把该 Zone 错误识别成其父域的子域,导致:
1. DNS 域名列表中可以获取到该 Zone,但点击“同步”失败;
2. 免费证书申请或自动续签时写入 ACME DNS 记录失败;
3. 开启“自动泛域名”时,申请域名甚至会被错误改成父域。
---
## 环境信息
| 项目 | 信息 |
|---|---|
| 宝塔面板 | 13.2.0 |
| 操作系统 | Debian GNU/Linux 13 |
| Web 服务 | Nginx |
| DNS 提供商 | Cloudflare API Token |
| 证书类型 | Let's Encrypt / LiteSSL 免费证书 |
| 认证方式 | DNS-01 |
| 复现时间 | 2026-11-15 |
---
## Cloudflare 账户中的实际 Zone
Token 对应的活动 Zone 如下(示例):
```text
116924.xyz
116925.xyz
buyun13.eu.cc
```
其中 `buyun13.eu.cc` 是 Cloudflare 中正常托管并可管理的独立 Zone,并不是普通网站子域名。
但在宝塔中,`116924.xyz`、`116925.xyz` 可以正常同步,`buyun13.eu.cc` 始终只能看到“同步”按钮;点击后不能成功加入 DNS 域名列表。
---
## 复现步骤
### DNS 域名同步
1. 在“SSL → DNS 接口设置”中添加 Cloudflare API Token;
2. 打开“DNS 域名管理”或域名同步页面;
3. 获取 Cloudflare Zone 列表;
4. 三个 Zone 均能被接口返回;
5. 点击 `buyun13.eu.cc` 后的“同步”。
**实际结果:**
```text
只能添加顶级域名
```
**期望结果:**
Cloudflare 账号实际拥有权限的 Zone 均应允许同步,包括 `buyun13.eu.cc` 这种 Zone 名称本身为多级域名的场景。
### 免费证书申请或续签
1. 对 `buyun13.eu.cc` 使用 DNS API 验证申请或续签证书;
2. 开启“自动泛域名”;
3. 面板创建 ACME 订单并尝试写入 `_acme-challenge` TXT 记录。
**实际结果:**
日志最终失败:
```text
Traceback (most recent call last):
...
File "/www/server/panel/class/sslModel/dataModel.py", line 575, in add_dns_value_by_domain
raise Exception("设置解析记录失败:{}".format(_return["msg"]))
Exception: 设置解析记录失败:此域名配置的dns账号不正确
```
同时,界面提交的证书域名是:
```text
buyun13.eu.cc
```
但实际 ACME 订单被扩展成了:
```text
eu.cc
*.eu.cc
```
这两个域名并不是 Token 中可管理的 Cloudflare Zone,因此证书验证必然无法完成。
---
## 根因分析
宝塔当前通过公共后缀列表拆分域名:
```text
public.split_domain_sld("buyun13.eu.cc")
```
在当前环境中返回:
```text
("eu.cc", "buyun13")
```
即宝塔认为:
- 根域名:`eu.cc`
- 子域名:`buyun13`
但 DNS 提供商的实际托管边界是:
```text
buyun13.eu.cc
```
公共后缀算法得到的是“可注册域名边界”,而 Cloudflare Zone 的实际托管边界不一定相同。Cloudflare 允许将某个子域名单独托管为 Zone,因此不能只用公共后缀拆分结果判断 DNS Zone。
该差异进一步引发四个问题:
1. 域名同步接口用“是否顶级域名”做校验,拒绝 `buyun13.eu.cc`;
2. Cloudflare 记录接口用 `eu.cc` 查询 Zone,而实际 Zone 是 `buyun13.eu.cc`;
3. 自动泛域名使用公共后缀根域名,错误生成 `eu.cc + *.eu.cc`;
4. 自动续签检查 DNS API 绑定时查询 `eu.cc`,即使 `buyun13.eu.cc` 已绑定也会被跳过。
---
## 建议修复方向
建议以 DNS 提供商的“实际 Zone 列表”或本地已同步的最长 Zone 作为判断依据,而不是直接使用公共后缀拆分结果。
### 1. DNS 域名同步
Cloudflare 等支持任意层级 Zone 的提供商,应允许同步账号实际返回的 Zone,而不是强制要求满足“顶级域名”判断。
### 2. Cloudflare 记录操作
查询、新增、修改、删除记录前,应在账号实际 Zone 列表中做最长后缀匹配:
```text
buyun13.eu.cc -> Zone: buyun13.eu.cc, 记录主机名: @
www.buyun13.eu.cc -> Zone: buyun13.eu.cc, 记录主机名: www
_acme-challenge.buyun13.eu.cc -> Zone: buyun13.eu.cc, 记录主机名: _acme-challenge
*.buyun13.eu.cc -> Zone: buyun13.eu.cc, 记录主机名: *
```
### 3. 免费证书自动泛域名
如果用户提交的 DNS 认证 Zone 是 `buyun13.eu.cc`,自动泛域名应生成:
```text
buyun13.eu.cc
*.buyun13.eu.cc
```
不应生成:
```text
eu.cc
*.eu.cc
```
### 4. 自动续签 DNS 绑定检查
续签时应使用本地已同步的最长 Zone 查找 DNS API,例如优先匹配 `buyun13.eu.cc`,回退到 `eu.cc`。
---
## 临时验证结果
在本地按“最长实际 Zone 匹配”修改后,已验证:
- `buyun13.eu.cc` 可正常同步到 DNS 域名列表;
- `buyun13.eu.cc` 和 `*.buyun13.eu.cc` 均可绑定到 Cloudflare DNS API;
- 临时 `_acme-challenge` TXT 记录可成功写入、读取并删除;
- 自动泛域名生成结果恢复为 `buyun13.eu.cc + *.buyun13.eu.cc`;
- 免费证书续签前置检查不再把该 Zone 判断为 `eu.cc`。
|
|