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 报价为准):
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
- APP/小程序 HTTPS · SSL网站加密证书 · 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 不会生效也不会有收益,可直接删除相关指令,改用短有效期配合自动续期来控制吊销风险。