跳到主要内容
SSL 证书付费服务

HTTPS/SSL 网站证书安装与配置全流程实战:CSR 生成、Nginx/Apache/Tomcat 部署与真实报错排查

HTTPS/SSL 网站证书安装与配置全流程实战:CSR 生成、Nginx/Apache/Tomcat 部署与真实报错排查 — HTTPS/SSL 网站证书安装与配置全流程实战:CSR 生成、Nginx/Apache/Tomcat 部署与真实报错排查

问题背景与根因:证书“装上了”为什么浏览器仍提示不安全

很多站点在做 HTTPS 改造时都会卡在同一步:证书文件已经上传,nginx -t 也通过,浏览器却报 NET::ERR_CERT_AUTHORITY_INVALID,或者微信小程序、iOS ATS 请求直接失败。证书安装与证书配置从来不是“传个文件”这么简单,问题通常出在链、密钥、协议、域名覆盖和有效期规划这五个环节。

  • 证书链不完整:只部署了服务器证书(叶子证书),没有拼接中间证书。桌面浏览器会通过 AIA 自动补链,看起来“正常”,但 Android、Java 客户端、微信小程序的校验更严格,会直接判定证书不受信任。
  • 私钥与证书不匹配:CSR 生成过多次,上传时把 A 次申请的证书和 B 次生成的私钥配到了一起。
  • 协议与加密套件过旧:仍开放 TLSv1.0/1.1,或保留 RC4、3DES 套件,现代客户端直接拒绝握手。
  • 域名覆盖不符:证书只签了 example.com,实际访问 www.example.com;或者误以为通配符 *.example.com 能覆盖 a.b.example.com(通配符只匹配一级)。
  • 有效期规则变化:CA/B Forum 规定公开信任 TLS 证书单张最长有效期 398 天;Ballot SC-081 已确定进一步缩短为 2026-03-15 起 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天。Let’s Encrypt 免费证书固定 90 天。仍按“买三年省事”的思路规划,必然踩到过期告警。

排查第一步,先用一条命令把现状打印出来:

openssl x509 -noout -subject -issuer -dates -ext subjectAltName -in /etc/nginx/ssl/example.com.pem

输出中 notAfter 是到期时间,subjectAltName 是实际覆盖的域名列表,issuer 必须是中间 CA 而不是根 CA——如果 issuer 显示为根证书,说明你上传的链文件顺序搞反了,这是证书配置中最常见的一类错误。

申请前的准备:私钥、CSR 与域名规划

无论是向 CA 代购证书,还是用 Let’s Encrypt 免费签发,第一步都是本地生成私钥与 CSR(证书签名请求)。私钥永远不要发给任何人,CA 只需要 CSR。

# 1. 生成 2048 位 RSA 私钥 + CSR,并一次性写入 SAN
openssl req -new -newkey rsa:2048 -nodes 
  -keyout example.com.key 
  -out example.com.csr 
  -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Co., Ltd./CN=example.com' 
  -addext 'subjectAltName=DNS:example.com,DNS:www.example.com,DNS:api.example.com'

# 2. 私钥权限收紧
chmod 600 example.com.key

# 3. 校验 CSR 内容(重点看 SAN 与 CN)
openssl req -noout -text -in example.com.csr | grep -A3 'Subject Alternative Name'

几个容易出错的参数:

  • -nodes 表示私钥不加密。若加了密码,Nginx 每次启动都要交互输入,必须改用 ssl_password_file 指定密码文件,否则 reload 会失败。
  • -addext subjectAltName 必须写。现代浏览器只认 SAN,完全忽略 CN 字段。
  • ECDSA 证书体积更小、握手更快:openssl ecparam -genkey -name prime256v1 -out example.com.key,但老旧 Android 4.x 与部分 Java 6 客户端不支持,面向国内长尾终端时仍建议 RSA 2048。

域名规划直接决定证书类型:单域名证书只保护一个 FQDN;通配符证书(*.example.com)保护同级无限个子域,但不保护二级的 a.b.example.com;多域名证书(SAN/UCC)一张挂多个不同主域,适合集团站群。验证方式上,HTTP-01 需要 80 端口可从公网访问,DNS-01 需要能添加 TXT 记录,并且是签发通配符证书的唯一方式。

