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

HTTPS 证书配置实战:从 CSR 申请、Nginx 部署到 301 跳转与故障排查

HTTPS 证书配置实战:从 CSR 申请、Nginx 部署到 301 跳转与故障排查 — HTTPS 证书配置实战:从 CSR 申请、Nginx 部署到 301 跳转与故障排查

一、问题背景:证书“买了、装了”为什么还是不安全

在 HTTPS 改造项目里,最高频的工单不是“如何申请证书”,而是“证书已经签发并上传,浏览器仍然报不安全”。典型现场有三种:Chrome 地址栏显示锁,但部分安卓机打开提示“您的连接不是私密连接”;微信小程序 wx.request 报 request:fail ssl handshake error;后端 Java 服务调用第三方 HTTPS 接口抛 PKIX path building failed。这些现象看起来各不相同,根因却高度集中。

第一类是证书链不完整。CA 签发时给出的是“服务器证书 + 中间证书”,很多人只把服务器证书写进 ssl_certificate。桌面版 Chrome 有 AIA 补链机制会自动下载中间证书,所以出现“我本地是好的”;而 Android、Java、curl、小程序、iOS 原生请求走严格校验,缺中间证书会直接握手失败。

第二类是域名不匹配。通配符证书 *.example.com 只覆盖一级子域,不覆盖裸域 example.com,也不覆盖 a.b.example.com。第三类是私钥与证书不成对,多见于 CSR 在多台机器上生成、或续期后只换了 crt 没换 key。

第四类是协议与套件过旧:服务端仍开启 TLSv1.0/1.1,或只提供 3DES/RC4 套件,现代浏览器和微信小程序(要求 TLS 1.2 及以上)会直接拒绝。第五类是环境问题:服务器时间偏差导致 certificate is not yet valid;同一 IP 承载多站点却未启用 SNI;以及最容易被误判的一种——域名未完成 ICP 备案,80/443 被运营商侧拦截,这与证书本身毫无关系,换任何 CA 都不会好。

二、准备阶段:生成 CSR、校验私钥与选对证书类型

无论走免费还是商业渠道,第一步都是生成密钥对与 CSR。推荐 RSA 2048 位(兼容性最好)或 ECDSA P-256(体积小、握手快,但需确认客户端支持)。

# RSA 2048
openssl genrsa -out example.com.key 2048
# 或 ECDSA P-256
openssl ecparam -genkey -name prime256v1 -out example.com.key

# 生成 CSR(CN 写主域名,其余域名走 SAN)
openssl req -new -key example.com.key -out example.com.csr 
  -subj "/C=CN/ST=Beijing/L=Beijing/O=Example Ltd/CN=example.com"

# 查看 CSR 内容,确认 SAN 列表
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"

拿到证书后务必先做本地校验,避免“传上去才发现不对”:

# RSA:比对模数指纹,两行输出必须完全一致
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5

# ECDSA:比对公钥
openssl x509 -noout -pubkey -in example.com.crt | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5

# 校验证书链(chain.pem 为中间证书)
openssl verify -CAfile chain.pem -untrusted chain.pem example.com.crt

选型上,DV 证书只校验域名控制权,适合个人站与内部系统;OV/EV 需要企业资质与组织核验,适合金融、电商等需要展示主体信息的场景。这里要纠正一个过时认知:主流浏览器自 2019 年起已取消 EV 证书的绿色地址栏,EV 只剩证书详情里的组织字段,加密强度与 DV 完全相同,不要被“EV 更安全”的销售话术误导。

有效期方面必须更新认知:公共信任证书单次有效期上限为 398 天(CA/B Forum 规定,2020 年 9 月起生效),Let’s Encrypt 默认 90 天,并已提供 6 天短期证书选项,行业也已确定逐步缩短至 47 天的路线。这意味着“一年一续”的人工模式必然出事故,自动化续期是硬性要求而非可选项。

三、完整实操:从签发到 Nginx 上线(命令可直接执行)

