讲师中心 微信公众号

工具推荐

视频效率加速
Seko
Seko

AI短剧一键生成成片

updream

一键生成高质量推广成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Laper
Laper

剧本策划到成片协作

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

阿宇姑娘_6006

阿宇姑娘_6006

发布时间:2026-04-09 18:02:04

|

661人浏览过

|

来源于php中文网

原创

泛域名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)建议一并加入,否则访问根域名会提示证书不匹配。

SSL Certificate Checker
SSL Certificate Checker

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

下载
  • 推荐在「域名」输入框里这样填:*.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 文件存在,得提前配好或改用环境变量方式传参。

热门AI工具

更多
咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

相关专题

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

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

775

2026.03.23

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

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

92

2026.03.25

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

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

199

2026.03.25

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

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

1276

2026.03.25

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

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

261

2026.03.25

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

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

769

2026.03.25

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

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

227

2026.03.25

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

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

192

2026.03.25

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

0

2026.11.17

热门下载

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

精品课程

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

共1课时 | 0.1万人学习

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

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn