HTTPS 配置与 SSL 证书安装配置全流程:Nginx/Apache 实操、真实报错排查与效果验证
问题背景与根因:HTTPS 到底解决了什么
SSL/TLS 协议提供三项核心服务:一是认证服务器(可选认证客户端)身份,确保数据发送到正确的服务器;二是加密传输数据,防止中途被窃取;三是通过 MAC/AEAD 校验维护数据完整性,确保传输过程中不被篡改。HTTP 明文传输时,公共 Wi-Fi、运营商链路、代理节点都能读取 Cookie、表单和 Token,也能注入广告甚至整站镜像。
大量「HTTPS 配好了但打不开、报错」的案例,根因集中在四类:① 只部署了服务器证书,没带中间证书,导致 Android 旧版本、Java 客户端、小程序报 unable to get local issuer certificate;② 证书 CN/SAN 与访问域名不一致;③ 页面里硬编码 http:// 资源造成混合内容;④ 协议与加密套件过旧(仍开 TLSv1.0/1.1、RC4、3DES),被现代浏览器直接拒绝握手。
动手前先做一次基线探测,明确当前状态:
# 查看对端证书链、协议版本、加密套件
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
# 只看协议与套件
openssl s_client -connect example.com:443 -servername example.com /dev/null | grep -E 'Protocol|Cipher'
# 检查是否强制跳转 HTTPS、是否支持 HTTP/2
curl -sI http://example.com | head -n 5
curl -sI --http2 https://example.com | head -n 1
参数说明:-servername 必须显式指定 SNI 主机名,否则多域名服务器会返回默认站点的证书,被误判为「域名不匹配」;-showcerts 输出完整证书链,用来确认是否缺中间证书。理想输出为 Protocol : TLSv1.3、Cipher : TLS_AES_256_GCM_SHA384。若返回 no peer certificate available,说明 443 端口没有配置证书,或连接到了非 TLS 端口。
第一步:生成 CSR 并申请证书(含有效期新规)
私钥必须在自己的服务器上生成,不要使用服务商代生成后用邮件发送的私钥。RSA 2048 位兼容性最好;ECC P-256 密钥更小、握手更快,在同等安全强度下性能更优:
# RSA 2048 + SAN(OpenSSL 1.1.1 及以上支持 -addext)
openssl req -new -newkey rsa:2048 -nodes
-keyout /etc/nginx/ssl/example.com.key
-out example.com.csr
-subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Tech Co.,Ltd/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
# ECC P-256
openssl ecparam -genkey -name prime256v1 -out example.com.key
openssl req -new -key example.com.key -out example.com.csr
-subj '/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
chmod 600 /etc/nginx/ssl/example.com.key
关键点:-nodes 表示私钥不加密存储,否则 Nginx 每次启动都要交互输入密码,reload 会直接失败;CN 已不是唯一校验项,现代浏览器只认 SAN,所以 subjectAltName 必须把所有要用的域名、泛域名写全。签发前自检 CSR:
openssl req -in example.com.csr -noout -text | grep -A2 'Subject Alternative Name'
有效期规则需要更新认知:受浏览器信任的公网 TLS 证书,单张签发有效期上限为 398 天(CA/Browser Forum 规定,Apple、Chrome 对超期证书直接判为不合规),早已不是「一次配置管一年以上」;Let’s Encrypt 免费证书固定 90 天,必须在到期前完成续期。因此部署时就要把自动续期一起做掉。DV 证书通常 10 分钟内通过 DNS/文件验证即签发;OV/EV 需 1–2 个工作日核验工商信息并完成电话回拨。EV 证书在主流浏览器已取消绿色地址栏,仅为「绿锁」多付费用意义不大。
第二步:Nginx 完整配置与上线
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-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384: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;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
add_header X-Content-Type-Options nosniff always;
add_header X-Frame-Options SAMEORIGIN always;
root /var/www/html;
index index.html;
}
参数说明:fullchain.pem 必须是「服务器证书在前、中间证书在后」的拼接文件,顺序颠倒会导致部分客户端握手失败;ssl_prefer_server_ciphers off 是 TLS 1.3 时代的主流做法,由客户端选择更优套件;ssl_session_tickets off 牺牲少量性能换取前向安全性。上线流程:
cp /etc/nginx/conf.d/example.com.conf /etc/nginx/conf.d/example.com.conf.bak
nginx -t && nginx -s reload
# 失败时回滚
cp /etc/nginx/conf.d/example.com.conf.bak /etc/nginx/conf.d/example.com.conf && nginx -s reload
若站点已在线,先加 max-age=300 试运行,确认全站 HTTPS 无异常后再改成一年(31536000)。HSTS 一旦下发,浏览器在有效期内会拒绝 HTTP 访问,回退成本很高。
第三步:Apache / Tomcat / IIS 配置示例
Apache 2.4:
<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,中间证书写入 fullchain.pem 即可
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256
SSLHonorCipherOrder off
Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>
Tomcat 需要 PKCS12 或 JKS 密钥库:
openssl pkcs12 -export -in fullchain.pem -inkey example.com.key
-out example.com.p12 -name tomcat -passout pass:changeit
keytool -importkeystore -srckeystore example.com.p12 -srcstoretype PKCS12
-destkeystore example.com.jks -deststoretype JKS -deststorepass changeit
<Connector port='8443' protocol='org.apache.coyote.http11.Http11NioProtocol'
SSLEnabled='true' scheme='https' secure='true' SSLProtocol='TLSv1.2+TLSv1.3'>
<SSLHostConfig>
<Certificate certificateKeystoreFile='/opt/tomcat/conf/example.com.jks'
certificateKeystorePassword='changeit' type='RSA'/>
</SSLHostConfig>
</Connector>
IIS:导入含私钥的 .pfx → 站点绑定 443 端口 → 勾选 SNI → 在「服务器证书」中确认中间证书已安装。pfx 生成命令:
openssl pkcs12 -export -out example.com.pfx -inkey example.com.key -in fullchain.pem -certfile chain.pem
IIS 的 pfx 必须包含完整证书链,否则客户端同样报 ERR_CERT_AUTHORITY_INVALID。
证书链、格式转换与私钥匹配校验
部署前必做三项校验,可以排除掉 80% 的「配置后打不开」问题。
# 1) 证书与私钥是否配对(两条命令输出的 md5 必须一致)
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
# 2) 查看 SAN、签发者与有效期
openssl x509 -noout -subject -issuer -dates -ext subjectAltName -in fullchain.pem
# 3) 证书链是否完整(应输出 2~3 段证书)
grep -c 'BEGIN CERTIFICATE' fullchain.pem
| 格式 | 常见扩展名 | 内容 | 典型用途 |
|---|---|---|---|
| PEM | .pem / .crt / .cer / .key | Base64 文本,-----BEGIN CERTIFICATE----- 开头 |
Nginx、Apache,最通用 |
| DER | .der / .cer | 二进制编码 | Java 导入、Windows 证书管理器 |
| PKCS#12 | .pfx / .p12 | 证书 + 私钥 + 证书链,带保护密码 | IIS、Tomcat、Java 应用 |
| JKS | .jks | Java KeyStore | Tomcat、WebLogic、老版本 Java |
| PKCS#7 | .p7b | 仅证书链,不含私钥 | 补装中间证书 |
合并证书链的正确做法是 cat example.com.crt intermediate.crt > fullchain.pem;根证书不要放进去,浏览器内置信任,放了反而增大握手体积。若服务商只提供 DER 二进制文件,先转换:openssl x509 -inform DER -in example.com.cer -out example.com.pem。私钥必须 chmod 600 且属主为 Nginx 运行用户,否则会报 Permission denied 或 cannot load certificate key。
证书类型与部署方式对比
选型先看验证等级,再看部署形态。下表为当前主流方案对比:
| 维度 | DV 域名型 | OV 企业型 | EV 扩展验证 |
|---|---|---|---|
| 验证内容 | 仅验证域名控制权(DNS TXT / HTTP 文件 / 邮箱) | 域名 + 工商信息人工核验 | 域名 + 更严格企业核验 + 电话回拨 |
| 签发时长 | 10 分钟内自动签发 | 1–2 个工作日 | 1–3 个工作日 |
| 单张有效期上限 | 398 天(Let’s Encrypt 为 90 天) | 398 天 | 398 天 |
| 浏览器表现 | 显示锁标志 | 锁标志,证书详情显示企业名称 | 与 OV 基本一致,绿色地址栏已取消 |
| 适用场景 | 博客、API、测试环境、中小企业官网 | 电商、金融、需展示主体身份的站点 | 强合规要求的机构 |
| 部署形态 | 关键配置 | 优点 | 局限 |
|---|---|---|---|
| 单域名证书 | SAN 只写一个域名 | 成本最低 | 每加一个域名都要新证书 |
| 多域名 SAN | subjectAltName=DNS:a,DNS:b |
一证多站,便于统一续期 | 域名变更需重新签发 |
| 泛域名 | DNS:*.example.com |
覆盖所有二级子域 | 不覆盖裸域与三级域 |
| 自动签发 | certbot / acme.sh | 90 天自动续期,零人工 | 需开放 80 端口或 DNS API 权限 |
泛域名要特别注意:*.example.com 不包含裸域 example.com,配置时必须写成 DNS:example.com,DNS:*.example.com,否则浏览器直接报 NET::ERR_CERT_COMMON_NAME_INVALID。
常见错误排查:真实报错与修复命令
| 报错信息 | 根因 | 修复 |
|---|---|---|
nginx: [emerg] PEM_read_bio_X509_AUX("/etc/nginx/ssl/fullchain.pem") failed (SSL: error:0909006C:PEM routines:get_name:no start line:Expecting: TRUSTED CERTIFICATE) |
文件是 DER 二进制,或下载的是占位/压缩文件 | openssl x509 -inform DER -in cert.cer -out fullchain.pem |
nginx: [emerg] SSL_CTX_use_PrivateKey("/etc/nginx/ssl/example.com.key") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) |
证书与私钥不是同一对(换了证书没换 key) | 用 modulus md5 比对后替换配对文件 |
curl: (60) SSL certificate problem: unable to get local issuer certificate / ERR_CERT_AUTHORITY_INVALID |
缺少中间证书 | cat server.crt intermediate.crt > fullchain.pem 后 reload |
NET::ERR_CERT_COMMON_NAME_INVALID / SSL_ERROR_BAD_CERT_DOMAIN |
SAN 不含当前域名,或 SNI 未命中默认站点 | 重签证书补全 SAN,每个站点单独配置 server_name 与证书 |
Mixed Content: The page at 'https://example.com/' was loaded over HTTPS, but requested an insecure element 'http://example.com/a.js'. This request has been blocked. |
页面硬编码 http:// 资源 | 改为 // 或 https://;或加 CSP upgrade-insecure-requests |
curl: (7) Failed to connect to example.com port 443: Connection refused |
安全组/防火墙未放行 443,或未监听 | 检查 listen 443 ssl 与安全组规则 |
SSL routines:ssl3_get_record:wrong version number |
用 http 访问 https 端口,或客户端协议过低 | 使用 https:// 并确认 ssl_protocols |
nginx: [warn] "ssl_stapling" ignored, issuer certificate not found |
证书链不完整或未配信任链 | 配置 ssl_trusted_certificate /etc/nginx/ssl/chain.pem |
混合内容的批量定位与修复:
# 抓取页面中所有 http:// 引用
grep -oE 'http://[^"''' ]+' index.html | sort -u
# Nginx 侧强制升级(注意会同时改写第三方外链,需回归测试)
add_header Content-Security-Policy 'upgrade-insecure-requests' always;
排查顺序建议固定为:先 nginx -t 确认配置语法 → 再 openssl s_client 确认链与协议 → 最后看浏览器控制台区分是证书问题还是混合内容问题。三者结论不一致时,以 openssl 输出为准。
效果验证与到期监控
配置完成后必须从外部验证,而不是只看浏览器有没有锁标志。
# 1) 校验证书链、协议、套件
openssl s_client -connect example.com:443 -servername example.com -CAfile /etc/ssl/certs/ca-certificates.crt /dev/null | grep -E 'Verify return code|Protocol|Cipher'
# 期望:Verify return code: 0 (ok)
# 2) 到期时间
openssl s_client -connect example.com:443 -servername example.com /dev/null | openssl x509 -noout -enddate
# 3) 跳转与 HSTS
curl -sI http://example.com | grep -Ei 'HTTP/|location'
curl -sI https://example.com | grep -Ei 'strict-transport-security|HTTP/2'
# 4) 验证结果码,0 表示通过
curl -s -o /dev/null -w '%{http_code} verify=%{ssl_verify_result} tls=%{time_appconnect}sn' https://example.com
到期监控脚本(cron 每天 9 点执行,剩余不足 15 天告警):
#!/bin/bash
DOMAIN='example.com'
END=$(openssl s_client -connect $DOMAIN:443 -servername $DOMAIN /dev/null | openssl x509 -noout -enddate | cut -d= -f2)
LEFT=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
[ $LEFT -lt 15 ] && echo "WARN: $DOMAIN 证书仅剩 $LEFT 天" | mail -s 'SSL 到期告警' ops@example.com
Let’s Encrypt 自动续期(90 天有效期,certbot 在剩余 30 天时自动续签):
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com
certbot renew --dry-run # 先演练,确认钩子可用
# /etc/letsencrypt/renewal-hooks/deploy/reload.sh
#!/bin/bash
nginx -t && nginx -s reload
最终验收标准:Verify return code: 0、HTTP 301 跳转到 HTTPS、存在 HSTS 响应头、HTTP/2 生效、页面无混合内容告警、第三方 SSL Labs 评级 A 及以上。
常见问题
受浏览器信任的公网证书单张有效期上限为 398 天(CA/B 论坛规定,Apple、Chrome 强制执行),Let’s Encrypt 免费证书固定 90 天。超过 398 天的证书会被判定不合规,必须提前规划自动续期。
不行。缺中间证书时桌面浏览器可能因缓存正常,但 Android、Java 客户端、微信小程序常报 unable to get local issuer certificate 或 ERR_CERT_AUTHORITY_INVALID。正确做法是把服务器证书与中间证书拼接成 fullchain.pem 再配置。
这是混合内容问题,不是证书配置错误。用浏览器控制台定位 http:// 资源,改成 // 或 https://;Nginx 可加 add_header Content-Security-Policy ‘upgrade-insecure-requests’ always; 强制升级,但需回归测试第三方外链。
分别计算模数并比对:openssl x509 -noout -modulus -in fullchain.pem | openssl md5 与 openssl rsa -noout -modulus -in example.com.key | openssl md5,两个结果必须一致,不一致说明二者不是同一对,需重新签发或找回配对私钥。
不能。*.example.com 只匹配一级子域(如 a.example.com),不匹配裸域 example.com 和三级域 a.b.example.com。申请时 SAN 要同时写 DNS:example.com,DNS:*.example.com。
通常是只替换了 .pem 没替换 .key。先用 modulus md5 比对确认配对关系,再把匹配的私钥一并替换,chmod 600 设置权限,最后执行 nginx -t && nginx -s reload 生效。