宝塔双11:分享抽 iPad 等好礼,100% 中奖!查看活动
当前位置:论坛首页 > Linux面板 > 建议

【已记录】loudflare 非顶级 Zone 无法同步,导致免费证书续签

发表在 Linux面板昨天 18:59 [复制链接] 1 27

# 【问题反馈】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`。






使用道具 举报 只看该作者 回复
发表于 8 小时前 | 显示全部楼层
您好,非常感谢反馈和支持!您的建议已收到并记录,后续会联系相关人员进行技术评估
面板相关问题建议优先联系您的专属客服处理。您可在面板或个人后台查看“专属客服”入口,扫描二维码后即可咨询。如未找到二维码的话可私聊将付费记录发送至我的消息,这边会处理您的问题,如果您当前没有专属客服(如免费版用户),可通过官方微信客服在线咨询。
操作方式:复制以下链接,
https://docs.bt.cn/wechat-service或https://work.weixin.qq.com/kfid/kfc2736fb7043e75033
在微信中打开:进入页面后,即可与在线客服沟通。
使用道具 举报 回复 支持 反对
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

紧急运维服务

响应时间:3分钟

问题处理方式:宝塔专家1对1服务

工作时间:工作日:9:00 - 18:30

宝塔专业团队为您解决服务器疑难问题

点击联系技术分析

工作时间:09:00至18:30

快速回复 返回顶部 返回列表