完整实操步骤:Nginx / Apache / Tomcat 三套部署命令

拿到 CA 返回的压缩包后,通常包含 example.com.crt(叶子证书)、intermediate.crt(中间证书)、root.crt(根证书,不要部署)和 example.com.key。第一步永远是拼 fullchain,顺序是“叶子在前、中间在后”:

cat example.com.crt intermediate.crt > fullchain.pem
openssl verify -CAfile root.crt -untrusted intermediate.crt example.com.crt
# 输出 example.com.crt: OK 才算链路正确

Nginx:ssl_certificate 指向 fullchain,ssl_certificate_key 指向私钥。

sudo cp fullchain.pem /etc/nginx/ssl/example.com.pem
sudo cp example.com.key /etc/nginx/ssl/example.com.key
sudo nginx -t && sudo systemctl reload nginx

Apache 2.4(2.4.8 起支持在 SSLCertificateFile 中直接给 fullchain):

SSLCertificateFile      /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile   /etc/httpd/ssl/example.com.key
# 2.4.8 以下版本才需要单独指定:
# SSLCertificateChainFile /etc/httpd/ssl/intermediate.crt
httpd -t && systemctl reload httpd

Tomcat:需转成 PKCS#12,注意 -name 与 Connector 的 keyAlias 必须一致。

openssl pkcs12 -export -in fullchain.pem -inkey example.com.key 
  -name tomcat -out example.com.p12 -passout pass:changeit
<Connector port='443' protocol='org.apache.coyote.http11.Http11NioProtocol'
  SSLEnabled='true' scheme='https' secure='true'>
  <SSLHostConfig>
    <Certificate certificateKeystoreFile='conf/example.com.p12'
      certificateKeystorePassword='changeit' certificateKeystoreType='PKCS12'
      type='RSA' />
  </SSLHostConfig>
</Connector>

Windows IIS 则用 certutil -mergepfx fullchain.pem example.com.key example.com.pfx 合并后导入“个人”存储区,再在站点绑定中添加 443。注意中间证书必须导入“中间证书颁发机构”存储区,否则同样出现链不完整,表现为部分客户端信任、部分不信任。

配置示例:Nginx 生产级 HTTPS 配置(HTTP/2 + HSTS + OCSP Stapling)

下面这份配置可以直接作为模板,重点在协议、套件、会话复用与跳转四块:

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/example.com.pem;   # fullchain
    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;

    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/nginx/ssl/fullchain.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;
    add_header X-Frame-Options SAMEORIGIN always;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto https;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

参数解释与坑点:

  • TLSv1.3 下 ssl_ciphers 不生效,套件由 OpenSSL 默认策略决定,只要不显式禁用就无需额外配置。
  • ssl_prefer_server_ciphers off 是现代推荐值,让客户端选择更优套件,同时保证前向安全。
  • HSTS 一旦下发就无法撤回,max-age 建议从 300 秒逐步加长;确认全站与所有子域都能 HTTPS 后再加 includeSubDomains,否则会把没有证书的子域彻底打不开。
  • OCSP Stapling 需要服务器能出网访问 CA 的 OCSP 地址,并配置 resolver,否则只是空转。Let’s Encrypt 已于 2025 年停止 OCSP 服务并从新证书中移除 OCSP URL,这类证书开启 stapling 无实际收益。
  • 若后端是 Spring Boot,必须透传 X-Forwarded-Proto,否则应用内部重定向会退回 http,造成混合内容告警。

证书类型、有效期与成本对比

把常见的服务报价按当前规则重新整理,便于按场景选型(价格为服务市场参考区间,实际以 CA 报价为准):

