跳到主要内容
ssl证书按装

网站 HTTPS 证书配置全流程:从 CSR 申请、Nginx 部署到报错排查

网站 HTTPS 证书配置全流程:从 CSR 申请、Nginx 部署到报错排查 — 网站 HTTPS 证书配置全流程:从 CSR 申请、Nginx 部署到报错排查

问题背景与根因:证书装上了,浏览器为什么还说“不安全”

在 CVM 上装好证书、放行 443 端口之后,仍有大量站点提示“不安全”。Chrome 控制台报 NET::ERR_CERT_AUTHORITY_INVALID,命令行 curl -I https://example.com 返回 curl: (60) SSL certificate problem: unable to get local issuer certificate。根因基本落在三类:

  • 证书链不完整:只上传了服务器证书(leaf),没有把中间证书拼进 fullchain.pem,客户端无法补链到受信任根。
  • 域名不匹配:证书 SAN 里只有 example.com,用户却用 www.example.com 访问,触发 SSL_ERROR_BAD_CERT_DOMAIN。
  • 私钥不匹配或权限过宽:key 与 crt 不是一对,或私钥被 chmod 644,Nginx 直接拒绝加载。

先用两条命令把问题定位到具体层级:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -E 'i:|s:'
curl -vI https://example.com 2>&1 | grep -Ei 'SSL|subject|issuer|expire'

还要注意有效期规则已经变化:CA/Browser Forum 规定 2020-09-01 之后签发的公开信任 TLS 证书最长有效期为 398 天,Let’s Encrypt 免费证书固定 90 天。原文中“一次配置长期有效”“不限平台、不限运行环境”只是营销话术,实际能否启用 TLS 1.3 取决于服务端 OpenSSL 版本(需 1.1.1 及以上)与 Nginx 编译参数。

第一步:生成私钥与 CSR,并完成证书申请

证书申请的核心是保证“私钥—CSR—证书”三者一致,并把所有要用到的域名写进 SAN。以下命令在任意 Linux 主机可直接执行:

openssl genrsa -out example.com.key 2048
chmod 600 example.com.key
openssl req -new -sha256 -key example.com.key -out example.com.csr -subj '/C=CN/ST=Guangdong/L=Shenzhen/O=Example/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'

拿到 CA 返回的证书后,必须先确认公钥指纹与私钥一致,否则后面一定报 key values mismatch:

openssl x509 -in example.com.crt -noout -pubkey | openssl sha256
openssl pkey -in example.com.key -pubout | openssl sha256

两行输出必须完全相同。免费证书建议用 ACME 自动化,避免 90 天到期遗漏:

certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com --deploy-hook 'systemctl reload nginx'
certbot renew --dry-run

通配符证书(*.example.com)只能用 DNS-01 验证,且只覆盖一级子域,a.b.example.com 需要单独签发或写进 SAN。企业内网、纯测试环境可用自签证书,但生产环境必须使用公开信任 CA,否则 iOS/Android 客户端会直接拦截请求。

第二步:部署证书到 Nginx 与 Apache(可直接执行)

部署前先把 CA 包按“服务器证书 → 中间证书”顺序拼成 fullchain.pem,顺序颠倒同样会报链错误:

mkdir -p /etc/nginx/ssl && cd /etc/nginx/ssl
cat example.com.crt intermediate.crt > fullchain.pem
cp intermediate.crt chain.pem
chmod 644 fullchain.pem chain.pem
chmod 600 example.com.key && chown root:root example.com.key

Nginx 上线流程必须带语法校验,不要直接 reload:

nginx -t && systemctl reload nginx
nginx -t 2>&1 | tail -n 3

Apache 2.4.8 及以上可以把中间证书直接拼在 SSLCertificateFile 里;低版本必须单独指定 SSLCertificateChainFile:

<VirtualHost *:443>
  ServerName example.com
  SSLEngine on
  SSLCertificateFile    /etc/httpd/ssl/fullchain.pem
  SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
  # Apache < 2.4.8 才需要下面这行
  # SSLCertificateChainFile /etc/httpd/ssl/chain.pem
