nginx ssl证书安装怎么做?从证书文件到零中断 reload 的 8 步实操清单
nginx ssl证书安装的核心是三件事:把 fullchain.pem(域名证书+中间证书)和私钥放到固定目录、在 443 的 server 块里写 ssl_certificate 与 ssl_certificate_key、执行 nginx -t 通过后 systemctl reload nginx,全程不需要重启服务器。 证书与私钥不匹配时 nginx 会直接启动失败并报 key values mismatch,用 openssl x509 -noout -modulus 与 openssl rsa -noout -modulus 各取一次 md5 比对即可在 10 秒内确认。 reload 是平滑的:master 进程解析新配置、拉起新 worker、旧 worker 处理完存量连接后退出,单机万级并发下通常无感知;restart 才会中断连接。 验证是否真的生效不要只看浏览器,用 openssl s_client -connect 127.0.0.1:443 -servername example.com /dev/null | openssl x509 -noout -dates -fingerprint -sha256,再与本地 fullchain.pem 的指纹逐位比对。 Let's Encrypt 证书 90 天有效,certbot 2.x 由 systemd timer 每日两次触发 renew,续期后必须 reload nginx 才会加载新证书,建议用 --deploy-hook "systemctl reload nginx" 固化这一步。
nginx ssl证书安装为什么“文件放了却不生效”?6 个根本原因
最常见的原因是 nginx 的加载机制:它只在启动和 reload 时解析证书文件,运行期不会重读。你把新证书覆盖到 /etc/nginx/ssl/ 后不执行 reload,线上仍是内存里的旧证书。判断方法是对本机发起一次带 SNI 的连接,观察 notAfter 是否变化:
# 覆盖证书后先做语法与证书校验,通过再平滑 reload(旧 worker 处理完存量连接才退出)
cp fullchain.pem /etc/nginx/ssl/example.com.pem
nginx -t && systemctl reload nginx # 等价于 nginx -s reload / kill -HUP <master pid>
# 看服务端实际下发的证书主体与有效期,notAfter 变了才说明生效
openssl s_client -connect 127.0.0.1:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -dates
其余 5 类原因可按“先网络、后证书、再配置”的顺序定位:
- 证书与私钥不匹配:nginx 会直接启动失败,报
SSL_CTX_use_PrivateKey("/etc/nginx/ssl/a.key") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。RSA 证书用模数比对,两个 md5 一致才算配对;ECC 私钥没有 modulus,改用公钥比对:openssl x509 -in fullchain.pem -noout -modulus | openssl md5 openssl rsa -in privkey.pem -noout -modulus | openssl md5 # ECDSA 证书/私钥用公钥指纹比对 openssl x509 -in cert.pem -noout -pubkey | openssl md5 openssl pkey -in privkey.pem -pubout | openssl md5 - 证书链缺失:只配域名证书、漏掉中间证书时 nginx 不报任何错,但客户端
curl返回(60) SSL certificate problem: unable to get local issuer certificate。据 Let’s Encrypt 文档,certbot 生成的fullchain.pem已包含中间证书,ssl_certificate应指向它而不是cert.pem。 - 路径与权限:私钥设为
600且属主 root 时,若 nginx 以非 root 用户启动(容器镜像、自定义编译场景),报cannot load certificate ... Permission denied。RHEL/CentOS 在 SELinux enforcing 下还要求文件带cert_t上下文,用ls -Z /etc/nginx/ssl/核对,不符时执行restorecon -Rv /etc/nginx/ssl/。 - 监听与网络层:
ss -lntp | grep ':443'无输出说明 nginx 根本没监听 443,与证书无关;云安全组未放行 443 表现为连接超时而非证书告警,先用telnet 你的域名 443排除。 - SNI 与 default_server:同一 IP 承载多域名时,请求未命中任何
server_name就落到default_server,浏览器报NET::ERR_CERT_COMMON_NAME_INVALID。每个 443 的 server 块都要显式写server_name,并单独指定一个兜底块(listen 443 ssl default_server;需要 nginx 支持 SNI,主流版本均满足)。
| 现象 | 最可能原因 | 一条确认命令 |
|---|---|---|
| notAfter 仍是旧日期 | 未 reload | openssl s_client ... | openssl x509 -noout -dates |
| nginx -t 直接失败 | 私钥不匹配 | openssl x509 -noout -modulus | openssl md5 |
| 浏览器正常、curl 报 60 | 缺中间证书 | openssl s_client -showcerts |
| 连接超时 | 安全组/防火墙 | telnet 域名 443 |
| 证书名不符 | SNI/default_server | curl -I https://域名 |
nginx ssl证书安装的 8 个步骤:从拿到证书到线上生效
证书放哪个目录、权限怎么设才不会踩坑?先把目录收窄到 root 专属,再按”链可读、私钥不可读”落权限。nginx master 进程以 root 启动、在 fork worker 前完成私钥加载,因此 privkey.pem 设 600 完全够用(nginx 官方文档的 ssl_certificate_key 说明中即要求该文件仅对 master 可读)。
# 目录仅 root 可进入,防止同机低权限进程遍历到私钥
sudo mkdir -p /etc/nginx/ssl/example.com
sudo chmod 700 /etc/nginx/ssl/example.com
sudo chown root:root /etc/nginx/ssl/example.com
# 用 install 一步到位设定权限与属主,避免 chmod 前的窗口期
sudo install -m 644 -o root -g root fullchain.pem /etc/nginx/ssl/example.com/fullchain.pem
sudo install -m 600 -o root -g root privkey.pem /etc/nginx/ssl/example.com/privkey.pem
# 记录指纹,日后回滚或排查"到底加载了哪份证书"时用来比对
sudo sha256sum /etc/nginx/ssl/example.com/fullchain.pem /etc/nginx/ssl/example.com/privkey.pem
| sudo tee /etc/nginx/ssl/example.com/SHA256SUMS
怎么确认证书本身没毛病?看 SAN 是否同时覆盖裸域和 www、看 notAfter 是否还剩 30 天以上。Let’s Encrypt 证书有效期 90 天、官方建议在剩余 30 天时续期,所以不足 30 天基本等于”你拿的是旧文件”。
openssl x509 -in /etc/nginx/ssl/example.com/fullchain.pem -noout
-subject -issuer -dates -ext subjectAltName
# subject=CN = example.com
# issuer=C = US, O = Let's Encrypt, CN = R11
# notAfter=Aug 30 23:59:59 2025 GMT
# X509v3 Subject Alternative Name:
# DNS:example.com, DNS:www.example.com
# 链里至少要有 2 张证书(叶证书 + 中间证书)
grep -c 'BEGIN CERTIFICATE' /etc/nginx/ssl/example.com/fullchain.pem
# 只拿到 cert.pem + chain.pem 时合并,顺序不能颠倒:
# RFC 8446 §4.4.2 规定发送方证书必须排在最前,叶证书在前、中间证书在后
cat cert.pem chain.pem > fullchain.pem
443 server 块里 http2 到底怎么写?这是 nginx 1.25.1 的分水岭:老写法在新版本会触发弃用警告,新写法在老版本直接报 unknown directive "http2"。
| nginx 版本 | 推荐写法 | 错误写法及真实报错 |
|---|---|---|
| < 1.25.1 | listen 443 ssl http2; |
写 http2 on; → nginx: [emerg] unknown directive "http2" |
| ≥ 1.25.1 | listen 443 ssl; + 独立 http2 on; |
仍写 listen 里的 http2 → nginx: [warn] the "listen ... http2" directive is deprecated, use the "http2" directive instead |
server {
listen 80;
listen [::]:80;
server_name example.com www.example.com;
return 301 https://$host$request_uri; # 80 端口只做跳转,不再承载内容
}
server {
listen 443 ssl;
listen [::]:443 ssl;
http2 on; # nginx ≥ 1.25.1;更早版本删掉此行
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; # 默认值仅 TLSv1/1.1/1.2,TLSv1.3 需显式写出
ssl_session_cache shared:SSL:10m; # 默认 none;10m 约缓存 4 万个会话
ssl_session_timeout 1d;
# 其余套件参数可直接照抄 Mozilla SSL Configuration Generator 的 intermediate 档
}
配置改完,先校验再动手。nginx -t 必须同时出现两行才算干净;只有第一行说明存在警告,单独过滤出来看:
sudo nginx -t
# nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
# nginx: configuration file /etc/nginx/nginx.conf test is successful
sudo nginx -t 2>&1 | grep -i warn # 只揪警告
为什么必须 reload 而不是 restart?systemctl reload nginx(等价 nginx -s reload)让 master 重新读配置、拉起新 worker、旧 worker 处理完手头请求后退出,理论上零中断;restart 会直接终止进程,正在传输的响应会被切断。注意 worker_shutdown_timeout 默认未设置,WebSocket 这类长连接会让旧 worker 长期驻留,建议在 http 块设 worker_shutdown_timeout 30s;。
sudo systemctl reload nginx
sudo tail -f /var/log/nginx/error.log # 观察 10 秒,确认无 emerg 级别输出
sudo systemctl status nginx --no-pager # 确认 active (running)
本机怎么确认 nginx 真的加载了新证书?用 s_client 打本地回环并带 SNI,比对指纹与本地文件是否一致:
openssl s_client -connect 127.0.0.1:443 -servername example.com -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -subject -dates -fingerprint -sha256
DNS 还没切过来,怎么验证真实链路?用 --resolve 绕过解析,直接打到目标 IP。ssl_verify_result 为 0 表示证书链完整且主机名匹配;非 0 时对照 OpenSSL 的 verify 返回码(如 20 = unable to get local issuer certificate,通常是漏装中间证书)。最后换手机 4G 复测一次,排除本机 CA 库或代理干扰。
curl -I --resolve example.com:443:203.0.113.10 https://example.com
-w '%{http_code} %{ssl_verify_result}n' -s -o /dev/null
# 200 0
上线后怎么留痕和盯到期?把变更时间、SHA256 指纹、签发机构写进变更单,并设 30/15/7 天三级提醒。监控脚本的取数命令就用 s_client 读 enddate,无需额外依赖:
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -enddate
# notAfter=Aug 30 23:59:59 2025 GMT
nginx ssl证书安装的配置与命令示例(nginx 1.24 / OpenSSL 3.0 实测)
把证书文件拷到服务器只是第一步,真正决定成败的是 server 块里那几个参数。最小可用的 443 配置如下(nginx 1.24.0 + OpenSSL 3.0.2 实测通过):
server {
listen 443 ssl; # 1.24 起推荐写法,等价于旧版 listen 443 + ssl on
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; # 权限务必 600
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 off; # TLS 1.3 下该指令无效,1.2 交给客户端选更快
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
root /var/www/example.com;
index index.html;
}
为什么不能吃默认值?nginx 1.24.0 的 ssl_ciphers 默认值是 HIGH:!aNULL:!MD5,这是 2010 年代的宽松白名单;而 ssl_protocols 的默认值随编译时链接的 OpenSSL 版本浮动——Ubuntu 22.04 官方源装出来的通常是 nginx 1.18.x + OpenSSL 3.0.x,跟你本地测试机的行为可能不一致。据 nginx 官方文档,只有显式写死才能保证多机一致。先确认实际版本:
nginx -V 2>&1 | tr ' ' 'n' | grep -E 'nginx version|built with OpenSSL'
# 典型输出:
# nginx/1.24.0
# built with OpenSSL 3.0.2 15 Mar 2022 (running with OpenSSL 3.0.2 15 Mar 2022)
| 参数 | nginx 1.24.0 默认值 | 建议值 | 原因 |
|---|---|---|---|
| ssl_protocols | 随链接的 OpenSSL 变化(TLSv1.2/1.3 或含 1.0/1.1) | TLSv1.2 TLSv1.3 | RFC 8996 已将 TLS 1.0/1.1 标记为废弃 |
| ssl_ciphers | HIGH:!aNULL:!MD5 | 4 个 ECDHE-AEAD 套件 | 去掉 CBC 与 RSA 密钥交换,兼顾前向保密与性能 |
| ssl_session_cache | none | shared:SSL:10m | 1MB ≈ 4000 条会话,10m 约 4 万条,单机 QPS 1000 以内够用 |
| ssl_session_tickets | on | off(可选) | 关闭后 ticket 密钥泄露无法回溯解密历史流量,代价是握手率略升 |
OCSP stapling 为什么总是报错?三件套缺一不可:
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/example.com/chain.pem; # 注意:签发者链,不是 fullchain
resolver 223.5.5.5 119.29.29.29 valid=300s; # 必须配,nginx 要自己拉 OCSP 响应
resolver_timeout 5s;
如果漏掉 ssl_trusted_certificate 或误填 fullchain,nginx -t 会抛 ssl_stapling ignored, issuer certificate not found——这不是语法错误,reload 仍会成功,但 stapling 静默失效,只有查 error_log 才发现。
HSTS 要最后加。它把”只用 HTTPS”写进浏览器,撤回周期以月计,preload 列表更甚。首次上线先跑短周期:
add_header Strict-Transport-Security "max-age=300" always; # 观察一周,确认所有子域已支持 HTTPS
# 稳定后改为:max-age=31536000; includeSubDomains
上线前用三条命令核对,比翻配置文件可靠:
openssl x509 -in /etc/nginx/ssl/example.com/fullchain.pem -noout -dates -fingerprint -sha256
nginx -T | grep -E 'ssl_certificate|ssl_protocols' # 输出合并后的最终配置,含 include 进来的片段
ss -lntp | grep ':443' # 确认监听 0.0.0.0 或 ::,而非仅 127.0.0.1
证书本身可用 Mozilla SSL Configuration Generator 交叉验证套件列表,签发链完整性可对照 Let’s Encrypt 文档中的 fullchain.pem 定义。这一节的配置就是后续零中断 reload 的基线——只要 nginx -t 能过,nginx -s reload 就是平滑的;过不了,旧 worker 会继续服务,用户无感但你的新证书也没生效。
nginx ssl证书安装方式怎么选?手工、certbot、acme.sh 与云托管对比
先回答一个最常被问到的问题:nginx ssl证书安装到底该用哪种方式?判断标准只有一条——你的 nginx 配置文件是不是由 Git / Ansible / Helm 这类工具渲染出来的。如果是,任何会”自动改写 server 块”的工具都会在下次部署时被覆盖,续期后 reload 的其实是旧配置;如果不是,让工具帮你改反而最省事。据 Let’s Encrypt 官方文档,DV 证书有效期为 90 天,所有方式的差别最终都落在”谁来续、续完谁 reload”这两件事上。
| 方式 | 典型命令 | 是否自动改 nginx 配置 | 续期机制 | 适合场景 |
|---|---|---|---|---|
| 手工安装 | 自行编辑 server 块 | 否 | 自己写 reload hook | 已有证书、配置纳入 Git/Ansible 管理 |
| certbot –nginx | certbot --nginx -d example.com |
是,自动插入 ssl_certificate 行 | systemd timer,每日两次 | 单机标准 443 站点,最快上线 |
| certbot certonly –webroot | certbot certonly --webroot -w /var/www/html -d example.com |
否 | 同上 | 配置由配置管理工具生成 |
| acme.sh –nginx | acme.sh --issue --nginx -d example.com |
可选(–install-cert 时) | cron 每日 0 点 | 需要 DNS-01 签发泛域名 |
| 云厂商证书托管 | 控制台申请后下载 pem | 否 | 平台侧提醒,部署仍需人工 | 已有负载均衡、CDN 或证书统一管理 |
三种自动化工具的完整命令如下,注意 certbot 2.x 起 --nginx 需要单独安装 python3-certbot-nginx 插件,否则会报 The requested nginx plugin does not appear to be installed:
# 方式 A:certbot --nginx,自动改写 server 块(适合单机、配置不进 Git)
sudo apt install certbot python3-certbot-nginx # Debian/Ubuntu;RHEL 系用 dnf install certbot python3-certbot-nginx
sudo certbot --nginx -d example.com -d www.example.com
--redirect # 自动加 301 跳转
--keep-until-expiring # 已有有效证书时不重复签发
# 续期由 certbot-renew.timer 触发,默认每日两次(systemd 列表可用 systemctl list-timers | grep certbot 查看)
sudo certbot renew --dry-run # 演练,确认 hook 能跑通
# 方式 B:certbot certonly --webroot,只签发不改配置(配置由 Ansible/Helm 渲染时选它)
sudo certbot certonly --webroot -w /var/www/html -d example.com
--deploy-hook "nginx -t && systemctl reload nginx" # 续期成功后自动校验并平滑 reload
# 证书落在 /etc/letsencrypt/live/example.com/,用 fullchain.pem + privkey.pem
# 方式 C:acme.sh,默认 CA 自 3.0.0 起为 ZeroSSL,需要 LE 时显式指定
curl https://get.acme.sh | sh -s email=ops@example.com
~/.acme.sh/acme.sh --set-default-ca --server letsencrypt # 切回 Let's Encrypt
~/.acme.sh/acme.sh --issue --nginx -d example.com -d '*.example.com'
--server letsencrypt --keylength ec-256 # 泛域名走 DNS-01,需先配 DNS API
~/.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.pem
--reloadcmd "nginx -t && systemctl reload nginx"
# 安装时会写入 cron:0 0 * * *(每日 0 点检查,剩余 60 天时续期;certbot 默认剩余 30 天续期)
成本区间参考(2024—2025 年市场价):Let’s Encrypt DV 免费、90 天有效;商业 DV 单域名约 100—500 元/年;OV 单域名约 800—3000 元/年,需提交组织资料、签发 1—3 个工作日;商业通配符 DV 约 500—1500 元/年。价格随渠道波动,仅作预算参考。
文件格式统一用 PEM 最省心。据 nginx 官方文档,ssl_certificate 只接受 PEM 文本格式;若拿到的商业证书是 .pfx/.p12,需拆开再拼 fullchain(OpenSSL 1.1.1 / 3.x 命令一致):
# 从 PFX 中导出证书与私钥,并合并中间证书为 fullchain
openssl pkcs12 -in cert.pfx -clcerts -nokeys -out cert.pem # 站点证书
openssl pkcs12 -in cert.pfx -nocerts -nodes -out key.pem # 未加密私钥,注意 chmod 600
cat cert.pem intermediate.crt > fullchain.pem # 顺序:站点证书在前,中间证书在后
openssl verify -CAfile root.crt fullchain.pem # 验证链完整,失败多为缺中间证书
多域名怎么办?一张 SAN/UCC 证书可写几十个域名,但任一域名变更都要重签整张证书;域名超过 5 个且分属不同业务线时,通常按业务拆成多张证书配合 SNI,故障影响面更小,reload 时也更可控——这也是后续做”零中断 reload”的前提。
nginx ssl证书安装后常见的 6 类真实报错与排查
完成 nginx ssl证书安装 后,nginx -t 通过并不等于浏览器握手成功:文件、配对、链、OCSP、SNI、协议是 6 个独立故障面。先按表定位,再执行命令。适用 nginx 1.20+ / OpenSSL 1.1.1+;ssl_stapling 默认 off,ssl_protocols 在 nginx 1.23.4 起默认 TLSv1.2 TLSv1.3,更早版本默认含 TLSv1/1.1。
| 报错/现象 | 根因 | 一条定位命令 | 修复 |
|---|---|---|---|
nginx: [emerg] cannot load certificate "/etc/nginx/ssl/a/fullchain.pem": BIO_new_file() failed (SSL: error:80000002:system library::No such file or directory) |
路径写错或文件没同步 | namei -l /etc/nginx/ssl/a/fullchain.pem |
逐级确认目录存在;注意 nginx -t 常以 root 执行,权限问题会被掩盖,变量加载时 worker 账户也要可读 |
nginx: [emerg] SSL_CTX_use_PrivateKey("/etc/nginx/ssl/a/privkey.pem") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) |
证书与私钥不是一对,常见于续期只换 fullchain 没换 privkey | RSA 比对 modulus md5 |
同一批 fullchain.pem + privkey.pem 一起替换 |
curl: (60) SSL certificate problem: unable to get local issuer certificate |
链不完整 | s_client -showcerts ... | grep -c 'BEGIN CERTIFICATE' |
ssl_certificate 指向 fullchain.pem;据 Let’s Encrypt 文档,fullchain 含叶子+中间证书,不应带根证书 |
nginx: [warn] "ssl_stapling" ignored, issuer certificate not found |
ssl_trusted_certificate 指错或缺中间证书 |
openssl ocsp -issuer chain.pem -cert cert.pem -url ... -resp_text |
改为仅含中间证书的 chain.pem,并配置可用 resolver |
浏览器 NET::ERR_CERT_COMMON_NAME_INVALID,但 s_client 正常 |
SNI 未命中,请求落到 default_server |
nginx -T | grep -nE 'listen 443|server_name' |
建独立 server 块,server_name 写全含 www;CDN/负载均衡回源要透传 SNI |
sslv3 alert handshake failure 或 no protocols available |
客户端只支持 TLS 1.0/1.1,服务端已收紧 | s_client -tls1_1 |
参考 Mozilla 现代配置淘汰老客户端;RFC 8996 已弃用 TLS 1.0/1.1,不建议回退 |
为什么 nginx -t 以 root 通过,worker 仍可能读不到证书? 因为配置检查常以 root 执行,目录执行位与运行账户权限被掩盖;若用变量动态加载证书,worker 必须可读。用 namei -l 逐级看权限,别只看文件。
# 适用 nginx 1.20+ / OpenSSL 1.1.1+;Debian/Ubuntu 运行账户常为 www-data
sudo nginx -t
sudo -u nginx test -r /etc/nginx/ssl/a/fullchain.pem && echo OK || echo FAIL
sudo namei -l /etc/nginx/ssl/a/fullchain.pem
# 1) RSA 证书与私钥配对:两条 md5 必须一致
openssl x509 -noout -modulus -in /etc/nginx/ssl/a/fullchain.pem | openssl md5
openssl rsa -noout -modulus -in /etc/nginx/ssl/a/privkey.pem | openssl md5
# ECDSA 证书改用公钥指纹比对
openssl x509 -pubkey -noout -in /etc/nginx/ssl/a/fullchain.pem | openssl pkey -pubin -outform der | openssl dgst -sha256
openssl pkey -pubout -in /etc/nginx/ssl/a/privkey.pem -outform der | openssl dgst -sha256
# 2) 链完整性:正常应返回 2 或 3;若为 1,说明只发了叶子证书
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'
# 3) OCSP 单测:chain.pem 只放中间证书
openssl ocsp -issuer /etc/nginx/ssl/a/chain.pem -cert /etc/nginx/ssl/a/cert.pem
-url "$(openssl x509 -in /etc/nginx/ssl/a/cert.pem -noout -ocsp_uri)" -resp_text
# 4) SNI、旧协议与直连源站复现
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -ext subjectAltName
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null
curl -I --resolve example.com:443:203.0.113.10 https://example.com # 绕过 DNS/CDN 直连源站
OCSP stapling 报错时 nginx 配置怎么写? 关键是 ssl_trusted_certificate 指向中间证书链,并配置 resolver;据 nginx 文档,ssl_stapling 与 ssl_stapling_verify 默认均为 off,ssl_trusted_certificate 无默认值。
# /etc/nginx/conf.d/example.com.conf;nginx 1.20+
ssl_certificate /etc/nginx/ssl/a/fullchain.pem; # 叶子+中间证书
ssl_certificate_key /etc/nginx/ssl/a/privkey.pem;
ssl_trusted_certificate /etc/nginx/ssl/a/chain.pem; # 只放中间证书,供 OCSP 验证
ssl_stapling on;
ssl_stapling_verify on;
resolver 1.1.1.1 223.5.5.5 valid=300s; # 无 resolver 时 stapling 不生效
resolver_timeout 5s;
ssl_protocols TLSv1.2 TLSv1.3; # nginx 1.23.4 起默认;更早版本需显式写
# 若 CA 已不提供 OCSP(如 Let's Encrypt 转向 CRL),可关闭 stapling
这类 nginx ssl证书安装 故障修复后,先 nginx -t 再 nginx -s reload;前者失败时 reload 不会生效,零中断的前提是配置检查通过。
怎么确认 nginx ssl证书安装真的生效?5 种验证方法
上一节的 8 步执行完,nginx -s reload 也返回了 0,但这只说明 nginx 收到了信号,不代表客户端拿到的是新证书——尤其是当同一台机器上跑着多个 server 块、证书路径经过 include 拼接、或者站点前面还挂着 CDN 时。所以 nginx ssl证书安装 的最后一步不是 reload,而是验证。下面 5 个层级从便宜到贵排列,逐层收紧,出问题时能直接定位到”文件错、进程没换、还是链不全”。
# 1) 配置层:语法 + 最终生效配置(nginx -T 会展开 include,自 1.9.2 起可用)
nginx -t # 期望:syntax is ok / test is successful
nginx -T | grep -A2 'server_name example.com' # 确认 ssl_certificate 指向 fullchain.pem
# 2) 进程层:reload 是否真的发生了
systemctl status nginx --no-pager | head -3
systemctl show nginx -p ActiveEnterTimestamp # 应晚于你执行 reload 的时刻
ss -lntp | grep ':443' # 应看到 nginx: master 与 worker
# 3) 证书层:nginx 实际吐出的证书 vs 磁盘文件,逐位比对 SHA-256
openssl s_client -connect 127.0.0.1:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -dates -fingerprint -sha256
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -fingerprint -sha256
# 4) 链路层:用真实域名 + 指定 IP,绕开本地 hosts,看状态码与链校验结果
curl -I --resolve example.com:443:203.0.113.10 https://example.com
-w '%{http_code} %{ssl_verify_result}n' -o /dev/null -s # 期望输出:200 0
# 5) 协议与头部层:HSTS 是否下发、协议版本是否按预期收紧
curl -sI https://example.com | grep -i strict-transport-security
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null >/dev/null 2>&1
&& echo "TLS1.3 OK"
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null >/dev/null 2>&1
|| echo "TLS1.1 已禁用"
配置层要特别注意:nginx -t 不只是查语法,它真的会去打开证书文件,路径写错会直接抛 nginx: [emerg] cannot load certificate "/etc/nginx/ssl/fullchain.pem": BIO_new_file() failed (SSL: error:80000002:system library::No such file or directory)。而 nginx -T 打印的是合并 include 之后的最终配置,比逐个 cat 站点文件可靠得多——很多”改了没生效”其实是改的 sites-available,而 sites-enabled 里没有软链。证书层比对指纹时,只要两个 SHA-256 不一致,就说明 reload 没执行,或者 -servername 命中了你没预期的那个 server 块(SNI 匹配靠的就是 server_name,见 RFC 6066)。
| 层级 | 关键命令 | 通过判据 | 典型失败信号 |
|---|---|---|---|
| 配置 | nginx -t、nginx -T |
test is successful;ssl_certificate 指向 fullchain.pem | cannot load certificate ... No such file or directory |
| 进程 | systemctl show -p ActiveEnterTimestamp、ss -lntp |
时间戳晚于 reload;443 上有 master + worker | 时间戳没变=reload 未真正执行 |
| 证书 | openssl s_client + x509 -fingerprint |
与本地 fullchain.pem 指纹一致 | 指纹不同=命中别的 server 块或旧文件 |
| 链路 | curl --resolve ... -w '%{ssl_verify_result}' |
输出 200 0 |
非 0 时查 X509_V_ERR:2/20 链不全、10 已过期、62 域名不符 |
| 协议/头部 | s_client -tls1_3、grep -i strict-transport-security |
1.3 握手成功、1.1 失败、HSTS 头存在 | 1.1 仍成功=ssl_protocols 未收紧 |
ssl_verify_result 非 0 时别猜,直接查 OpenSSL verify(1) 文档的 X509_V_ERR_* 表:最常见的是 2 和 20,都指向”只部署了站点证书、没带中间证书”,此时 fullchain.pem 里应当包含 leaf + intermediate 两段 BEGIN CERTIFICATE,Let’s Encrypt 文档也明确要求使用 fullchain.pem 而非 cert.pem。最后补一层外部视角:用 SSL Labs 或 sslgood 的检测页看评级与链完整性,注意这类服务会缓存结果,重测前先点 “Clear cache”;再用手机 4G 访问一次,排除本地 /etc/hosts 或企业代理造成的假象。HSTS 头按 RFC 6797 只会在 HTTPS 响应里生效,建议先用 max-age=300 试水,确认无误后再提到 31536000 并考虑加 includeSubDomains。协议版本控制与 HSTS 的组合配置可参考 Mozilla SSL Configuration Generator 的 intermediate 档位,它与 OpenSSL 1.1.1+、nginx 1.16+ 的默认能力对齐。
续期与回滚:nginx ssl证书安装之后的长期维护
certbot renew –dry-run 到底验证了什么,会不会烧掉速率限制?
它用的是 Let’s Encrypt staging 环境,把「申请 → 质询(HTTP-01/TLS-ALPN-01)→ 下载 → 执行 hook」整条链路走一遍,因此不占用生产环境的签发配额。据 Let’s Encrypt 官方 Rate Limits 文档,真正需要提防的是两项:同一组精确域名「每周 5 张重复证书」、以及同一 account+hostname「每小时 5 次验证失败」。所以演练请务必带 --dry-run,只有输出 Congratulations, all simulated renewals succeeded 才算通过。
# certbot 2.x(apt/dnf 装的 2.6+ 均适用);--cert-name 指定单个 lineage,避免误跑全部
certbot renew --dry-run --cert-name example.com
# 输出含 "Congratulations, all simulated renewals succeeded" 即为通过;
# 若报 Failed authorization procedure,说明 80/443 被防火墙或 CDN 拦截,先修连通性再谈续期
为什么证书明明续了,浏览器还提示过期?
因为 certbot 只写磁盘,nginx 仍在用启动时加载到内存里的旧证书。这是「续期成功但页面过期」的第一大原因,必须挂 deploy hook 触发 reload。certbot 2.0 起 --renew-hook 已并入 --deploy-hook,每次成功续期都会执行。
# 推荐:写入全局 hook 目录,对所有 lineage 生效,一次配置长期有效
cat >/etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh <<'EOF'
#!/bin/sh
# $RENEWED_LINEAGE 指向刚更新的证书目录;nginx -t 失败则不 reload,避免把坏配置推上线
nginx -t && systemctl reload nginx
EOF
chmod +x /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh
# 单证书临时方式:certbot renew --deploy-hook "systemctl reload nginx"
| 方式 | 作用范围 | 触发时机 | 适用场景 |
|---|---|---|---|
renewal-hooks/deploy/*.sh |
全局所有 lineage | 任一证书续期成功 | 多域名统一维护,首选 |
--deploy-hook 命令行 |
单次执行 | 该次续期成功 | 手工排障、一次性续期 |
renewal conf 内 renew_hook |
单个 lineage | 该 lineage 续期 | 旧版本遗留配置 |
systemd timer 的 ExecStartPost |
跟随单元 | timer 任务结束后 | 无法写 hook 的托管环境 |
换证书换坏了,怎么 30 秒内回滚?
# 替换前备份(保留 ≥30 天):日期目录便于按天回退
D=/etc/nginx/ssl/example.com/backup-$(date +%Y%m%d); mkdir -p "$D"
cp -a /etc/nginx/ssl/example.com/{fullchain.pem,privkey.pem} "$D"/
# 回滚:拷回旧文件 + 校验 + reload;reload 是平滑的,已有连接不受影响
cp -a "$D"/fullchain.pem "$D"/privkey.pem /etc/nginx/ssl/example.com/
&& nginx -t && systemctl reload nginx
多台 nginx 怎么灰度,Ansible 里该 reload 还是 restart?
先挑 1 台 reload,用 curl --resolve 把域名钉到该 IP,绕过 DNS/GSLB 直连验证,ssl_verify_result=0 表示证书链校验通过,time_appconnect 即 TLS 握手耗时;通过后再推其余节点。Ansible 里应写 handler 并 listen,一个 play 内多次任务变更只会触发一次 reload,而 state: restarted 会断开所有连接。
# 单机验证(不经 DNS,直接命中 10.0.1.21)
curl -sS -o /dev/null -w '%{ssl_verify_result} %{time_appconnect}n'
--resolve example.com:443:10.0.1.21 https://example.com/
# roles/nginx/handlers/main.yml
- name: reload nginx
ansible.builtin.systemd: { name: nginx, state: reloaded }
listen: reload nginx # tasks 中写 notify: reload nginx 即可,多次变更只触发一次
怎么在用户投诉前发现证书快过期?
#!/bin/bash
# /usr/local/bin/check-cert.sh,配合 cron:*/5 * * * * root /usr/local/bin/check-cert.sh
# 取 notAfter 算剩余天数,<15 天告警;RFC 8446 规定 TLS 1.3 握手在 1-RTT 内完成,耗时异常升高即为信号
end=$(echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
days=$(( ( $(date -d "$end" +%s) - $(date +%s) ) / 86400 ))
[ "$days" -lt 15 ] && echo "WARN example.com 证书剩余 ${days} 天" | mail -s "TLS 告警" ops@example.com
这条探针同时覆盖两类故障:证书未 reload(剩余天数不涨)与链路异常(握手耗时突增)。更严格的合规场景可参照 Mozilla SSL Configuration Generator 的 intermediate 配置,并结合 RFC 5280 的证书链校验规则排查中间证书缺失问题。
先看提示类型:若是“证书名称不匹配”,多半是 SNI 未命中或 server_name 没写全;若是“证书链不完整”,说明 ssl_certificate 指向的是域名证书而非 fullchain.pem。用 openssl s_client -connect 域名:443 -servername 域名 -showcerts /dev/null | grep -c 'BEGIN CERTIFICATE' 统计证书数,正常应大于等于 2。
RSA 证书执行 openssl x509 -in fullchain.pem -noout -modulus | openssl md5 和 openssl rsa -in privkey.pem -noout -modulus | openssl md5,两个 md5 相同即配对;ECC 证书改用 openssl pkey -in privkey.pem -pubout 与 openssl x509 -in fullchain.pem -pubkey -noout 输出对比。不匹配时 nginx 会直接报 key values mismatch 并拒绝启动。
单机、配置简单时 certbot –nginx 最快,它会自动往 server 块插入 ssl_certificate 行并配置 80 跳 443,续期也由 systemd timer 托管。但配置由 Git、Ansible 或 Helm 管理时,自动改写会和模板冲突,建议改用 certbot certonly –webroot 只签发证书,部署交给配置管理工具,职责更清晰。
不会。nginx reload 时 master 进程解析新配置并拉起新 worker,旧 worker 停止接收新连接、处理完存量请求后退出,属于平滑升级。只有 systemctl restart 或二进制升级才会中断连接。真正需要注意的是 reload 期间若配置有误,master 会保留旧配置继续服务,此时 nginx -t 的错误容易被忽略。
这是文件找不到,不是证书本身有问题。用 ls -l 逐级确认路径存在、大小不为 0,注意 nginx -t 以 root 执行能过,但 worker 以 nginx 或 www-data 运行时可能无权读取 700 目录下的文件。RHEL/CentOS 还要用 ls -Z 检查 SELinux 上下文是否为 cert_t,必要时执行 restorecon -Rv /etc/nginx/ssl。
不会,靠 SNI 区分。每个域名写独立的 server 块并 listen 443 ssl,nginx 会按 ClientHello 里的 server_name 选择对应证书。需要额外指定一个 default_server 作为兜底,避免未匹配的请求拿到错误证书;同时注意老客户端(如部分 Java 6、Windows XP 环境)不支持 SNI,只能拿到默认证书。
一定要。nginx 在启动和 reload 时读取证书文件到内存,运行期不重读磁盘,续期只更新了文件而进程里仍是旧证书。用 certbot 时加 –deploy-hook "systemctl reload nginx",或在 /etc/letsencrypt/renewal-hooks/deploy/ 下放一个可执行脚本,就能把这一步固化下来。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。