跳到主要内容
ssl证书按装

网站 HTTPS 证书配置全流程:CSR 生成、Nginx/Tomcat 部署、证书链修复与排错实战

网站 HTTPS 证书配置全流程:CSR 生成、Nginx/Tomcat 部署、证书链修复与排错实战 — 网站 HTTPS 证书配置全流程:CSR 生成、Nginx/Tomcat 部署、证书链修复与排错实战

问题背景与根因:为什么“证书装好了”仍然不是 HTTPS

大量站点在完成证书安装后仍会出现三类现象:浏览器地址栏没有锁形图标、移动端 APP 或微信小程序请求报“证书无效”、部分接口偶发握手失败。根因通常不在证书本身,而在以下五个环节。

  • 证书链不完整:只部署了站点证书(server.crt),漏掉中间证书(intermediate.crt)。桌面 Chrome 会通过 AIA 自动补链,所以“电脑上正常”;而 Android WebView、微信小程序容器、Java/Go 客户端严格校验,直接失败。
  • 域名不匹配:证书 CN/SAN 只写了 example.com,用户访问 www.example.com 或 m.example.com 时报 NET::ERR_CERT_COMMON_NAME_INVALID。
  • 混合内容:页面本身是 https,但图片、JS、CSS 仍用 http:// 绝对地址,浏览器降级为“不安全”。
  • 协议与套件过时:服务端仍开启 TLS 1.0/1.1 或只配 RSA 密钥交换套件,被现代客户端拒绝,报 SSL_ERROR_NO_CYPHER_OVERLAP。
  • 反向代理头丢失:Nginx 或云负载均衡终止 TLS 后,后端应用读不到 X-Forwarded-Proto,生成 http:// 跳转链接,形成 301 死循环。

另外必须建立有效期意识:公共信任 TLS 证书单次签发最长 398 天(2020 年 9 月起生效),Let’s Encrypt 免费证书为 90 天;CA/B 论坛已确定自 2026 年 3 月起缩短至 200 天并继续递减。任何“一次配置、长期不管”的做法都会在续期日集中爆雷,配置之初就应把自动续期与到期巡检一并设计进去。

前置准备:证书选型与 CSR 生成

证书申请的第一步是生成密钥对与 CSR。以下命令在 Linux/macOS 任意目录可直接执行,不依赖任何控制面板。

# 1. 生成 2048 位 RSA 私钥 + CSR,同时写入 SAN(现代浏览器只认 SAN,不认 CN)
openssl req -new -newkey rsa:2048 -nodes 
  -keyout example.com.key -out example.com.csr 
  -subj "/C=CN/ST=Beijing/L=Beijing/O=Example Tech/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com,DNS:m.example.com"

# 2. ECDSA 方案(握手更快、密钥更短,Nginx 1.11+/OpenSSL 1.0.2+ 支持)
openssl ecparam -genkey -name prime256v1 -out example.com.ec.key
openssl req -new -key example.com.ec.key -out example.com.ec.csr 
  -subj "/CN=example.com" -addext "subjectAltName=DNS:example.com,DNS:www.example.com"

# 3. 校验 CSR 与私钥是否配对(两个 md5 必须完全一致)
openssl req -in example.com.csr -noout -modulus | openssl md5
openssl rsa -in example.com.key -noout -modulus | openssl md5

# 4. 私钥权限收敛
chmod 600 example.com.key && chown root:root example.com.key

选型建议:DV 单域名适合个人站与测试环境;DV 通配符适合二级子域多、增长快的业务;OV/EV 适合金融、政企、需要组织实名展示与合规审计的场景。注意通配符 *.example.com 只覆盖一级子域,不覆盖裸域 example.com,也不覆盖 a.b.example.com,裸域必须单独写进 SAN。CSR 提交后由 CA 签发:DV 通常 10 分钟内完成,OV/EV 需 1-3 个工作日人工核验。无论选择哪种,私钥都不应提交到 Git 仓库,建议放在仅 root 可读的目录并纳入备份。

