SSL 证书安装教程与到期提醒完整实操:CSR 签发、Nginx 部署、certbot 续期与告警配置
SSL 证书安装教程的正确顺序是「先建到期提醒、再传证书文件」:公共 TLS 证书最长有效期已从 398 天进入压缩通道,Let's Encrypt 默认 90 天,靠人脑记到期日必然出事故,建议按剩余 30 天告警、14 天日报、7 天电话三档设置。 安装完成后用一条命令即可自查到期时间:echo | openssl s_client -connect www.example.com:443 -servername www.example.com 2>/dev/null | openssl x509 -noout -dates -issuer,输出中的 notAfter 就是告警脚本的输入源。 自动续期必须验证而不只是配置:certbot 2.11.0 执行 certbot renew --dry-run 应输出「Congratulations, all simulated renewals succeeded」,并配合 --deploy-hook "systemctl reload nginx" 才能真正生效。 到期提醒建议双通道:本地 cron/systemd timer 读取 fullchain.pem 的 notAfter,同时用 blackbox_exporter 的 probe_ssl_earliest_cert_expiry 指标做远程探测,避免「本地文件已换、线上仍是旧证书」的假阴性。 成本参考:Let's Encrypt 与自建监控为 0 元;商业 DV 证书约 100–300 元/年、OV 约 500–2000 元/年、EV 约 1500–6000 元/年,付费证书的到期邮件通知不能替代你自己的告警链路。
为什么 SSL 证书安装教程照做了,还是会栽在到期提醒上?
很多人搜 ssl证书 安装教程到期提醒,往往是因为照着教程配完 Nginx、绿锁亮了之后就再没管过,直到某天早上浏览器甩出 NET::ERR_CERT_DATE_INVALID,用户投诉比告警邮件先到。问题从来不出在“装”,而出在“装完之后没有任何东西在盯着它”。
典型事故链是这样的:
- Let’s Encrypt 签发的证书有效期只有 90 天(据 Let’s Encrypt 官方文档 Renewing certificates 章节,官方建议在剩余 30 天时续期);
- certbot 靠 systemd timer 触发续期,Debian/Ubuntu 的软件包默认安装并启用
certbot.timer,每天触发两次并带随机延迟; - 某次安全加固执行了
systemctl disable --now certbot.timer,或 80 端口被 WAF / 安全组拦截,HTTP-01 校验失败; - 续期静默失败——
certbot renew的失败信息只写进 journal,没人看; - 第 90 天证书过期,服务不可用。
失败时你会在 journalctl -u certbot 里看到这样的真实报错,但它不会主动通知你:
# 依次验证:证书到底哪天到期、定时器是否在跑、续期通路是否还通
openssl x509 -in /etc/letsencrypt/live/example.com/cert.pem
-noout -subject -enddate -ext subjectAltName
# 输出形如 notAfter=Jun 18 03:14:07 2025 GMT,这才是判断到期的唯一依据
systemctl list-timers | grep -i certbot # 没有输出 = 续期永远不会被触发
systemctl status certbot.timer # 关注 Active: 是否为 active (waiting)
# 空跑一次,验证 HTTP-01 通路;--dry-run 走 staging 环境,不消耗正式速率限制
certbot renew --dry-run --webroot -w /var/www/html
# 校验失败时典型报错:
# Failed authorization procedure. example.com (http-01):
# urn:ietf:params:acme:error:unauthorized :: Invalid response from http://example.com/.well-known/acme-challenge/...
更麻烦的是,有效期还在持续缩短。CA/Browser Forum 已通过 SC-081 ballot,把公共 TLS 证书最长有效期分阶段压缩,30 天告警阈值在 100 天证书时代只剩三分之一缓冲,提醒阈值必须跟着改:
| 生效日期 | 公共 TLS 证书最长有效期 | Let’s Encrypt 实际签发 | 提前 30 天告警的剩余缓冲 |
|---|---|---|---|
| 当前 | 398 天 | 90 天 | 约 33% |
| 2026-03-15 起 | 200 天 | 90 天 | 约 33% |
| 2027-03-15 起 | 100 天 | 90 天 | 约 33%(绝对天数不变,但商业 CA 证书缓冲骤减) |
三类高频盲区同样致命:泛域名证书只监控了主域,漏掉 SAN 里的 api.example.com;CDN 边缘证书与回源证书不是同一张,只监控回源必然漏报;内网自签证书没有 CA 邮件通知,到期后内部系统调用直接握手失败。
还有一层:提醒本身也会失效。告警邮件被企业邮箱判为垃圾、钉钉机器人 access_token 过期、监控服务器自身 DNS 被改指向旧 IP,都会造成“配了提醒但没收到”。所以邮件 + webhook 双通道是底线,并每季度做一次阈值演练——手动把告警阈值调到剩余 89 天,确认两条通道都真的响。
把 ssl证书 安装教程到期提醒 拆成“台账 → 签发 → 部署 → 提醒 → 演练”五段,提醒环节放在部署之前设计,而不是等出事再补,才是这类教程该有的写法。
SSL 证书安装教程 6 步实操:从证书清单到到期提醒上线
为什么”装证书”这件事要从建台账开始?因为据 Let’s Encrypt 官方公告,其自 2025 年 6 月起已停止发送证书到期提醒邮件;而 CA/Browser Forum 的 SC-081 ballot 又要求公有证书最长有效期从 398 天逐步缩短(2026-03-15 起 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天)。也就是说,证书换得越来越勤,外部提醒却越来越少——到期提醒必须由你自己兜底,而台账就是提醒脚本唯一可靠的数据源。下面 6 步是一条可直接照做的完整链路。
第 1 步:先建证书台账,再谈安装
用 OpenSSL 1.1.1 及以上版本(-ext 选项自 1.1.1 引入)把每张存量证书的元数据一次性导出来:
openssl x509 -in cert.pem -noout -subject -issuer -dates -ext subjectAltName
# 输出示例:
# subject=C = CN, O = Example Ltd, CN = example.com
# 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
# X509v3 Subject Alternative Name:
# DNS:example.com, DNS:www.example.com
把结果登记成表,字段至少包含:域名、SAN 列表、签发 CA、签发日、到期日、部署节点、负责人、续期方式(certbot 自动 / 手动 CSR)。SAN 一定要抄全,据 RFC 5280 第 4.2.1.6 节,现代浏览器早已忽略 CN 字段、只认 SAN,漏掉 www 子域是最常见的”证书装了但报错”来源。
第 2 步:生成私钥与 CSR
# RSA 2048(兼容性优先)
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key -out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Ltd/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
# ECDSA P-256(性能优先)
openssl ecparam -genkey -name prime256v1 -out example.com.key
openssl req -new -key example.com.key -out example.com.csr
-subj "/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
chmod 600 example.com.key # 生成后立刻收紧权限
| 维度 | RSA 2048 | ECDSA P-256 |
|---|---|---|
| 证书体积 | 约 1.5 KB | 约 0.6 KB |
| TLS 1.3 握手开销 | 较大 | 更小,移动端首包更快 |
| 兼容性 | 全平台通吃 | Android 4.x 及更早系统不支持 |
| Nginx 配置 | 指令相同;ECDSA 建议同时挂 RSA 证书做双栈 | |
第 3 步:组装 fullchain,顺序不能错
CA 下发的压缩包里通常是 domain.crt(叶子)与 ca_bundle.crt(中间证书)。拼接规则是”叶子在前、中间在后、根证书不打包”:
cat domain.crt ca_bundle.crt > fullchain.pem
# 校验:链完整则返回 OK
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem
# 顺序反了会得到:
# error 20 at 0 depth lookup: unable to get local issuer certificate
顺序拼错时,curl 会直接报 SSL certificate problem: unable to get local issuer certificate,浏览器则显示 ERR_CERT_AUTHORITY_INVALID。这是本教程里最高频的翻车点。
第 4 步:部署到 Nginx
install -d -m 755 /etc/nginx/ssl/example.com
install -m 644 fullchain.pem /etc/nginx/ssl/example.com/fullchain.pem
install -m 600 privkey.pem /etc/nginx/ssl/example.com/privkey.pem
chown -R root:root /etc/nginx/ssl/example.com
# /etc/nginx/conf.d/example.com.conf
server {
listen 443 ssl;
http2 on; # Nginx 1.25.1+;旧版写 listen 443 ssl http2;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/example.com/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_session_cache shared:SSL:10m;
add_header Strict-Transport-Security "max-age=31536000" always;
}
nginx -t # 期望输出:test is successful
systemctl reload nginx # 用 reload 而非 restart,避免瞬时连接中断
若私钥与证书不匹配,nginx -t 会明确报 [emerg] SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。TLS 参数可参考 Mozilla SSL Configuration Generator 的 intermediate 配置档。
第 5 步:写入到期提醒(30 / 14 / 7 天三级)
#!/usr/bin/env bash
# /usr/local/bin/cert-expiry-check.sh 适用 OpenSSL >= 1.1.1
set -uo pipefail
WARN=30; DAILY=14; PAGE=7
MAIL="ops@example.com"
LIST="/etc/nginx/ssl/cert-list.txt" # 每行一个 fullchain.pem 绝对路径
LOG="/var/log/cert-expiry.log"
while IFS= read -r cert; do
[[ -z "$cert" || "$cert" == #* ]] && continue
[[ -r "$cert" ]] || { echo "$(date -Is) MISSING $cert" >> "$LOG"; continue; }
end_ts=$(date -d "$(openssl x509 -in "$cert" -noout -enddate | cut -d= -f2)" +%s)
days=$(( (end_ts - $(date +%s)) / 86400 ))
subj=$(openssl x509 -in "$cert" -noout -subject | sed 's/^subject=//')
if (( days <= PAGE )); then level=PAGE # 7 天内:电话/短信
elif (( days <= DAILY )); then level=DAILY # 14 天内:转日报
elif (( days <= WARN )); then level=WARN # 30 天内:首封邮件
else continue; fi
echo "$(date -Is) [$level] ${days}d $subj $cert" >> "$LOG"
printf '%sn' "$level: $subj 剩余 ${days} 天,证书 $cert"
| mail -s "[$level] 证书 ${days} 天后到期" "$MAIL"
done < "$LIST"
# /etc/cron.d/cert-expiry 注意 cron.d 格式多一个用户字段
SHELL=/bin/bash
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin
0 9 * * * root /usr/local/bin/cert-expiry-check.sh >> /var/log/cert-expiry.log 2>&1
同时登录 CA 后台,确认到期通知邮箱是运维组邮箱而不是离职员工邮箱——这一点在换过几轮人的团队里几乎必然出过问题。
第 6 步:演练一次,然后留档
把 WARN 临时改成 400 手动执行一次脚本,确认邮件与 webhook 在 5 分钟内到达(注意 mail(1) 发出的信容易被企业网关丢进垃圾箱,要顺手检查 SPF/DKIM)。演练通过后,把本次 CSR、fullchain 拼接命令、部署路径、权限、提醒阈值写进 runbook;如果同域也在用 certbot,把 /etc/letsencrypt/renewal/*.conf 一并归档——交接时缺了它,接手人连续期用的验证方式(webroot 还是 standalone)都无从判断。
配置与命令示例:OpenSSL 3.0.13 + Nginx 1.24 + certbot 2.11 可直接复制
怎么确认线上真正生效的证书到期时间?不要看本地文件——Nginx 换了证书但忘了 reload、或者 SNI 多站点下查错了虚拟主机,都会让”到期提醒”报出错误日期。直接用 OpenSSL 走一遍握手,拿到的就是用户浏览器看到的证书。Ubuntu 24.04 自带 OpenSSL 3.0.13,无需额外安装:
# -servername 触发 SNI,多站点/共用 IP 场景必须带,否则返回默认站点证书
echo | openssl s_client -connect www.example.com:443 -servername www.example.com 2>/dev/null
| openssl x509 -noout -dates -issuer -subject
# 典型输出(Let's Encrypt 证书有效期 90 天)
# notBefore=Mar 1 00:00:00 2025 GMT
# notAfter=May 30 23:59:59 2025 GMT
# issuer=C=US, O=Let's Encrypt, CN=R11
# subject=CN=www.example.com
SNI 由 RFC 6066 定义,缺少 -servername 时服务端只能回落到默认 server 块,这是”证书查出来是别人的”最常见原因。
Nginx 1.24 最小可用 HTTPS 片段:手写 cipher 套件容易漏项且跟不上安全基线,建议套件部分交给 Mozilla SSL Configuration Generator 的 intermediate 档位生成(覆盖 TLS 1.2/1.3,兼容 Firefox 27、Chrome 31、Android 4.4.2 及以上),再补上这几行核心配置:
server {
listen 443 ssl;
http2 on; # 1.25.1+ 写法;1.24 用 listen 443 ssl http2;
server_name www.example.com;
ssl_certificate /etc/nginx/ssl/example.com/fullchain.pem; # 必须 fullchain,不能只给 leaf
ssl_certificate_key /etc/nginx/ssl/example.com/privkey.pem; # 权限 600,属主 root
ssl_protocols TLSv1.2 TLSv1.3;
ssl_session_cache shared:SSL:10m; # 约 4 万会话,默认 none
ssl_session_timeout 1d;
}
# 改完先 nginx -t,通过后再 systemctl reload nginx
certbot 2.11.0 自动续期怎么写?Let’s Encrypt 证书有效期 90 天,官方文档明确建议在剩余 30 天内续期,certbot renew 默认就是按这个阈值跳过未到期证书的。先用 dry-run 验证链路,再交给 cron/timer:
certbot renew --dry-run # 演练,不写盘、不触碰真实证书
certbot renew --webroot -w /var/www/html --deploy-hook "systemctl reload nginx"
| 方式 | 适用场景 | 是否自动改 Nginx 配置 | 是否需 deploy-hook |
|---|---|---|---|
--webroot -w |
Nginx 配置由 Git/配置管理维护,不希望被工具改写 | 否 | 需要,用于 reload |
--nginx |
单机、配置简单,图省事 | 是(自动插入证书路径) | 不需要,插件自己 reload |
到期提醒脚本怎么写得跨平台不踩坑?核心四行用 GNU date 计算剩余天数:
#!/usr/bin/env bash
CRT=/etc/nginx/ssl/example.com/fullchain.pem
end=$(openssl x509 -in "$CRT" -noout -enddate | cut -d= -f2) # 形如 Mar 30 23:59:59 2025 GMT
end_ts=$(date -d "$end" +%s) # macOS 的 date 无 -d,改用 gdate 或 Python
now_ts=$(date +%s)
left=$(( (end_ts - now_ts) / 86400 ))
if [ "$left" -le 30 ]; then
curl -s -X POST -H 'Content-Type: application/json'
-d "{"msgtype":"text","text":{"content":"example.com 证书剩余 ${left} 天"}}"
'https://oapi.dingtalk.com/robot/send?access_token=xxxx'
fi
用 cron 还是 systemd timer?推荐 timer:支持 Persistent=true 补偿关机期间错过的执行,还有随机抖动避免批量机器同一秒打爆告警接口。
# /etc/systemd/system/cert-expiry.timer
[Unit]
Description=Daily TLS certificate expiry check
[Timer]
OnCalendar=*-*-* 09:00:00
Persistent=true
RandomizedDelaySec=300
[Install]
WantedBy=timers.target
# /etc/systemd/system/cert-expiry.service
[Unit]
Description=TLS cert expiry checker
[Service]
Type=oneshot
ExecStart=/usr/local/bin/cert-expiry.sh
systemctl enable --now cert-expiry.timer
systemctl list-timers cert-expiry.timer # 确认 NEXT 时间
推送渠道切换时只改 curl 的 body:钉钉是 msgtype/text.content,企业微信是 msgtype/text.content 但 URL 为 qyapi.weixin.qq.com/cgi-bin/webhook/send?key=,飞书则是 msg_type/content.text,字段名大小写和下划线不同,混用会直接返回 400 或 code:19001 参数错误。
SSL 证书到期提醒方案怎么选:5 种做法横向对比
证书到期提醒真正的难点不在于“能不能检测”,而在于“哪些场景检测不到”。据 Let’s Encrypt 官方文档,ACME 证书有效期固定 90 天,官方建议在剩余 30 天时开始续期;CA/Browser Forum 基线要求把公有证书单次有效期上限压到 398 天。这意味着提醒链路一旦断掉,留给人工补救的窗口可能只有几天。一份完整的 ssl证书 安装教程到期提醒方案,至少要同时覆盖“证书文件本身”和“线上实际下发的证书”两个对象。下面先把 5 种主流做法拉平对比。
| 方案 | 成本 | 检测精度 / 触发方式 | 适用规模 | 主要盲区 |
|---|---|---|---|---|
| A. 本地 cron/systemd + openssl | 0 元 | 天级(cron 最小粒度 1 分钟,通常按天跑) | 1–20 台自建服务器 | 只读本机文件;CDN/负载均衡后的证书需改远程探测;宿主机宕机时提醒同时消失 |
| B. certbot deploy-hook | 0 元 | 事件型(续期成功/失败时触发) | 纯 ACME 单机场景 | 不覆盖商业证书;发现不了“续期成功但 Nginx 没 reload” |
| C. Zabbix 6.4 web certificate 模板 | 自建服务器费用 | 分钟级 | 50 台以上且已有 Zabbix 的团队 | 需维护 Zabbix Server/Agent;模板项依赖 Agent 可达性 |
| D. Prometheus + blackbox_exporter 0.25 | 0 元(软件) | 默认 15s 采集 | K8s、多集群、多域名 | 需自维护 Prometheus + Alertmanager 栈 |
| E. 商业监控 / 云厂商证书托管 | UptimeRobot 免费版 5 个监控,付费约 7 美元/月起;云证书服务按证书数量计费 | 分钟级,自带短信/电话 | 对外多域名、多 CDN 业务 | 内网自签证书覆盖不到;价格随监控点数量线性上升 |
方案 A 的最小可用脚本。核心是把 openssl x509 -enddate 的 UTC 时间转成时间戳再算差,注意 date -d 是 GNU coreutils 的写法(Debian/Ubuntu/CentOS 7+ 可用,macOS 需 gdate):
#!/usr/bin/env bash
# /usr/local/bin/check_cert.sh —— 检查本机 PEM 证书剩余天数
set -euo pipefail
CERT=/etc/nginx/ssl/example.com.pem
END=$(openssl x509 -in "$CERT" -noout -enddate | cut -d= -f2) # 形如 Apr 1 12:00:00 2026 GMT
DAYS=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
if [ "$DAYS" -lt 21 ]; then
echo "[WARN] $CERT 剩余 ${DAYS} 天" | mail -s "[证书告警] $(hostname)" ops@example.com
fi
# crontab -e:每天 09:00 执行
# 0 9 * * * /usr/local/bin/check_cert.sh
证书挂在 CDN 或 SLB 后面时,本机文件是旧的,必须改成远程探测。s_client 的 -servername 不可省略,否则 SNI 多域名站点会拿到默认证书:
echo | openssl s_client -servername example.com -connect example.com:443 2>/dev/null
| openssl x509 -noout -subject -enddate
# 输出示例:subject=CN = example.com
# notAfter=Apr 1 12:00:00 2026 GMT
方案 B 只能当补充。把 reload 动作写成 deploy-hook,certbot 只在证书真正更新时执行它(certbot 2.3.0 起 renew_hook 与 --deploy-hook 等价,3.x 推荐后者):
# /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh (chmod +x)
#!/usr/bin/env bash
set -euo pipefail
nginx -t && systemctl reload nginx # 配置校验通过才 reload,失败会返回非 0 并写进 certbot 日志
# 失败告警靠 cron 的 MAILTO,或改用 --deploy-hook 推送到钉钉/Slack webhook
方案 C 适合已有值班体系的团队。Zabbix 6.4 内置的 “Website certificate by Zabbix agent 2” 模板通过 web.certificate.get 采集证书信息,再预处理出剩余秒数(社区模板里常命名为 ssl_certificate_expiry)。触发器直接比秒数最省事,2592000 = 30 天:
{HOST.MAX(ssl_certificate_expiry)}<2592000 # 剩余不足 30 天告警
{HOST.MAX(ssl_certificate_expiry)}<604800 # 剩余不足 7 天升级为严重
方案 D 是云原生默认解。blackbox_exporter 0.25.0 的 probe_ssl_earliest_cert_expiry 返回的是 Unix 时间戳(gauge 类型),所以告警必须减 time() 再除 86400,直接和天数比较是新手最常见的错误:
- alert: SSLCertExpiringSoon
expr: (probe_ssl_earliest_cert_expiry - time()) / 86400 < 21
for: 1h
labels:
severity: warning
annotations:
summary: "{{ $labels.instance }} 证书剩余 {{ $value | printf "%.1f" }} 天"
方案 E 解决“看不见的地方”。UptimeRobot 免费版提供 5 个监控、付费约 7 美元/月起,云厂商证书服务按证书数量计费并自带到期短信。它最大的价值不是精度,而是外部视角——服务器整机失联时,只有第三方还能替你叫醒人。
- SSL证书安装服务 · 腾讯云 HTTPS 部署 · 证书过期更新
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
- 服务器维护 · 网站代维护 · 服务器托管代维
怎么选:单机小站用 A+B 组合(B 保证续期后一定 reload,A 兜住“续期根本没跑”的情况)即可;已有 Zabbix 或 Prometheus 的团队直接上 C 或 D,把证书到期并入现有值班通道,别再单独维护一套告警;对外多域名、多 CDN 的业务再叠加 E 做外部兜底。任何单一方案都不建议单独使用——因为每种方案的失效模式,恰好都被另一种覆盖。
SSL 证书安装教程与到期提醒的 6 类真实报错及排查
这 6 类报错里,只有第 1、2 类真的是证书本身有问题,其余多半是时间、端口、配额或监控对象选错。按下面的顺序逐条对号入座,能省掉大部分反复重签的折腾。
1. nginx: [emerg] SSL_CTX_use_PrivateKey_file(“/etc/nginx/ssl/privkey.pem”) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
这是证书与私钥不配对,常见于“重签后只换了 cert 没换 key”。OpenSSL 文档给出的做法是比对模数指纹,RSA 证书如下:
# RSA:两串 MD5 必须完全一致,否则就是配错文件
openssl x509 -noout -modulus -in /etc/nginx/ssl/fullchain.pem | openssl md5
openssl rsa -noout -modulus -in /etc/nginx/ssl/privkey.pem | openssl md5
# ECDSA(Let's Encrypt 默认签发 ECDSA 时)改用公钥比对
openssl x509 -in fullchain.pem -noout -pubkey | openssl md5
openssl pkey -in privkey.pem -pubout | openssl md5
2. curl: (60) SSL certificate problem: unable to get local issuer certificate
这是 fullchain 里缺少中间证书,或者顺序颠倒。据 RFC 5280,服务端必须下发“叶子证书 + 中间证书”构成的链,根证书由客户端自带:
# 正常应返回 2(叶子 + 中间);只有 1 张说明 ca_bundle 没拼进去
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null | grep -c "BEGIN CERTIFICATE"
# 修复:叶子在前、中间在后,顺序反了浏览器同样报错
cat cert.pem chain.pem > fullchain.pem
3. 浏览器 NET::ERR_CERT_DATE_INVALID
证书确实过期,或服务器时间偏差超过 5 分钟(Mozilla 服务器端 TLS 指南建议启用 NTP)。时间回拨会让未过期证书被判无效:
date -u # 与真实 UTC 时间比对
chronyc tracking # 看 System time 偏移;无 chrony 用 timedatectl
openssl x509 -in fullchain.pem -noout -dates # 核对 notBefore / notAfter
4. problem binding to port 80: Could not bind to IPv4 or IPv6
certbot 的 standalone 模式需要独占 80 端口,被 Nginx/CDN 占用即失败。按场景选验证方式:
| 验证方式 | 适用场景 | 关键命令参数 | 端口要求 |
|---|---|---|---|
| standalone | 无 Web 服务 | --standalone |
独占 80/443 |
| webroot | 已有 Nginx/Apache | --webroot -w /var/www/html |
复用 80 |
| nginx 插件 | Nginx 自动改写配置 | --nginx |
复用 80 |
| DNS-01 | 前置 CDN / 泛域名 | --preferred-challenges dns |
无需 80 |
# 前置 CDN 时,确认回源放行校验路径
curl -I http://example.com/.well-known/acme-challenge/test # 期望 200/404,而非 403/502
5. too many certificates already issued for exact set of domains
这是触发了 Let’s Encrypt 速率限制。据 Let’s Encrypt 官方文档,同一注册域名每周上限 50 张,完全相同的域名集合每周仅 5 张。调试阶段必须加参数,正式环境不要在一天内反复重签:
# 只走 staging,不消耗正式配额
certbot certonly --nginx -d example.com -d www.example.com --staging
# 或先空跑一遍看流程是否通
certbot renew --dry-run
6. 到期提醒配了却不响
脚本读的是本地 /etc/nginx/ssl/fullchain.pem,而线上走的是 CDN 边缘证书,两者签发时间与到期日完全不同。用远程与本地各取一次日期比对,差异超过 1 天即说明监控对象选错了:
# 线上真实生效的证书
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -enddate
# 本地文件里的证书
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -enddate
这套排查逻辑同样适用于 certbot 之外的 acme.sh、Caddy 等工具:证书链、私钥配对、系统时间这三项与客户端无关,是 SSL 证书安装教程里最值得先固定下来的检查项;而到期提醒的准确性,取决于你监控的到底是“文件”还是“线上握手实际返回的那张证书”。
证书装完、Nginx reload 也返回了 ok,并不代表这条链在客户端眼里是可信的,更不代表三个月后那条到期提醒真的会响。下面 5 种验证方式按”从证书本身到告警链路”的顺序排列,建议每次部署后全跑一遍,整套 SSL 证书安装教程到期提醒流程才算真正闭环。
方法一:验证证书链完整性(最容易翻车的一步)。据 OpenSSL 官方 verify(1) 手册,s_client 的 Verify return code 由 RFC 5280 定义的链验证结果决定,只有 0 才代表客户端能凭本地根库走到受信根:
# -servername 必加:SNI 站点不加会拿到默认虚拟主机的证书
# -CAfile 指定本地根证书库,模拟真实客户端而非"信任一切"
openssl s_client -connect example.com:443 -servername example.com
-CAfile /etc/ssl/certs/ca-certificates.crt /dev/null
| grep "Verify return code"
# 期望输出:Verify return code: 0 (ok)
| 返回码 | 含义 | 典型原因 |
|---|---|---|
| 0 (ok) | 链完整可信 | — |
| 20 | unable to get local issuer certificate | 漏配中间证书,Nginx 只配了 cert.pem 而没配 fullchain.pem |
| 21 | unable to verify the first certificate | 自签证书或链被截断 |
| 10 | certificate has expired | 证书确实过期,或系统时间漂移 |
| 62 | hostname mismatch | 证书 SAN 不含该域名 |
方法二:浏览器侧表现与第三方评级。先用 curl 走一遍真实握手,输出里应同时出现 SSL certificate verify ok 和与台账一致的到期日:
curl -sSvo /dev/null https://example.com 2>&1
| grep -E "SSL certificate verify|expire date"
# 期望:SSL certificate verify ok.
# expire date: Oct 12 03:14:07 2025 GMT
再上 Qualys SSL Labs(ssllabs.com/ssltest)跑一次完整测试:目标评级 A 及以上,且 Chain issues 一栏必须显示 None;若显示 “Incomplete”,与方法一的返回码 20 是同一个病因。
方法三:验证自动续期真的会跑。certbot 官方文档明确 --dry-run 会走 staging 环境模拟一次完整续期而不消耗生产环境速率限制:
certbot renew --dry-run
# 期望结尾:Congratulations, all simulated renewals succeeded
# 确认定时器已激活,Next 不能是 n/a
systemctl list-timers | grep certbot
# NEXT LEFT UNIT ACTIVATES
# Mon 2025-01-13 03:22:00 CST 11h certbot.timer certbot.service
方法四:把到期提醒的阈值临时拉爆,实测告警链路。纯靠等 30 天无法验证脚本,正确做法是改阈值触发:
# 临时把阈值 30 改成 400 天,强制命中告警分支(测完务必改回 30)
sed -i 's/^THRESHOLD=30/THRESHOLD=400/' /usr/local/bin/cert-expiry.sh
/usr/local/bin/cert-expiry.sh # 手动跑一次,5 分钟内应收到钉钉/邮件
# 再以 systemd 方式跑一次,检查脚本本身有无 openssl 报错
systemctl start cert-expiry.service
journalctl -u cert-expiry -n 50 --no-pager
# 关注有无 "unable to load certificate" / "No such file or directory"
sed -i 's/^THRESHOLD=400/THRESHOLD=30/' /usr/local/bin/cert-expiry.sh # 还原
方法五:监控侧指标交叉验证。Prometheus 的 blackbox_exporter 会把证书到期时间暴露为 probe_ssl_earliest_cert_expiry(Unix 秒),用它减去当前时间即为剩余秒数:
# PromQL:结果为正数说明未过期,/86400 得剩余天数
probe_ssl_earliest_cert_expiry{instance="example.com"} - time()
# 与 openssl 结果应相差不超过 1 天(时区与采集延迟所致)
openssl x509 -in /etc/letsencrypt/live/example.com/cert.pem -noout -enddate
Zabbix 用户则看最新数据中 ssl_certificate_expiry 的 lastclock 是否在刷新周期内,停更说明 item 已失效。
| 验证项 | 命令 / 工具 | 通过标准 | 失败信号 |
|---|---|---|---|
| 证书链 | openssl s_client | return code 0 | 20 / 21 |
| 浏览器侧 | curl + SSL Labs | verify ok、A 级、Chain None | 评级 B、Chain Incomplete |
| 自动续期 | certbot renew –dry-run | all simulated renewals succeeded | Next 显示 n/a |
| 到期提醒 | 阈值改 400 手动触发 | 5 分钟内收到告警 | 无消息、journal 有 openssl 报错 |
| 监控指标 | Prometheus / Zabbix | 剩余天数为正且与本地误差 ≤1 天 | 指标缺失或长期不刷新 |
最后一步:三方台账对齐。把监控显示的到期日、CA 后台显示的到期日、本地证书 notAfter 三者拉到同一天。只要有一处不一致,就说明磁盘上存在多张同名证书并存(常见于手动上传的旧文件与 certbot 生成的 live/ 目录混用),必须清理旧文件,否则下一次续期后 Nginx 仍可能加载到旧证书——这也是 SSL 证书安装教程到期提醒环节里最隐蔽的故障源。
把 SSL 证书安装教程沉淀为 SOP:台账、分级提醒与交接
证书装完就完事了吗?恰恰相反——线上证书事故里,绝大多数不是签发失败,而是”没人记得它快过期了”。把 ssl证书安装教程 沉淀成可交接的 SOP,关键不在技术,而在于台账、分级提醒和交接清单这三样”人肉基础设施”。据 Let’s Encrypt 文档,其证书有效期为 90 天,官方推荐用 certbot 自动续期,但自动续期失败(DNS 变更、webroot 权限、ACME 账号失效)恰恰是最常见的静默故障,所以人工兜底的提醒链路必须存在。
台账固定 9 列,存 Git 或 CMDB,禁止只躺在某人的本地 Excel 里
# certs.csv —— 提交到 Git,每次变更走 PR,天然带审计
# 域名,SAN列表,签发CA,证书类型,签发日,到期日,部署节点与路径,续期方式,负责人
www.example.com,"www.example.com,example.com",Let's Encrypt,DV,2024-11-02,2025-01-31,"nginx-01:/etc/nginx/ssl/example.com",ACME自动,zhangsan
api.example.com,"api.example.com",DigiCert,OV,2024-06-15,2025-06-15,"lb-02:/etc/haproxy/certs/api.pem",手动, lisi
为什么强调 Git:git log -p certs.csv 能回答”谁在什么时候换了 CA”,而本地 Excel 一旦离职即失传。SAN 列必须写全,否则通配符证书与多域名证书的覆盖范围无法核对。
提醒分级写进值班制度,而不是靠日历提醒
| 剩余天数(90 天证书) | 动作 | 通知渠道 | 责任角色 |
|---|---|---|---|
| 30 天 | 进入周报待办 | 邮件 / IM 频道 | 当班运维 |
| 14 天 | 转为日报跟踪 | 邮件 + IM @负责人 | 证书负责人 |
| 7 天 | 升级告警 | 电话 / 短信 | 负责人 + 主管 |
| 到期当天 | 冻结发布窗口 | 全员公告 | 变更评审 |
这套阈值是按 90 天周期设计的;若 CA 有效期按 CA/Browser Forum 的缩短提案降到 100 天,阈值同步下调为 20/10/5 天,否则告警窗口会被压缩到没有处理余量。
交接必带四样东西,缺一项接手人就无法在 7 天内完成续期
/etc/letsencrypt/renewal/下的续期配置(含 authenticator、webroot 路径);- ACME 账号邮箱(
certbot show_account可查); - 私钥备份位置与解密方式(GPG 口令或 KMS 密钥 ID);
- 告警 webhook 的接收群 / 值班号。
# 交接前自检:能列出域名、验证方式、到期时间即合格
ls /etc/letsencrypt/renewal/
grep -E '^(authenticator|installer|server)' /etc/letsencrypt/renewal/example.com.conf
certbot certificates --cert-name example.com # 输出 Expiry Date 与 Key Path
每季度全量扫描:用台账域名批量取 notAfter,顺便揪出遗忘的子域和测试环境证书
#!/usr/bin/env bash
# quarterly-scan.sh:GNU date 环境;macOS 用 gdate 替换 date -d
scan() {
d="$1"
end=$(timeout 10 openssl s_client -servername "$d" -connect "$d:443" /dev/null
| openssl x509 -noout -enddate 2>/dev/null | cut -d= -f2)
[ -z "$end" ] && { echo "$d,UNREACHABLE,-1"; return; }
days=$(( ( $(date -d "$end" +%s) - $(date +%s) ) / 86400 ))
echo "$d,$end,$days"
}
export -f scan
xargs -a domains.txt -P 10 -I{} bash -c 'scan "$@"' _ {} # 并发 10,100 个域名约 1 分钟
扫描结果与监控系统的 probe_ssl_earliest_cert_expiry 比对,不一致的条目往往就是台账漏登的节点。
年度复盘只看两个数字:全年证书到期告警触发次数、因证书问题导致的线上故障次数(后者应为 0)。若一年内出现 2 次以上 7 天告警,说明续期自动化本身有缺陷,应优先排查 systemctl list-timers | grep certbot 与 renew hook,而不是加人盯盘。想进一步降低风险,可把到期指标接入 Prometheus 的 blackbox_exporter 与 certbot 的 --deploy-hook 做双通道校验。
建议按剩余 30 天、14 天、7 天三档设置。Let's Encrypt 证书有效期 90 天,30 天时启动人工核查、14 天转日报、7 天升级电话,留出至少两轮续期重试窗口;若使用 398 天的商业证书,可放宽到 60/30/7 天,但仍建议保留 7 天兜底。
常见原因有三个:certbot.timer 被 disable(用 systemctl status certbot.timer 确认)、HTTP-01 校验的 80 端口被安全组或 CDN 拦截、触发速率限制。先跑 certbot renew –dry-run 看具体报错,再检查 /var/log/letsencrypt/letsencrypt.log 中的 challenge 失败原因。
cron 脚本成本 0 元、部署 5 分钟,但只能读本机文件且服务器宕机时提醒一起失效;Zabbix 6.4 的 web certificate 模板和 Prometheus 的 probe_ssl_earliest_cert_expiry 是远程探测,能发现 CDN 边缘证书、负载均衡证书的到期,且天然接入值班告警。单机用脚本够,多节点建议上监控系统。
这是证书与私钥不配对。RSA 证书用 openssl x509 -noout -modulus -in fullchain.pem | openssl md5 与 openssl rsa -noout -modulus -in privkey.pem | openssl md5 对比,两串 MD5 必须相同;ECDSA 证书用 openssl pkey -pubout 分别导出公钥比对。不一致就重新签发或找回对应私钥,不要强行 reload。
泛域名证书只覆盖 *.example.com 一级,example.com 本身和 api.dev.example.com 这类二级子域不在范围内,SAN 列表要单独监控。另外泛域名通常用 DNS-01 校验,续期依赖 DNS API Token,Token 过期会导致续期失败但证书文件仍在,所以提醒脚本必须探测线上证书而不是本地文件。
私有 CA 没有厂商邮件通知,只能在证书签发流程里强制登记到期日。做法是用 openssl x509 -noout -enddate 把 notAfter 写入 CMDB,再用同一套 cron 或 Prometheus 探测内网地址;私有 CA 建议把有效期设为 365 天并配合 30 天提醒,避免内部服务大规模同时过期。
需要。CA 的邮件通常只发给证书申请时填写的邮箱,一旦该邮箱变更、离职或进入垃圾箱就会漏报;而且 CA 邮件只覆盖它签发的证书,覆盖不到你同时使用的免费证书、自签证书和 CDN 边缘证书。把 CA 邮件当作第二通道,自建监控作为主通道更稳妥。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。