路线 A:Let’s Encrypt 自动化签发,零成本、可续期。

apt install -y certbot python3-certbot-nginx

# 单域名/多域名:HTTP-01 校验,自动改写 Nginx 并加 301
certbot --nginx -d example.com -d www.example.com 
  --agree-tos -m ops@example.com --redirect

# 泛域名:必须走 DNS-01
certbot certonly --manual --preferred-challenges dns 
  -d "*.example.com" -d example.com

路线 B:商业证书手工部署。关键动作是把服务器证书与中间证书拼成 fullchain,这是 90% 故障的分水岭:

install -m 600 example.com.key /etc/nginx/ssl/example.com.key
cat example.com.crt intermediate.crt > fullchain.pem
install -m 644 fullchain.pem /etc/nginx/ssl/fullchain.pem
install -m 644 intermediate.crt /etc/nginx/ssl/chain.pem

然后做语法检查与平滑重载,reload 不会断开现有连接:

nginx -t && nginx -s reload

若使用云负载均衡(SLB/ALB)或 CDN,则把 fullchain 与私钥上传到证书管理控制台,再绑定 443 监听;容器环境用 Ingress 的 tls 字段引用 Secret:

kubectl create secret tls example-tls 
  --cert=fullchain.pem --key=example.com.key -n prod

安全细节别省略:私钥必须 600 且属主为 root;证书目录绝不能放在 Web 根目录下,.key 可被直接下载是最常见的信息泄露源;证书文件不要提交进 Git 仓库。整套流程 15 分钟内可以跑完,真正的成本在后续的续期与巡检。

四、配置示例:Nginx、Apache、Spring Boot 与 301 跳转

Nginx 生产可用模板,含 HTTP 301、TLS 1.2/1.3、OCSP Stapling 与 HSTS:

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/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_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/nginx/ssl/chain.pem;

    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;

    location / {
        root /var/www/example;
        index index.html;
    }
}

Apache 的写法差异在于需要单独指定 SSLCertificateChainFile:

<VirtualHost *:443>
    SSLEngine on
    SSLCertificateFile      /etc/httpd/ssl/example.com.crt
    SSLCertificateKeyFile   /etc/httpd/ssl/example.com.key
    SSLCertificateChainFile /etc/httpd/ssl/intermediate.crt
    SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
    Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>

Spring Boot 内嵌 Tomcat 需先转成 PKCS12:

openssl pkcs12 -export -in fullchain.pem -inkey example.com.key 
  -out example.p12 -name example -passout pass:$SSL_PASS
server:
  port: 443
  ssl:
    enabled: true
    key-store: classpath:example.p12
    key-store-type: PKCS12
    key-store-password: ${SSL_PASS}
    enabled-protocols: TLSv1.2,TLSv1.3

关于跳转:return 301 会把 POST 降级为 GET,纯前端站点无影响,但 API 网关建议用 308 保留请求方法与请求体。HSTS 首次上线先给 max-age=300 观察一天,确认全站无混合内容后再拉到一年,否则回退极其痛苦。

五、方案对比:证书类型与部署方式怎么选

先看校验等级。下表是三类证书的实际差异,注意“浏览器展示”一列已经和很多旧文章写的不同:

维度 DV 域名型 OV 企业型 EV 增强型
校验内容 域名控制权 域名 + 企业资质 域名 + 企业资质 + 更严格核验
签发时长 分钟级 1–3 个工作日 3–7 个工作日
浏览器展示 锁标志 锁标志(详情可见组织) 锁标志(绿色地址栏已取消)
典型用途 个人站、测试、内部系统 企业官网、SaaS 金融、政务
价格区间 0–数百元 千元级 数千元

再看覆盖范围,这是“证书买错”最集中的地方:

类型 覆盖 不覆盖
单域名 example.com www.example.com
多域名 SAN 证书中列出的每个域名 未列出的域名
泛域名 *.example.com www / api / shop 等一级子域 裸域 example.com、a.b.example.com