实操一:Nginx 配置 HTTPS 与 HTTP/2 跳转

Nginx 是最常见的 TLS 终止点。以下配置适用于 Nginx 1.25.1 及以上(http2 已是独立指令),旧版本请把 http2 写在 listen 后面。

# /etc/nginx/conf.d/example.conf
server {
    listen 80;
    server_name example.com www.example.com;
    location /.well-known/acme-challenge/ { root /var/www/certbot; }  # 保留 ACME 验证通道
    location / { return 301 https://$host$request_uri; }
}

server {
    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:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
    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/chain.pem;
    resolver 223.5.5.5 119.29.29.29 valid=300s;

    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
    add_header X-Content-Type-Options nosniff always;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;   # 关键:否则后端生成 http 链接
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

改完先执行 nginx -t 再 systemctl reload nginx,不要用 restart 造成连接中断。HSTS 头建议先用 max-age=300 观察一周,确认全部子域都已支持 HTTPS 后再拉到 31536000,否则一旦有子域仍是 HTTP,用户将无法回退访问。另外 ssl_session_tickets off 会略微增加握手开销,但可避免 ticket key 长期不变带来的前向安全性问题,公网业务建议关闭。

实操二:Apache、Tomcat 与云负载均衡部署

Apache 2.4.8 之后不再需要单独指定 SSLCertificateChainFile,只要把中间证书拼进 fullchain.pem 即可。

<VirtualHost *:443>
    SSLEngine on
    SSLCertificateFile      /etc/httpd/ssl/fullchain.pem
    SSLCertificateKeyFile   /etc/httpd/ssl/example.com.key
    SSLProtocol             -all +TLSv1.2 +TLSv1.3
    SSLCipherSuite          ECDHE+AESGCM:ECDHE+CHACHA20
    SSLHonorCipherOrder     off
    Protocols               h2 http/1.1
    Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>

Tomcat 只认 JKS/PKCS12,需要先转换再挂载:

openssl pkcs12 -export -in fullchain.pem -inkey example.com.key 
  -name tomcat -out example.p12 -passout pass:changeit

<!-- server.xml -->
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
  SSLEnabled="true" maxThreads="200" scheme="https" secure="true" SSLProtocol="TLSv1.2+TLSv1.3">
  <SSLHostConfig>
    <Certificate certificateKeystoreFile="/opt/tomcat/conf/example.p12"
      certificateKeystorePassword="changeit" certificateKeystoreType="PKCS12"/>
  </SSLHostConfig>
</Connector>

如果 TLS 在云负载均衡(SLB/CLB/ALB)或 CDN 上终止,证书只需上传到云平台,后端服务器可继续用 HTTP,但必须在应用层开启“信任代理头”,例如 Spring Boot 设置 server.forward-headers-strategy=framework。微信小程序与 iOS/Android APP 的硬性要求是:公共 CA 签发、完整证书链、TLS 1.2 及以上、域名完成 ICP 备案,自签名证书一律拒绝。证书安装与平台、操作系统、运行环境版本无关,但配置项名称与文件路径差异很大,跨平台迁移时务必重新验证。

证书链拼接:最常见的“证书不受信任”根因

证书链问题占了 HTTPS 故障的一半以上。签发机构返回的压缩包通常包含三个文件:站点证书、中间证书、根证书。正确拼法是站点证书在前,中间证书在后,根证书绝对不要放进去——根证书已在客户端系统信任库中,放进去只会增大握手包并可能触发部分客户端的链校验告警。

# 拼接顺序不能颠倒
cat example.com.crt intermediate.crt > fullchain.pem
cp intermediate.crt chain.pem

# 本地验证链是否完整(-untrusted 指定中间证书)
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt 
  -untrusted chain.pem fullchain.pem
# 期望输出:fullchain.pem: OK

# 查看线上实际下发的链(-showcerts 打印全部证书)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null

判断链是否完整最快的方法:openssl s_client ... | grep -c "BEGIN CERTIFICATE",正常应返回 2(站点证书 + 1 张中间证书)或 3(中间证书存在交叉签名时)。返回 1 就说明缺中间证书,这正是“电脑正常、手机报错”的典型特征。另外 ssl_stapling on 依赖 ssl_trusted_certificate 指向 chain.pem,若指向错误文件,OCSP Stapling 会静默失效,表现为 openssl s_client -status 返回 “no response sent”,浏览器首屏握手会明显变慢。

配置对比:证书类型与部署方式选型表

选型与部署方式的取舍直接决定续期成本和故障率,下面两张表可作为决策依据。

证书类型 验证方式 浏览器表现 单次有效期 参考价格 适用场景
DV 单域名 DNS 或文件验证 锁形图标 ≤398 天 免费(Let’s Encrypt 90 天)~数百元 个人站、测试环境、内部系统
DV 通配符 DNS 验证 锁形图标 ≤398 天 数百~数千元 二级子域多、频繁新增业务
DV 多域名 SAN 逐域名验证 锁形图标 ≤398 天 按域名数递增 多品牌域名、API 网关
OV 企业型 域名 + 组织实名核验 锁形图标,证书详情可见组织信息 ≤398 天 千元级 政企、B2B 平台、招投标要求
EV 增强型 严格组织与法律存在核验 主流浏览器已取消绿色地址栏,仅详情可见 ≤398 天 数千元 金融、支付、对公业务
部署方式 配置复杂度 续期自动化 适用规模
Nginx/Apache 手工部署 中,需维护 fullchain 与 reload 需自建 cron + certbot 单机、少量域名
Caddy / Traefik 低,自动申请与续期 内置 ACME 容器化、中小集群
云负载均衡 / CDN 托管 低,控制台上传 平台提醒,需手动或调 API 更新 多地域、大流量
证书托管运维服务 最低,含安装、巡检、到期提醒 服务商代维,一对一响应 无专职运维团队、APP/小程序后端

需要特别说明:EV 证书的绿色地址栏自 Chrome 77、Firefox 70 起已取消,不要再被“买 EV 就显示公司名”的旧宣传误导;OV/EV 的真实价值在于组织身份核验与合规审计,而非 UI 差异。对多数业务而言,DV 通配符 + 自动化续期是性价比最高的组合。

常见错误排查:真实报错与修复命令

下面列出线上最高频的八条报错,以及可直接执行的定位动作。

报错信息 根因 修复方式
nginx: [emerg] SSL_CTX_use_PrivateKey_file(…) failed (SSL: error:0B080074:…key values mismatch) 证书与私钥不配对 比对 openssl x509 -noout -modulus -in fullchain.pem | openssl md5 与私钥 modulus
curl: (60) SSL certificate problem: unable to get local issuer certificate 缺中间证书 重新拼接 fullchain.pem 后 reload
NET::ERR_CERT_COMMON_NAME_INVALID 访问域名不在 SAN 列表中 重签证书补全 SAN,或对齐 server_name
ERR_SSL_VERSION_OR_CIPHER_MISMATCH 客户端与服务端无交集协议/套件 检查 ssl_protocols,不要只保留 TLSv1.3
Java: PKIX path building failed … SunCertPathBuilderException JDK 信任库缺根证书或链不完整 补中间证书;必要时 keytool -import 到 cacerts
Go: x509: certificate has expired or is not yet valid 证书过期或服务器时间偏差 chronyd 校时,并立即续期部署
AH01909: RSA certificate configured for example.com:443 does NOT include an ID which matches the server name 虚拟主机与证书域名不匹配 对齐 ServerName 与证书 SAN
ERR_TOO_MANY_REDIRECTS 代理未传 X-Forwarded-Proto,后端再次跳转 补 proxy_set_header 或在应用层信任代理头

三个通用排查动作:一是 openssl s_client -connect 域名:443 -servername 域名 -tls1_2 </dev/null,强制指定协议版本可快速判断是否协议不匹配;二是 curl -vI https://域名 观察握手与证书链下发;三是 journalctl -u nginx -n 50 或 tail -f /var/log/nginx/error.log 抓实时错误。若报错只出现在特定客户端,优先怀疑证书链与 TLS 版本,而不是证书本身无效。

效果验证:四层检查与到期监控脚本

部署完成后必须做完整验证,缺一层都可能在真实用户侧暴露问题。

# 1. 基础连通与状态码
curl -sI https://example.com | head -5

# 2. 证书主体、签发者、有效期、SAN
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates -ext subjectAltName

# 3. 链完整性(应返回 2 或 3)
echo | openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null 
  | grep -c "BEGIN CERTIFICATE"

# 4. 协议矩阵(TLS 1.0/1.1 应失败)
for v in tls1 tls1_1 tls1_2 tls1_3; do
  echo -n "$v: "; echo | openssl s_client -connect example.com:443 -servername example.com -$v 2>&1 
    | grep -q "Cipher is" && echo OK || echo FAIL
done

# 5. 混合内容扫描
curl -s https://example.com | grep -oE 'src="http://[^"]+"|href="http://[^"]+"' | sort -u

# 6. HSTS 与 80 端口跳转
curl -sI http://example.com | grep -iE "location|strict-transport"

再补一层到期监控,剩余天数小于 21 天即告警:

END=$(echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -enddate | cut -d= -f2)
echo "剩余 $(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 )) 天"

最后用 SSL Labs 复核评分,目标 A 及以上,重点看 Certificate Chain、Protocol Support、HSTS 三项是否全绿。若微信小程序仍报错,用微信开发者工具的“网络”面板查看具体失败环节,绝大多数是证书链不完整或请求域名与证书 SAN 不一致。APP 侧则建议在发版前用真机分别跑一次 iOS 与 Android 的登录链路,避免因证书链问题只在特定系统版本上暴露。

常见问题

目前单次签发最长 398 天(2020 年 9 月起生效),Let’s Encrypt 免费证书为 90 天。CA/B 论坛已确定自 2026 年 3 月起缩短至 200 天,之后继续递减,因此务必用 ACME 或服务商代维做自动续期,不要依赖人工记忆。


九成是证书链不完整。桌面浏览器会通过 AIA 自动补全中间证书,而 Android WebView、小程序容器、Java 与 Go 客户端严格校验整条链。把中间证书合并进 fullchain.pem(顺序为站点证书→中间证书,不含根证书)后重新加载即可。


只覆盖一级子域,如 www.example.com、m.example.com,不覆盖 a.b.example.com,也不覆盖裸域 example.com。裸域必须额外写进 SAN 或单独签发,否则访问裸域仍会报 NET::ERR_CERT_COMMON_NAME_INVALID。


需要保留。80 端口用于 301 跳转、ACME http-01 验证以及用户直接输入域名时的访问。建议只放行 /.well-known/acme-challenge/ 目录,其余路径全部 301 到 HTTPS,并确保跳转不带多余路径参数。


立即在 CA 控制台吊销证书(并确认 OCSP/CRL 生效),重新生成密钥对与 CSR 签发新证书,替换部署后清理旧文件与备份。同时排查访问日志与主机入侵痕迹。私钥务必 chmod 600、不入 Git、不进镜像层。


加密强度与浏览器兼容性没有差别,都是 DV 域名验证。差异在有效期(90 天 vs 最长 398 天)、赔付条款、OV/EV 组织信息展示、技术支持响应,以及通配符与多域名组合的管理便利性。合规审计场景通常要求 OV 及以上。

内容审核

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