跳到主要内容
ssl证书按装

HTTPS 配置与 SSL 证书安装配置全流程:Nginx/Apache 实操、真实报错排查与效果验证

HTTPS 配置与 SSL 证书安装配置全流程:Nginx/Apache 实操、真实报错排查与效果验证 — 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 生效。

内容审核

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