证书类型 验证内容 典型场景 签发周期 最长有效期 参考价格
DV 单域名 仅域名控制权 个人站、测试环境 10 分钟 398 天 免费(Let’s Encrypt 90 天)~200 元/年
DV 通配符 域名控制权 + DNS-01 多子域业务 10 分钟 398 天 约 900 元/年
DV 多域名(SAN) 多个 FQDN 控制权 站群、微服务 10 分钟 398 天 约 1000 元起,每增一个域名 +300 元
OV 企业级 域名 + 企业工商实名 对外官网、招投标 1–3 工作日 398 天 约 3000 元/年
EV 企业级 OV + 严格扩展审查 金融、支付 3–7 工作日 398 天 约 4000 元/年
纯安装配置服务 不含证书 已有证书需部署 当日 — 约 100 元/次

三点必须澄清:

  • 浏览器不再展示 EV 绿色地址栏。Chrome 77 起移除了 EV 标识,Safari 15 起也不再显示企业名称,EV 的价值只剩合规与审计要求,不必为“绿条”买单。
  • 有效期上限已不是 2 年。市面上“通配符证书二年”“2 年单域名证书”的表述在 2020 年 9 月后已不成立,单张公开信任证书最长 398 天,多年套餐只是把多次续费权打包。
  • 多域名证书不等于无限域名。主流 CA 单张证书 SAN 上限为 100 个,且每个域名都要独立通过验证。

常见错误排查:真实报错与定位命令

以下报错均来自生产环境,按“报错 → 根因 → 修复”给出:

报错信息 根因 修复
nginx: [emerg] SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) 私钥与证书不配对 比对模数:openssl x509 -noout -modulus -in cert.pem | openssl md5 与 openssl rsa -noout -modulus -in key | openssl md5,两个值必须一致
PEM_read_bio_X509_AUX() failed ... no start line:Expecting: TRUSTED CERTIFICATE 路径错误,或上传成了 DER 二进制 file cert.pem 应显示 ASCII text;DER 需转换:openssl x509 -inform DER -in cert.cer -out cert.pem
curl: (60) SSL certificate problem: unable to get local issuer certificate 缺中间证书 用 fullchain 替换叶子证书,openssl s_client -showcerts 应能看到 2 张以上证书
java.security.cert.CertPathValidatorException: PKIX path building failed Java 客户端不信任该链 补齐 fullchain;或导入中间 CA:keytool -importcert -alias intermediate -file intermediate.crt -keystore $JAVA_HOME/lib/security/cacerts
SSL_ERROR_NO_CYPHER_OVERLAP / sslv3 alert handshake failure 协议或套件无交集 保留 TLSv1.2 TLSv1.3,检查是否误配只留 ECDSA 套件而证书是 RSA
AH02217: ssl_stapling_init_cert: can't retrieve issuer certificate Apache 找不到签发者证书 SSLCertificateChainFile 指向中间证书,或把 SSLCertificateFile 换成 fullchain
小程序 / ATS 报 request:fail ssl hand shake error 协议过低或链不完整 禁用 TLSv1.0/1.1,确保 RSA ≥ 2048 位、SHA-256 签名

三段式快速定位命令:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>&1 | openssl x509 -noout -subject -issuer -dates
openssl s_client -connect example.com:443 -servername example.com -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null 2>&1 | grep 'Verify return code'
curl -sSI https://example.com | head -1

效果验证与自动化续期监控

部署完成不等于交付完成,至少跑完下面五项:

# 1. 证书链完整性(Verify return code 必须为 0 (ok))
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>&1 | grep -E 'Verify return code|Protocol|Cipher'

# 2. 强制各协议版本握手
openssl s_client -connect example.com:443 -tls1_2 </dev/null >/dev/null 2>&1 && echo 'TLS1.2 OK'
openssl s_client -connect example.com:443 -tls1_1 </dev/null >/dev/null 2>&1 || echo 'TLS1.1 已禁用'

# 3. HTTP/2 与 301 跳转
curl -sI --http2 https://example.com | head -3
curl -sI http://example.com | grep -i location

# 4. 剩余有效期
openssl x509 -noout -enddate -in /etc/nginx/ssl/example.com.pem

# 5. 在线评级
curl -s 'https://api.ssllabs.com/api/v3/analyze?host=example.com&all=done' | grep -o 'grade[^,]*'

