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

SSL证书怎么配置:从CSR生成到Nginx/Apache生效的6步实操指南

SSL证书怎么配置 — SSL证书怎么配置:从CSR生成到Nginx/Apache生效的6步实操指南
核心结论

1. SSL 证书配置的本质是把 CA 签发的 leaf 证书、中间证书和私钥正确放到服务器,并让 443 端口完成 TLS 握手;2. Nginx 的 ssl_certificate 应指向 fullchain.pem,私钥权限设为 600,改完先 nginx -t 再 reload;3. Let's Encrypt 用 ACME v2 的 HTTP-01 或 DNS-01 可在 5-30 分钟内签发 90 天 DV 证书,certbot renew --dry-run 可验证续期;4. 配置是否生效不要只看浏览器锁标,需用 openssl s_client、curl -I、testssl.sh 和 SSL Labs 检查证书链、协议、OCSP 与 HSTS。

一、问题背景与根本原因:为什么 SSL 证书配置后仍会报错?

很多人把证书文件路径填进 Nginx 的 ssl_certificate 后重启,浏览器依然弹出红色警告——原因是 SSL 证书并不是一段可以随意粘贴的配置文本,而是 CA 严格按 RFC 5280 签发的 X.509 结构:一个 leaf(服务器证书)+ 一到多个 intermediate(中间证书),浏览器再用操作系统/自身内置的 root store 做证书路径构建(path building)。握手时服务器只发 leaf 而不发 intermediate,路径就断了,Chrome 报 NET::ERR_CERT_AUTHORITY_INVALID,curl 报 unable to get local issuer certificate。这是生产环境最高频的一类”配置了却报错”。

按发生频率排序的根因大致是:①证书链不完整(只配了 cert.pem 没拼 chain.pem);②私钥与证书不匹配(CSR 与 key 不是一对,或复制时漏了换行);③域名只写在 CN 而没写入 SAN 扩展——RFC 6125 起浏览器已完全忽略 CN;④云安全组 / firewalld / ufw 未放行 443,表现为连接超时而非证书错误;⑤系统时间偏差超过 5 分钟,导致 notBefore/notAfter 与 OCSP 响应校验失败;⑥仍启用 TLS 1.0/1.1,RFC 8996 已将其正式废弃,现代客户端直接握手失败。

根因 典型现象/报错 一条定位命令
缺中间证书 ERR_CERT_AUTHORITY_INVALID openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem
私钥不匹配 Nginx 启动即报 SSL_CTX_use_PrivateKey ... key values mismatch 比对证书与私钥的 SHA-256 公钥指纹
SAN 缺域名 ERR_CERT_COMMON_NAME_INVALID openssl x509 -noout -ext subjectAltName
443 未放行 连接超时、无 TLS 响应 ss -lntp | grep 443
时钟漂移 ERR_CERT_DATE_INVALID timedatectl status
# 以下命令适用于 OpenSSL 1.1.1 / 3.x,证书与私钥路径按实际替换
# 1) 查看服务器真实下发的证书链;-servername 会带上 SNI,不加则可能拿到默认站点证书
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null

# 2) 确认 SAN 与有效期(当前公共 CA 单张证书有效期上限为 398 天)
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -subject -dates -ext subjectAltName

# 3) 用系统根证书库校验整条链;缺 intermediate 会直接报 verify error
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt /etc/nginx/ssl/fullchain.pem

# 4) 校验证书与私钥是否配对:两行输出的哈希必须完全一致
openssl x509 -in fullchain.pem -noout -pubkey | openssl sha256
openssl pkey  -in privkey.pem  -pubout     | openssl sha256

# 5) 核对时间同步状态(未同步会导致日期类报错)
date -u; timedatectl status | grep -i synchronized

