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 配置:
- SSL证书申请 · SSL证书购买 · SSL证书安装配置
- SSL域名证书申请 · 小程序证书 · 国外SSL证书
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
<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 核验,适合金融支付场景。