跳到主要内容
ssl证书按装

HTTPS 配置与 SSL 证书安装全流程:从 CSR 生成到 Nginx/Apache 部署、混合内容修复与排错

HTTPS 配置与 SSL 证书安装全流程:从 CSR 生成到 Nginx/Apache 部署、混合内容修复与排错 — HTTPS 配置与 SSL 证书安装全流程:从 CSR 生成到 Nginx/Apache 部署、混合内容修复与排错

一、问题背景与根因:SSL/TLS 到底解决了什么

SSL/TLS 协议提供的三项核心服务至今没变:身份认证——浏览器通过证书链验证「你连上的确实是 example.com」,防止 DNS 劫持与中间人仿冒;数据加密——握手阶段用非对称算法协商会话密钥,之后用 AES-128-GCM 或 ChaCha20-Poly1305 加密业务数据,避免链路被旁路嗅探;完整性保护——AEAD 算法自带校验,被篡改的报文会被直接丢弃。

但线上 90% 的「HTTPS 打不开 / 地址栏红叉 / 页面样式错乱」并不是协议本身的问题,根因集中在四类:①证书链不完整,服务器只下发了站点证书而没带中间 CA,Android、Java、curl 直接报错,桌面 Chrome 却可能正常;②证书与私钥不匹配,nginx 直接启动失败;③页面内混用 http:// 资源,触发浏览器 Mixed Content 拦截,表现就是「页面错乱」;④证书过期。

必须注意时效性变化:自 2020 年 9 月 1 日起,CA/Browser Forum 规定所有公共信任证书最长有效期不得超过 398 天,Let’s Encrypt 免费证书固定为 90 天。同时苹果 ATS、微信小程序、支付宝开放平台均已强制 HTTPS。也就是说,证书不再是「装一次管三年」,必须建立自动续期与到期监控机制。

二、证书选型与申请:DV / OV / EV 与 398 天规则

按验证等级分三类,签发时效如下:

  • DV(域名验证):仅验证域名控制权(DNS TXT 或 HTTP 文件校验),一般 10 分钟内签发,适合博客、API、内部系统。
  • OV(组织验证):需提交营业执照,CA 人工审核,约 1-2 个工作日,证书详情中显示公司名称,适合企业官网、SaaS 平台。
  • EV(扩展验证):在 OV 基础上增加电话回呼、DUNS 编号或第三方信用库(如百度信用)留存的座机号码核验,同样 1-2 个工作日,适合金融、支付、电商。

除等级外还要看三个参数:

维度 选项 说明
覆盖范围 单域名 / 通配符 / 多域名 SAN 通配符 *.example.com 只覆盖一级子域,不含 a.b.example.com;SAN 证书通常赠送 3-5 个域名
密钥算法 RSA 2048 / ECC P-256 RSA 兼容性最好;ECC 握手更快、CPU 开销更低,但 Android 4.x、Windows XP 不支持
有效期 ≤398 天 / Let’s Encrypt 90 天 超过 398 天的公共证书会被主流浏览器拒绝信任

申请时向 CA 提交的就是下一步生成的 CSR 文件,私钥永远不要上传给任何人,包括代维服务商。

三、生成私钥与 CSR:可直接执行的 OpenSSL 命令

在服务器上生成 2048 位 RSA 私钥并设置权限:

mkdir -p /etc/nginx/ssl && cd /etc/nginx/ssl
openssl genrsa -out example.com.key 2048
chmod 600 example.com.key

生成 CSR,关键是把所有需要用到的域名写进 SAN,否则会报「证书名称不匹配」:

openssl req -new -sha256 -key example.com.key -out example.com.csr 
  -subj "/C=CN/ST=Guangdong/L=Shenzhen/O=Example Co., Ltd./CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com,DNS:api.example.com"

如果 CA 要求 ECC 证书,改用 P-256 曲线:

openssl ecparam -genkey -name prime256v1 -out example.com.ecc.key
openssl req -new -sha256 -key example.com.ecc.key -out example.com.ecc.csr 
  -subj "/CN=example.com" -addext "subjectAltName=DNS:example.com,DNS:www.example.com"

提交前务必自检,确认 SAN 与密钥匹配:

openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
openssl req -in example.com.csr -noout -verify -key example.com.key

拿到 CA 签发的证书后,先做一次密钥匹配校验,可避免后面 nginx 启动失败:

openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5

两个 MD5 值必须完全一致。ECC 证书则用 openssl ec -noout -text -in example.com.ecc.key | grep pub 与证书公钥比对。

四、部署配置示例:Nginx 与 Apache 完整片段

先把证书拼成完整链文件:站点证书在前,中间 CA 在后,根证书可省略:

cat example.com.crt intermediate.crt > example.com.fullchain.pem
openssl verify -CAfile intermediate.crt example.com.fullchain.pem

Nginx 配置(含 80 跳转、TLS1.2/1.3、HSTS、OCSP Stapling):

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}
server {
    listen 443 ssl http2;
    server_name example.com www.example.com;
    ssl_certificate     /etc/nginx/ssl/example.com.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/intermediate.crt;
    resolver 223.5.5.5 119.29.29.29 valid=300s;
    add_header Strict-Transport-Security "max-age=31536000" always;
    root /var/www/html;
}

Apache 2.4 配置:

<VirtualHost *:80>
    ServerName example.com
    Redirect permanent / https://example.com/
</VirtualHost>
<VirtualHost *:443>
    ServerName example.com
    SSLEngine on
    SSLCertificateFile    /etc/httpd/ssl/example.com.fullchain.pem
    SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
    # Apache 2.4.8 之前需单独指定链文件
    # SSLCertificateChainFile /etc/httpd/ssl/intermediate.crt
    SSLProtocol           -all +TLSv1.2 +TLSv1.3
    SSLCipherSuite        ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256
    Header always set Strict-Transport-Security "max-age=31536000"
    DocumentRoot /var/www/html