还有一层更前置的问题:证书可能根本没签发下来。据 Let’s Encrypt 文档,ACME v2(RFC 8555)签发 DV 证书时,HTTP-01 挑战要求 CA 能从公网访问 http://域名/.well-known/acme-challenge/<token>(即 80 端口必须放行且不能 301 到 HTTPS 之外的怪路径),DNS-01 则要求写入 _acme-challenge TXT 记录。验证失败时不会有任何证书产物,此时排查 ssl_certificate 属于方向错误,应先用 certbot certificates 或 acme.sh --list 确认证书是否真实存在。有效期方面:CA/Browser Forum 基线要求把公共信任证书有效期压到 398 天以内,Let’s Encrypt DV 固定 90 天,商业 DV 常见 1 年,OV/EV 需 1–7 个工作日人工核验;到期与续期失败是线上最常见的”突然不可用”事故源,建议用 certbot renew --dry-run 做演练。

最后,握手协商层还有几个易被忽视的变量:同一 IP 承载多个域名时,客户端必须发送 SNI 扩展,Nginx 才能选中对应的 server 块,否则返回默认站点证书并触发 SSL_ERROR_BAD_CERT_DOMAIN;协议版本应显式收敛为 ssl_protocols TLSv1.2 TLSv1.3;(TLS 1.3 见 RFC 8446),cipher suite 交由 Mozilla SSL Configuration Generator 的 “Intermediate” 档位即可;OCSP Stapling 与 HSTS(Strict-Transport-Security,建议 max-age=31536000 起步、确认全站 HTTPS 后再加 includeSubDomains)会改变浏览器对证书状态的判定路径,配置顺序错也会表现为”证书有问题”。理解这条链路后,后面的 CSR 生成与 Nginx/Apache 落地才有意义。

二、完整实操步骤:SSL 证书怎么配置的 6 个编号步骤

