HTTPS 证书配置全流程:从私钥与 CSR 生成到 Nginx/Tomcat 部署、证书链修复与排错
一、问题背景与根因:备案通过不等于 HTTPS 可用
大量站点在完成 ICP 备案、域名解析后,浏览器地址栏仍提示“不安全”或直接报错。ICP 备案由工信部管理,SSL 证书由 CA(证书颁发机构)签发,两者是完全独立的体系:备案解决“能否在国内合法提供服务”,证书解决“传输是否加密、服务端身份是否可信”。所以“域名备案”从来不是证书配置的前置条件,只是国内服务器上线的合规要求。
线上 HTTPS 故障中,绝大多数集中在四类根因:①证书链不完整,服务器只下发了站点证书而缺少中间证书;②SAN(Subject Alternative Name)未覆盖实际访问域名,例如只签了 example.com,却用 www.example.com 访问;③证书过期——按 CA/Browser Forum 规定,2020 年 9 月 1 日起所有公开信任证书有效期上限为 398 天,Let’s Encrypt 则固定 90 天,靠人工续期必然出问题;④TLS 协议版本与加密套件配置过时,被现代浏览器拒绝握手。
先用两条命令定位问题,再决定是重新签发还是修改配置:
# 查看服务端实际下发的证书主体、签发者、有效期与 SAN
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 统计证书链段数(正常 2~3 段;只有 1 段说明缺中间证书)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| grep -c "BEGIN CERTIFICATE"
若第二条命令返回 1,且浏览器报 NET::ERR_CERT_AUTHORITY_INVALID,即可确认链不完整;若 subjectAltName 里没有你正在访问的域名,则是域名不匹配。下面按“生成密钥 → 签发 → 部署 → 验证”的顺序完整走一遍。
二、准备阶段:私钥、CSR 与域名规划
无论选择哪家证书,第一步都是在自己的服务器上生成私钥和 CSR(证书签名请求),私钥绝不能上传给任何第三方。推荐 RSA 2048 位(兼容性最好)或 ECDSA P-256(握手更快、体积更小,但需确认老客户端兼容性)。
mkdir -p /etc/nginx/ssl && cd /etc/nginx/ssl
# 1. 生成 2048 位私钥并立刻收紧权限
openssl genrsa -out example.com.key 2048
chmod 600 example.com.key && chown root:root example.com.key
# 2. 生成 CSR:CN 填主域名,SAN 必须写全所有要用的域名
openssl req -new -key example.com.key -out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Tech/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com,DNS:m.example.com"
# 3. 提交前自检
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
openssl req -in example.com.csr -noout -text | grep "Public-Key"
三个必须注意的点:其一,现代浏览器只认 SAN,不再校验 CN,CSR 里必须用 -addext subjectAltName 写全域名,漏一个就报 ERR_CERT_COMMON_NAME_INVALID;其二,私钥一旦泄露只能吊销重签,生成后应立即备份到离线介质;其三,通配符 *.example.com 只覆盖一级子域,既不覆盖 a.b.example.com,也不覆盖裸域 example.com,通常需要“通配符 + 裸域”两张证书或一张多域名证书。
CSR 交给 CA 后,DV 证书一般 10 分钟内签发(DNS TXT 或文件验证),OV/EV 需提交营业执照、法人信息并接受电话回访,通常 1~3 个工作日。拿到的文件一般有三类:站点证书 .crt、中间证书 chain.crt(或 ca-bundle)、根证书(不要部署到服务器)。
三、实操一:用 certbot 签发 Let’s Encrypt 证书(90 天自动续期)
Let’s Encrypt 证书有效期固定 90 天,必须自动化续期,人工续期几乎必然漏掉。以 Nginx 为例:
# Debian/Ubuntu
apt update && apt install -y certbot python3-certbot-nginx
# RHEL/CentOS/Rocky
dnf install -y certbot python3-certbot-nginx
# 一键签发,自动改写 Nginx 配置并强制 80 跳 443
certbot --nginx -d example.com -d www.example.com
--agree-tos -m ops@example.com --redirect --no-eff-email
# Nginx 由容器/面板托管时改用 webroot(80 端口必须放行)
certbot certonly --webroot -w /var/www/html
-d example.com -d www.example.com --deploy-hook "systemctl reload nginx"
签发成功后证书位于 /etc/letsencrypt/live/example.com/:fullchain.pem(站点证书+中间证书,配 ssl_certificate)、privkey.pem(配 ssl_certificate_key)、chain.pem(配 OCSP stapling 的 ssl_trusted_certificate)。不要把 cert.pem 直接配给 Nginx,那会丢掉中间证书。
续期验证与定时任务检查:
certbot renew --dry-run # 演练续期,必须成功
systemctl list-timers | grep certbot # 确认 certbot.timer 已启用
systemctl enable --now certbot.timer
常见坑:CDN 或 WAF 回源到 80 端口时拦截了 /.well-known/acme-challenge/,验证会失败并报 Detail: Invalid response from http://example.com/.well-known/acme-challenge/xxx: 404。此时需在 Nginx 中显式放行,且该路径不能被 301 跳转到 HTTPS:
location ^~ /.well-known/acme-challenge/ { root /var/www/html; default_type text/plain; }
四、实操二:商业证书申请与 Nginx 完整 HTTPS 配置
商业 DV 证书(约 200 元档)只需验证域名所有权;OV/EV(千元档)需企业实名核验并在证书详情中显示组织名称。EV 证书自 2019 年起主流浏览器已不再显示绿色地址栏,因此除非合规审计明确要求,一般选 OV 即可。签发后把站点证书与中间证书按“站点证书在前、中间证书在后”合并:
cat example.com.crt intermediate.crt > example.com.fullchain.pem
openssl verify -CAfile intermediate.crt example.com.fullchain.pem # 应输出 OK
Nginx 配置(1.25.1 起 listen 443 ssl http2 写法已废弃,改用 http2 on;):
server {
listen 80;
server_name example.com www.example.com;
location ^~ /.well-known/acme-challenge/ { root /var/www/html; }
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
http2 on;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/example.com.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/example.com.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 X-Forwarded-Proto https;
proxy_set_header Host $host;
}
}
生效前务必 nginx -t 语法检查通过,再 systemctl reload nginx。启用 HSTS 前请确认所有子域都已支持 HTTPS:max-age=31536000 一旦下发,浏览器一年内不会允许用户手动点击“继续访问”降级到 HTTP,回滚成本极高。
五、实操三:证书链处理与 Tomcat/IIS/Java 格式转换
不同运行环境要求的证书格式不同:Nginx 用 PEM,Apache 用 PEM(证书与链可分开配置),Tomcat 用 PKCS#12 或 JKS,IIS 用 PFX。转换命令如下:
# PEM → PKCS#12(Tomcat 7+/IIS 通用)
openssl pkcs12 -export -out example.com.pfx
-inkey example.com.key -in example.com.fullchain.pem
-certfile intermediate.crt -passout pass:YourPass123
# PKCS#12 → JKS(老版本 Tomcat)
keytool -importkeystore -srckeystore example.com.pfx -srcstoretype PKCS12
-srcstorepass YourPass123 -destkeystore example.com.jks
-deststoretype JKS -deststorepass YourPass123
# 检查 PKCS#12 内是否包含完整链(应为 2~3)
openssl pkcs12 -in example.com.pfx -nokeys -passin pass:YourPass123 | grep -c "BEGIN CERTIFICATE"
Tomcat 的 conf/server.xml 关键片段:
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
maxThreads="200" SSLEnabled="true" scheme="https" secure="true">
<SSLHostConfig>
<Certificate certificateKeystoreFile="/opt/tomcat/conf/example.com.pfx"
certificateKeystoreType="PKCS12"
certificateKeystorePassword="YourPass123" />
</SSLHostConfig>
</Connector>
最常见的失误是把根证书也拼进 fullchain.pem。部分客户端(Android 旧版本、Java 客户端)会因链中出现自签根而直接握手失败。正确顺序是“站点证书 → 中间证书”,到中间证书为止。用一条命令确认链层级:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -E "s:|i:"
输出中第一段的 i:(issuer)应指向中间 CA;若第一段就直接指向根 CA 名称,说明中间证书缺失。
六、方案对比:证书类型、有效期规则与部署方式
选证书先看三件事:验证等级、有效期上限、是否覆盖多域名。下表为国内市场常见方案对比(价格为区间估算):
| 证书类型 | 验证内容 | 单次有效期 | 浏览器展示 | 参考价格(元/年) | 适用场景 |
|---|---|---|---|---|---|
| Let’s Encrypt DV | 域名所有权(HTTP-01/DNS-01) | 90 天 | 锁标志 | 0 | 个人站、测试环境、有自动化能力的团队 |
| 商业 DV | 域名所有权 | 最长 398 天 | 锁标志 | 200~600 | 中小企业官网、单域名快速上线 |
| 商业 OV | 域名 + 企业实名(执照、电话回访) | 最长 398 天 | 锁标志,证书详情显示组织名 | 800~2000 | 电商、金融、需展示主体身份 |
| 商业 EV | 严格企业核验 | 最长 398 天 | 锁标志(2019 年后无绿色地址栏) | 1600~5000 | 强合规审计场景 |
| 通配符 DV | 域名所有权(DNS-01) | 90 / 398 天 | 锁标志 | 500~1500 | 大量同级子域 |
有效期是硬约束,任何 CA 都不能签发超期证书:
| 规则来源 | 有效期上限 | 生效时间 | 说明 |
|---|---|---|---|
| Let’s Encrypt 官方策略 | 90 天 | 长期有效 | 必须依赖 certbot.timer 自动续期 |
| CA/Browser Forum 现行规定 | 398 天 | 2020-09-01 | 所有公开信任 TLS 证书通用 |
| CA/B Forum SC-081 第一阶段 | 200 天 | 2026-03-15 | 逐年缩短,需提前自动化 |
| SC-081 第二阶段 / 第三阶段 | 100 天 / 47 天 | 2027-03-15 / 2029-03-15 | 手工续期将不可行 |
部署方式对照:
| 运行环境 | 证书文件 | 关键配置项 | 生效命令 |
|---|---|---|---|
| Nginx | fullchain.pem + privkey.pem | ssl_certificate / ssl_certificate_key | nginx -t && systemctl reload nginx |
| Apache httpd | cert.pem + chain.pem | SSLCertificateFile / SSLCertificateChainFile / SSLCertificateKeyFile | apachectl configtest && systemctl reload httpd |
| Tomcat | .pfx(PKCS12) | certificateKeystoreFile / Type / Password | systemctl restart tomcat |
| IIS | .pfx | 导入“服务器证书”→ 站点绑定 443 | iisreset |
| Node.js | fullchain.pem + key | https.createServer({key, cert}) | pm2 reload app |
七、常见错误排查:真实报错与处置
下面这些报错在 HTTPS 上线阶段出现频率最高,可直接对照定位:
| 报错信息 | 根因 | 处置方式 |
|---|---|---|
NET::ERR_CERT_AUTHORITY_INVALID;curl: (60) SSL certificate problem: unable to get local issuer certificate |
只下发了站点证书,缺中间证书 | cat site.crt intermediate.crt > fullchain.pem 后重载服务 |
NET::ERR_CERT_COMMON_NAME_INVALID;SSL_ERROR_BAD_CERT_DOMAIN |
SAN 未包含当前访问域名 | 重签 CSR,-addext "subjectAltName=DNS:example.com,DNS:www.example.com" |
nginx: [emerg] cannot load certificate "/etc/nginx/ssl/a.pem": PEM_read_bio_X509_AUX() failed |
文件是 DER/PFX 格式,或含 Windows 换行/多余文本 | openssl x509 -in a.pem -inform DER -out a.pem;确认首行为 -----BEGIN CERTIFICATE----- |
SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) |
证书与私钥不配对 | 见下方 md5 比对命令 |
NET::ERR_CERT_DATE_INVALID |
证书过期,或服务器系统时间错误 | timedatectl set-ntp true 校准;certbot renew 续期 |
Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure element 'http://...' |
页面内引用 HTTP 资源 | 改为相对协议或全站 https,加 CSP upgrade-insecure-requests |
Detail: Invalid response from http://example.com/.well-known/acme-challenge/xxx: 404 |
验证路径被重写规则或 CDN 拦截 | 加 location ^~ /.well-known/acme-challenge/ 放行,并排除 301 跳转 |
too many failed authorizations recently |
验证失败次数过多被 CA 限流 | 等待 1 小时,先用 certbot renew --dry-run 排查 |
证书与私钥配对校验(两行输出的 md5 必须一致):
openssl x509 -noout -modulus -in example.com.fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
ECDSA 私钥不适用 -modulus,改用公钥比对:
openssl x509 -in cert.pem -noout -pubkey | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5
八、效果验证:从命令行到 SSL Labs 评分
配置完成后不要只看浏览器锁标志,要逐项验证协议、链路、跳转与响应头:
# 1. 跳转与响应头(应看到 301 到 https,以及 HSTS 头)
curl -sI http://example.com | head -5
curl -sI https://example.com | grep -iE "strict-transport|server"
# 2. 证书有效期、主体、签发者
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 3. 协议支持情况:TLS 1.0/1.1 应握手失败
openssl s_client -connect example.com:443 -tls1_1 </dev/null 2>&1 | grep -E "Protocol|alert"
# 4. OCSP stapling 是否生效(应输出 OCSP Response Status: successful)
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null | grep -A2 "OCSP Response"
再用到期监控脚本接入告警,避免 398 天或 90 天到期“静默失效”:
#!/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)
DAYS=$(( ($(date -d "$END" +%s) - $(date +%s)) / 86400 ))
if [ "$DAYS" -lt 15 ]; then
echo "$DOMAIN 证书剩余 $DAYS 天" | mail -s "[SSL 告警] $DOMAIN" ops@example.com
fi
最终验收清单:①浏览器无任何证书警告;②openssl s_client 显示链段数为 2~3;③仅启用 TLS 1.2/1.3;④HTTP 全量 301 到 HTTPS;⑤HSTS 头存在且子域已覆盖;⑥Qualys SSL Labs 评分达到 A 或 A+;⑦续期定时任务 --dry-run 通过。
常见问题
域名必须先备案才能配置 HTTPS 吗?
不需要。备案是工信部对境内服务器的合规要求,SSL 证书由 CA 独立签发,两者没有先后依赖。只要域名解析指向你的服务器、80 或 443 端口可达,就可以签发并部署证书。但要注意:使用境内服务器对外提供 Web 服务,未备案会被接入商拦截 80/443 端口,表现出的现象很像“证书没配好”,排查时先确认端口是否被运营商或云厂商阻断。
免费的 Let’s Encrypt 和 200 元商业证书,选哪个?
两者加密强度完全一致,差别在有效期与保障。Let’s Encrypt 有效期 90 天、无人工客服、无赔付,必须配 certbot.timer 自动续期;商业 DV 最长 398 天,提供签发失败赔付和中文工单支持。个人站、内部系统、具备自动化能力的团队用免费证书即可;面向客户的生产业务、缺少运维人力或需要发票报销与责任兜底的场景,建议买商业证书。
证书为什么只能签 398 天?到期忘了续会怎样?
这是 CA/Browser Forum 的强制基线要求,2020 年 9 月 1 日起所有公开信任的 TLS 证书有效期不得超过 398 天,目的是缩短密钥泄露的暴露窗口。按 SC-081 决议,该上限将在 2026-03-15 缩短至 200 天、2027-03-15 缩短至 100 天、2029-03-15 缩短至 47 天。证书过期后浏览器会直接拦截并报 NET::ERR_CERT_DATE_INVALID,接口调用方则报 curl: (60) certificate has expired,属于硬中断,必须靠监控告警提前介入。
配好 HTTPS 后网站打不开、502 或无限重定向怎么办?
先分层定位:curl -vI https://example.com 看是 TLS 握手失败还是 HTTP 层错误。握手失败多为证书链或私钥不匹配;502/504 说明 TLS 已通但反向代理后端不可达,检查 proxy_pass 地址与后端端口;无限重定向通常是应用自身也做了 HTTPS 跳转,而 Nginx 未透传 X-Forwarded-Proto https,导致应用误判为 HTTP 又跳一次,补上该请求头即可。
通配符证书和多域名(SAN)证书怎么选?
通配符 *.example.com 适合子域数量多且经常新增的场景,但它只匹配一级子域,不覆盖裸域 example.com,也不覆盖 a.b.example.com,实际部署常用“通配符 + 裸域”组合。多域名证书(UCC/SAN)适合域名固定、跨主域的业务,一张证书可放 5~100 个域名,管理成本更低但新增域名必须重签。子域超过 20 个且结构稳定时,通配符更划算。
多台服务器和 CDN 场景怎么部署与续期?
推荐用 DNS-01 验证集中签发,再把证书分发到各节点:certbot certonly --manual --preferred-challenges dns -d example.com -d '*.example.com',配合云厂商 DNS API 插件(如 certbot-dns-aliyun)实现全自动。签发后通过 Ansible 或对象存储同步 fullchain.pem 与 privkey.pem,并用 --deploy-hook 触发各节点 reload。CDN 场景下,回源链路也应启用 HTTPS,否则“用户到 CDN 加密、CDN 到源站明文”,等于没有端到端加密。