</VirtualHost>

改完执行 nginx -t && systemctl reload nginx 或 apachectl configtest && systemctl reload httpd。首次上线不要急着加 includeSubDomains 与 preload,否则子域未全站 HTTPS 时会把用户锁在 HSTS 里。

五、混合内容(页面错乱)的定位与修复

原文提到的「配置后 https 页面错乱」几乎都是混合内容:主文档是 HTTPS,但 CSS、JS、图片仍走 http://,浏览器按「可升级/被拦截」策略处理后,样式表加载失败,页面自然花掉。按 F12 打开 Console,会看到明确报错:

Mixed Content: The page at 'https://example.com/' was loaded over HTTPS,
but requested an insecure stylesheet 'http://example.com/css/app.css'.
This request has been blocked; the content must be served over HTTPS.

定位命令——直接在页面源码里搜出所有 http 资源:

curl -s https://example.com/ | grep -oE 'http://[^"''' ]+' | sort -u

三类修复方式:

  • 改代码/模板:把 http:// 换成 https:// 或协议相对写法 //example.com/x.js,这是根治方案。
  • 批量改库:WordPress 用 WP-CLI wp search-replace 'http://example.com' 'https://example.com' --skip-columns=guid;裸 SQL 参考 UPDATE wp_options SET option_value = REPLACE(option_value,'http://example.com','https://example.com') WHERE option_name IN ('home','siteurl');
  • 兜底升级:加 CSP 让浏览器自动把 http 请求升级为 https,但第三方不支持 HTTPS 的域名仍会失败:add_header Content-Security-Policy "upgrade-insecure-requests" always;

注意:这属于程序侧改造,不是证书配置错误,代维方通常只负责证书与 Web 服务器层。

六、常见报错排查对照表

以下都是线上真实出现的报错,按提示对号入座:

  • NET::ERR_CERT_AUTHORITY_INVALID:证书链不完整。执行 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null,正常应返回站点证书加 1-2 张中间 CA;只有 1 张就是漏拼链。
  • curl: (60) SSL certificate problem: unable to get local issuer certificate:同上,把 ca-bundle 拼进 fullchain 即可。
  • nginx: [emerg] SSL_CTX_use_PrivateKey_file("/etc/nginx/ssl/a.key") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch):私钥与证书不配套,用第三节的 modulus 命令比对。
  • nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line):文件不是 PEM 格式,可能上传了 DER、.pfx 或空文件,用 file example.com.crt 确认。
  • NET::ERR_CERT_COMMON_NAME_INVALID / SSL_ERROR_BAD_CERT_DOMAIN:CSR 的 SAN 没写全,缺 www 或某个子域,只能重签。
  • NET::ERR_CERT_DATE_INVALID:证书过期,或服务器系统时间偏差过大,用 timedatectl 检查并开启 NTP。
  • ERR_SSL_PROTOCOL_ERROR:用 https 访问了 80 端口,或服务端只允许 TLS1.3 而客户端过旧。
  • ERR_SSL_VERSION_OR_CIPHER_MISMATCH:listen 后漏写 ssl,或 cipher 列表不含客户端支持的套件。

若曾误开 HSTS 导致无法回退,在 Chrome 打开 chrome://net-internals/#hsts,在 Delete domain 中输入域名删除。

七、效果验证与到期监控

部署完按顺序验证四件事:协议与证书、跳转、链完整性、到期时间。

# 1. 查看协议版本、加密套件与证书信息
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates

# 2. HTTP 是否 301 到 HTTPS
curl -sI http://example.com | grep -i -E "HTTP/|location"

# 3. OCSP Stapling 是否生效(应看到 Response Status: successful)
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null | grep -A1 "OCSP Response Status"

# 4. 30 天内是否到期,返回 1 表示即将过期
openssl x509 -in /etc/nginx/ssl/example.com.fullchain.pem -noout -checkend 2592000; echo "exit=$?"

Let’s Encrypt 用户务必验证自动续期:certbot renew --dry-run;certbot 已自带 systemd timer,可用 systemctl list-timers | grep certbot 确认。最后把到期检查写进监控脚本,每天跑一次,过期前 15 天告警:

#!/bin/bash
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 "证书剩余 ${DAYS} 天,需续期" | mail -s "SSL 告警" ops@example.com

浏览器侧再跑一次 SSL Labs(ssllabs.com/ssltest),A/A+ 评级即代表协议版本、套件强度、HSTS、证书链均达标。

常见问题

公共信任证书最长有效期 398 天(CA/Browser Forum 规定,2020 年 9 月起生效),超过部分浏览器不信任。Let’s Encrypt 免费证书固定 90 天,建议用 certbot 配置自动续期,不要手工续。


一般不是。这属于混合内容:页面里的 CSS、JS、图片仍用 http:// 引用,被浏览器拦截。按 F12 在 Console 查看 Mixed Content 报错,把资源地址改成 https:// 或加 CSP upgrade-insecure-requests 即可。


典型是证书链不完整。桌面 Chrome 会自动补全中间证书,Android、Java、curl 不会。执行 openssl s_client -showcerts 检查,把站点证书与中间 CA 拼成 fullchain.pem 后重新加载。


*.example.com 只覆盖一级子域,如 a.example.com、b.example.com,不覆盖 a.b.example.com,也不包含裸域 example.com。多级子域需要多张证书或改用 SAN 多域名证书。


没有区别。三者握手加密强度相同,差别只在身份验证深度:DV 只验域名,10 分钟签发;OV 需营业执照,1-2 个工作日;EV 额外电话或 DUNS 核验,适合金融支付场景。

内容审核

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