具体到命令行,SSL 证书怎么配置?下面 6 步按顺序执行即可,每一步都给出可复制的命令和验证点。开始前先确认版本:openssl version(本文基于 OpenSSL 3.0.13)、nginx -v(1.24/1.26)、httpd -v(Apache 2.4.58)、certbot --version(2.10.0)。

  1. 先列域名清单,再决定证书类型。把要覆盖的主机名写全:example.com、www.example.com、api.example.com。注意通配符只匹配一个标签,据 RFC 6125 §6.4.3,*.example.com 覆盖 api.example.com,但不覆盖 a.b.example.com。选型对比:

    类型 覆盖范围 参考价格(元/年) 适用场景
    单域名 DV 仅 1 个 FQDN 0(Let’s Encrypt)/ 50–300 单站点、测试环境
    多域名 SAN DV 1 张证书含多个 SAN,主流 CA 上限 100 个 100–600 主域 + www + 若干子域
    通配符 DV *.example.com,仅一级 300–1500 子域数量多且常变动
    OV 同 SAN,需组织实名核验 800–3000 对外商务、需展示企业身份

    预算 0–300 元/年走 DV 足够;EV 证书自 Chrome 77 起已不再显示绿色地址栏,不必为此加价。

  2. 生成私钥与 CSR。在服务器本地执行,私钥永不出机器:

    # -newkey rsa:2048 生成 2048 位 RSA 私钥;-sha256 为 CSR 签名摘要
    # -nodes = no DES,私钥不加密,否则每次 reload 都要手输密码
    openssl req -new -newkey rsa:2048 -sha256 -nodes 
      -keyout example.com.key -out example.com.csr 
      -subj "/C=CN/ST=Shanghai/L=Shanghai/O=Example Ltd/CN=example.com"
    chmod 600 example.com.key      # 立即收紧权限,默认 umask 022 会留下 644
    openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"

    CSR 只含公钥与主体信息,不含私钥;任何要求你上传 .key 的“代签发”平台都应视为风险。SAN 建议在 CSR 阶段就写入(-addext "subjectAltName=DNS:example.com,DNS:www.example.com"),因为 CN 字段已被主流浏览器忽略。

  3. 完成 CA 验证并签发。免费路线用 certbot 的 webroot 插件,ACME 挑战文件落在站点根目录:

    # --webroot 复用 80 端口现有站点,无需停机;-d 可重复多次
    certbot certonly --webroot -w /var/www/html 
      -d example.com -d www.example.com
    # 产物在 /etc/letsencrypt/live/example.com/,有效期 90 天
    dig +short CAA example.com   # 若有 CAA 记录,必须包含 letsencrypt.org

    据 Let’s Encrypt 文档,CAA 记录若未授权 letsencrypt.org,签发会直接失败并返回 CAA record forbids issuance。商业证书在 CA 控制台粘贴 CSR 内容:DV 通常 5–30 分钟,OV 1–3 个工作日,EV 3–7 个工作日。

  4. 下载证书包并核对。应拿到 leaf 证书、中间证书 chain.pem、合并后的 fullchain.pem 与私钥。fullchain.pem 的顺序必须是 leaf 在前、intermediate 在后,根证书不要放(客户端自带):

    openssl x509 -in fullchain.pem -noout -subject -issuer -dates
    # 再确认 SAN 是否齐全
    openssl x509 -in fullchain.pem -noout -ext subjectAltName
    # 本地验链:leaf + 中间证书能否走通
    openssl verify -untrusted chain.pem fullchain.pem
  5. 部署到 Web 服务器。Nginx 放在 server 块内,证书与私钥必须成对:

    server {
        listen 443 ssl;
        http2 on;                                  # Nginx 1.25.1+ 的写法
        server_name example.com www.example.com;
        ssl_certificate     /etc/nginx/ssl/fullchain.pem;   # 含中间证书
        ssl_certificate_key /etc/nginx/ssl/example.com.key;
        ssl_protocols       TLSv1.2 TLSv1.3;       # 1.23.4 起默认值即此,仍建议显式写
    }

    Apache 2.4.58(SSLCertificateFile 自 2.4.8 起可直接指向含链的 fullchain):

    SSLEngine on
    SSLCertificateFile    /etc/httpd/ssl/fullchain.pem
    SSLCertificateKeyFile /etc/httpd/ssl/privkey.pem
    # 老版本才需要单独指定中间证书
    # SSLCertificateChainFile /etc/httpd/ssl/chain.pem

    IIS 则先导入含私钥的 PFX,再在站点“绑定”中添加 https/443 并勾选 SNI。协议套件可参照 Mozilla SSL Configuration Generator 的 intermediate 档。

  6. 平滑重载并回归验证。先语法检查,再 reload:

    nginx -t && systemctl reload nginx
    # 或
    apachectl configtest && systemctl reload httpd

    reload 只让 worker 平滑换配置,不断开在途连接;restart 会短暂中断,生产环境优先 reload。常见失败是权限:

    nginx: [emerg] cannot load certificate "/etc/nginx/ssl/fullchain.pem":
    BIO_new_file() failed (SSL: error:8000000D:system library::Permission denied)

    说明 nginx 用户读不到私钥——检查目录 755、私钥 600 且属主为 root。重载后用 openssl s_client -connect example.com:443 -servername example.com </dev/null | openssl x509 -noout -dates 确认线上生效,再按第六节做完整回归。

三、配置/命令示例:Nginx、Apache、certbot 与 OpenSSL 的具体参数

接上文,证书文件已经就位,问题变成:Nginx 和 Apache 各自该写哪些指令、参数默认值是什么、写错了怎么排查?下面按 Web 服务器逐一给出可直接复制的配置,并附上验证命令。

Q:Nginx 1.26 的 443 server 块怎么写?

据 Mozilla SSL Configuration Generator 的 intermediate 配置,TLS 1.3 的套件由 OpenSSL 自动协商,ssl_ciphers 只对 TLS 1.2 及以下生效,因此不必也无法在此枚举 TLS 1.3 套件。

