当前位置:

首页 > 编程开发 > 宝塔面板如何配置泛域名SSL证书_使用DNS API接口自动申请

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

配置泛域名SSL证书需在宝塔面板中使用DNSAPI验证,填写`*.example.com`并同时包含主域名,需添加TXT解析记录。自动续期需手动添加计划任务,例如每月执行acme.sh命令。部署后需修改Nginx配置中server_name为通配符格式,并重启Nginx服务,否则子域名访问会报错。

本文目录

    配置泛域名SSL证书,在宝塔面板里其实是个很典型的“一步到位但容易踩坑”的操作。很多人照着流程走下去,最后发现子域名还是报证书错误,或者续期的时候悄无声息地失败了。这些问题,归根结底就出在验证方式、域名填写、续期配置和Nginx处理这四个环节上。下面逐个拆开来看。

    ![宝塔面板如何配置泛域名SSL证书_使用DNS API接口自动申请](http://img.318050.com/uploads/20260415/177620348469deb6dcba9dc685074171.webp) ### 泛域名SSL在宝塔里必须用DNS验证,HTTP验证行不通 泛域名证书有个关键特征——它走的是DNS-01挑战,没法用HTTP方式验证。ACME协议对此有明确规定。如果你在宝塔面板里点了“文件验证”或“自动验证”,日志里大概率会看到类似 `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 ~^(?.+)\.example\.com$;`,但需要配合 `ssl_certificate` 和 `ssl_certificate_key` 动态加载——宝塔不原生支持,得手写逻辑。 - 改完之后务必点“重载配置”,别只保存。否则reload不生效,HTTPS仍然会fallback到默认站点或报错。 最容易被忽略的是DNS API权限粒度和续期脚本的执行权限。RAM子用户如果只给了读权限,申请能过,续期会卡在“添加TXT记录失败”。而cron任务默认以 `root` 身份运行,但部分云厂商的SDK(比如腾讯云)要求 `~/.tencentcloud/credentials` 文件存在,得提前配好,或者改用环境变量方式传参。
    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发 ssl
    相关文章 更多
    yandex中文版官网入口
    yandex中文版官网入口

    Yandex中文版官网入口为https://yondex.net/,支持右上角切换简体中文、中文搜索、地图地名标注、图像反向搜索、知识图谱卡片、新闻过滤、学术搜索、多端同步、网页翻译、语音识别及视频/图书/音乐/生活服务等本地化功能。俄罗斯搜索引擎入口☜☜☜☜☜点击保存yandex无需登录网址☜☜☜

    中国电信官网在线访问入口
    中国电信官网在线访问入口

    中国电信官网在线访问入口与核心功能解析 对于许多电信用户来说,高效便捷地找到官方服务入口并进行在线办理,是日常生活中的高频需求。今天我们就来详细拆解一下中国电信的官方网站,看看它究竟能为用户带来哪些便利。 访问入口明确且统一:中国电信官网的在线访问地址是 https://www.189.cn。这个入

    中国移动官网在线登录入口
    中国移动官网在线登录入口

    中国移动官网在线登录入口指引:功能、安全与体验全解析 说到在网上办理业务,第一步往往就是登录。对中国移动的用户而言,那个关键的入口在哪里呢?其实,答案很明确:http://login.10086.cn/html/login/login.html,这个直达地址就是您进入中国移动数字服务世界的官方大门。

    edge浏览器无法同步数据怎么办
    edge浏览器无法同步数据怎么办

    Edge同步失败?五大根因分析与修复方案 明明登录了微软账户,但Edge浏览器就是不同步书签、密码或历史记录——这大概是不少用户都遇到过的头疼事。问题通常出在几个地方:网络连接不畅、同步服务短暂卡住,或者是本地配置文件出了点小差错。别担心,下面这几套修复方案都是独立可操作的,你可以从第一条开始,逐一

    c++如何校验文件MD5值_调用OpenSSL计算文件哈希【实战】
    c++如何校验文件MD5值_调用OpenSSL计算文件哈希【实战】

    使用OpenSSL校验文件MD5时,应采用固定缓冲区循环读取进行流式计算,避免一次性加载大文件。通过EVP_DigestUpdate逐块更新哈希,注意fread返回0需结合ferror判断。MD5结果16字节需手动转为32位十六进制字符串。编译链接需添加-lssl-lcrypto,并确保二进制文件以"rb"模式打开及检查返回值。

    如何在 Java 中通过 LinkageError 解决由于多个 ClassLoader 加载同一类导致的冲突
    如何在 Java 中通过 LinkageError 解决由于多个 ClassLoader 加载同一类导致的冲突

    Java中LinkageError多因多个ClassLoader加载同一类引发,常见于模块化系统、Web容器或依赖冲突场景。可通过开启类加载日志、使用诊断工具或检查依赖树定位问题。解决方案包括规范库位置、排除Maven冲突依赖、遵循双亲委派模型或精确配置模块化系统。预防时建议构建检查依赖一致性并集成至CI流程。

    Linux怎么安装OpenSSL 3.x版本 Linux安全库平滑升级详解
    Linux怎么安装OpenSSL 3.x版本 Linux安全库平滑升级详解

    Linux怎么安装OpenSSL 3.x版本 Linux安全库平滑升级详解 直接运行 yum install openssl 或 apt install openssl 肯定行不通。原因很简单:CentOS 7 默认的 OpenSSL 版本是 1.0.2k,而 Ubuntu 20.04 则是 1.1

    phpopenssl扩展怎么配置_https与加密功能【教程】
    phpopenssl扩展怎么配置_https与加密功能【教程】

    PHP的openssl扩展怎么配置_https与加密功能【教程】 PHP的openssl扩展需同时满足扩展已加载、密钥可用、证书链可信三条件;否则HTTPS请求、加密函数等均会失败,须逐项验证配置、CA路径、IV/密钥长度及PEM格式。 把PHP的openssl扩展当成一个“配好就能用”的普通模块,

    Java SSL调试日志中如何唯一标识多TLS连接?
    Java SSL调试日志中如何唯一标识多TLS连接?

    Ja va SSL调试日志中如何唯一标识多TLS连接? Ja va SSL调试日志本身不直接标记TLS连接ID,但可通过线程ID(第3字段)与线程名(第4字段)组合,在单次握手生命周期内准确定位归属;需注意线程复用场景下该组合仅反映处理线程而非连接本身。 排查多TLS连接问题时,面对满屏的SSL调试

    Java中SSL的作用及加密机制解析
    Java中SSL的作用及加密机制解析

    Java中SSL/TLS的作用是为网络通信提供加密、身份验证和完整性保护,确保数据传输安全。其核心作用包括:1.加密数据防止窃听;2.验证身份防止中间人攻击;3.校验数据完整性防止篡改。SSL握手失败的解决方法包括:1.检查证书有效性;2.确认协议和加密套件兼容;3.排查中间人攻击;4.检查客户端配置;5.排查网络问题。证书过期时应重新申请、安装并重启服务器。选择加密套件的原则为:1.禁用不安全协议与算法;2.优先使用AES;3.支持前向安全(如ECDHE、DHE);4.兼顾性能。可通过工具如SSLLab

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。