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

HTTPS 证书配置全流程:从私钥与 CSR 生成到 Nginx/Tomcat 部署、证书链修复与排错

HTTPS 证书配置全流程:从私钥与 CSR 生成到 Nginx/Tomcat 部署、证书链修复与排错 — 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 到源站明文”,等于没有端到端加密。

内容审核

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