# /etc/nginx/conf.d/example.conf  —— Nginx 1.26 实测可用
server {
    listen 443 ssl;              # 1.25.1 起 http2 不再写在 listen 后面
    http2 on;
    server_name example.com www.example.com;

    ssl_certificate     /etc/nginx/ssl/fullchain.pem;   # 叶子证书 + 中间证书
    ssl_certificate_key /etc/nginx/ssl/example.com.key;

    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;
    ssl_prefer_server_ciphers off;                       # 让客户端选,支持 ChaCha20 优先

    ssl_session_cache shared:SSL:10m;   # 1MB 约存 4000 个会话,10m 够万级 QPS
    ssl_session_timeout 1d;
    ssl_session_tickets off;            # 关闭 ticket,避免前向安全性缺口
}
指令 默认值 建议取值
ssl_protocols TLSv1.2 TLSv1.3(1.23.4+) TLSv1.2 TLSv1.3
ssl_session_cache none shared:SSL:10m
ssl_session_timeout 5m 1d
ssl_session_tickets on off
ssl_prefer_server_ciphers off(1.9.4+) off

Q:OCSP Stapling 不生效怎么办?

ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem;   # 必须是签发者链,不能只放叶子证书
resolver 223.5.5.5 119.29.29.29 valid=300s;
resolver_timeout 5s;

最常见原因是 chain.pem 缺失或内容错误,Nginx 日志会打出 "ssl_stapling" ignored, issuer certificate not found(Apache 侧对应 AH02217)。验证方法:openssl s_client -connect example.com:443 -status </dev/null | grep -i "OCSP Response Status",返回 successful 才算生效。

Q:Apache 2.4.58 怎么写?

<VirtualHost *:443>
    ServerName example.com
    SSLEngine on
    SSLCertificateFile    /etc/httpd/ssl/fullchain.pem
    SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
    SSLProtocol -all +TLSv1.2 +TLSv1.3
    SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384
    SSLHonorCipherOrder off
</VirtualHost>
# 改完必须:apachectl configtest && systemctl reload httpd

Q:自动续期怎么确认真的会成功?

certbot 用 certbot renew --dry-run,成功输出末行为 Congratulations, all simulated renewals succeeded;acme.sh 3.0.7 则用 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' 把续期与重载绑定。定时任务建议每天 02:00 的随机分钟执行,避免整点集中冲击 Let’s Encrypt 的 ACME 接口。

Q:怎么确认证书和私钥确实配对、链完整?OpenSSL 3.0.13 下三条命令即可:

openssl x509 -noout -modulus -in cert.pem | openssl md5     # 两条 md5 必须一致
openssl rsa  -noout -modulus -in example.com.key | openssl md5
openssl verify -CAfile chain.pem cert.pem                   # 期望输出 cert.pem: OK
openssl x509 -in fullchain.pem -noout -text | grep -A1 'Subject Alternative Name'

最后一条用于核对 SAN 是否覆盖 www 子域——据 RFC 6125,现代客户端只认 SAN,CN 字段已不再参与域名匹配。这也是 SSL 证书怎么配置里最容易被忽略、却直接导致浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID 的一环。

四、参数对比与方案选型表:DV、OV、EV、通配符和自动签发怎么选

SSL 证书怎么配置,第一步其实不是敲命令,而是先定证书类型。因为类型决定了验证流程、续期方式和部署位置,选错会让后面每一步都变麻烦。下面是 2024–2025 年中国大陆主流 CA 与代理商的常见区间(单域名,价格随促销浮动):

类型 验证方式 有效期 参考价格 签发时长 适用判断
Let’s Encrypt DV ACME v2 HTTP-01 / DNS-01 90 天,需自动续期 0 元 5–30 分钟 个人站、测试站、内部工具
商业 DV 邮箱 / 文件 / DNS 1 年 0–300 元 10–60 分钟 不想维护 ACME 客户端
OV 企业工商资料核验 1 年 800–3000 元 1–3 工作日 电商、登录页需展示主体
EV 严格企业核验 + 电话回访 1 年 2000–8000 元 3–7 工作日 金融、招投标等强合规场景
通配符 DV 强制 DNS-01 90 天或 1 年 300–1500 元 10–60 分钟 多子域、泛域名后台
自签名 / 私有 CA 无 自定义 0 元 5 分钟 仅内网与 CI,公网不被信任