</VirtualHost>

容器或 Kubernetes 场景把证书挂成 Secret,挂载后文件权限通常是 0444,与私钥 0600 的要求冲突,需要在 entrypoint 里 cp 一份再改权限。部署完成后立刻用 openssl 复核,确认服务器真的下发了中间证书,而不是只下发了 leaf。

第三步:完整配置示例(全站 HTTPS + HSTS + OCSP Stapling)

下面的配置同时完成 80 跳转、TLS 1.2/1.3 收紧、会话复用、OCSP 装订与 HSTS,可直接改域名后套用:

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

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/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-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
    ssl_prefer_server_ciphers off;

    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;
    ssl_session_tickets off;

    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;

    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
    add_header X-Content-Type-Options nosniff always;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

HSTS 首次上线建议先写 max-age=300 试运行一周,确认所有子域都支持 HTTPS 后再加 includeSubDomains;一旦提交 preload 列表,回退成本极高。反向代理到自签后端时,需额外加 proxy_ssl_trusted_certificate,不要图省事关掉校验。

第四步:云产品接入差异(CVM、CLB、CDN、COS、CDB)

证书在哪一层终结,决定你要配几次、在哪里续期。同一套域名往往需要在 CDN 与源站各配一份,只更新一层就会出现“CDN 已换证书、回源仍握手失败”。常见接入层对照如下:

接入层 配置位置 是否需上传私钥 关键注意点
CVM 自建 Nginx /etc/nginx/ssl 是 自行续期并 reload,注意私钥 0600
CLB 负载均衡 HTTPS 监听器绑定证书 是 后端可为 HTTP,需透传 X-Forwarded-Proto
CDN 域名管理 → HTTPS 配置 是 加速证书与回源协议分开配置,回源 HTTPS 需源站证书可信
对象存储 COS 自定义域名证书 是 域名须已 CNAME 到服务端并完成归属验证
CDB 数据库 一般不暴露 443 否 应用层用 TLS 连接串加密,勿把 3306 直接对公网

逐层验证命令(把域名换成 CDN 加速域名或 CLB 域名即可):

openssl s_client -connect cdn.example.com:443 -servername cdn.example.com </dev/null 2>/dev/null | openssl x509 -noout -issuer -dates
curl -s -o /dev/null -w '%{http_code} %{ssl_verify_result}' https://cdn.example.com

第二条命令输出 200 0 才算校验通过,末尾数字非 0 表示链或域名有问题。老客户端不带 SNI 时会拿到默认站点证书,若业务仍需兼容,必须为该域名配置独立 IP。

第五步:证书类型与 TLS 协议对比表

选型先看验证等级,再看覆盖域名数量,最后看预算,不要盲目追求 EV:

证书类型 验证方式 签发时长 典型场景
DV 域名型(单域名) DNS/文件自动验证 分钟级 个人站、API 网关、测试环境
DV 通配符 *.example.com DNS-01 分钟级 子域多且新增频繁,仅覆盖一级子域
DV 多域名 SAN 自动验证 分钟级 5~10 个不同主域,一张证书统管
OV 企业型 人工核验企业主体 1~3 个工作日 企业官网、需展示组织信息
EV 扩展型 严格人工核验 3~7 个工作日 金融、政企合规要求;现代浏览器已不显示企业名

协议侧同样需要收敛,旧协议不仅不安全,还会拉低整体评分:

协议版本 状态 说明
TLS 1.0 / 1.1 已淘汰 2020 年起主流浏览器弃用,PCI DSS 明确禁止
TLS 1.2 最低可用 必须配 ECDHE 密钥交换 + AEAD 套件
TLS 1.3 推荐 1-RTT 握手,仅 5 个套件,需 OpenSSL 1.1.1+

公开信任证书有效期上限 398 天、Let’s Encrypt 90 天,意味着任何方案都必须具备自动续期能力,手工续期在一年多以后必然出事故。

第六步:常见错误排查(真实报错对照表)

