SSL 证书安装教程续期全流程:从 90 天周期倒推 Nginx/Apache 配置
SSL 证书安装教程的关键不在“装”,而在“续”:Let's Encrypt 证书有效期 90 天,必须在剩余 30 天前由 certbot.timer 或 acme.sh 的 cron 自动续期并 reload Web 服务,否则第 91 天浏览器必然报 NET::ERR_CERT_DATE_INVALID。 certbot 2.9 及以上版本由 systemd timer 驱动,默认每天 00:00 与 12:00 各触发一次并带 RandomizedDelaySec=43200 的随机延迟,执行 certbot renew --dry-run 无报错才算安装完成。 Web 配置必须直接指向 /etc/letsencrypt/live//fullchain.pem 与 privkey.pem 这两个软链接;一旦把文件复制到 /etc/nginx/ssl/,续期日志显示成功但线上仍是旧证书。 续期后不 reload 等于没续:在 renewal 配置里写 renew_hook = systemctl reload nginx,deploy-hook 只在真正签发新证书时触发,dry-run 不会触发。 排错优先看三类报错:80 端口被占用(Problem binding to port 80)、防火墙超时(Timeout during connect)、失败验证限流(too many failed authorizations recently)。
为什么装好的 SSL 证书 90 天后会突然失效?——续期失败的 5 个根因
先给结论:证书不是”装好就完事”。据 Let’s Encrypt 官方文档,其签发的证书有效期固定为 90 天,官方建议在剩余 30 天时续期,也就是每 60 天必须成功完成一次续期;2020 年 9 月起 CA/Browser Forum 将公开信任 TLS 证书的最长有效期限制为 398 天,商业证书同样不再是”一年装一次”。所以线上突然失效,八成不是签发失败,而是”续期成功但没生效”——这正是 ssl证书 安装教程续期 流程里最容易被跳过的一步。以下 5 个根因按实际排查频率排序。
根因一:把 fullchain.pem 复制到静态目录,续期只更新软链接。certbot 续期只改写 /etc/letsencrypt/live/example.com/ 下的符号链接(指向 ../archive/ 中的新文件)。若安装时执行过 cp fullchain.pem /etc/nginx/ssl/,两边永久不同步:续期日志显示成功,线上仍是旧证书。一条命令即可判定:
# 两条命令的 notAfter 必须一致,不一致即命中根因一
openssl x509 -noout -dates -in /etc/letsencrypt/live/example.com/fullchain.pem
# notAfter=Aug 30 23:59:59 2025 GMT
openssl x509 -noout -dates -in /etc/nginx/ssl/fullchain.pem
# notAfter=Jun 1 23:59:59 2025 GMT ← 旧值
# 修复:Nginx 直接引用 live 路径,禁止复制
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
根因二:certbot.timer 从未启用。官方安装包用 systemd timer 调度续期(旧文档中的 cron 条目已不是默认方式);容器或精简镜像里没有 systemd,结果同样是从未调度。
systemctl status certbot.timer # 显示 inactive (dead) 即从未被调度
systemctl enable --now certbot.timer
systemctl list-timers | grep certbot # 应看到下次触发时间
certbot renew --dry-run # 演练,不消耗速率限制
根因三:HTTP-01 校验依赖 80 端口,而云安全组只放行 443。此时续期日志会原样打印 urn:ietf:params:acme:error:connection :: Timeout during connect (likely firewall problem),随后整次续期失败。先用公网视角验证可达性(返回 404 也算通),无法开放 80 端口就改用 DNS-01:
curl -I http://example.com/.well-known/acme-challenge/test
# 无 80 端口时:
certbot certonly --manual --preferred-challenges dns -d example.com
根因四:证书文件已更新,但 Web 服务没 reload。Nginx/Apache 在启动或 reload 时把证书读入内存,磁盘上的 notAfter 已是新值,浏览器仍报 NET::ERR_CERT_DATE_INVALID。用 deploy hook 把”续期”和”生效”绑在一起:
# --dry-run 同样会触发 hook,可先验证链路
certbot renew --deploy-hook "systemctl reload nginx"
# 写入 /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh 后长期生效
# Apache 对应:systemctl reload apache2
根因五:私钥权限或属主被改。privkey.pem 默认权限为 600 root:root;误执行 chmod 644 privkey.pem 后 nginx -t 仍能通过(它只做语法检查),但 reload 时读取私钥失败,systemd 回滚到旧配置,问题被掩盖到下一次重启才爆发。
ls -l /etc/letsencrypt/live/example.com/privkey.pem # lrwxrwxrwx → archive
ls -l /etc/letsencrypt/archive/example.com/privkey*.pem # 应为 -rw------- root root
chmod 600 /etc/letsencrypt/archive/example.com/privkey*.pem
| 根因 | 典型症状 | 一条验证命令 | 修复动作 |
|---|---|---|---|
| 静态目录副本 | 续期成功、线上仍旧证书 | openssl x509 -noout -dates -in ... |
配置改指 live 路径 |
| timer 未启用 | 证书到期前无任何续期日志 | systemctl status certbot.timer |
enable --now |
| 80 端口被挡 | ACME connection timeout | curl -I http://域名/.well-known/... |
放行 80 或改 DNS-01 |
| 未 reload | 磁盘新、浏览器报过期 | systemctl status nginx 看启动时间 |
配置 deploy hook |
| 私钥权限 | reload 失败、重启后暴露 | ls -l archive/*/privkey*.pem |
chmod 600 + chown root |
这 5 项恰好构成一条完整的 ssl证书 安装教程续期 自检链:签发 → 调度 → 校验通道 → 生效 → 权限。任何一环断开,都会在第 90 天以同一副面孔出现。
从续期倒推安装:6 步把证书路径、权限与 reload 钩子一次配对
续期失败最常见的根因不是 ACME 协议,而是安装阶段留下的路径分裂:Nginx 读的是 /etc/nginx/ssl/ 下的复制件,certbot 续的却是 /etc/letsencrypt/live/ 下的原件。等到第 90 天,证书确实续了,线上却照旧过期。所以最稳的做法是从续期倒推安装,把”路径—权限—reload 钩子”当成一次配对的整体。
第 1 步:先盘点现状,别急着装
两条命令对账:一条问”线上实际在用什么”,一条问”ACME 侧以为你在用什么”。
# 查看线上实际加载的证书:签发者、生效/到期时间
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -subject -issuer -dates
# 查看 certbot 自己记录的证书清单与到期日
certbot certificates
# 用 Nginx 实际配置反查它到底读了哪个文件,避免猜
nginx -T 2>/dev/null | grep -E "ssl_certificate|ssl_certificate_key"
若 openssl 输出的 notAfter 与 certbot certificates 的 Expiry Date 不一致,说明线上是复制件,续期钩子改不到它——必须先把路径统一,再谈自动化。
第 2 步:统一路径,一套流程管两种证书
Let’s Encrypt 证书一律指向 /etc/letsencrypt/live/<域名>/fullchain.pem 与 privkey.pem(据 Let’s Encrypt 文档,live/ 是软链接,指向 archive/ 里的版本化文件,因此路径永久不变,reload 后即生效);商业证书固定放 /etc/ssl/<域名>/,续费替换后调用同一个 reload 脚本,避免维护两套心理模型。
# Nginx:/etc/nginx/conf.d/example.com.conf
server {
listen 443 ssl;
server_name example.com www.example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; # 必须用 fullchain,含中间证书
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem; # 权限 600,属主 root
ssl_protocols TLSv1.2 TLSv1.3; # 对齐 Mozilla 中间配置
}
# 统一 reload 入口,商业证书替换后也调它
# /usr/local/bin/reload-tls.sh
systemctl reload nginx && echo "$(date -Is) reload ok" >> /var/log/tls-reload.log
Apache 对应 SSLCertificateFile 指向 fullchain.pem、SSLCertificateKeyFile 指向 privkey.pem,不要再用 SSLCertificateChainFile(2.4.8 起已弃用,链并入 fullchain)。
第 3 步:装客户端,按发行版与依赖偏好选
| 方案 | 安装命令 | 版本与依赖 | 适用场景 |
|---|---|---|---|
| certbot(Ubuntu 24.04) | apt install certbot python3-certbot-nginx |
2.9+,依赖 Python 3.12 | Nginx 自动改配置、自动 reload |
| certbot(Rocky Linux 9) | dnf install certbot python3-certbot-nginx |
EPEL 源,2.x | RHEL 系,systemd timer 托管 |
| acme.sh | curl https://get.acme.sh | sh -s email=ops@example.com |
3.0.8,纯 Shell 无 Python | 容器、精简镜像、DNS API 多 |
不想引入 Python 依赖就用 acme.sh;但要注意它默认装 cron 而非 systemd timer,排查入口不同。
第 4 步:首次签发,一次把 SAN 和跳转做对
# HTTP-01:自动改 Nginx 配置并加 80→443 跳转
certbot --nginx -d example.com -d www.example.com
--agree-tos -m ops@example.com --redirect
# 泛域名只能走 DNS-01(RFC 8555 要求 wildcard 用 dns-01)
certbot certonly --manual --preferred-challenges dns
-d '*.example.com' -d example.com
泛域名用 --manual 无法自动续期,需换成 DNS 插件(如 --dns-cloudflare)并配 API Token,否则第 90 天必然失败。
第 5 步:绑定 reload 钩子,这是全流程的关键一行
# /etc/letsencrypt/renewal/example.com.conf
[renewalparams]
authenticator = nginx
renew_hook = systemctl reload nginx # 写入此处则每次成功续期后执行
# 也可命令行临时指定:
# certbot renew --deploy-hook "systemctl reload nginx"
关键区别:--deploy-hook 只在真正签发新证书时执行,--dry-run 不触发;而 renew_hook 与 --post-hook 行为不同,后者每次 renew 运行都执行。想验证钩子逻辑,用 --dry-run --run-deploy-hooks 强制触发(certbot 1.22+ 支持)。
第 6 步:演练与接管,把续期变成可观测项
# 零报错才算通过;--cert-name 避免多域名误伤
certbot renew --dry-run --cert-name example.com
# 确认定时器下次触发在 12 小时内(官方建议每日两次随机延迟)
systemctl list-timers certbot.timer
# NEXT 形如 Thu 2025-06-12 03:14:00 UTC,LEFT 应 < 12h
# 长期留存日志:renew 输出进 journal,便于回溯失败原因
journalctl -u certbot --since "7 days ago" | grep -Ei "error|failed|renew"
据 Let’s Encrypt 官方说明,证书有效期 90 天,官方建议在剩余 30 天时续期,certbot 默认即在到期前 30 天触发,因此 certbot.timer 的 NEXT 若超过 12 小时,说明定时器被停用或时间漂移。至此,路径、权限、reload 钩子三者配对完成,后续任何 ssl 证书 安装教程续期 的排障都可以从这三个入口定位,而不是重新翻一遍配置。
可直接复制的配置与命令:Nginx 1.24 + OpenSSL 3.0 + certbot 2.9
先把问题说清楚:Nginx 1.24 上抄一份”能跑”的 HTTPS 配置,到底哪些行是必需的,哪些行抄错会静默失效?
下面这份片段在 nginx 1.24.0 + OpenSSL 3.0.13(Debian 12 / Ubuntu 22.04 自带版本)与 certbot 2.9.0 上验证通过。注意一个高频坑:http2 on; 是 nginx 1.25.1 才引入的独立指令,在 1.24 里直接写会得到 nginx: [emerg] unknown directive "http2" in /etc/nginx/conf.d/example.com.conf:3,必须退回 listen 443 ssl http2; 的写法。
# /etc/nginx/conf.d/example.com.conf —— nginx 1.24.x + OpenSSL 3.0.x
server {
listen 443 ssl http2; # 1.24 用 listen 参数开启 h2;1.25.1+ 才可改成 http2 on;
listen [::]:443 ssl http2;
server_name example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; # 叶子+中间证书
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem; # 权限 600
ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem; # 只放中间证书
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384;
ssl_prefer_server_ciphers off; # Mozilla intermediate 建议交给客户端选择
ssl_session_cache shared:SSL:10m; # 1MB≈4000 会话,默认 none
ssl_session_timeout 1d; # 默认 5m
ssl_session_tickets off;
ssl_stapling on;
ssl_stapling_verify on;
resolver 223.5.5.5 1.1.1.1 valid=300s; # 缺这行 stapling 直接不工作
resolver_timeout 5s;
add_header Strict-Transport-Security "max-age=31536000" always; # always 保证错误页也带 HSTS
}
上面 ssl_ciphers 取自 Mozilla SSL Configuration Generator 的 intermediate(v5.7)配置,据 Mozilla 文档,intermediate 兼顾 TLS 1.2 客户端兼容性与前向保密,是绝大多数站点的推荐档位。OCSP Stapling 的关键细节:ssl_trusted_certificate 必须指向 chain.pem;若误填 fullchain.pem,nginx 会把叶子证书当成信任锚去验证响应,结果 stapling 静默失效,nginx -t 不报错,只有用命令才能看出来:
echo | openssl s_client -connect example.com:443 -servername example.com -status 2>/dev/null
| grep -i "OCSP Response Status"
# 正常输出:OCSP Response Status: successful (0x0)
# 失败时输出:OCSP response: no response sent
certbot 的全局参数该写在哪?写进 /etc/letsencrypt/cli.ini,所有 certbot 与 certbot renew 调用都会读取:
# /etc/letsencrypt/cli.ini (certbot 2.9.0)
max-log-backups = 10 # 默认 1000,日志会长期堆积
key-type = ecdsa # 默认 rsa;仅对首次签发生效
elliptic-curve = secp384r1 # 默认 secp256r1
deploy-hook = systemctl reload nginx # 续期成功后自动生效,无需重启
| 维度 | ECDSA P-384 (secp384r1) | RSA 2048 |
|---|---|---|
| 证书+私钥体积 | 约为 RSA 的 1/2~1/3 | 基准 |
| 握手签名运算开销 | 显著更低,高并发下 CPU 更省 | 基准 |
| 客户端兼容性 | Android 6 以下、Windows XP/2003 不支持 | 全平台 |
| Let’s Encrypt 支持 | 支持(2015 年起提供 ECDSA 中间证书) | 支持 |
是否切 ECDSA 取决于你的访问日志里 Android 5.x、Windows 7 + IE11 的占比,别凭感觉。这也是”ssl证书 安装教程续期”里最容易被忽略的一步:密钥类型改了,续期链路要跟着验证一遍。
不用 certbot,改用 acme.sh 3.0.8 怎么写落盘命令?acme.sh 默认 CA 是 ZeroSSL,先切 Let’s Encrypt,再用 --install-cert 把证书复制到 nginx 能读的位置(这一步同时把续期后的 reload 命令注册进去):
curl https://get.acme.sh | sh -s email=admin@example.com
~/.acme.sh/acme.sh --set-default-ca --server letsencrypt # 默认 ZeroSSL,务必显式切换
~/.acme.sh/acme.sh --issue -d example.com -w /var/www/html --keylength ec-384
~/.acme.sh/acme.sh --install-cert -d example.com --ecc
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.crt
--reloadcmd "systemctl reload nginx"
# 续期阈值默认 60 天(--days 60),cron 条目默认:0 3 * * *
90 天周期怎么倒推?certbot 默认在到期前 30 天才续(renew_before_expiry),而 Debian/Ubuntu 的 certbot.timer 默认是 OnCalendar=*-*-* 00,12:00:00 加 RandomizedDelaySec=43200——注意这个随机延迟上限是 12 小时,整点请求容易撞上 Let’s Encrypt 的速率限制。改成凌晨低峰并缩小抖动窗口:
systemctl edit certbot.timer
# 在打开的 drop-in 中写入(第一行空赋值用于清掉原有 OnCalendar)
[Timer]
OnCalendar=
OnCalendar=*-*-* 03:17:00
RandomizedDelaySec=3600
Persistent=true
systemctl daemon-reload && systemctl restart certbot.timer
systemctl list-timers certbot.timer # 确认 NEXT 时间已生效
certbot renew --dry-run # 演练,不消耗速率配额
权限收口怎么做才不破坏续期?Let’s Encrypt 官方文档明确不建议放开 /etc/letsencrypt 目录权限。私钥保持 600/root:root:
chmod 600 /etc/letsencrypt/archive/example.com/privkey*.pem
chown root:root /etc/letsencrypt/archive/example.com/privkey*.pem
若 nginx worker 以 www-data 运行且无法读私钥,正确做法是用 deploy hook 复制一份到 nginx 自己的目录,而不是 chmod -R 755 /etc/letsencrypt:
#!/bin/sh
# /etc/letsencrypt/renewal-hooks/deploy/nginx-copy.sh (chmod 755)
install -o root -g www-data -m 640
/etc/letsencrypt/live/example.com/privkey.pem /etc/nginx/ssl/example.com.key
install -o root -g www-data -m 644
/etc/letsencrypt/live/example.com/fullchain.pem /etc/nginx/ssl/example.com.crt
systemctl reload nginx
改完统一执行 nginx -t && systemctl reload nginx,再用 openssl s_client -connect example.com:443 -tls1_2 与 -tls1_3 各验一次,确认协议与证书链都符合预期,这套 ssl证书 安装教程续期 的配置才算真正闭环。
certbot、acme.sh、商业证书、云托管证书怎么选?一张对比表说清
先把结论摊开:续期是否需要人工介入,比证书价格重要一个数量级。据 Let’s Encrypt 官方文档,其证书固定 90 天有效期,正是为了逼迫自动化;而一张 398 天的商业证书如果到期前没人记得替换,事故概率反而更高。下面是 2025 年 6 月口径的四类方案横向对比。
| 方案 | 有效期 / 续期方式 | 运行依赖 | 泛域名 | 续期是否需人工 | 典型场景 |
|---|---|---|---|---|---|
| certbot 2.9 | 90 天,默认到期前 30 天自动续 | Python3 + systemd timer | 需 DNS 插件(dns-cloudflare 等) | 否 | 单机 Nginx/Apache 首选 |
| acme.sh 3.0.8 | 90 天,默认第 60 天续期 | 纯 Shell,无 Python | 支持 100+ DNS API | 否(但 reloadcmd 需自查) | 容器、多域名、泛域名、内网 |
| 商业 DV | ≤398 天(CA/B Forum 新规 2026-03-15 起降至 200 天) | 人工或厂商 API | 支持 | 是 | 需要发票、合同、SLA 与赔付条款 |
| 云托管免费 DV | 90 天(2024 年起由 1 年缩短) | 平台自动签发 | 部分支持 | 半自动,需手动同步到 SLB/CDN | 已使用 SLB/CDN 的站点 |
certbot 的取舍:优势在 --nginx 插件会直接改写 server 块并插入 301 跳转,省去手写配置;代价是 Python 依赖较重,Alpine 等精简镜像需额外装 python3、openssl-dev、gcc 才能编译。这是 SSL 证书安装教程续期流程里最省心的一条路径:
# 适用:certbot 2.9.x / Ubuntu 22.04、Debian 12(systemd 环境)
sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d example.com -d www.example.com
--redirect # 自动加 301 跳转
--keep-until-expiring # 未临期不重复签发,避免触发速率限制
--deploy-hook "systemctl reload nginx" # 仅在成功续期后 reload
# 续期参数落在 /etc/letsencrypt/renewal/example.com.conf
# renew_before_expiry 默认 30 天,可改为 30d 之外的值
sudo certbot renew --dry-run # 演练,不消耗真实签发额度
acme.sh 的取舍:单文件 Shell 脚本,能跑在没有 80 端口的内网机器上,靠 DNS TXT 记录完成验证,是做泛域名与 CDN 回源证书的主力。坑在 --install-cert:--reloadcmd 写错(比如服务名拼错)不会报错,证书文件已复制但 Nginx 仍加载旧证书,浏览器照旧显示过期。
# 适用:acme.sh 3.0.8(2024-11 发布)
curl https://get.acme.sh | sh -s email=ops@example.com
~/.acme.sh/acme.sh --set-default-ca --server letsencrypt # 3.0 起默认 CA 为 ZeroSSL,需显式切回
export Ali_Key="LTAI***"; export Ali_Secret="***"
~/.acme.sh/acme.sh --issue --dns dns_ali -d example.com -d '*.example.com'
~/.acme.sh/acme.sh --install-cert -d example.com
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/fullchain.pem
--reloadcmd "systemctl reload nginx" # 写错不报错,务必核对时间戳
ls -l --time-style=full-iso /etc/nginx/ssl/fullchain.pem # 时间戳应等于本次续期时间
商业与云托管证书:商业 DV 单域名公开报价约 ¥100–500/年,OV 约 ¥800–3000/年,DV 通配符约 ¥500–1500/年,DV 通常 1–3 个工作日出证,OV 需企业资质审核。按 CA/Browser Forum Baseline Requirements,公开信任证书最长 398 天,且 2026-03-15 起分阶段缩至 200 天、2027 年 100 天、2029 年 47 天——”买一年省事”的逻辑正在失效。阿里云、腾讯云的免费 DV 单账号每年约 20 张额度,续期后不会自动同步到 SLB/CDN,需要调 API 或手工上传,这是最容易被漏掉的一步。
所以选型只有一条:把”续期是否需要人”放在第一位,价格与品牌放第二位。能全自动签发并自动 reload 的 90 天证书,运维风险低于需要人工替换的 1 年期证书;需要合同与赔付条款时再上商业 OV,并用 ACME 客户端管好其余域名,这套 SSL 证书安装教程续期的组合拳在 90 天周期下反而最稳。
续期时最常见的 6 条真实报错,分别怎么处理?
续期失败时先别急着重跑命令——每次失败都消耗 Let’s Encrypt 的限流额度。日志在 /var/log/letsencrypt/letsencrypt.log,先 grep -i “error|failed” 定位再动手。下面 6 条报错覆盖了这套 ssl证书 安装教程续期 流程里 90% 的翻车场景。
问:certbot renew 报 Problem binding to port 80: Could not bind to IPv4 or IPv6,是不是要先停 Nginx?
不要停。这条报错来自 renewal 配置里仍写着 standalone:standalone 要独占 80 端口,而 Nginx 已监听 0.0.0.0:80,内核直接返回 EADDRINUSE。停 Web 服务会让验证窗口内业务 502。改用 webroot 让 Nginx 顺带吐出验证文件,或交给 nginx 插件:
# 先看当前用的是哪种 authenticator,standalone 就是罪魁
grep -E 'authenticator|installer' /etc/letsencrypt/renewal/example.com.conf
# 方案 A:webroot,验证文件落在站点根目录,Nginx 无需停机
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com
# 方案 B:nginx 插件(Debian/Ubuntu 需先 apt install python3-certbot-nginx)
certbot --nginx -d example.com -d www.example.com
据 Let’s Encrypt 文档,http-01 只要求 /.well-known/acme-challenge/ 下的随机文件名能被公网 GET 到,因此 webroot 模式与线上业务天然共存;执行后 renewal 文件中的 authenticator 会改写为 webroot,后续自动续期不再抢端口。
问:报 Timeout during connect (likely firewall problem),安全组明明放行了?
按”本机 → 公网 → IPv6″三层排查:
# 1) 本机造验证文件,确认 Nginx 能返回 200
mkdir -p /var/www/html/.well-known/acme-challenge
echo ok > /var/www/html/.well-known/acme-challenge/test.txt
curl -I http://example.com/.well-known/acme-challenge/test.txt
# 2) 换一台公网机器复测;再查 firewalld 是否放行 http
firewall-cmd --list-services
firewall-cmd --add-service=http --permanent && firewall-cmd --reload
# 3) AAAA 指向不可达地址同样触发超时(LE 优先走 IPv6)
dig +short AAAA example.com
IPv6 是最易被忽略的一环:AAAA 记录残留旧机器地址时,IPv4 再通也会超时。
- SSL域名证书申请 · 小程序证书 · 国外SSL证书
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- Wildcard 通配符 SSL 证书安装部署续费申请
- 中小企业云服务器安全代运维(防攻击方案)
- APP/小程序 HTTPS · SSL网站加密证书 · CA证书配置
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
问:too many failed authorizations recently 要等多久?
Let’s Encrypt 对”同一账号 + 同一主机名”的失败验证限流为每小时 5 次,触发后 1 小时内该主机名的所有验证请求被直接拒绝。别用 –force-renewal 硬撞,先去 staging 调通:
# staging 端点不消耗生产配额,签发的是不被信任的测试证书
certbot certonly --webroot -w /var/www/html -d example.com
--server https://acme-staging-v02.api.letsencrypt.org/directory
# 回生产前,若已存在同名 lineage,需强制覆盖
certbot certonly --webroot -w /var/www/html -d example.com --force-renewal
更稳妥的日常体检是 certbot renew –dry-run:它同样走 staging,只演练不落盘。
问:Nginx 报 BIO_new_file() failed (SSL: error:80000002:system library::No such file or directory)?
这是 OpenSSL 找不到文件,而非证书内容错误——多为路径拼错或证书从未签发成功。检查软链接链是否完整:
ls -l /etc/letsencrypt/live/example.com/
# 正常应看到 fullchain.pem -> ../../archive/example.com/fullchain2.pem
readlink -f /etc/letsencrypt/live/example.com/fullchain.pem # 必须解析到真实文件
grep ssl_certificate /etc/nginx/conf.d/example.com.conf
nginx -t
live/ 里只有软链接,实体在 archive/;打包迁移只拷 live 目录就会链接悬空。同时确认 worker 进程用户对 /etc/letsencrypt 有读权限(默认 0755 / 0644 即可)。
问:curl 报 (60) SSL certificate problem: unable to get local issuer certificate,浏览器却正常?
浏览器会自动补链(AIA Fetching),curl、Java、旧版 Android 不会。根因是只配了 cert.pem,缺中间证书。按 Mozilla SSL 配置生成器的建议,服务器应下发完整链:
# Nginx:分别指向 fullchain.pem 与 privkey.pem
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
# Apache 2.4.8+ 用 fullchain 覆盖 SSLCertificateFile(SSLCertificateChainFile 已废弃)
SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
# 数链层数,正常 2–3 层(叶子 + 中间,不含根)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'
问:磁盘上证书日期是新的,浏览器仍提示 NET::ERR_CERT_DATE_INVALID?
证书换了但进程没重载,或 CDN 边缘节点还持着旧证书。Nginx reload 是平滑的,不会中断存量连接:
nginx -t && systemctl reload nginx # Apache:apachectl configtest && systemctl reload httpd
systemctl status certbot.timer # Debian 系默认每天跑两次
echo | openssl s_client -connect example.com:443 2>/dev/null | openssl x509 -noout -dates
前置 CDN 时,源站 reload 对边缘无效,须在控制台重新上传 fullchain.pem 与 privkey.pem 并刷新节点,再用手机 4G 等不同网络复测,排除本地代理缓存。
| 报错关键字 | 根因 | 一分钟定位 | 处置 |
|---|---|---|---|
| Could not bind to port 80 | standalone 与 Nginx 抢端口 | grep authenticator renewal/*.conf | 改 –webroot 或 –nginx,不停服务 |
| Timeout during connect | 安全组/firewalld/AAAA 不可达 | curl -I …/acme-challenge/test.txt | 放行 80,清理无效 AAAA |
| too many failed authorizations | 失败验证 5 次/小时限流 | 日志中的 “retry after” | 等 1 小时,转 staging 调通 |
| BIO_new_file() failed | 路径错误或软链接悬空 | readlink -f live/…/fullchain.pem | 修正路径或重新签发 |
| unable to get local issuer | 缺中间证书 | s_client 数 BEGIN CERTIFICATE 行数 | 改用 fullchain.pem |
| ERR_CERT_DATE_INVALID | 未 reload 或 CDN 缓存 | openssl x509 -noout -dates | reload + 重传边缘证书 |
怎么确认续期真的生效?6 个验证动作从本机做到公网
运行 certbot renew 并看到 Congratulations, all renewals succeeded,只说明新证书已写入 /etc/letsencrypt/live/,并不等于浏览器实际收到了它——Nginx/Apache 未 reload 时会继续使用内存里的旧证书。据 Let’s Encrypt 文档,证书有效期 90 天、官方建议在剩余 30 天时续期,所以下面 6 个动作按“磁盘 → 进程 → 公网”由内向外排列,OpenSSL 3.x、curl 8.x、certbot 2.x / acme.sh 3.x 均适用。
-
本机直接读取叶证书,比对 notAfter 与 issuer。notAfter 应比上一次推进约 90 天;issuer 应为 R10/R11(RSA)或 E5/E6(ECDSA),商业 CA 则显示对应品牌名(如
DigiCert TLS RSA SHA256 2020 CA1)。若仍是Let's Encrypt Authority X3,说明服务器还在下发 2021 年 9 月已停用的旧中间证书,fullchain.pem需要更新。openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates # 期望输出(节选) # issuer=C = US, O = Let's Encrypt, CN = R11 # notBefore=Jun 1 00:00:00 2025 GMT # notAfter=Aug 30 23:59:59 2025 GMT -
HTTP 层再验一次。curl 的
-v会同时打印校验结果与到期日;出现SSL certificate verify failed基本只有两种原因:ssl_certificate指向了cert.pem而非fullchain.pem(缺中间证书),或 SNI 未命中目标 server 块。curl -vI https://example.com 2>&1 | grep -E "expire date|SSL certificate verify ok" # 期望:* SSL certificate verify ok. # * expire date: Aug 30 23:59:59 2025 GMT -
查看客户端记录。certbot 的续期状态表里 VALID 与 EXPIRY DATE 两列必须刷新,acme.sh 则看 Next Renew 时间(两者默认都提前 30 天续期)。
certbot certificates # certbot 2.x,默认 /etc/letsencrypt # Expiry Date: 2025-08-30 23:59:59+00:00 (VALID: 89 days) # Certificate Path: /etc/letsencrypt/live/example.com/fullchain.pem acme.sh --list # acme.sh 3.x,默认 ~/.acme.sh # Main_Domain KeyLength SAN_Domains CA Created Renew -
调度验证。certbot 2.x 默认安装
certbot.timer(OnCalendar=*-*-* 00/12:00:00加最多 12 小时随机延迟,即每天两次);若同时保留旧 cron 条目会重复续期,撞上 Let’s Encrypt 每周 50 张/注册域名的速率限制。NEXT 应指向未来 12 小时内,LAST 应在 12 小时内。systemctl list-timers | grep certbot # NEXT LEFT LAST PASSED UNIT # Mon 2025-07-28 03:22:11 UTC 1 day 2h Sun 2025-07-27 03:22:11 UTC 22h ago certbot.timer journalctl -u certbot --since "7 days ago" | grep -Ei "succeeded|failed|error" # 出现 "status=1/FAILURE" 或 "Some challenges have failed" 即需人工介入 -
第三方验证。据 Qualys SSL Labs 评级文档,A 级的硬门槛是证书链完整且只启用 TLS 1.2/1.3;A+ 还要求响应头带 HSTS(
max-age≥ 15768000 秒且含includeSubDomains);OCSP Stapling 在 Protocol Details 中单列。本地复核用 testssl.sh 3.2+,有 HIGH 及以上发现时退出码非 0。testssl.sh --severity HIGH --exitcode https://example.com; echo "exit=$?" -
OCSP Stapling 验证。据 RFC 6960,stapled 响应由服务器代取并随握手下发,取不到时 Nginx 会静默回退为不下发,只有
-status能看到真相。echo | openssl s_client -connect example.com:443 -status 2>/dev/null | grep -A1 "OCSP Response Status" # 生效: OCSP Response Status: successful (0x0) # 未生效:OCSP Response Status: no response sent# /etc/nginx/conf.d/example.com.conf —— nginx 1.25.x,三项默认均为 off ssl_stapling on; # 默认 off,必须显式开启 ssl_stapling_verify on; # 默认 off,校验响应签名 ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem; resolver 1.1.1.1 valid=300s; # 缺 resolver 会取不到 OCSP,表现为 no response sentApache 对应
SSLUseStapling on与SSLStaplingCache "shmcb:logs/ssl_stapling(32768)"(mod_ssl 中默认 off)。
| 现象 | 根因 | 处置 |
|---|---|---|
| curl 报 verify failed | 只发叶证书,缺中间证书 | ssl_certificate 指向 fullchain.pem |
| notAfter 未变化 | 进程未 reload,仍用旧证书 | certbot renew --deploy-hook "systemctl reload nginx" |
| no response sent | 无 resolver,或 trusted_certificate 指向 fullchain | 配 resolver + chain.pem |
| SSL Labs 停在 A | 未下发 HSTS,或仍支持 TLS 1.1 | 加 Strict-Transport-Security: max-age=31536000; includeSubDomains |
最后补一环:webroot 方式续期不会自动 reload,certbot 只在配置了 deploy hook 时才执行。把重载写进 /etc/letsencrypt/renewal-hooks/deploy/ 下的脚本,或用下面这条命令做一次演练(--dry-run 走 staging 环境,不消耗速率配额),才算真正闭环——这也是“ssl证书 安装教程续期”里最容易被跳过的一步。
certbot renew --dry-run --deploy-hook "systemctl reload nginx"
把续期做成可观测:30/14/7 天三级告警与应急回滚清单
为什么 90 天周期要配三级告警,而不是”过期前一周提醒一下”?
据 Let’s Encrypt 文档,证书有效期固定 90 天,官方建议在剩余 30 天时完成续期。如果第 30 天还没续上,说明 certbot.timer、cron 或 ACME 挑战这条链路本身已经坏了;此时再等到剩 7 天才告警,等于把 60 天的排查窗口压缩成 72 小时。把 ssl证书 安装教程续期 做成可观测的关键,是让”续期失败”在证书过期前 80 天就自己冒出来,而不是靠人记日子。
| 级别 | 剩余时间 | PromQL 阈值(秒) | 含义与处置动作 | 通知策略 |
|---|---|---|---|---|
| 提醒 | 30 天 | 86400 * 30(2592000) |
正常续期本应已发生,检查 systemctl status certbot.timer、/var/log/letsencrypt/letsencrypt.log |
工单/IM 群,每日一次 |
| 告警 | 14 天 | 86400 * 14(1209600) |
续期链路异常,重点查 80/443 是否可达、webroot 路径、DNS-01 API 凭证 | 值班电话,每 4 小时重复 |
| P1 | 7 天 | 86400 * 7(604800) |
立即手工介入并准备回滚,见下文应急命令 | 升级到负责人,每 1 小时重复 |
blackbox_exporter 怎么配才能拿到这个指标?
# /etc/blackbox_exporter/blackbox.yml —— 版本 v0.25.0 验证通过
modules:
https_2xx:
prober: http
timeout: 5s
http:
method: GET
preferred_ip_protocol: ip4
tls_config:
insecure_skip_verify: false # 证书链有问题就该探活失败,不要跳过
# prometheus.yml —— 关键在 relabel:target 传给 exporter,instance 保留原域名
scrape_configs:
- job_name: 'blackbox-tls'
metrics_path: /probe
params:
module: [https_2xx]
static_configs:
- targets: ['https://example.com']
relabel_configs:
- source_labels: [__address__]
target_label: __param_target
- source_labels: [__param_target]
target_label: instance
- target_label: __address__
replacement: 127.0.0.1:9115 # blackbox_exporter 监听地址
# rules/tls-expiry.yml
groups:
- name: tls-expiry
rules:
- alert: SSLCertExpiresIn14d
expr: probe_ssl_earliest_cert_expiry - time() < 86400 * 14
for: 1h
labels: { severity: critical }
annotations:
summary: "{{ $labels.instance }} 证书剩余 {{ $value | humanizeDuration }}"
Alertmanager 侧把 repeat_interval: 4h 写在 route 上,配合 group_by: [alertname, instance],避免同一域名在 14 天内反复刷屏又漏掉。注意 probe_ssl_earliest_cert_expiry 是 Unix 时间戳(秒),所以必须减 time();直接比较绝对值是最常见的写错方式。
不用 Prometheus 的两种替代
- Zabbix 6.0+ 内置
web.certificate.get[example.com,443,,example.com],返回 notAfter 文本,触发器写last(/host/web.certificate.get[...]) - now() < 14d即可,无需额外 agent。 - Nginx 的
stub_status只暴露连接数、不暴露证书信息,必须另跑脚本:echo | openssl s_client -servername example.com -connect example.com:443 2>/dev/null | openssl x509 -noout -enddate。 - 宝塔面板用户在「网站 → SSL → 自动续签」查看上次续签时间;证书实际落在
/www/server/panel/vhost/cert/example.com/,续签失败日志在/www/server/panel/logs/letsencrypt.log。
手工应急:先备份,再强制重签
# 1) 快照,出问题能原样还原(Let's Encrypt 与 Nginx 配置一起打包)
tar czf /root/le-$(date +%F).tgz /etc/letsencrypt /etc/nginx
# 2) 强制重签;--force-renewal 会跳过"剩余 30 天才续"的判断
certbot certonly --webroot -w /var/www/html -d example.com --force-renewal
# 3) 验证后再 reload(不要用 restart,避免连接中断)
nginx -t && systemctl reload nginx
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -dates
据 Let’s Encrypt 限流文档,同一组完全相同的域名每周最多签发 5 张重复证书(Duplicate Certificate limit),--force-renewal 每次都计入。所以调试期用 --dry-run 或 staging 环境验证,别在正式环境反复试。
reload 失败怎么回滚?
nginx -t
# 典型报错:
# nginx: [emerg] cannot load certificate "/etc/letsencrypt/live/example.com/fullchain.pem":
# BIO_new_file() failed (SSL: error:80000002:system library::No such file or directory)
# 用快照还原证书与配置,再平滑重载
tar xzf /root/le-2025-01-01.tgz -C /
nginx -t && systemctl reload nginx
ss -lntp | grep ':443' # 确认监听未中断
要点是:live/ 目录下是软链,指向 archive/ 里的编号文件;续期失败常表现为软链指向了不存在的新版本,此时从快照恢复比手工改软链更安全。
变更记录别省:每次续期后在 CMDB 或工单登记域名、签发时间、notAfter、执行的 reload 命令与验证结果。半年后统计”应续期次数 / 实际成功次数”,就能算出续期失败率,这也是下一次 ssl证书 安装教程续期 复盘里最有说服力的数据。
多数情况是 Web 配置指向了复制出来的证书文件,而 certbot 更新的是 /etc/letsencrypt/live/ 下的软链接。先 grep -r ssl_certificate /etc/nginx/ 确认路径,改成 fullchain.pem 后执行 nginx -t && systemctl reload nginx,再用 openssl s_client 检查 notAfter 是否变化。
单机跑 Nginx/Apache 且系统有 systemd,certbot 2.9+ 的 –nginx 插件最省配置,续期由 certbot.timer 自动调度。若在容器里、没有 Python 环境,或需要 DNS-01 自动签发泛域名,acme.sh 3.0.8 更合适,但它不会自动帮你改 Web 配置,–reloadcmd 要自己写对。
可以自动续期,但通配符只能用 DNS-01 验证,必须配置 DNS 服务商的 API 凭据。certbot 需安装对应的 dns 插件(如 python3-certbot-dns-aliyun),acme.sh 内置 100 多种 DNS API,例如 acme.sh –issue –dns dns_ali -d example.com -d '*.example.com',全程不需要 80 端口。
Let's Encrypt 对同一账号、同一主机名的失败验证限流是每小时 5 次,触发后通常等待 1 小时即可恢复。建议先用 –server https://acme-staging-v02.api.letsencrypt.org/directory 在测试环境把 80 端口、DNS 解析、防火墙全部调通,再切回生产环境正式续期,避免反复触发限流。
正常续期不需要停机。HTTP-01 验证只读取 /.well-known/acme-challenge/ 下的临时文件,reload Nginx 是平滑重载,已建立的连接不会断开。真正会中断的是误用 standalone 模式去抢占 80 端口,或者 reload 时配置语法错误导致进程退出,所以务必先 nginx -t 再 reload。
需要。商业 CA 续费后签发的是全新证书与序列号,私钥可能复用也可能重新生成,必须把新的 fullchain 与 key 覆盖到 /etc/ssl// 并 reload。建议把这一步写进同一个 deploy 脚本,和 Let's Encrypt 的 renew_hook 共用一条 systemctl reload nginx,避免两套流程各自维护。
不要用 standalone 模式。Nginx 占用 80 时给 certbot 加 –webroot -w /var/www/html,让校验文件走已有站点目录;或直接用 –nginx 插件由 certbot 自己插入 location 段。Apache 场景同理用 –apache 或 –webroot,关键是保证 http://域名/.well-known/acme-challenge/ 能被公网访问到。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。