一个常被误解的点:EV 的绿色地址栏早在 Chrome 77(2019 年)、Firefox 70、Safari 中就被移除,据 CA/Browser Forum Baseline Requirements 及各大浏览器厂商公告,EV 现在只在证书详情里体现企业名。“买 EV 让地址栏变绿”这个理由已经不成立,只在合规审查明确要求时才值得评估。

按部署位置选:Nginx/Apache 直接终止 TLS 时,证书路径必须指向 fullchain.pem(叶子证书 + 中间证书)。只配叶子证书会让 Android 7 以下和部分 Java 客户端报 unable to get local issuer certificate。

# /etc/nginx/conf.d/example.conf —— 适用于 nginx 1.23.4 及以上
server {
    listen 443 ssl;
    http2 on;                      # nginx ≥1.25.1 写法;更早版本写 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;
    ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;  # OCSP Stapling 必需

    # 公网站点只开 TLSv1.2/1.3;nginx 1.23.4 起已是默认值,旧版本默认含 TLSv1/1.1
    ssl_protocols TLSv1.2 TLSv1.3;
    # 仅对 TLSv1.2 生效,TLS 1.3 套件由 OpenSSL 默认提供
    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;

    ssl_stapling on;
    ssl_stapling_verify on;
    resolver 223.5.5.5 119.29.29.29 valid=300s;   # 缺 resolver 时 Stapling 静默不生效
    resolver_timeout 5s;

    # HSTS 首次设 300 秒观察,全站及子域确认 HTTPS 正常后再升到 31536000
    add_header Strict-Transport-Security "max-age=300" always;
}

若前面挂了 SLB / CDN / WAF,证书一般上传到负载均衡或 CDN 控制台,源站可复用自签或内网 CA,但回源链路仍要加密,且必须让应用读到正确协议:Nginx 侧配 set_real_ip_from 与 real_ip_header X-Forwarded-For,后端读取 X-Forwarded-Proto,否则容易陷入 301 重定向循环。

按工具选:certbot 适合单机,certbot --nginx -d example.com -d www.example.com 会自动改配置并装 systemd timer 续期;acme.sh 纯 shell 无 Python 依赖,支持百余家 DNS API,通配符只能走 DNS-01:acme.sh --issue --dns dns_ali -d example.com -d '*.example.com';宝塔面板 8.x 可视化但升级后要人工核对 /www/server/panel/vhost/cert/ 下的文件与续期日志;IIS 10 导入 PFX 后在站点绑定中选择,并通过 certlm.msc 收紧私钥可导出权限。

回到 SSL 证书怎么配置 的主线,最常见的失败是私钥与证书不匹配,报错形如 nginx: [emerg] SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:...:key values mismatch)。用下面三条命令可提前验证:

# 1) 两个 MD5 必须完全一致
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in privkey.pem   | openssl md5
# 2) 确认有效期与颁发者
openssl x509 -noout -dates -subject -issuer -in fullchain.pem
# 3) 验证线上是否真的下发了中间证书,输出应 ≥ 2
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null | grep -c "BEGIN CERTIFICATE"

五、常见错误与排查:这些真实报错分别怎么处理?

排查顺序建议固定为三步:先看服务端实际下发的证书链,再验证本地文件本身是否合法,最后才检查协议与密码套件。下面五类真实报错覆盖了 Let’s Encrypt 与商业证书部署中的绝大多数失败场景,每条都给出可复制的定位命令。