最后是部署方式的选择,续期能力比价格更值得关注:

方式 续期方式 适合场景 常见坑
Nginx 自建 + certbot systemd timer 自动 自有服务器、成本敏感 需放行 80 端口做 HTTP-01
云 SLB / ALB 控制台或 API 上传 云上多实例业务 证书须上传到同一地域
CDN 托管证书 平台自动签发续期 静态站、高并发 回源须也是 HTTPS,否则混合内容
K8s Ingress cert-manager 容器化微服务 Secret 必须与 Ingress 同 namespace

一句话结论:子域数量少于 5 个用多域名 SAN 更省心,子域动态增长(如每个租户一个二级域)才用泛域名;而无论选哪种,都要把“有效期上限 398 天、Let’s Encrypt 90 天”写进运维台账。

六、常见错误排查:8 个真实报错与对应处置

1)curl: (60) SSL certificate problem: unable to get local issuer certificate
缺中间证书。用 openssl s_client -showcerts 看是否只返回一张证书,修复方式是 cat example.com.crt intermediate.crt > fullchain.pem 后 reload。

2)nginx: [emerg] SSL_CTX_use_PrivateKey_file("/etc/nginx/ssl/example.com.key") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
私钥与证书不匹配。用第二节的 modulus/pubkey 指纹比对,重新匹配 CSR 与 key。

3)error 20 at 0 depth lookup: unable to get local issuer certificate
chain.pem 缺中间证书,或拼接顺序错误。正确顺序是“服务器证书 → 中间证书”,不要拼根证书。

4)NET::ERR_CERT_COMMON_NAME_INVALID / SSL_ERROR_BAD_CERT_DOMAIN
SAN 不含当前访问域名。执行 openssl x509 -noout -text -in example.com.crt | grep -A1 "Subject Alternative Name" 确认,泛域名证书记得补裸域。

5)curl: (35) error:14094410:SSL routines:ssl3_read_bytes:sslv3 alert handshake failure
客户端与服务端没有共同协议或套件。检查 ssl_protocols 是否已开 TLSv1.2/1.3,套件里是否只剩已被淘汰的 3DES。

6)微信小程序 request:fail ssl handshake error
逐项确认:TLS ≥ 1.2、证书链完整、域名已在微信后台配置、请求地址不带端口号、证书由公共信任 CA 签发。

7)SSL certificate problem: certificate has expired 或 certificate is not yet valid
前者是续期失败,后者是服务器时间错误。用 timedatectl status 查看,chronyd/ntpd 重新同步。

8)证书正常但站点 502 / 打不开
多为安全组未放行 443,或回源仍是 HTTP 被 CDN 拒绝;也可能是之前误配了长周期 HSTS,浏览器强制跳转 https 而 443 未监听。

七、效果验证:命令行自检 + 在线评级 + 到期巡检

部署完不要只看浏览器,用四条命令做客观验证:

# 1. 证书主题、签发者与有效期
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates

# 2. 链校验,期望输出 Verify return code: 0 (ok)
openssl s_client -connect example.com:443 -servername example.com 
  -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null 2>/dev/null | grep "Verify return code"

# 3. 301 跳转是否生效
curl -sI http://example.com | head -2

# 4. 旧协议应握手失败(预期报 handshake failure)
openssl s_client -connect example.com:443 -tls1_1 </dev/null

把到期检查做成定时任务,比任何人工台账都可靠:

#!/bin/bash
end=$(openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -enddate | cut -d= -f2)
days=$(( ( $(date -d "$end" +%s) - $(date +%s) ) / 86400 ))
if [ "$days" -lt 15 ]; then
  echo "WARN: example.com 证书剩余 ${days} 天" | mail -s "SSL 到期告警" ops@example.com
fi