目标基线:SSL Labs 评级 A 及以上、无 TLS1.0/1.1、支持 TLS1.3、HSTS 已下发、证书链只有 2 层(叶子 + 中间)。

续期自动化是避免“半夜过期”的唯一可靠手段:

# certbot(Let's Encrypt,90 天,官方建议每 60 天续一次)
sudo certbot renew --dry-run
sudo systemctl list-timers | grep certbot

# acme.sh(支持 DNS-01 签发通配符)
acme.sh --issue --dns dns_ali -d example.com -d '*.example.com'
acme.sh --install-cert -d example.com 
  --key-file /etc/nginx/ssl/example.com.key 
  --fullchain-file /etc/nginx/ssl/example.com.pem 
  --reloadcmd 'systemctl reload nginx'

商用证书没有自动续期接口,建议用脚本每日巡检并告警:

#!/bin/bash
DOMAIN='example.com'
END=$(echo | openssl s_client -servername $DOMAIN -connect $DOMAIN:443 2>/dev/null 
  | openssl x509 -noout -enddate | cut -d= -f2)
LEFT=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
[ $LEFT -lt 30 ] && echo "证书剩余 ${LEFT} 天,请续费" | mail -s 'SSL 告警' ops@example.com

按 SC-081 时间表,2026 年 3 月起单张证书最长 200 天、2027 年 100 天、2029 年 47 天,人工续费窗口会越来越窄,把 ACME 自动化提前接入是更省事的选择。

常见问题

证书装好后浏览器显示锁形图标,但微信小程序仍请求失败,是什么原因?

九成是证书链不完整。小程序与 iOS ATS 不走浏览器的 AIA 补链机制,只认服务器下发的完整链。执行 openssl s_client -connect 域名:443 -servername 域名 -showcerts,如果只输出 1 张证书,就把中间证书拼进 fullchain 再重载。其次检查是否仍开放 TLSv1.0/1.1,以及签名算法是否为已被淘汰的 SHA-1。

一张通配符证书能不能覆盖 a.b.example.com 和 example.com?

都不行。*.example.com 只匹配一级子域,a.b.example.com 属于二级,需要单独签发或改用 *.b.example.com。裸域 example.com 也不在通配符范围内,多数 CA 会把它作为附赠 SAN 一并签发,申请时务必确认 SAN 列表包含裸域,否则用户直接输入域名就会报证书名称不匹配。

证书最长能签多久?“买两年、三年”还有意义吗?

公开信任的 TLS 证书单张有效期上限为 398 天,这是 CA/B Forum 自 2020 年 9 月 1 日起的强制要求;Let’s Encrypt 固定 90 天。所谓多年期套餐只是把多张 398 天证书的续费权打包售卖,中间仍需重新签发与部署。按 SC-081,2026-03-15 起降为 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天,长期套餐的价值主要在价格锁定,不在减少操作。

部署后还需要保留 80 端口吗?

需要,但要区分用途。一是做 301 跳转到 443,二是 Let’s Encrypt 的 HTTP-01 验证需要访问 /.well-known/acme-challenge/。如果只用 DNS-01 验证,可以关闭 80 端口,但要提前把跳转规则移到 443 的默认 server 块,避免用户访问 http 时直接超时。

开启 HSTS 后想回退到 HTTP 怎么办?

在缓存有效期内基本无法回退。浏览器会按 max-age 缓存该策略,期间所有 http 请求在本地就被改写成 https,用户无法点击“继续访问”。因此上线顺序应为:先只加 max-age=300 观察一周,确认所有子域都有有效证书,再逐步提升到 31536000 并追加 includeSubDomains。确实需要回退时,只能下发 max-age=0 并等待旧缓存自然过期。

OCSP Stapling 还需要配置吗?

视证书而定。传统商业 CA 证书仍有 OCSP URL,开启 stapling 可减少客户端额外查询、加快握手;但 Let’s Encrypt 已于 2025 年停止 OCSP 服务并从新签发证书中移除该扩展,这类证书配置 ssl_stapling on 不会生效也不会有收益,可直接删除相关指令,改用短有效期配合自动续期来控制吊销风险。

内容审核

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