NET::ERR_CERT_AUTHORITY_INVALID 或 curl: (60) SSL certificate problem: unable to get local issuer certificate?根因几乎总是证书链不完整:Nginx 的 ssl_certificate 指向了只含叶子证书的 cert.pem。据 Let’s Encrypt 文档,fullchain.pem 才是叶子证书后紧跟中间证书的正确文件;根证书绝不能拼接进去,因为客户端本地已信任根,重复下发反而会增大握手包并可能触发校验异常(RFC 5280 第 6 节描述的认证路径构建规则)。

# 1. 观察服务端实际下发的链:应看到 2 条 s:(leaf + intermediate),不应出现根
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | grep -E "^ *[0-9]+ s:|^ *i:"

# 2. 本地验证:cert.pem 为域名证书,chain.pem 为中间证书
openssl verify -CAfile chain.pem cert.pem
# 期望输出:cert.pem: OK

# 3. 修正 Nginx 指向(该指令无默认值,必须显式配置)
ssl_certificate     /etc/nginx/ssl/fullchain.pem;   # 不是 cert.pem
ssl_certificate_key /etc/nginx/ssl/privkey.pem;

nginx: [emerg] cannot load certificate … PEM_read_bio_X509_AUX() failed?该报错来自 OpenSSL 解析 PEM 失败,常见四种诱因:Windows 换行符(CRLF)、文件里混入了私钥或说明文字、权限不足、路径写错。逐项确认:

file /etc/nginx/ssl/fullchain.pem
# 期望:... PEM certificate
# 若显示 "with CRLF line terminators":
sed -i 's/r$//' /etc/nginx/ssl/fullchain.pem

chmod 644 /etc/nginx/ssl/fullchain.pem   # 公钥文件可读即可
chmod 600 /etc/nginx/ssl/privkey.pem     # 私钥仅属主可读写
nginx -t                                 # 通过后再 reload

SSL_ERROR_BAD_CERT_DOMAIN 或 NET::ERR_CERT_COMMON_NAME_INVALID?证书的 SAN 列表不含当前访问域名。自 Chrome 58 起,CN 字段已被完全忽略,只认 Subject Alternative Name(依据 RFC 6125 与 CA/Browser Forum 基线要求)。检查:

# 需 OpenSSL 1.1.1 及以上支持 -ext
openssl x509 -in fullchain.pem -noout -ext subjectAltName
# X509v3 Subject Alternative Name:
#     DNS:example.com, DNS:www.example.com

若缺 www、api 等子域,必须重新签发(多域名或通配符),改 CN 无效。

ERR_SSL_VERSION_OR_CIPHER_MISMATCH?客户端与服务器没有交集。Nginx 1.23.4 起 ssl_protocols 默认值已改为 TLSv1.2 TLSv1.3,更早版本默认仍含 TLSv1/1.1;Apache httpd 2.4 的 SSLProtocol 默认为 all,需显式减掉旧协议。Apache 还需注意:SSLProtocol/SSLCipherSuite 写在 <VirtualHost *:443> 外层时,会被内层 VirtualHost 覆盖而失效。

# Nginx
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384';
ssl_prefer_server_ciphers off;   # 1.11.0 起默认 off

# Apache httpd 2.4(禁用 RC4/3DES)
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES:!RC4

AH02217: ssl_stapling_init_cert: can’t retrieve issuer certificate! 或 OCSP response: no response sent?OCSP Stapling 需要三件套齐全:ssl_stapling(默认 off)、ssl_trusted_certificate(默认 none,须指向含中间证书的 chain.pem)、可用的 resolver(Nginx 无默认 DNS,缺失则完全不生效)。验证结果用 openssl s_client -connect example.com:443 -status | grep "OCSP Response Status",期望 successful。内网无外网出口时应关闭 stapling 并在变更记录中注明原因。

ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem;  # 注意不是 fullchain.pem
resolver 223.5.5.5 8.8.8.8 valid=300s;
resolver_timeout 5s;
报错关键字 根因 一行修复
ERR_CERT_AUTHORITY_INVALID / curl (60) 链不完整,指向 cert.pem 改用 fullchain.pem,openssl verify 复核
PEM_read_bio_X509_AUX() failed CRLF、杂内容、权限或路径错 sed -i 's/r$//' + 644/600 + nginx -t
ERR_CERT_COMMON_NAME_INVALID SAN 缺域名 重新签发含 SAN 的证书
ERR_SSL_VERSION_OR_CIPHER_MISMATCH 协议/套件无交集 显式声明 TLSv1.2/1.3,禁用 RC4/3DES
ssl_stapling_init_cert / no response sent 缺 chain.pem 或 resolver 补 ssl_trusted_certificate 与 resolver

