宝塔面板如何配置泛域名SSL证书_使用DNS API接口自动申请

阿宇姑娘_6006

阿宇姑娘_6006

2026-04-09

661人浏览

原创

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

宝塔面板如何配置泛域名ssl证书_使用dns api接口自动申请

泛域名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 凭据,宝塔不会默认帮你保存并触发。

SSL Certificate Checker
SSL Certificate Checker

SSL/TLS 证书到期检查器和域名健康监控。检查证书到期、颁发者信息、SAN 条目及证书链有效性,适用于单个或多个域名。

下载
  • 进「计划任务」→「添加计划任务」→ 任务类型选「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 ~^(?.+)\.example\.com$;,但需配合 ssl_certificate 和 ssl_certificate_key 动态加载(宝塔不原生支持,需手写逻辑)
  • 改完务必点「重载配置」,别只保存——否则 reload 不生效,HTTPS 仍会 fallback 到默认站点或报错

最常被忽略的是 DNS API 权限粒度和续期脚本执行权限:RAM 子用户如果只给了读权限,申请能过,续期会卡在「添加 TXT 记录失败」;而 cron 任务默认以 root 身份运行,但部分云厂商 SDK(如腾讯云)要求 ~/.tencentcloud/credentials 文件存在,得提前配好或改用环境变量方式传参。

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

ssl 宝塔面板

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
宝塔面板部署ThinkPHP6项目与LNMP环境配置实践
宝塔面板部署ThinkPHP6项目与LNMP环境配置实践

本专题围绕宝塔面板在 ThinkPHP6 项目部署中的实际应用展开,系统讲解 LNMP 环境一键搭建、站点创建、域名绑定、伪静态配置以及 PHP 版本切换等关键操作。内容还包括数据库配置、项目上传部署、运行目录设置及常见部署问题排查。通过完整上线流程演示,帮助开发者快速实现 ThinkPHP 项目的服务器部署与稳定运行,提升网站上线效率与运维能力。

2026.03.23

775

15

宝塔面板网站安全加固与防攻击配置实践
宝塔面板网站安全加固与防攻击配置实践

本专题围绕宝塔面板在网站安全防护中的应用展开,系统讲解防火墙配置、SSH 安全策略、登录保护、端口管理及恶意访问拦截机制。内容涵盖 CC 攻击防护、文件权限设置、敏感目录保护及安全日志分析,帮助用户全面提升服务器安全性。

2026.03.25

92

17

宝塔面板多站点管理与虚拟主机配置实践
宝塔面板多站点管理与虚拟主机配置实践

本专题讲解如何通过宝塔面板实现多站点部署与统一管理,包括站点创建、域名绑定、子站配置及资源隔离策略。通过实战案例,帮助用户高效管理多个网站项目,提高服务器利用率。

2026.03.25

199

21

宝塔面板Nginx性能优化与高并发配置实践
宝塔面板Nginx性能优化与高并发配置实践

本专题围绕宝塔环境下的 Nginx 优化展开,深入讲解缓存策略、连接数调优、Gzip 压缩、静态资源加速及反向代理配置。帮助用户提升网站访问速度与并发处理能力。

2026.03.25

1276

29

宝塔面板数据库管理与MySQL性能调优实践
宝塔面板数据库管理与MySQL性能调优实践

本专题讲解宝塔面板中数据库管理与优化技巧,包括数据库备份恢复、慢查询日志分析、索引优化及连接数配置。通过实际案例,帮助用户提升数据库运行效率。

2026.03.25

261

25

宝塔面板SSL证书部署与HTTPS配置实践
宝塔面板SSL证书部署与HTTPS配置实践

本专题围绕网站 HTTPS 部署展开,讲解 SSL 证书申请、自动续签、强制 HTTPS 跳转及混合内容问题解决方案,提升网站安全与 SEO 表现。

2026.03.25

769

25

宝塔面板定时任务与自动化运维实践
宝塔面板定时任务与自动化运维实践

本专题讲解宝塔定时任务功能的使用,包括计划任务创建、Shell 脚本执行、日志管理及自动备份策略,帮助用户实现服务器自动化运维。

2026.03.25

227

23

宝塔面板FTP与文件权限管理实践
宝塔面板FTP与文件权限管理实践

本专题围绕文件管理与权限控制展开,讲解 FTP 创建、用户权限分配、文件读写控制及安全上传策略,保障网站文件安全。

2026.03.25

192

19

宝塔面板PHP环境配置与多版本切换实践
宝塔面板PHP环境配置与多版本切换实践

本专题讲解宝塔中 PHP 环境的配置方法,包括版本切换、扩展安装、运行参数优化及错误日志分析,适用于多项目运行场景。

2026.03.25

386

25

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
简单聊聊mysql8与网络通信
简单聊聊mysql8与网络通信

共1课时 | 0.1万人学习

宝塔入门指引手册
宝塔入门指引手册

共0课时 | 0人学习