下面这些报错几乎覆盖了 90% 的现场问题,按“报错原文 → 根因 → 修复”逐条对照:

报错信息 根因 修复
nginx: [emerg] SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) 私钥与证书不配对 用 sha256 比对公钥指纹,重新配对 key 与 crt
curl: (60) SSL certificate problem: unable to get local issuer certificate 缺少中间证书 按 leaf→intermediate 顺序拼 fullchain.pem
NET::ERR_CERT_COMMON_NAME_INVALID / SSL_ERROR_BAD_CERT_DOMAIN SAN 不含当前域名 重签证书并把 www 与非 www 都写入 SAN
sslv3 alert handshake failure 协议或套件无交集 确认客户端版本,服务端保留 TLSv1.2 TLSv1.3
nginx: [warn] "ssl_stapling" ignored, issuer certificate not found 未配 ssl_trusted_certificate 指向 chain.pem 并配置可用 resolver
upstream SSL certificate verify error 伴随 502 反代后端为自签证书 配置 proxy_ssl_trusted_certificate,勿长期关闭校验
certificate has expired 但证书尚未到期 服务器系统时间偏差 chronyc makestep 或 ntpdate 校时后重试
nginx: [emerg] cannot load certificate ... PEM_read_bio_X509_AUX() failed 文件含多余文本或为 DER 格式 openssl x509 -in cert.crt -out cert.pem 转换

排查顺序建议固定:先 nginx -t 看本地配置,再 openssl s_client 看链与协议,最后看客户端与服务端时间、SNI、CDN 缓存,避免在错误层级反复试错。

第七步:效果验证与到期监控

部署完成后必须做四类验证:证书链、协议版本、HSTS 头、到期时间。以下命令可直接复制:

openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
curl -sI https://example.com | head -n 5
curl -s -o /dev/null -w '%{http_code} %{ssl_verify_result}' https://example.com
nmap --script ssl-enum-ciphers -p 443 example.com

最后一条用于确认 TLS 1.0/1.1 已关闭;如果仍列出 TLSv1.0: sslv3 alert handshake failure 之外的可协商项,说明 ssl_protocols 未生效或前面还有一层代理。到期监控建议用脚本加 cron,不要依赖日历提醒:

#!/bin/bash
DOMAIN=example.com
END=$(echo | openssl s_client -connect $DOMAIN:443 -servername $DOMAIN 2>/dev/null | openssl x509 -noout -enddate | cut -d= -f2)
LEFT=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
[ $LEFT -lt 20 ] && echo "WARN $DOMAIN 剩余 $LEFT 天" | mail -s cert-alert ops@example.com

写入 crontab:0 8 * * * /usr/local/bin/check_cert.sh。同时保留 certbot renew --dry-run 每周一次,确认续期链路(webroot 目录、80 端口、DNS API 凭据)始终可用,而不是等到到期当天才发现续期失败。

常见问题

公开信任的 TLS 证书最长有效期为 398 天(CA/Browser Forum 规定,2020 年 9 月起执行);Let’s Encrypt 免费证书固定 90 天。因此必须配置自动续期,手工续期最迟一年多就会失效。


可以。签发时把两个域名都写入 SAN 字段即可,例如 -addext ‘subjectAltName=DNS:example.com,DNS:www.example.com’。只写 CN 已不被现代浏览器认可,缺失 SAN 会报 ERR_CERT_COMMON_NAME_INVALID。


不能。*.example.com 只匹配一级子域,如 a.example.com,不匹配 a.b.example.com。多级子域需要单独签发,或把具体域名逐个写入 SAN,通配符证书只能用 DNS-01 方式验证域名归属。


不需要重启,执行 nginx -t 校验通过后 systemctl reload nginx 即可平滑加载新证书,连接不会中断。用 certbot 时配置 –deploy-hook ‘systemctl reload nginx’ 可自动完成这一步。


不能。自签证书不在系统信任库中,浏览器会显示红色警告,App 与小程序会直接拒绝请求。它只适合内网测试、开发联调或反向代理后端加密,对外服务必须使用公开信任 CA 签发的证书。

内容审核

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