六、效果验证方法:如何确认 SSL 证书配置真正生效?

改完配置是先 reload 还是先测语法?先测。Nginx 必须看到两行输出才算通过:

# 1) 语法与证书文件可读性检查(不会重载进程)
sudo nginx -t
# 期望输出:
# nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
# nginx: configuration file /etc/nginx/nginx.conf test is successful

# 2) 两行都出现后再平滑重载,避免中断现有连接
sudo systemctl reload nginx
systemctl status nginx | grep Active   # 期望 active (running)

# 3) 确认 443 真的在监听(LISTEN 状态、进程为 nginx)
ss -lntp | grep ':443'

Apache 对应命令是 sudo apachectl configtest,返回 Syntax OK 后执行 sudo systemctl reload apache2(RHEL 系为 httpd)。若 ss 无输出,多半是 listen 443 ssl; 没写进 server 块——注意 Nginx 1.25.1 起 listen 443 ssl http2; 的 http2 参数已废弃,需改用独立的 http2 on; 指令,否则报 "listen ... http2" directive is deprecated。

本机通了,怎么证明证书链对外可校验?据 OpenSSL 官方文档,s_client 的 -servername 用于发送 SNI(虚拟主机多证书场景必加,否则可能拿到默认站点的证书):

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
# 关注末尾:Verify return code: 0 (ok)  ← 唯一合格值
# 20 (unable to get local issuer certificate) → 漏配中间证书,应部署 fullchain.pem
# 21 (unable to verify the first certificate) → 只发了站点证书

# 分别验证协议版本是否按预期启停
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null | grep "Protocol"
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null | grep "Protocol"

# 检查 OCSP Stapling:需看到 "OCSP Response Status: successful"
openssl s_client -connect example.com:443 -servername example.com -status </dev/null | grep -A2 "OCSP Response"

链的修复点在于:Nginx 的 ssl_certificate 与 Apache 2.4.8+ 的 SSLCertificateFile 都应指向 fullchain.pem(站点证书+中间证书),而不是 cert.pem;Apache 2.4.7 及更早版本才另需 SSLCertificateChainFile。

浏览器能打开就算成功吗?不一定,还要看 HTTP 层与证书字段:

curl -I https://example.com
# 期望首行 HTTP/2 200 或 HTTP/1.1 200,而非 301 循环或 000

curl -vI https://example.com 2>&1 | grep -E "subject|issuer|expire date|SSL certificate verify"
# 输出中的 expire date 即 NotAfter,用于确认不是旧证书仍在生效

# 直接核对本地证书文件的到期日、主体与 SAN 覆盖范围
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem 
  -noout -dates -subject -issuer -ext subjectAltName

据 Let’s Encrypt 文档,其证书有效期 90 天,subjectAltName 必须同时覆盖 example.com 与 www.example.com,否则访问 www 会出现 NET::ERR_CERT_COMMON_NAME_INVALID。

地址栏有小锁但样式丢失,问题在哪?是混合内容。在开发者工具 Console 里搜索 Mixed Content,把 http:// 资源改为 https://,或下发响应头 Content-Security-Policy: upgrade-insecure-requests 自动升级。同时确认 HSTS 头为 Strict-Transport-Security: max-age=31536000; includeSubDomains;首次上线建议先用 max-age=300 观察一周再拉长,因为该头一旦下发,浏览器在有效期内会强制走 HTTPS,回滚代价很高。