写入 crontab:0 9 * * * /opt/scripts/check_ssl.sh。在线侧用 SSL Labs 做一次全量评级,拿到 A/A+ 的条件通常是:仅启用 TLS 1.2/1.3、启用 HSTS、无 RC4/3DES、开启 OCSP Stapling、RSA 密钥 ≥ 2048 位或 ECDSA P-256、支持前向保密套件。评级从 A 掉到 B 时,九成是套件列表里残留了 CBC 或密钥长度不足。

八、续期与长期运维:把“到期事故”变成不可能

证书有效期上限 398 天、Let’s Encrypt 90 天,且行业正推进缩短至 47 天,靠日历提醒续期已经不现实。certbot 用户先做一次演练,确认整个续期链路可用:

certbot renew --dry-run
systemctl list-timers | grep certbot   # 确认 certbot.timer 已启用

续期成功后必须让 Nginx 重新加载,否则新证书不会生效。用 deploy hook 固化这一步:

# /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh
#!/bin/bash
nginx -t && systemctl reload nginx || systemctl restart nginx

chmod +x /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh

泛域名证书走 DNS-01,手工模式无法自动续期,应改用 DNS 插件(如 certbot-dns-aliyun、certbot-dns-cloudflare)并配置只允许改 TXT 记录的 API 子账号,凭据文件权限设为 600。

商业证书用户的运维重点是“台账 + 灰度”:把每张证书的域名、签发日、到期日、部署位置(Nginx / SLB / CDN / Ingress)记进 CMDB;到期前 30 天完成新证书上传,先在测试域名验证链完整,再切生产。多实例场景要确保所有节点都替换,漏掉一台就会出现“刷新几次有时正常有时报错”的诡异现象。最后给证书文件加监控告警,任何节点剩余天数低于 15 天即触发工单,这样“证书过期”才会真正变成历史问题。

常见问题

问题:泛域名证书能同时覆盖 example.com 和 www.example.com 吗?

不能完全覆盖。*.example.com 只匹配一级子域,因此覆盖 www.example.com、api.example.com,但不覆盖裸域 example.com,也不覆盖 a.b.example.com。正确做法是申请时把裸域一并加入 SAN,即同时提交 *.example.com 与 example.com,大多数 CA 支持这种组合。

问题:SSL 证书有效期最长是多少天?

公共信任证书单次有效期上限为 398 天(CA/B Forum 规定,2020 年 9 月起生效),不是过去常说的一到两年。Let’s Encrypt 默认 90 天,并提供 6 天短期证书选项;行业已确定逐步缩短至 47 天的路线。因此续期必须自动化,手工续期在 47 天时代基本不可行。

问题:域名没有备案,能配 HTTPS 吗?

技术上可以签发并安装证书,但备案是 ICP 管理要求,与证书无关。域名解析到中国大陆境内服务器时,未备案会被接入商侧拦截,此时 HTTPS 同样打不开,很容易被误判为“证书问题”。若服务器在境外或使用港澳节点,则不受此限制,但访问速度与稳定性需自行评估。

问题:HTTP 301 跳转到 HTTPS 会影响接口和小程序吗?

会有影响。301 是永久重定向,部分客户端会把 POST 改写为 GET 并丢弃请求体,API 场景建议改用 308 保留方法与请求体。微信小程序要求请求地址必须是 HTTPS、TLS 1.2 及以上、证书链完整且不能带端口号,因此小程序后端应直接使用 https 地址,不要依赖 301。

问题:免费证书和付费证书的加密强度有区别吗?

没有区别。加密强度由密钥长度与协议套件决定,与是否付费无关,DV 免费证书和万元级 EV 证书用的是同一套 TLS 加密。差异在于有效期长度、泛域名支持、赔付保障、OCSP/CRL 稳定性、技术支持响应,以及 OV/EV 提供的组织身份核验信息。

问题:更换证书后需要重启 Nginx 吗?

不需要重启,nginx -t 校验配置后执行 nginx -s reload 或 systemctl reload nginx 即可平滑加载新证书,现有连接不会中断。只有在 reload 失败或需要更换监听端口、协议栈等结构性变更时才考虑 restart。

内容审核

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