跳到主要内容
安装配置教程

SSL 证书安装教程与到期提醒完整实操:CSR 签发、Nginx 部署、certbot 续期与告警配置

ssl证书 安装教程到期提醒 — 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,用户投诉比告警邮件先到。问题从来不出在“装”,而出在“装完之后没有任何东西在盯着它”。

典型事故链是这样的:

  1. Let’s Encrypt 签发的证书有效期只有 90 天(据 Let’s Encrypt 官方文档 Renewing certificates 章节,官方建议在剩余 30 天时续期);
  2. certbot 靠 systemd timer 触发续期,Debian/Ubuntu 的软件包默认安装并启用 certbot.timer,每天触发两次并带随机延迟;
  3. 某次安全加固执行了 systemctl disable --now certbot.timer,或 80 端口被 WAF / 安全组拦截,HTTP-01 校验失败;
  4. 续期静默失败——certbot renew 的失败信息只写进 journal,没人看;
  5. 第 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 美元/月起,云厂商证书服务按证书数量计费并自带到期短信。它最大的价值不是精度,而是外部视角——服务器整机失联时,只有第三方还能替你叫醒人。

怎么选:单机小站用 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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。