怎么对外证明配置达标,续期会不会翻车?用 testssl.sh 3.2 做全量体检,再用 dry-run 演练续期:

# 1) 外部扫描:协议、套件、证书链、OCSP、已知漏洞
git clone --depth 1 https://github.com/drwetter/testssl.sh.git
cd testssl.sh && ./testssl.sh --fast example.com

# 2) 续期演练(不会真正签发,但会跑完钩子与 reload 命令)
sudo certbot renew --dry-run
# acme.sh 用户:
~/.acme.sh/acme.sh --cron --home ~/.acme.sh

SSL Labs 评级到 A/A+ 即达标,不必追求满分套件列表。下表是常见检查项与失败输出的对照,可直接当排障清单:

检查项 命令 通过标准 典型失败输出
配置语法 nginx -t / apachectl configtest syntax is ok + test is successful / Syntax OK BIO_new_file() failed (SSL: error:...:system lib) 证书路径错误
端口监听 ss -lntp | grep :443 出现 LISTEN 且进程为 nginx/httpd 无输出 → 未 reload 或 listen 缺失
证书链 openssl s_client -showcerts Verify return code: 0 (ok) code 20 / 21(缺中间证书)
OCSP Stapling openssl s_client -status OCSP Response Status: successful no response sent(需 ssl_stapling on; 且已配 resolver)
续期钩子 certbot renew --dry-run Congratulations, all simulated renewals succeeded reloadcmd 失败 → 新证书签发但进程仍加载旧证书

最后一步最容易被忽略:续期成功后必须触发重载(certbot 的 --deploy-hook "systemctl reload nginx",acme.sh 的 --reloadcmd),否则磁盘上是新证书、内存里仍是旧的,等到 90 天期满才会集中爆出过期告警。

不够。完整配置至少包括 fullchain.pem 证书链、私钥、443 监听、TLS 1.2/1.3 协议、重载 Web 服务和验证五部分;只放证书文件但私钥不匹配、链缺失或防火墙未放行,浏览器仍会报错。

两者都是 DV 级别,浏览器信任链相同。Let's Encrypt 有效期 90 天、0 元、依赖 ACME 自动续期,适合有脚本能力的团队;商业 DV 常见 1 年、0-300 元/年,适合缺少自动化或需要厂商工单支持的场景。

先检查 ssl_certificate 路径是否存在、文件是否为 PEM 格式、是否被 Windows CRLF 或多余文本污染。再执行 chmod 644 fullchain.pem、chmod 600 privkey.pem,并用 nginx -t 复测;路径权限错误也会触发同类报错。

cert.pem 通常只有站点 leaf 证书,chain.pem 是中间证书,fullchain.pem 是 leaf 加 intermediate。Nginx 的 ssl_certificate 应指向 fullchain.pem,OCSP Stapling 的 ssl_trusted_certificate 可指向 chain.pem;根证书不需要拼进链里。

不能。*.example.com 只覆盖 a.example.com 这一级,不覆盖 a.b.example.com。若要多级子域名,需要分别签发对应 SAN 或使用多张证书,并在 Nginx/Apache 中按 SNI 配置多个 server 块。

通常不需要重启,reload 即可让新证书生效。certbot 或 acme.sh 的 reloadcmd 配成 systemctl reload nginx 更稳妥;restart 会中断现有连接,生产环境优先用 reload。

在 Windows Server 2019/IIS 10 中把 PFX 导入本地计算机个人证书存储,再在站点绑定里选 https 和该证书。可用 PowerShell 的 Import-PfxCertificate -FilePath cert.pfx -CertStoreLocation Cert:LocalMachineMy,随后用 netsh http show sslcert 核对 443 绑定与私钥权限。


本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

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