宝塔 letsencrypt 申请总失败?从 HTTP-01 验证链路到 acme.sh 替代的实操指南
宝塔 letsencrypt 申请走的是 ACME v2 的 HTTP-01 文件验证:面板在网站根目录写入 /.well-known/acme-challenge/,Let's Encrypt 验证节点从 http://你的域名/.well-known/acme-challenge/ 回读,内容必须与提交的 keyAuthorization 完全一致,所以 80 端口不可达、CDN 橙云代理、伪静态重写这三件事任一发生都会直接失败。 同一组域名(exact set)在 168 小时内最多签发 5 张、同一注册域名最多 50 张、验证失败每小时每账号每主机名 5 次,据 Let's Encrypt 官方 Rate Limits 文档,反复点“申请”很容易撞上 urn:ietf:params:acme:error:rateLimited。 acme.sh 3.0.7 起默认 CA 已改为 ZeroSSL,要用它替代宝塔 letsencrypt 申请必须显式加 --server letsencrypt,否则装上去的不是 Let's Encrypt 证书。 证书路径在 /www/server/panel/vhost/cert//fullchain.pem 与 privkey.pem,验证命令:openssl x509 -in fullchain.pem -noout -issuer -dates,issuer 应显示 C = US, O = Let's Encrypt, CN = R10/R11(RSA)或 E5/E6(ECDSA)。 泛域名 *.example.com 只能走 DNS-01,宝塔面板的文件验证做不到;acme.sh --issue --dns dns_ali -d example.com -d '*.example.com' --server letsencrypt 是常用替代方案,注意 --dnssleep 默认 120 秒。
宝塔 letsencrypt 申请为什么老是失败?先看清面板背后的验证链路
问:宝塔面板点“Let’s Encrypt”到底发生了什么? 答:它并不是“调用一个远程接口给你发证”,而是面板内置的 ACME v2 客户端在本地完成一次标准协议交互。面板先在站点根目录写入 /.well-known/acme-challenge/<token> 文件,内容为 keyAuthorization;Let’s Encrypt 的验证节点随后发起 GET http://域名/.well-known/acme-challenge/<token>,返回正文必须与面板提交的 keyAuthorization 逐字节一致(协议见 RFC 8555 §8.3)。所以宝塔 letsencrypt 申请失败,九成不是证书签发环节的问题,而是这个 HTTP 请求在半路被截断了。
这条链路要同时满足三个必要条件,缺一不可:
- 域名的 A/AAAA 记录指向本机公网 IP(有 AAAA 但 IPv6 不可达,验证节点可能优先走 IPv6 而超时);
- 80 端口从公网可达,云厂商安全组、宝塔“安全”页、系统 firewalld/ufw 三层都要放行;
- Nginx/Apache 对
/.well-known/路径返回 200,不返回 301、403、404。
最省时间的排查方式是用另一台机器模拟验证节点,先绕开面板:
# 适用:宝塔 7.x/8.x/9.x 全版本,curl 7.x+
# 1) 手工放置测试文件,路径按你的站点替换
mkdir -p /www/wwwroot/example.com/.well-known/acme-challenge
echo "test-token-123" > /www/wwwroot/example.com/.well-known/acme-challenge/test-token-123
# 2) 从外网机器验证,务必用 http 且不要加 -L(跟随后续跳转会掩盖问题)
curl -v --max-time 10 http://example.com/.well-known/acme-challenge/test-token-123
# 期望:HTTP/1.1 200,正文严格等于 test-token-123
# 出现 301/403/404 或返回站点首页 HTML,说明链路已断,先修这里再回面板点申请
问:为什么面板里明明开了“强制 HTTPS”,申请反而必定失败? 答:因为强制跳转把 80 的验证请求 301 到 443,而 443 上此刻还没有有效证书,验证节点拿不到文件,形成死循环。同理,Cloudflare 橙云代理的 “Always Use HTTPS” 或 WAF 规则、第三方 CDN 的回源限制,都会让验证节点看到 301/403 而不是 200。常见现象的对照如下:
| 面板报错 / 浏览器表现 | 真实根因 | 一条定位命令 |
|---|---|---|
| 验证失败,浏览器打开链接 301 到 https | “强制 HTTPS”已开或 CDN 强制跳转 | curl -I http://example.com/.well-known/acme-challenge/x |
| 返回 403 | .well-known 目录权限不对,或被 WAF 拦截 | ls -ld /www/wwwroot/example.com/.well-known |
| 请求超时、无响应 | 安全组或 firewalld/ufw 未放行 80 | ss -lntp | grep ':80 ' |
| 返回站点首页 HTML | 伪静态把请求重写到 index.php | grep -rn "well-known" /www/server/panel/vhost/rewrite/ |
日志出现 acme: error: tls: handshake failure |
老版本面板内置 Python/OpenSSL 过旧,不满足 TLS 1.2 | openssl version; /www/server/panel/pyenv/bin/python -V |
针对伪静态,宝塔默认不会为 .well-known 生成例外规则,使用 ThinkPHP/Laravel 等预设规则时需手动前置一段:
# 写入 /www/server/panel/vhost/rewrite/example.com.conf 最前面
# ^~ 前缀匹配优先级高于 try_files 与 index.php 重写
location ^~ /.well-known/acme-challenge/ {
default_type text/plain;
root /www/wwwroot/example.com;
}
问:连点几次申请有没有代价? 有。据 Let’s Encrypt 官方 Rate Limits 文档,同一注册域名每 168 小时限 50 张证书、同一组 exact set of domains 限 5 张,验证失败还限每小时每账号每主机名 5 次。所以宝塔 letsencrypt 申请连续失败 5 次以上就该停手排查,继续点只会把失败配额耗尽,之后即使链路修好也要等窗口重置。
问:面板版本会影响报错可读性吗? 会。7.x 的 ACME 客户端对错误做了部分中文化,8.x 起弹窗同时给中文提示与英文原文,但原始堆栈仍要落到日志里看:tail -n 50 /www/server/panel/logs/error.log | grep -iE "acme|challenge|handshake"(宝塔各版本默认路径一致)。
最后提醒续期:证书有效期 90 天,据 Let’s Encrypt 2024 年公告,2025 年起提供 6 天短期证书选项并逐步推进。这意味着“申请成功”只是起点,自动续期任务(面板计划任务里的续签脚本或改用 acme.sh 的 cron)必须和首次申请一起设计好,否则 60 天后同一套链路问题会以“续期失败”的形式重演。
宝塔 letsencrypt 申请完整实操步骤(面板一键路径,8 步)
面板一键申请看起来只是点两下,但失败几乎都发生在点击之前。下面 8 步按”先证明链路通、再排除干扰、最后才点申请”的顺序排列,每步都给出可复制的验证命令。适用于宝塔面板 7.7 / 8.x / 9.x(Let’s Encrypt 选项卡逻辑一致),底层由面板内置的 acme 客户端调用 ACME v2 接口完成。
第 1 步:前置自检,三条命令证明链路通。Let’s Encrypt 的 HTTP-01 校验由境外多节点发起(据 Let’s Encrypt 文档,验证请求不带 User-Agent、不跟随重定向以外的特殊行为),因此必须确认解析、80 端口、响应码三件事同时成立:
# 1) 解析是否指向本机公网 IP(用公共 DNS,绕开本机缓存与 hosts)
dig +short A example.com @8.8.8.8
# 期望输出:本机公网 IP,若返回 CDN 节点 IP 说明还没切"仅 DNS"
# 2) 80 端口是否直接返回 200(-I 只看响应头)
curl -I http://example.com
# 期望:HTTP/1.1 200 OK;若是 301/302 必须先关闭强制 HTTPS
# 3) 防火墙是否放行
firewall-cmd --list-ports # CentOS/Alma/Rocky,期望含 80/tcp 443/tcp
ufw status # Ubuntu/Debian,期望 80,443 ALLOW
# 云厂商安全组需在控制台单独放行 80/443,与系统防火墙是两道独立关卡
第 2 步:排除干扰。站点”设置 → SSL → 强制 HTTPS”先关闭;Cloudflare 等 CDN 把该记录改为”仅 DNS”(灰云),否则验证请求打到 CDN 边缘节点而非源站;临时停用 WAF 与”防跨站攻击(open_basedir)”——后者常导致验证文件写入 /.well-known/acme-challenge/ 失败,报错表现为 404 而非权限拒绝。
第 3 步:发起申请。登录宝塔 → 网站 → 目标站点”设置” → “SSL” → “Let’s Encrypt” 选项卡 → 勾选 example.com 与 www.example.com(可多选)→ 验证方式选”文件验证” → 点”申请”。正常 10–40 秒返回”申请成功”。
第 4 步:失败时只信英文原文。把弹窗英文整段复制下来,中文提示只是概括。常见原文与含义:
| 报错原文(片段) | 真实原因 | 优先排查 |
|---|---|---|
| Invalid response from http://… : 404 | 验证文件未被 Web 服务器返回 | open_basedir、伪静态规则、CDN 未灰云 |
| Invalid response from … : 301 | 被重定向到 HTTPS 或 www | 关闭强制 HTTPS 后重试 |
| urn:ietf:params:acme:error:dns | 域名不存在或解析未生效 | dig 复查 NS 与 A 记录 |
| too many certificates already issued | 触发配额(据 Let’s Encrypt 文档:同一 exact set 域名 168 小时内 5 张) | 等待窗口滑过或换 exact set |
第 5 步:先验证 443 再开跳转。申请成功后不要立刻开强制 HTTPS,先 curl -I https://example.com 确认返回 200,再回面板打开跳转,否则易出现全站 301 循环。
第 6 步:配置续期任务。面板 → 计划任务 → 添加任务 → 类型选”续签 Let’s Encrypt 证书” → 周期”每天” → 保存。随后用 crontab -l 应能看到类似 /www/server/panel/script/rememory.sh 之外的续签条目(不同版本脚本名略有差异)。这是宝塔 letsencrypt 申请之后最容易漏的一步,证书 90 天有效期不会自动延长。
第 7 步:域名变更要重签而非续签。一次申请会把所选域名写入同一张证书的 SAN,增删域名即改变 exact set。此时点”续签”仍会消耗配额,建议直接重新申请并规划好域名清单,避免撞上 5 张/168 小时上限。
第 8 步:迁移打包。证书位于 /www/server/panel/vhost/cert/<域名>/ 下的 fullchain.pem 与 privkey.pem。换服务器时连同该目录整体打包,比在新机器上重走一遍宝塔 letsencrypt 申请更稳,也避免迁移期间触发配额。
# 迁移打包与还原示例
tar czf cert-backup.tgz -C /www/server/panel/vhost/cert example.com
# 新机器解压到同名路径后,在面板"SSL → 其他证书"粘贴内容即可
ls -l /www/server/panel/vhost/cert/example.com/{fullchain.pem,privkey.pem}
宝塔 letsencrypt 申请的命令行替代:acme.sh 参数与 Nginx 配置片段
面板里点了十几次都是”获取失败”,能不能绕开面板直接上命令行?可以。宝塔的 letsencrypt 申请底层同样是走 ACME 协议,换成 acme.sh 并不会改变验证方式,只是把 HTTP-01 的完整过程暴露出来——失败时你能看到具体是哪个 URL 返回了 404,而不是面板上那句没有上下文的”获取失败”。
第一个坑:acme.sh 的默认 CA 早就不是 Let’s Encrypt 了。据 acme.sh 官方 README,从 3.0.7 版本起默认 CA 已切换为 ZeroSSL。如果你不先切回来,签出来的证书签发者是 ZeroSSL,90 天后续期走的是 ZeroSSL 账户,与宝塔面板里那张 Let’s Encrypt 证书完全不是一条链路。所以第一步永远是显式指定 CA:
# 安装:写入 ~/.acme.sh,并自动注册 cron 续期任务
curl https://get.acme.sh | sh -s email=ops@example.com
# 关键行:3.0.7+ 默认 CA 是 ZeroSSL,这里切回 Let's Encrypt
~/.acme.sh/acme.sh --set-default-ca --server letsencrypt
# 事后核对:输出中的 "CA" / "Le_API" 字段应为 letsencrypt
~/.acme.sh/acme.sh --info -d example.com | grep -Ei 'ca|issuer'
签发时最容易翻车的是 -w。它指向的目录必须与站点 Nginx 配置里 root 的值逐字符一致(不能是上级目录,不能带尾斜杠差异),否则 acme.sh 会把验证文件写到 A 目录,而 Nginx 从 B 目录找,结果依然是 404:
# -w = 该站点 Nginx 的 root;--keylength 可选 2048/4096/ec-256/ec-384
~/.acme.sh/acme.sh --issue -d example.com -d www.example.com
-w /www/wwwroot/example.com --keylength ec-256
路径不一致时,acme.sh 的报错会直接点出被请求的 URL,例如 Verify error:Invalid response from http://example.com/.well-known/acme-challenge/xxxx: 404——把这行和 Nginx access.log 里的同一条请求对照,就能立刻确认 root 是否配错。
签下来之后要装到宝塔的证书目录,并让 Nginx 自动重载。注意 --ecc 必须与签发时的 ec-256 对应,漏掉会提示找不到证书文件:
# 落盘到宝塔标准路径,面板"SSL"页可直接看到;--reloadcmd 在每次续期后执行
~/.acme.sh/acme.sh --install-cert -d example.com --ecc
--key-file /www/server/panel/vhost/cert/example.com/privkey.pem
--fullchain-file /www/server/panel/vhost/cert/example.com/fullchain.pem
--reloadcmd "nginx -t && nginx -s reload"
对应的站点 TLS 配置参考 Mozilla SSL Configuration Generator 的 intermediate 档(兼容 TLS 1.2 客户端,已剔除 DHE 与 CBC 套件):
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
ssl_prefer_server_ciphers on;
ssl_session_cache shared:SSL:10m; # 约 40000 个会话,10MB 是常用值
ssl_session_timeout 10m;
ssl_stapling on; # LE 已于 2025 年停用 OCSP,此项对 LE 证书已无实际作用,保留无害
add_header Strict-Transport-Security "max-age=31536000" always;
80 端口的跳转必须给 ACME 校验路径留白名单。很多人把整站 301 到 https,续期时 HTTP-01 请求被重定向,校验直接失败——这正是”首次能签、三个月后自动续期失败”的典型成因。顺序不能反:
server {
listen 80;
server_name example.com www.example.com;
# 必须写在 return 之前,且用 ^~ 前缀匹配
location ^~ /.well-known/acme-challenge/ {
root /www/wwwroot/example.com;
}
location / {
return 301 https://$host$request_uri;
}
}
两套续期链路只能留一套。acme.sh 的续期由 cron 驱动,crontab -l 里能看到 17 0 * * * "/root/.acme.sh"/acme.sh --cron --home "/root/.acme.sh" > /dev/null,执行日志写在 ~/.acme.sh/acme.sh.log;宝塔面板的”续签 Let’s Encrypt 证书”是另一套计划任务。二者写的是同一个 fullchain.pem,同时开启会互相覆盖,且面板那套可能把 acme.sh 装的 ECC 证书换回 RSA。选定 acme.sh 后,请在面板里关闭该站点的自动续签。
| 维度 | 宝塔面板”续签 Let’s Encrypt 证书” | acme.sh 命令行 |
|---|---|---|
| 默认 CA | 固定 Let’s Encrypt | 3.0.7+ 为 ZeroSSL,需 --set-default-ca 切回 |
| 验证方式 | 仅 HTTP-01,自动写 .well-known | HTTP-01(-w)或 DNS-01(--dns dns_dp 等) |
| 续期触发 | 面板计划任务 | cron 中 acme.sh --cron,默认每日 00:17 |
| 失败可见性 | 面板提示”获取失败” | 完整 ACME 响应体与 404 的 URL |
| 证书落盘 | /www/server/panel/vhost/cert/<域名>/ |
--install-cert 指定,可指向同一目录 |
宝塔 letsencrypt 申请方案怎么选?四种路径对比表
宝塔 letsencrypt 申请到底该走哪条路?先别急着点面板上的”申请”,四条路径的硬指标差异比想象中大。核心判断依据只有一个:Let’s Encrypt 的 HTTP-01 验证只认 80 端口,且不支持泛域名——据 Let’s Encrypt 官方文档《Challenge Types》,HTTP-01 请求固定发往 http://<domain>/.well-known/acme-challenge/<token>,允许 301 跳转到 443,但不接受 8080、8443 等非标准端口;通配符证书只能走 DNS-01。这一条直接决定了 CDN 回源、云主机封 80 的场景下,面板一键申请必然失败。
| 方案 | 验证方式 | 泛域名 | 需公网 80 | CDN 场景 | 续期方式 | 成本 |
|---|---|---|---|---|---|---|
| 宝塔面板一键 Let’s Encrypt | HTTP-01 文件验证 | 不支持 | 是 | 需临时改灰云(DNS only) | 面板计划任务 | 0 元 |
| acme.sh + webroot | HTTP-01 文件验证 | 不支持 | 是 | 需临时改灰云 | acme.sh cron | 0 元 |
| acme.sh + DNS-01(dns_ali / dns_dp / dns_cf) | DNS TXT 记录 | 支持 *.example.com |
否 | 可保持代理开启 | acme.sh cron | 0 元 + DNS API 权限 |
| 商业 DV / OV 证书 | 文件或 DNS + 身份核验 | 视套餐 | 视方案 | 视方案 | 商家托管或手动 | DV 约 100–400 元/年,OV 约 800–3000 元/年 |
为什么推荐 acme.sh 做 DNS-01 兜底?因为它绕开了整条 80 端口链路:验证记录写在 DNS 里,CDN 的”小黄云”代理无需临时关闭,续期时也不会因为忘记改回灰云而导致 60 天后自动续期失败。下面是可直接复制的完整序列(acme.sh v3.x,脚本默认安装到 ~/.acme.sh,默认密钥类型自 v3.0.0 起为 ec-256)。
# 1) 安装 acme.sh,并写入 root 的 crontab(默认每天 00:00 左右检查,到期前 30 天自动续)
curl https://get.acme.sh | sh -s email=you@example.com
# 2) 关键:acme.sh 自 2021-08 起默认 CA 是 ZeroSSL,必须显式切回 Let's Encrypt
~/.acme.sh/acme.sh --set-default-ca --server letsencrypt
# 3) 阿里云 DNS API 凭证(建议用 RAM 子账号,仅授予 AliyunDNSFullAccess)
export Ali_Key="LTAI5txxxxxxxxxxxx"
export Ali_Secret="xxxxxxxxxxxxxxxxxxxxxxxx"
# 腾讯云 DNSPod 用 DP_Id / DP_Key;Cloudflare 用 CF_Token(Zone.DNS 编辑权限即可)
# 4) 签发主域 + 泛域名,DNS-01 全程不碰 80/443
~/.acme.sh/acme.sh --issue --dns dns_ali -d example.com -d '*.example.com' --keylength ec-256
# 5) 安装到宝塔站点证书目录,并在续期后自动重载 Nginx
~/.acme.sh/acme.sh --install-cert -d example.com --ecc
--key-file /www/server/panel/vhost/cert/example.com/privkey.pem
--fullchain-file /www/server/panel/vhost/cert/example.com/fullchain.pem
--reloadcmd "nginx -t && nginx -s reload"
几个容易踩的参数细节:--keylength 默认 ec-256,若老客户端(如部分 Android 7 以下、旧版 Java)不兼容 ECC,可显式改 2048;--ecc 用于安装 ECC 证书,漏写会去读 RSA 目录并报 Error, keylength does not match;Let’s Encrypt 证书有效期 90 天,且遵循 RFC 8555 的续期信息(renewalInfo)机制,acme.sh 的 cron 会在剩余 30 天时触发续期,无需人工干预。
选型结论:纯内网测试站、个人博客优先用面板一键,省事;站点挂 CDN、需要泛域名、或 80 端口被封(部分云主机默认封 80)时改用 DNS-01;涉及支付、企业身份展示的站点再考虑 OV,因为它提供的是组织信息背书,而不是更强的加密算法——加密强度由密钥长度和 TLS 版本决定,与证书类型无关。
宝塔 letsencrypt 申请常见报错与排查对照(含真实错误原文)
宝塔 letsencrypt 申请失败时,面板只会弹出一句被压缩过的中文提示,真正的判定依据藏在英文原文里。下表把面板日志、/www/server/panel/vhost/cert/<域名>/ 下留存的错误与首个验证动作对齐,先定位再动手。
| 报错原文(截断) | 真实根因 | 首个验证动作 |
|---|---|---|
| Invalid response from http://…: 404 | 根目录被改、伪静态吃掉 .well-known、open_basedir 拦截 | curl -I 探针文件 |
| DNS problem: NXDOMAIN looking up A for … | A 记录主机记录写错(@ 与 www 混用)或未生效 | dig 双路核对 |
| too many certificates (5) … 168 hours | 同一域名集合重复签发配额用尽 | crt.sh 查历史 |
| too many failed authorizations recently | 每小时 5 次失败验证上限 | 停手 1 小时 |
| curl: (35) SSL connect error | 到 ACME 端点网络不通 | curl -sv … --max-time 10 |
| NET::ERR_CERT_AUTHORITY_INVALID | 只部署了 cert.pem,缺中间证书 | openssl verify |
| JWS has an invalid anti-replay nonce | 服务器时间偏差超 300 秒 | chronyc tracking |
提示“检查域名解析或防火墙”却同时报了 404,怎么查?404 说明 80 端口是通的、ACME 服务器已经到达你的站点,只是取不到文件。先在真实站点根目录放探针,确认路径与面板里“网站目录”一致:
# 1. 在面板显示的网站根目录下建探针(注意 public 与上一级的区别)
mkdir -p /www/wwwroot/example.com/.well-known/acme-challenge
echo ok > /www/wwwroot/example.com/.well-known/acme-challenge/test
# 2. 必须返回 HTTP/1.1 200;301 到 https 也可接受,但跳转目标证书必须有效
curl -I http://example.com/.well-known/acme-challenge/test
# 3. 若 404,检查伪静态是否重写了 .well-known
cat /www/server/panel/vhost/rewrite/example.com.conf
ThinkPHP、Laravel 等规则常写成 rewrite ^(.*)$ /index.php?s=$1 last;,会把探针请求吞掉。在该文件顶部加一条例外即可(Nginx 中 ^~ 优先级高于正则):
location ^~ /.well-known/acme-challenge/ {
root /www/wwwroot/example.com; # 与站点根目录一致
try_files $uri =404;
}
另外两处易忽略:宝塔“网站 → 设置 → 网站目录 → 防跨站攻击(open_basedir)”默认开启并写入 .user.ini,若你把根目录指到 public 而探针建在上一级,PHP 侧读取会被拦;以及根目录被改成 /www/wwwroot/example.com/public 后,ACME 写入位置随之偏移。
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
- HTTPS配置 · SSL证书安装服务(各种服务器)
- SSL证书安装服务 · 腾讯云 HTTPS 部署 · 证书过期更新
报 NXDOMAIN 是不是解析没生效?多数是主机记录填错:面板申请了 www.example.com,DNS 里却只加了 @。用两家公共 DNS 交叉验证,避免本地缓存误导:
dig +short A example.com @1.1.1.1
dig +short A www.example.com @8.8.8.8
# 两条结果必须都等于本机公网 IP;返回空则记录缺失,返回旧 IP 则是 TTL 未过
撞上 rateLimited 还能重试吗?不能。据 Let’s Encrypt 速率限制文档,完全相同的域名集合每 168 小时限 5 张(Duplicate Certificate),每注册域名每周 50 张,失败验证为每账号每主机名每小时 5 次。先到 https://crt.sh/?q=example.com 看签发历史确认配额已用尽,然后只有两条路:等窗口滚动,或临时增删一个子域改变域名集合。
一直卡在“正在申请”不动?国内机器到 acme-v02.api.letsencrypt.org 常被阻断,面板不会超时退出:
curl -sv https://acme-v02.api.letsencrypt.org/directory --max-time 10
# 正常应返回 JSON,含 "newNonce"、"newOrder" 等字段(RFC 8555 定义的目录资源)
# 超时或 35 错误则需为面板进程配置 HTTP 代理后重试
浏览器报证书不受信任?只部署了 cert.pem 而没带中间证书。Nginx 的 ssl_certificate 必须指向 fullchain.pem(宝塔路径 /www/server/panel/vhost/cert/example.com/fullchain.pem):
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt
/www/server/panel/vhost/cert/example.com/fullchain.pem
# 期望输出:fullchain.pem: OK
# 输出 unable to get local issuer certificate 即为链不全
JWS nonce 校验失败是什么原因?ACME 的 anti-replay nonce 有效期极短,服务器时钟偏差超过 300 秒就会被拒。核对并强制同步:
date -u
chronyc tracking # 看 System time 一行,偏差应远小于 1 秒
timedatectl status # System clock synchronized: yes 才算正常
timedatectl set-ntp true
如果时间正常仍报错,多半是中间代理缓存了 newNonce 响应,绕过代理直连即可。
怎么确认宝塔 letsencrypt 申请真的生效?六步验证法
别只盯着宝塔面板上那个绿色对勾——它只证明证书文件写成功了,并不证明 Nginx 已加载、链路完整、客户端会信任。判断一次宝塔 letsencrypt 申请是否真的生效,要按”本地文件 → 线上握手 → HTTP 行为 → 证书链 → 协议套件 → 监控”这六步依次验证,全部通过才算生效。
- 先看文件本身,确认签出的是什么
# 直接读磁盘上的证书,不经过网络 openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem -noout -subject -issuer -dates -ext subjectAltName # 预期输出(关键行) # issuer=C = US, O = Let's Encrypt, CN = R11 # notAfter=Aug 30 11:59:59 2025 GMT # X509v3 Subject Alternative Name: # DNS:example.com, DNS:www.example.com据 Let’s Encrypt 2024 年 6 月的中级证书轮换公告,新证书由
R10/R11(RSA)与E5/E6(ECDSA)签发,旧的 R3/E1 已停止使用——若 issuer 还是 R3,说明读到的是历史残留文件。同时校验:notAfter 距今不超过 90 天(Let’s Encrypt 有效期固定 90 天)、SAN 覆盖所有实际访问的域名(单证书上限 100 个名字)。 - 看线上握手,确认 Nginx 加载的是新证书
# 线上真实下发的证书 echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -issuer -dates # 两侧各取 SHA-256 指纹逐字节比对 openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem -noout -fingerprint -sha256 echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -fingerprint -sha256两行
SHA256 Fingerprint必须完全相同。不一致说明面板写了新文件但 Nginx 未 reload,或ssl_certificate指向了旧目录(宝塔历史上有vhost/cert/与vhost/ssl/两套路径)。-servername不能省,否则 SNI 多站点会返回默认站点证书。 - 看 HTTP 行为,两条同时成立才算跳转正确
curl -sI https://example.com | head -5 # 期望 200 curl -sI http://example.com | head -5 # 期望 301,且 Location: https://example.com/只有 https 返回 200、http 返回 301 且 Location 指向 https,才说明跳转生效。http 仍返回 200 是规则没命中;https 也 301 到 https 则构成循环,浏览器报
ERR_TOO_MANY_REDIRECTS。 - 看链完整性,证书链里应有 2 张证书
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c "BEGIN CERTIFICATE"结果应为
2(叶子证书 + 中间证书)。为 1 表示漏装中间证书,桌面 Chrome 可能靠 AIA 自动补链看起来正常,但 Android、Java 与部分 curl 会直接报SSL certificate problem: unable to get local issuer certificate。修复方式:确认 nginx 配置中ssl_certificate指向fullchain.pem,而非只含叶子的cert.pem(依据 RFC 5280 的链构建规则)。 - 看协议与套件,TLS 1.0/1.1 必须握手失败
nmap --script ssl-enum-ciphers -p 443 example.com openssl s_client -connect example.com:443 -tls1_1 </dev/null # 期望失败:error:0A000102:SSL routines::unsupported protocolnmap 输出中只应出现 TLSv1.2、TLSv1.3 两段。若 1.1 仍能握手,去
/www/server/nginx/conf/nginx.conf检查ssl_protocols:宝塔新版默认TLSv1.2 TLSv1.3,老版本可能是TLSv1 TLSv1.1 TLSv1.2,与 Mozilla SSL Configuration Generator 的 Intermediate 配置不一致。 - 接监控,把”过期”变成可告警事件
# ssl_verify_result=0 表示链与主机名校验通过,非 0 即有问题 curl -o /dev/null -s -w "%{http_code} %{ssl_verify_result}n" https://example.com # checkend 返回 0 表示 30 天内不过期,非 0 即触发告警 openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem -noout -checkend 2592000 || echo "30 天内将过期,检查续期任务"2592000 秒即 30 天;把它写进 crontab 或 Zabbix/脚本告警,就不必依赖面板的续期提示。
| 验证维度 | 关键参数 | 通过标准 | 失败最常见原因 |
|---|---|---|---|
| 文件内容 | -issuer -dates -ext subjectAltName |
R10/R11/E5/E6,≤90 天,SAN 齐全 | 读到旧文件、漏 www |
| 线上握手 | -servername + 指纹比对 |
两侧 SHA-256 一致 | Nginx 未 reload、路径指向旧目录 |
| HTTP 行为 | curl -sI |
https 200 且 http 301→https | 规则缺失或重定向循环 |
| 链完整性 | -showcerts | grep -c |
计数 = 2 | 指向 cert.pem |
| 协议版本 | ssl-enum-ciphers / -tls1_1 |
仅 1.2/1.3,1.1 失败 | ssl_protocols 未收紧 |
| 自动化监控 | ssl_verify_result / -checkend |
0 / 0 | 无监控,过期才发现 |
若六步里第 2、4 步反复失败而第 1 步正常,问题就不在签发环节,而在部署环节;这时先别急着重跑宝塔 letsencrypt 申请,去查 nginx 的 ssl_certificate 路径和 reload 记录,效率会高得多。
进阶:宝塔 letsencrypt 申请拿不到泛域名,改用 DNS-01 怎么做
据 Let’s Encrypt 官方的 Challenge Types 文档,通配符域名(如 *.example.com)只能通过 DNS-01 验证;HTTP-01 和 TLS-ALPN-01 在协议层就无法证明你对“任意子域”拥有控制权。这就是为什么在宝塔 letsencrypt 申请里勾选泛域名后,面板往往直接报错或签发失败:面板默认走的是文件验证,而 ACME 服务器根本不会为通配符订单下发 HTTP-01 挑战。要拿到泛域名证书,必须换到能操作 DNS 记录的工具,最省事的就是 acme.sh。
先搞清楚:三家主流 DNS API 怎么选?
| 服务商 | 环境变量 | –dns 参数 | 建议授予的最小权限 |
|---|---|---|---|
| 阿里云 DNS | Ali_Key / Ali_Secret |
dns_ali |
仅 AliyunDNSFullAccess,或自定义策略只允许 dns:AddDomainRecord 等接口 |
| DNSPod | DP_Id / DP_Key |
dns_dp |
使用该域名所在的子账号 Token,不要用主账号 API Key |
| Cloudflare | CF_Token |
dns_cf |
Token 只勾 Zone → DNS → Edit,并限定到单个 Zone |
不要用全局 API Key:acme.sh 会把凭据写进 ~/.acme.sh/account.conf,一旦泄露就是整个账号沦陷。临时凭据建议只 export 在当前 shell,别写进 ~/.bashrc。
完整签发流程(阿里云示例,acme.sh v3.x)
# 1) 安装 acme.sh;注意 v3.0.0 起默认 CA 是 ZeroSSL,必须显式指定 Let's Encrypt
curl https://get.acme.sh | sh -s email=admin@example.com
source ~/.bashrc
# 2) 导出 DNS API 凭据(仅当前会话有效)
export Ali_Key="LTAI5tXXXXXXXX"
export Ali_Secret="XXXXXXXXXXXXXXXX"
# 3) 同时签根域和泛域名:两条 -d 缺一不可,通配符不覆盖 example.com 本身
~/.acme.sh/acme.sh --issue --dns dns_ali
-d example.com -d '*.example.com'
--server letsencrypt
--dnssleep 60
--dnssleep 的默认值是 120 秒(单位秒,取值 0 表示由 acme.sh 主动轮询 TXT 记录)。阿里云、DNSPod 一般 10–60 秒即可生效,所以上面压到 60;如果过早查询,你会看到典型报错 Timeout, no TXT record found,此时调回 120 再试一次即可,别怀疑密钥配错了。
拿到证书后怎么塞回宝塔?两条路:面板“SSL → 其他证书”里粘贴 fullchain 和私钥,或者直接让 acme.sh 写到面板的证书目录,并顺手配好续期后的重载命令:
export DEPLOY=/www/server/panel/vhost/cert/example.com
~/.acme.sh/acme.sh --install-cert -d example.com
--key-file $DEPLOY/privkey.pem
--fullchain-file $DEPLOY/fullchain.pem
--reloadcmd "nginx -t && nginx -s reload"
最后一个最容易踩的坑:续期归属。acme.sh 安装时会自动写入 crontab(0 0 * * * ... --cron),从此续期由它负责。此时必须去宝塔面板关掉对应的“续签 Let’s Encrypt 证书”计划任务,否则两套续期同时往同一份 fullchain.pem / privkey.pem 写入,很容易出现证书与私钥不匹配、nginx 起不来的情况——这也是很多人第二次宝塔 letsencrypt 申请失败时看到 SSL_CTX_use_PrivateKey ... key values mismatch 的真实原因。
把宝塔 letsencrypt 申请纳入日常运维:续期、监控与回滚
宝塔 letsencrypt 申请成功只是起点——真正决定线上是否掉证的是“续期有没有被触发、触发后有没有成功、失败后能不能 30 秒回滚”这三件事。很多站点证书过期,不是没配续期任务,而是任务在跑却一直输出 Skipping,没人看过日志。
续期时机到底由谁决定?据 Let’s Encrypt 官方 Renewal 文档,建议在证书剩余 30 天时续期,以摊平 CA 的负载峰值;acme.sh 的默认阈值更早,为剩余 60 天(--days 60,可在签发时用 --days N 覆盖,N 建议不小于 30);宝塔面板的计划任务则是每天固定跑一次、命中条件才真正发起签发。三者叠加的结论是:“任务存在”不等于“已经续过”,必须回看输出。
| 触发方 | 判断依据 | 默认阈值 | 可调参数 |
|---|---|---|---|
| Let’s Encrypt 官方建议 | notAfter | 剩余 30 天 | 不可配置,仅建议值 |
| acme.sh cron | notAfter | 剩余 60 天 | --days(默认 60) |
| 宝塔计划任务 | 调用底层续期逻辑 | 每天执行一次 | 执行周期、任务开关 |
| ARI(RFC 9773) | renewalInfo 建议窗口 | 由 CA 下发 | 需客户端支持 |
怎么确认“上次到底续没续”?先确认任务条目存在,再读日志里的两种典型输出:
# 1) 确认续期任务真实存在(acme.sh 装过就会有 --cron 条目)
crontab -l | grep -i acme
# 期望看到:"/root/.acme.sh/acme.sh --cron --home /root/.acme.sh > /dev/null"
# 2) 宝塔计划任务的执行日志目录(文件名取自任务名)
ls -lt /www/server/cron/ | head
# 3) 看 acme.sh 自己的日志,区分“续成功”和“没到窗口”
grep -E "Cert success|Skipping" ~/.acme.sh/acme.sh.log | tail -n 5
# [Mon May 12 03:11:02 CST 2025] Cert success. ← 本次确实签发了
# [Tue May 13 03:10:44 CST 2025] Skipping. Next renewal time is: 2025-06-10T... ← 未到窗口,属正常
只有 Skipping 一直出现且 Next renewal time 已经过期,才说明卡住了——此时应回到 HTTP-01 验证链路排查(80 端口、CDN 回源、/.well-known/acme-challenge/ 是否被伪静态规则拦截)。
监控怎么做才不依赖面板?最轻量的是 openssl x509 -checkend,剩余秒数不足时退出码为 1,可直接接告警脚本:
# 剩余不足 14 天(1209600 秒)时输出告警,退出码非 0
openssl s_client -connect example.com:443 -servername example.com /dev/null
| openssl x509 -noout -checkend 1209600 || echo "证书 14 天内到期"
# 未到期时输出 "Certificate will not expire",退出码 0
规模化环境用 Prometheus 的 blackbox_exporter,HTTPS 探测自带 probe_ssl_earliest_cert_expiry(证书过期时间戳,单位秒),无需额外模块配置:
# alert.rules.yml —— 证书 14 天内到期即告警
- alert: SSLCertExpiringSoon
expr: probe_ssl_earliest_cert_expiry - time() < 14 * 86400
for: 1h
labels:
severity: warning
annotations:
summary: "{{ $labels.instance }} 证书 14 天内到期,检查宝塔 letsencrypt 申请续期链路"
变更后必须演练。换服务器 IP、上 CDN、改 Nginx 配置都会打断 80 端口验证,别等 60 天后才发现。手动强制续一次即可验证整条链路:
# 面板路径下先备份(可放进 cron 前置钩子)
mkdir -p /root/backup
tar czf /root/backup/cert-example.com-$(date +%F).tar.gz
-C /www/server/panel/vhost/cert example.com
# 强制重签,验证 HTTP-01 仍然通(acme.sh 3.x 通用)
~/.acme.sh/acme.sh --renew -d example.com --force
# 失败回滚:换回旧证书并热加载
tar xzf /root/backup/cert-example.com-2025-05-12.tar.gz -C /www/server/panel/vhost/cert
nginx -t && nginx -s reload
宝塔的证书目录为 /www/server/panel/vhost/cert/<域名>/,内含 fullchain.pem 与 privkey.pem,回滚即替换这两个文件,nginx -s reload 后 30 秒内恢复旧证,比重新走一遍签发快得多。
还要为 ARI 留出改造空间。Let’s Encrypt 已在推进 ACME Renewal Information(RFC 9773)与 6 天短期证书:CA 通过 renewalInfo 端点主动下发建议续期窗口,客户端应优先采纳而非只算 notAfter。届时“剩余 30 天续期”这类硬编码判断会集体失效。先确认本地版本是否具备 ARI 能力:
~/.acme.sh/acme.sh --help | grep -i ari
# 无输出说明版本偏旧,执行 ~/.acme.sh/acme.sh --upgrade 后再验证
把续期日志巡检、-checkend 监控、续期前 tar 备份、变更后 --force 演练这四步写进运维手册,宝塔 letsencrypt 申请才算真正闭环。
Let's Encrypt 证书本身免费,宝塔面板的申请入口也不收费,成本只体现在域名、服务器和排错时间上。付费 DV 证书(约 100-400 元/年)主要差在有效期可选 1 年、支持通配符打包和人工客服;OV 证书(约 800-3000 元/年)额外提供企业身份核验信息。加密强度上两者都用同样的 TLS 1.2/1.3 套件,差别不在算法。
先看弹窗里的英文原文。如果是 404,检查站点根目录是否与验证目录一致、是否开了 open_basedir、伪静态是否重写了 .well-known;如果是 NXDOMAIN,用 dig +short A 域名 @8.8.8.8 核对解析;如果是超时,检查云安全组、宝塔防火墙、firewalld/ufw 三层 80 端口是否都放行,以及 CDN 是否还开着橙云代理。
面板里的“文件验证”方式签不了 *.example.com,因为 Let's Encrypt 规定通配符只能用 DNS-01 验证。可行路径是改用 acme.sh 的 dns_ali、dns_dp、dns_cf 等 DNS API 插件签发,再通过 –install-cert 把证书装到 /www/server/panel/vhost/cert// 下,或在面板“其他证书”里粘贴。
需要在面板“计划任务”里手动添加类型为“续签 Let's Encrypt 证书”的任务,周期设为每天,添加后 crontab -l 能看到条目才会真正执行。续签失败最常见的原因是 80 端口验证链路在续期时被强制 HTTPS 跳转或 CDN 代理打断,可以先手动跑一次 –renew –force 复现报错,再按报错原文排查。
先用 curl -sv https://acme-v02.api.letsencrypt.org/directory –max-time 10 确认是网络层超时还是 TLS 握手失败。确认超时后,可以给服务器或面板进程配置 HTTP 代理,或者把申请动作挪到网络可达的机器上执行 acme.sh,再用 –install-cert 把证书同步回宝塔目录。
据 Let's Encrypt 官方 Rate Limits 文档,同一组 exact set of domains 的限额是 168 小时内 5 张,窗口是滚动计算的,不是自然周清零。可以到 crt.sh 查签发历史推算释放时间,或临时增删一个子域改变域名集合作为绕行方案,但不要靠反复重试解决。
已签发的证书与 IP 无关,把 /www/server/panel/vhost/cert// 下的 fullchain.pem 和 privkey.pem 一起复制到新机器即可继续使用,不需要重新走宝塔 letsencrypt 申请。但续期依赖 HTTP-01 验证,必须确认新 IP 的 80 端口可达、解析已切换,否则下次续期会失败。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。