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

nginx ssl证书安装怎么做?从证书文件到零中断 reload 的 8 步实操清单

nginx ssl证书安装 — 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 类原因可按“先网络、后证书、再配置”的顺序定位:

  1. 证书与私钥不匹配: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
    
  2. 证书链缺失:只配域名证书、漏掉中间证书时 nginx 不报任何错,但客户端 curl 返回 (60) SSL certificate problem: unable to get local issuer certificate。据 Let’s Encrypt 文档,certbot 生成的 fullchain.pem 已包含中间证书,ssl_certificate 应指向它而不是 cert.pem。
  3. 路径与权限:私钥设为 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/。
  4. 监听与网络层:ss -lntp | grep ':443' 无输出说明 nginx 根本没监听 443,与证书无关;云安全组未放行 443 表现为连接超时而非证书告警,先用 telnet 你的域名 443 排除。
  5. 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"
续期后触发 reload 的几种方式对比
方式 作用范围 触发时机 适用场景
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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

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