网站 HTTPS CA 证书配置全流程:从 CSR 生成、证书链拼接到强制跳转与故障排查
一、为什么“装个证书”仍然会失败:HTTPS 配置的根因
把 HTTPS 等同于“上传一个 .crt 文件”,是绝大多数配置事故的起点。浏览器地址栏的锁标背后至少有三层校验:证书链能否回溯到本地信任库中的根证书、证书主体与 SAN 是否匹配当前访问域名、握手协商出的 TLS 版本与密码套件是否被双方共同支持。任何一层断裂,页面就会退回 NET::ERR_CERT_AUTHORITY_INVALID 或 ERR_SSL_PROTOCOL_ERROR。
按线上工单统计,故障集中在五类根因:
- 证书链不完整(约占四成):只部署了站点证书,缺失中间证书。桌面 Chrome 可能借助证书里的 AIA 地址自动补链而显示正常,但 Android、Java、微信内置浏览器、curl 会直接报
unable to verify the first certificate。 - 私钥与证书不匹配:CSR 生成后私钥被覆盖,或从 A 服务器复制证书、从 B 服务器复制私钥,Nginx 直接启动失败。
- SNI 未生效:同一 IP 上多站点共用 443,旧客户端或不支持 SNI 的库拿到的是默认站点证书。
- 混合内容:HTML 里残留
http://的图片、JS、接口地址,锁标变成灰色感叹号。 - 有效期管理失控:CA/Browser Forum 规定公开信任的 TLS 证书单张最长有效期 398 天,Let’s Encrypt 免费证书固定 90 天,官方建议在剩余 30 天左右续期。靠人工日历提醒,过期只是时间问题。
动手改配置前,先做一次 30 秒体检,把根因定位清楚:
# 查看服务端实际下发的证书与完整链
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
# 查看有效期、主体、签发者
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -dates -subject -issuer
# 校验链是否完整(chain.pem 只放中间证书)
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem cert.pem
只有输出 Verify return code: 0 (ok) 才算链完整。若出现 unable to get local issuer certificate,说明缺中间证书,先补齐链路,不要急着改 TLS 参数。
二、生成私钥与 CSR:参数错一个后面全白做
CSR(Certificate Signing Request)是“公钥 + 主体信息”的签名请求,CA 只签 CSR,全程不接触私钥。因此私钥必须在自己的服务器上生成,且权限收紧到 600:
# 方案 A:RSA 2048,兼容性最好,2048 位是安全下限
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out example.com.key
# 方案 B:ECDSA P-256,握手更快、传输体积更小
openssl ecparam -genkey -name prime256v1 -noout -out example.com.key
chmod 600 example.com.key
生成 CSR 的关键是 SAN(subjectAltName)。自 2017 年起主流浏览器已忽略 CN 字段,只填 -subj 里的 CN 必然触发 ERR_CERT_COMMON_NAME_INVALID:
openssl req -new -key example.com.key -out example.com.csr
-subj '/C=CN/ST=Beijing/L=Beijing/O=Example Ltd/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com,DNS:api.example.com'
提交给 CA 之前自检两件事:CSR 签名有效、私钥与 CSR 公钥一致。第二条最容易被忽略,也是后面 key values mismatch 的源头:
openssl req -in example.com.csr -noout -verify -text | head -20
openssl req -in example.com.csr -noout -pubkey | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5
两行 MD5 必须完全相同。-addext 需要 OpenSSL 1.1.1 及以上,CentOS 7 自带的 1.0.2 会报 Unknown option or ciphersuite,此时升级 openssl 或改用 openssl.cnf 配置文件方式。另外通配符证书 *.example.com 只覆盖一级子域,既不覆盖裸域 example.com,也不覆盖 a.b.example.com,裸域必须单独写进 SAN。
三、拼装证书链并写入 Nginx / Apache 配置
CA 下发的压缩包通常包含站点证书 example.com.crt、中间证书 chain.crt 或 ca_bundle.crt、以及私钥。拼接顺序错了等同于没配,必须“站点证书在前、中间证书在后”:
cd /etc/nginx/ssl
cat example.com.crt chain.crt > fullchain.pem
chmod 600 example.com.key
chmod 644 fullchain.pem chain.pem
# 拼接后链中应至少有 2 段证书
grep -c 'BEGIN CERTIFICATE' fullchain.pem
Nginx 1.25.1 起 listen ... http2 已废弃,改用独立的 http2 on;:
server {
listen 443 ssl;
listen [::]:443 ssl;
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-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;
}
Apache 2.4.8 之后不再需要 SSLCertificateChainFile,把中间证书拼进 SSLCertificateFile 指向的文件即可:
<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 HIGH:!aNULL:!MD5:!3DES
</VirtualHost>
改完先做语法校验再平滑重载:nginx -t && nginx -s reload;Apache 用 apachectl configtest && systemctl reload httpd。注意 ssl_certificate 写相对路径时是相对于 Nginx 前缀目录而非 conf 文件所在目录,一律写绝对路径最省事。
四、强制 HTTPS 跳转、HSTS 与握手参数调优
证书装好只代表“能说 HTTPS”,用户仍可能从 http:// 进入。301 跳转要写在 80 端口的 server 块里,但必须放行 ACME 验证路径,否则 HTTP-01 校验永远失败:
server {
listen 80;
server_name example.com www.example.com;
location ^~ /.well-known/acme-challenge/ { root /var/www/letsencrypt; }
location / { return 301 https://$host$request_uri; }
}
HSTS 让浏览器在有效期内不再发起明文请求,代价是一旦下发就很难回退。务必先确认全站无混合内容,再把 max-age 从 300 秒逐步加长:
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
只有确认所有子域都已上 HTTPS 才加 includeSubDomains;preload 更要谨慎,提交到浏览器预置列表后撤销需要数月。OCSP Stapling 需要 ssl_trusted_certificate 指向纯中间证书链,并配置可用 DNS 解析器:
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem;
resolver 223.5.5.5 1.1.1.1 valid=300s;
resolver_timeout 5s;
注意:Let’s Encrypt 已于 2025 年停止提供 OCSP 响应,其证书开启 stapling 没有实际收益,改为依赖短周期证书与 CRL 即可;只有商业 CA 证书才需要这一步。同时务必关闭 TLS 1.0/1.1 与 3DES、RC4,否则 Chrome 会对页面直接标记“不安全”。
五、证书类型与有效期对比:选型看这几行就够
选型只需回答三个问题:谁在用、要不要展示组织身份、客户端有多老。三类证书的加密强度完全一致,差别只在身份核验深度与赔付条款。
| 证书类型 | 验证内容 | 单张最长有效期 | 典型场景 | 签发耗时 |
|---|---|---|---|---|
| DV 域名型 | 仅域名控制权(DNS TXT 或 HTTP 文件) | 398 天;Let’s Encrypt 为 90 天 | 博客、API、内部测试 | 分钟级 |
| OV 组织型 | 域名 + 企业工商信息 | 398 天 | 企业官网、SaaS 平台 | 1-3 个工作日 |
| EV 扩展验证 | 严格身份核验 | 398 天 | 金融、支付(浏览器已不再显示绿色公司名) | 3-7 个工作日 |
有效期规则正在快速收紧,运维流程必须提前适配自动化续期:
| 生效时间 | 公开信任证书单张最长有效期 |
|---|---|
| 2020-09-01 起 | 398 天 |
| 2026-03-15 起 | 200 天 |
| 2027-03-15 起 | 100 天 |
| 2029-03-15 起 | 47 天 |
密钥算法同样需要取舍:
| 对比项 | RSA 2048 | ECDSA P-256 |
|---|---|---|
| 生成命令 | genpkey -algorithm RSA |
ecparam -name prime256v1 |
| 握手体积 | 较大 | 约为 RSA 的 1/6 |
| 兼容性 | 全平台无死角 | 需 TLS 1.2+ 与较新客户端 |
| 建议 | 存量系统默认首选 | 移动端、高并发站点优先 |
实践建议:面向公众的主站优先 ECDSA,同时保留一张 RSA 证书作为旧客户端回退;有效期不足 100 天的时代,任何证书都不应依赖手工续期。
六、常见错误排查:从真实报错到修复命令
下面这些报错覆盖了九成以上的 HTTPS 配置故障,按报错原文对照即可定位:
| 报错原文 | 根因 | 修复 |
|---|---|---|
SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:X509_check_private_key:key values mismatch) |
私钥与证书不配对 | 比对 modulus 或公钥指纹后替换 |
curl: (60) SSL certificate problem: unable to get local issuer certificate |
缺中间证书 | 拼接 fullchain.pem |
PEM_read_bio_X509_AUX() failed |
文件是 DER 格式或含 BOM/CRLF | 转 PEM 并去掉换行符 |
SSL_ERROR_NO_CYPHER_OVERLAP |
客户端只支持 TLS 1.0,服务端已禁用 | 评估是否放行旧协议或升级客户端 |
certificate has expired or is not yet valid |
证书过期或服务器时钟漂移 | 续期 / 开启 NTP 同步 |
AH01909: RSA certificate configured for example.com:443 does not include an ID which matches the server name |
ServerName 不在 SAN 中 | 重新签发含该域名的证书 |
私钥不匹配的判定命令(RSA 用 modulus,ECDSA 用公钥指纹):
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
# ECDSA 证书改用:
openssl x509 -in fullchain.pem -noout -pubkey | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5
DER 转 PEM 与换行符清理:
openssl x509 -in cert.crt -inform DER -out cert.pem -outform PEM
sed -i 's/r$//' fullchain.pem
时间漂移导致的 not yet valid 常出现在容器或虚拟机休眠后:timedatectl set-ntp true,或 chronyc makestep 强制校时。混合内容则看浏览器 Console 的 Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure resource,把资源地址改成协议相对写法 //cdn.example.com/a.js 或直接 https。
七、效果验证:从命令行到自动化巡检
配置完成后不要只看浏览器锁标,命令行验证更可靠。第一条命令验证链与协议版本,第二条验证证书校验结果码:
openssl s_client -connect example.com:443 -servername example.com -verify_return_error
-CAfile /etc/ssl/certs/ca-certificates.crt </dev/null 2>/dev/null |
openssl x509 -noout -subject -issuer -dates
curl -s -o /dev/null -w '%{http_code} %{ssl_verify_result} %{time_total}n' https://example.com
# 期望输出:200 0 0.123,第二列为 0 表示证书校验通过
再确认三件事:80 端口是否 301、HSTS 是否下发、TLS 1.0 是否已拒绝。
curl -sI http://example.com | head -3
curl -sI https://example.com | grep -i strict-transport-security
openssl s_client -connect example.com:443 -tls1 </dev/null 2>&1 | grep -i 'handshake failure'
深度扫描可以用 testssl.sh --fast https://example.com 或 SSL Labs 在线评级,目标是不低于 A、无弱套件、无心脏滴血类漏洞。最后把到期巡检做成定时任务,不要依赖记忆:
#!/bin/bash
DOMAIN=example.com
END=$(openssl s_client -connect ${DOMAIN}:443 -servername ${DOMAIN} </dev/null 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
LEFT=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
[ "$LEFT" -lt 21 ] && echo "WARN ${DOMAIN} 证书剩余 ${LEFT} 天" | mail -s 'cert alert' ops@example.com
使用 ACME 自动续期时,务必先演练再上线:certbot renew --dry-run,并检查定时器状态 systemctl list-timers | grep certbot。同时配置部署钩子 --deploy-hook 'systemctl reload nginx',避免出现“续期成功、线上仍是旧证书”的经典事故。
常见问题
没有。加密强度由密钥长度与 TLS 版本决定,与价格无关。DV、OV、EV 的差别只在身份核验深度、组织信息展示和赔付条款,握手过程完全一致。付费证书的价值主要在有效期、技术支持与商业保障。
按顺序查三点:用 openssl s_client 看是否返回完整证书链;确认证书 SAN 包含当前访问域名(含 www 与裸域);打开 F12 看 Console 是否有 Mixed Content 警告,把页面内 http:// 资源改成 // 或 https://。
能,但两个域名都必须写进 SAN。只写 CN=example.com 的证书在访问 www.example.com 时会报 ERR_CERT_COMMON_NAME_INVALID。通配符 *.example.com 只覆盖一级子域,不覆盖裸域,通常仍需额外添加裸域 SAN。
不需要重启,执行 nginx -t && nginx -s reload 平滑重载即可生效,连接不会中断。使用 certbot 时加 –deploy-hook ‘systemctl reload nginx’ 可自动完成,避免续期成功但线上仍用旧证书的典型事故。
多半是证书链不完整。桌面浏览器会通过证书里的 AIA 地址自动下载中间证书补链,而 Java 信任库、OkHttp、微信内置浏览器不会。把中间证书拼进 fullchain.pem 后重载即可解决。
不是必须,但强烈建议。TLS 1.3 把握手压缩到 1-RTT(会话恢复可 0-RTT),并移除了 RSA 密钥交换等弱套件。保留 TLS 1.2 兼容旧客户端即可,但务必关闭 TLS 1.0/1.1,否则 Chrome 会标记连接不安全。