HTTPS SSL 证书安装与配置全流程:CSR 生成、Nginx/Apache/Tomcat 部署与真实报错排查
本文把“HTTPS 证书购买—安装—配置—验证”拆成可直接执行的工程步骤:CSR 生成、证书链合并、Nginx/Apache/Tomcat 三套配置模板、真实报错对照排查与自动化续期。文中命令均可复制执行,路径以 /etc/nginx/ssl/ 为例,请按实际环境替换域名与目录。
一、问题背景与根因:证书“装上了”为什么浏览器还报警
实际运维中最常见的场景不是“买不到证书”,而是证书文件已经放到服务器、Nginx 也 reload 成功,用户端却仍然报错。典型现象分三类:
- Chrome/Edge:
NET::ERR_CERT_COMMON_NAME_INVALID、NET::ERR_CERT_AUTHORITY_INVALID、NET::ERR_CERT_DATE_INVALID; - 命令行与后端:
curl: (60) SSL certificate problem: unable to get local issuer certificate; - Java/Android/小程序:
javax.net.ssl.SSLHandshakeException: PKIX path building failed。
根因基本落在五类,按真实工单占比排序:
1. 证书链不完整(占比最高)。只部署了域名证书 example.com.crt,没把中间 CA 证书拼进去。桌面浏览器会通过 AIA 自动补链,所以“我这台电脑打开是绿的”,但 Android 老版本、Java 客户端、微信小程序、部分 iOS 直接握手失败。
2. 域名不匹配。证书 SAN 里只有 example.com,用户却访问 www.example.com;或者只签了 www 漏了裸域。
3. 私钥与证书不配对。多次签发后把新证书配了旧私钥,Nginx 直接启动失败。
4. 协议与端口层问题。只监听 443 未做 80 跳转;或 ssl_protocols 仍保留 TLSv1/1.1,被现代浏览器拒绝。
5. 有效期与系统时间。证书过期,或服务器时钟漂移导致校验失败。
先用下面两条命令定性,80% 的问题能直接定位:
# 查看服务端实际下发的证书主体、签发者与有效期
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 检查证书链是否完整,Verify return code 必须为 0
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| grep -E 'Verify return code|verify error'
若输出 verify error:num=21:unable to verify the first certificate 或 Verify return code: 21,即为缺中间证书。再验证私钥与证书是否配对(两行 MD5 必须一致):
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
ECC 证书改用 openssl pkey -in example.com.key -pubout | openssl md5 对比即可。
二、动手前的准备:私钥、CSR 与域名验证
选型先定三件事:验证等级(DV/OV/EV)、覆盖范围(单域名/通配符/多域名 SAN)、部署环境(Nginx 用 PEM,Tomcat/IIS 用 PFX/JKS)。确定后在目标服务器上生成私钥与 CSR,私钥不出服务器。
mkdir -p /etc/nginx/ssl && cd /etc/nginx/ssl
# RSA 2048,SAN 直接写进 CSR(需 OpenSSL 1.1.1+ 的 -addext)
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key -out example.com.csr
-subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Ltd/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
# 或 ECC P-256:握手更快,TLS 1.3 首选
openssl ecparam -genkey -name prime256v1 -out example.com.key
openssl req -new -key example.com.key -out example.com.csr
-subj '/C=CN/O=Example Ltd/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
chmod 600 example.com.key && chown root:root example.com.key
提交前检查 SAN 是否写对(多数 CA 以 CSR 的 SAN 为准,写错就要重签):
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
域名验证方式对比:
| 验证方式 | 操作 | 生效时间 | 注意 |
|---|---|---|---|
| DNS TXT | 添加 _dnsauth.example.com TXT 记录 |
5-30 分钟(受 TTL 影响) | 通配符证书只能用 DNS 验证 |
| HTTP 文件 | 上传 /.well-known/pki-validation/xxx.txt |
即时 | 需 80 端口可访问且未被 CDN 缓存 |
| 邮箱验证 | 接收 admin@example.com 邮件 | 即时 | 易被企业邮箱拦截,不推荐 |
签发完成后你会拿到三类文件:域名证书(example.com.crt)、中间证书(ca_bundle.crt 或 intermediate.crt)、以及第一步生成的私钥。有效期红线:公共 CA 签发的 TLS 证书单张最长 398 天,Let’s Encrypt 为 90 天;CA/Browser Forum 已通过分阶段缩短方案(2026 年 3 月起 200 天、2027 年起 100 天、2029 年起 47 天),因此续期必须自动化,不能靠人工日历提醒。
三、Nginx 部署:合并证书链到 443 配置(可直接执行)
第一步永远是合并链,顺序为“站点证书 → 中间证书”,根证书不要放(放了会让握手包变大,部分客户端还会判错):
cd /etc/nginx/ssl
cat example.com.crt intermediate.crt > fullchain.pem
# 应输出 2(部分 CA 提供交叉证书时为 3)
grep -c 'BEGIN CERTIFICATE' fullchain.pem
第二步写配置。以下模板使用 Nginx 1.25.1+ 的 http2 on; 写法,旧版本请改成 listen 443 ssl http2;:
server {
listen 80;
server_name example.com www.example.com;
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;
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 1.1.1.1 valid=300s;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
root /var/www/example;
index index.html;
}
第三步校验并热加载:
nginx -t && systemctl reload nginx
三个易错点:① ssl_trusted_certificate 必须指向含中间证书的链文件,否则 OCSP Stapling 不生效;② Let’s Encrypt 已于 2025 年停止 OCSP 服务,若日志出现 ssl_stapling ignored, issuer certificate not found 或 stapling 长期失败,直接注释掉 stapling 三行;③ 开启 HSTS 前先确认全站(含子域)HTTPS 可用,否则浏览器会在 max-age 期间拒绝回退。
四、Apache 与 Tomcat 配置示例(含 PFX/JKS 转换)
Apache 2.4.8 之后链文件直接合并进 SSLCertificateFile,SSLCertificateChainFile 已废弃:
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256
SSLHonorCipherOrder off
Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>
apachectl configtest && systemctl reload httpd
Tomcat 8.5/9 支持直接读 PEM,不必转 JKS:
<Connector port='8443' protocol='org.apache.coyote.http11.Http11NioProtocol'
SSLEnabled='true' scheme='https' secure='true' maxThreads='150'>
<SSLHostConfig protocols='TLSv1.2,TLSv1.3'>
<Certificate certificateFile='/etc/tomcat/ssl/fullchain.pem'
certificateKeyFile='/etc/tomcat/ssl/example.com.key'
type='RSA' />
</SSLHostConfig>
</Connector>
老项目必须用 JKS 时,先转格式再校验链:
keytool -importkeystore -srckeystore example.pfx -srcstoretype PKCS12 -srcstorepass 123456
-destkeystore example.jks -deststoretype JKS -deststorepass 123456 -destkeypass 123456
# 正常应看到 3 条 Owner/Issuer 记录(站点证书 + 中间证书 + 根证书)
keytool -list -v -keystore example.jks -storepass 123456 | grep -E 'Owner|Issuer|Valid'
Tomcat 高频坑:keystoreFile 写相对路径时是相对于 catalina.base 而非当前目录,日志会报 java.io.IOException: Keystore was tampered with, or password was incorrect(其实往往是找不到文件);另外 certificateFile 若只填站点证书不含中间证书,浏览器正常但 Java 客户端会报 PKIX path building failed。
五、证书类型、有效期与部署方式对比
选证书前先看对比表,别为不需要的等级付费,也别在必须 OV 的场景用 DV 凑合:
| 类型 | 核验内容 | 签发时长 | 有效期上限 | 典型场景 |
|---|---|---|---|---|
| DV 域名型 | 仅域名控制权 | 1-10 分钟 | 398 天 | API、博客、测试环境 |
| OV 企业型 | 工商信息 + 域名 | 1-3 工作日 | 398 天 | 企业官网、电商 |
| EV 扩展型 | 严格主体核验 | 3-7 工作日 | 398 天 | 金融、政企(2019 年起主流浏览器已不再显示绿色公司名,仅证书详情可见) |
| Let’s Encrypt | ACME 自动验证 | 秒级 | 90 天 | 可自动化的站点、内网 |
按覆盖范围又分单域名、通配符(*.example.com,只匹配一级)、多域名 SAN(一张证书挂多个不同域名)。部署方式对比:
| 部署方式 | 适用组件 | 优点 | 代价/注意 |
|---|---|---|---|
| PEM 直装 | Nginx / Apache | 性能好、配置透明 | 续期后需 reload |
| PFX / JKS | Tomcat / IIS / Java | 兼容老系统 | 别名、密码、链易错 |
| 反向代理终止 TLS | Nginx 前置 + 多后端 | 证书只维护一处 | 后端要配 X-Forwarded-Proto |
| CDN 托管证书 | Cloudflare 等 | 自动续期、就近握手 | 回源段也必须 HTTPS,否则出现 526 |
成本判断:单域名 DV 证书市场价几十到几百元,通配符通常是单域名的 3-5 倍;而“代安装/代配置”类服务报价一般在 100-150 元/个(PHP 环境约 100 元、Tomcat 约 150 元)。按本文流程自行操作可以省下这部分费用,但要自行承担排错与续期的工作量。
六、常见错误排查:真实报错对照表
下面这些报错覆盖了绝大多数部署失败场景,按“报错原文 → 根因 → 修复”对号入座即可:
| 报错原文(截取) | 根因 | 修复 |
|---|---|---|
nginx: [emerg] cannot load certificate '...fullchain.pem': BIO_new_file() failed (SSL: error:0200100D:system library:fopen:Permission denied) |
路径错误或 worker 无读权限 | chmod 644 fullchain.pem;SELinux 环境执行 restorecon -Rv /etc/nginx/ssl |
nginx: [emerg] SSL_CTX_use_PrivateKey_file('...example.com.key') failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) |
私钥与证书不配对 | 用 -modulus | openssl md5 比对,重新下载匹配的私钥 |
curl: (60) SSL certificate problem: unable to get local issuer certificate |
缺中间证书 | 合并 fullchain.pem 后 reload |
PKIX path building failed: unable to find valid certification path to requested target |
Java truststore 不认该链 | keytool -import -alias intermediate -file intermediate.crt -keystore $JAVA_HOME/lib/security/cacerts |
NET::ERR_CERT_COMMON_NAME_INVALID |
SAN 不含当前访问域名 | 重签并补齐 www 与裸域 |
NET::ERR_CERT_DATE_INVALID |
证书过期或系统时间错 | date -u 校时、timedatectl set-ntp true,并重签 |
SSL_ERROR_BAD_CERT_DOMAIN(Firefox) |
SNI 缺失,命中默认站点证书 | 每个 server 块配 server_name,兜底站点加 default_server 并单独签证书 |
526 Invalid SSL certificate(Cloudflare) |
回源证书自签/过期/链不全 | 先修源站链,再切 Full (strict) |
4832:error:0909006C:PEM routines:get_name:no start line |
文件不是 PEM(DER/PFX 或含 BOM) | openssl x509 -in cert.crt -inform DER -out cert.pem |
批量验证证书链是否正确,一条 openssl verify 就够:
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem
# 期望输出:fullchain.pem: OK
若输出 unable to get local issuer certificate 或 error 20 at 0 depth lookup,说明链文件里缺中间证书。改完务必先 nginx -t 通过再 reload,不要直接 restart,避免同机其他站点被一起中断。
七、效果验证与自动化续期
部署完成不等于生效,按下面清单逐条打勾:
# 1) 链完整性:Verify return code 必须为 0
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep 'Verify return code'
# 2) 状态码与校验结果(输出应为 200 0)
curl -sI https://example.com -o /dev/null -w '%{http_code} %{ssl_verify_result}n'
# 3) 80 端口跳转是否正常(应返回 301)
curl -sI http://example.com | head -3
# 4) HSTS 头是否下发
curl -sI https://example.com | grep -i strict-transport-security
# 5) 剩余有效期(返回 0 表示 30 天内过期)
openssl x509 -in fullchain.pem -noout -checkend 2592000
再配合在线扫描交叉验证:SSL Labs(评级目标 A 及以上)、Hardenize,以及 Chrome DevTools Console 中的 Mixed Content 警告——页面里残留 http:// 图片或脚本会让地址栏的“锁”变灰。
续期自动化,两条主流路径。Certbot:
certbot --nginx -d example.com -d www.example.com
certbot renew --dry-run # 演练,不消耗速率限制
# crontab -e 添加
0 3 * * * /usr/bin/certbot renew --quiet --deploy-hook 'systemctl reload nginx'
acme.sh(支持 DNS API,通配符首选):
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/fullchain.pem
--reloadcmd 'systemctl reload nginx'
最后加一条到期巡检,避免自动续期静默失败:
#!/bin/bash
DOMAIN=example.com
END=$(echo | openssl s_client -connect $DOMAIN:443 -servername $DOMAIN 2>/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 'cert warning' ops@example.com
常见问题
问题1:公共 CA 签发的 SSL 证书最长有效期是多久?
目前公共信任的 TLS 证书单张最长 398 天(2020 年 9 月起生效),Let’s Encrypt 为 90 天。CA/Browser Forum 已通过分阶段缩短方案:2026 年 3 月 15 日起上限 200 天,2027 年 3 月 15 日起 100 天,2029 年 3 月 15 日起 47 天。这意味着手工换证很快不可行,建议直接上 ACME 自动续期并加到期巡检。
问题2:通配符证书 *.example.com 能覆盖 a.b.example.com 和裸域 example.com 吗?
都不能。通配符只匹配一级子域,a.b.example.com 不匹配;裸域 example.com 也不匹配,必须在 SAN 里额外写 DNS:example.com,或另签一张单域名证书。另外通配符证书签发只能走 DNS 验证,无法用 HTTP 文件方式。
问题3:浏览器显示锁,但 Java 客户端/微信小程序报 PKIX path building failed,为什么?
因为服务端只下发了站点证书、没带中间证书。桌面 Chrome 会通过 AIA 自动补链,所以看起来正常;Java 的 truststore 不做 AIA 拉取,直接判定链不完整。修复方式:把站点证书与中间证书合并成 fullchain.pem 后 reload,或在 Java 侧用 keytool -import 把中间证书导入 cacerts。
问题4:部署 HTTPS 后页面样式丢失、接口被拦截怎么处理?
这是混合内容(Mixed Content)。Chrome DevTools Console 会明确列出被拦截的 http:// 资源。处理办法:把静态资源改为 https:// 或协议相对写法,接口统一走 HTTPS;临时缓解可加响应头 Content-Security-Policy: upgrade-insecure-requests,但这只是浏览器侧升级,不能替代源头修复。
问题5:私钥泄露或证书需要紧急吊销,应该按什么顺序操作?
先由 CA 吊销旧证书(通过 OCSP/CRL 生效,部分 CA 支持 24 小时内完成),再重新生成私钥与 CSR 签发新证书,替换部署并 nginx -t && systemctl reload nginx。如果已启用 HSTS,不要立刻把 max-age 归零,先确认新证书在所有节点生效,再逐步下调,否则用户会被锁在无法访问的状态。
问题6:市面上的“证书一条龙安装配置”和自己用 Let’s Encrypt 该选哪个?
看两点:有没有运维能力、有没有合规要求。有 Linux 基础且能配置 ACME 的,Let’s Encrypt 免费 + --deploy-hook 自动 reload 是成本最低的方案;需要 OV/EV 主体核验、需要商业 SLA 与保险赔付、或环境是封闭的 Tomcat/IIS 老系统,则买商业证书更省事。无论哪种,私钥都应自己生成和保管,不要把私钥长期交给第三方代持。