泛域名SSL在宝塔中必须使用DNS验证,HTTP验证不支持;需配置DNS API权限、填写正确泛域名格式(如*.example.com,example.com)、手动设置Nginx server_name并添加续期计划任务。

泛域名SSL在宝塔里必须用DNS验证,HTTP验证行不通
泛域名(如 *.example.com)不支持 HTTP 方式验证,ACME 协议明确要求泛域名只能走 DNS-01 挑战。宝塔面板默认的「文件验证」或「自动验证」按钮点下去会失败,日志里大概率看到 Cannot issue for "*.xxx": Domain is not valid for issuance 或 NS error: No TXT record found 这类提示——不是宝塔有问题,是验证路径选错了。
必须手动切换到 DNS API 模式,并确保你用的 DNS 服务商在 ACME 支持列表里(阿里云、腾讯云、Cloudflare 最常用)。
- 确认你的域名 DNS 解析托管在支持的平台(比如阿里云云解析 DNS),且账号有 API 权限(RAM 子用户需授予
Alidns:DescribeDomainRecords和Alidns:AddDomainRecord等权限) - 在宝塔「网站」→「SSL」→「其他证书」→「Let's Encrypt」里,不要点「申请」,先点右上角「设置」→ 勾选「使用 DNS API 验证」
- 下拉选择对应 DNS 服务商,填入
AccessKey ID和AccessKey Secret(阿里云)或API Token(Cloudflare),注意 Cloudflare 的 Token 需带Zone:Read和DNS:Edit权限
填泛域名时必须带星号且只填一级通配符
申请框里写 *.example.com 是对的,但写 *.sub.example.com 或 **.example.com 都会失败;ACME 不允许多级通配或嵌套通配。另外,不能只填 * 或 example.com —— 泛域名证书必须显式包含 *. 前缀,且主域名(example.com)建议一并加入,否则访问根域名会提示证书不匹配。
- 推荐在「域名」输入框里这样填:
*.example.com,example.com(逗号分隔,无空格) - 如果还想覆盖
www.example.com,也得加进去:*.example.com,example.com,www.example.com,但注意 Let's Encrypt 单张证书最多 100 个域名,泛域名本身已占一个主体,别堆太多 - 填完别急着提交,先点「测试 DNS API」按钮——宝塔会尝试添加一条临时 TXT 记录并查询,成功才代表凭证和权限没问题
自动续期依赖 cron 任务,但宝塔默认不自动启用
DNS API 模式申请成功后,证书有效期是 90 天,但宝塔不会像 HTTP 模式那样自动挂载续期任务。如果你没手动干预,到期前 20 天左右面板右上角会出现黄色提醒,点进去看「自动续签」开关仍是灰色的——这是正常现象,因为 DNS 续期需要复用相同 API 凭据,宝塔不会默认帮你保存并触发。
- 进「计划任务」→「添加计划任务」→ 任务类型选「Shell 脚本」→ 执行周期设为「每天 03:00」(避开 Let's Encrypt 请求高峰)
- 脚本内容填:
bt 71 && bt 72
(bt 71是重载 SSL 配置,bt 72是强制续签所有可续签证书) - 更稳妥的做法是单独指定站点续签:
/www/server/panel/pyenv/bin/python /www/server/panel/class/acme_v2.py --renew=www.example.com
,把www.example.com换成你实际的主域名
证书部署后 Nginx 配置要手动检查 server_name
宝塔生成的泛域名证书虽然绑定了,但默认站点配置里的 server_name 可能还是写的具体域名(比如 www.example.com),导致 api.example.com 或 shop.example.com 访问时走不到这个 HTTPS 配置,浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID。
- 进「网站」→「设置」→「配置文件」,找到
server_name行,改成:server_name *.example.com example.com; - 注意:Nginx 不支持
server_name *这种写法,必须写完整通配格式;如果子域名太多,也可以用正则:server_name ~^(?<subdomain>.+)\.example\.com$;</subdomain>,但需配合ssl_certificate和ssl_certificate_key动态加载(宝塔不原生支持,需手写逻辑) - 改完务必点「重载配置」,别只保存——否则 reload 不生效,HTTPS 仍会 fallback 到默认站点或报错
最常被忽略的是 DNS API 权限粒度和续期脚本执行权限:RAM 子用户如果只给了读权限,申请能过,续期会卡在「添加 TXT 记录失败」;而 cron 任务默认以 root 身份运行,但部分云厂商 SDK(如腾讯云)要求 ~/.tencentcloud/credentials 文件存在,得提前配好或改用环境变量方式传参。


















