跳到主要内容
ssl证书按装

SSL 证书申请、部署与续费全流程实战:CSR 生成、Nginx/Apache/Tomcat 配置与真实报错排查

SSL 证书申请、部署与续费全流程实战:CSR 生成、Nginx/Apache/Tomcat 配置与真实报错排查 — SSL 证书申请、部署与续费全流程实战:CSR 生成、Nginx/Apache/Tomcat 配置与真实报错排查

一、问题背景与根因:HTTPS 能打开不等于配置正确

站点换上 HTTPS 后仍然报错,绝大多数不是「证书买错了」,而是下面三类根因之一。先把根因分清,后面每一步操作才有落点。

根因一:信任链断裂。CA 签发的不只是服务器证书(leaf),还有一到两张中间证书。部署时只贴了 leaf,浏览器靠缓存或 AIA 补链可能侥幸能打开,但微信小程序、iOS 原生请求、Java 客户端、curl 往往直接失败,典型报错是 unable to get local issuer certificate。正确做法是部署 fullchain(leaf + 中间证书),顺序必须是 leaf 在前、中间证书在后,根证书不要放进去。

根因二:身份不匹配。证书的 CN 只保留一个域名,真正生效的是 SAN 扩展。只签 example.com 却用 www.example.com 访问,就会命中 ERR_CERT_COMMON_NAME_INVALID。通配符 *.example.com 只覆盖一级子域,不覆盖 a.b.example.com,也不覆盖裸域 example.com(需要单独加一条 SAN)。

根因三:时效与协议失效。CA/Browser Forum 规定公有 TLS 证书单张有效期上限为 398 天,自 2020-09-01 起强制,任何宣称「一张证书管三年」的都是过时信息;Let’s Encrypt 免费证书有效期为 90 天。同时 TLS 1.0/1.1 已被 Chrome、Safari 与微信小程序拒绝,服务端必须开启 TLS 1.2/1.3。证书过期与协议过旧,是「昨天还好、今天全站白屏」最常见的原因。

先用一条命令把现状看清楚,再决定改哪里:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates

输出里 subject 看域名、issuer 看签发 CA、notAfter 看到期时间。若 -showcerts 只打印出一张证书,基本可以断定中间证书缺失。微信小程序侧还有额外硬性要求:域名已备案、证书由受信任 CA 签发、不支持自签名、服务端必须支持 TLS 1.2 及以上;否则 wx.request 会直接返回 request:fail ssl hand shake error。

二、证书选型:DV/OV/EV 与单域名/多域名/通配符的边界

选型只需要回答两个问题:要覆盖哪些域名,需不需要组织身份背书。

按覆盖范围分三类:单域名证书只保护一个 FQDN;多域名证书(SAN 证书)在一张证书里塞多个不同域名,主流 CA 默认给 5 个左右、可扩展到 100 个;通配符证书 *.example.com 覆盖该层级下所有二级子域,但不覆盖多级子域和裸域。生产上最常见的组合是「通配符 + 裸域」两条 SAN 一起签。

按验证等级分三类:DV 只验证域名控制权,几分钟签发;OV 需要核验企业工商信息,通常 1-3 个工作日;EV 验证最严,过去会在地址栏显示公司名——这一点已经过时,Chrome 77 起移除了 EV 的绿色公司名 UI,Safari、Firefox 也早已不再展示,EV 现在的价值在于合规审计与保险条款,而不是视觉差异。

有效期方面,所有公有 CA 的证书都不能超过 398 天,商业 CA 通常按「1 年(实为 397/398 天)」售卖,Let’s Encrypt 为 90 天。因此无论买哪种,都必须把续期自动化纳入交付范围,否则 398 天后必然二次故障。

等级 验证内容 签发时长 有效期上限 价格量级 典型场景
DV 域名控制权(DNS TXT / HTTP 文件) 5 分钟 – 2 小时 398 天(LE 90 天) 免费 – 数百元/年 小程序后端、API、个人站
OV 域名 + 企业工商信息 1 – 3 工作日 398 天 千元级/年 企业门户、B 端系统
EV 域名 + 深度组织核验 3 – 7 工作日 398 天 数千元/年 金融、电商合规场景

结论:小程序后端、API 网关、个人站点用 DV 通配符即可,成本最低、签发最快;只有金融、电商、招投标等明确要求组织身份或需要合规审计的场景才值得上 OV/EV。把钱花在自动化续期和监控上,收益远大于证书等级。

三、生成私钥与 CSR:openssl 可直接执行的命令

CSR(证书签名请求)包含公钥和主体信息,私钥必须留在自己服务器上,任何情况下都不要发给 CA 或代购服务商。

mkdir -p /etc/ssl/private/example.com && cd /etc/ssl/private/example.com

# 1) 生成 2048 位 RSA 私钥(4096 亦可,握手开销略高)
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out example.com.key
chmod 600 example.com.key

# 2) 生成 CSR(-subj 里 CN 只填主域名)
openssl req -new -key example.com.key -out example.com.csr 
  -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Ltd/OU=IT/CN=example.com'

注意 -subj 只写了 CN,现代证书必须靠 SAN 扩展生效,所以要用配置文件把 SAN 一起写进 CSR:

cat > san.cnf <<'EOF'
[req]
distinguished_name = dn
req_extensions = ext
prompt = no
[dn]
CN = example.com
[ext]
subjectAltName = @alt
[alt]
DNS.1 = example.com
DNS.2 = www.example.com
DNS.3 = api.example.com
EOF

openssl req -new -key example.com.key -out example.com.csr -config san.cnf

提交前自检,确认 SAN 已写入:

openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'

如果服务端是 Nginx 1.11+ 且客户端支持,可以改用 ECDSA P-256 私钥,握手更快、包更小:

openssl ecparam -genkey -name prime256v1 -out example.com.ec.key

常见坑:chmod 600 漏做,Nginx worker(nobody/www-data)读不到私钥,启动时报 BIO_new_file() failed (SSL: error:0200100D:system library:fopen:Permission denied);证书与私钥不配对时,用下面两条命令比对 modulus 校验:

openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5

四、域名验证与签发:DNS-01 与 HTTP-01 双路径实操

签发前先确认两件事:CAA 记录没有拦住你的 CA,以及验证通道可达。

dig +short CAA example.com
dig +short TXT _acme-challenge.example.com @8.8.8.8

如果 CAA 里只写了某一家 CA,换别家签发会直接被拒,报 CAA record forbids issuance。

路径 A:DNS-01(推荐,支持通配符)。以 acme.sh + 阿里云 DNS API 为例,全程无需开放 80 端口,也适合走 CDN 的站点:

curl https://get.acme.sh | sh -s email=ops@example.com
export Ali_Key='你的AccessKeyId'
export Ali_Secret='你的AccessKeySecret'

~/.acme.sh/acme.sh --issue --dns dns_ali 
  -d example.com -d '*.example.com' --keylength ec-256

~/.acme.sh/acme.sh --install-cert -d example.com --ecc 
  --key-file       /etc/nginx/ssl/example.com.key 
  --fullchain-file /etc/nginx/ssl/example.com.fullchain.pem 
  --reloadcmd      'systemctl reload nginx'

--install-cert 会把证书复制到指定路径并注册续期钩子,续期后自动 reload,这才是「一次配置、长期免维护」的关键;直接在 Nginx 里引用 ~/.acme.sh/ 下的文件,续期后可能因路径变化失效。

路径 B:HTTP-01(通用)。需要 80 端口对外可达,且 CDN 回源不能改写 /.well-known/acme-challenge/:

certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com
# 或临时停掉 web 服务独占 80
certbot certonly --standalone -d example.com

商业 CA 的 DV 证书流程类似:在 DNS 服务商处添加 CA 指定的 TXT 记录(形如 _dnsauth.example.com),等 TTL 生效后回控制台点验证。TTL 建议临时调到 60 秒,通过后再改回;Cloudflare 的橙云代理会隐藏源站,务必先切灰或直接改用 DNS-01。

常见失败:Error getting validation data(80 端口不通或被 WAF 拦截)、too many failed authorizations recently(同一账户失败过多,需等待 1 小时)、Invalid response ... 404(webroot 路径与实际站点根目录不一致)。

五、服务端配置示例:Nginx、Apache、Tomcat

Nginx 建议把 80 与 443 拆成两个 server 块,80 只做跳转。注意 http2 的写法在 1.25.1 之后变了:

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.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/trusted.pem;

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

改完必须先 nginx -t 再 systemctl reload nginx,不要 restart,避免连接中断。

Apache 关键指令如下,httpd 2.4.8+ 只需把 fullchain 写进 SSLCertificateFile:

<VirtualHost *:443>
    ServerName example.com
    SSLEngine on
    SSLCertificateFile      /etc/httpd/ssl/example.com.fullchain.pem
    SSLCertificateKeyFile   /etc/httpd/ssl/example.com.key
    # httpd < 2.4.8 才需要额外指定:
    # SSLCertificateChainFile /etc/httpd/ssl/chain.crt
    SSLProtocol -all +TLSv1.2 +TLSv1.3
    Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>

Tomcat 需要先转成 PKCS12,再改 Connector:

openssl pkcs12 -export -in fullchain.pem -inkey example.com.key 
  -out /opt/tomcat/conf/example.p12 -name tomcat -passout pass:ChangeMe123
<Connector port='8443' protocol='org.apache.coyote.http11.Http11NioProtocol'
           maxThreads='200' SSLEnabled='true' scheme='https' secure='true'>
  <SSLHostConfig protocols='TLSv1.2,TLSv1.3'>
    <Certificate certificateKeystoreFile='/opt/tomcat/conf/example.p12'
                 certificateKeystorePassword='ChangeMe123'
                 certificateKeystoreType='PKCS12'/>
  </SSLHostConfig>
</Connector>

Tomcat 的坑集中在两处:一是 JDK 8 早期版本默认不启用 TLS 1.3;二是 PKCS12 里必须包含完整链,用 keytool -list -v -keystore example.p12 应能看到 3 条证书条目,少于 3 条大概率缺中间证书。

六、HTTP 301 跳转与 TLS 加固:参数逐项说明

跳转只有一行,但写错会带来两类问题:重定向循环,以及 CDN 场景下把用户跳到源站域名。

第一,用 $host 而不是 $http_host。$host 是规范化后的 Host(去端口、按 server_name 匹配),$http_host 是客户端原始 Host 头,可能带端口或被伪造,用于跳转就是开放重定向漏洞。第二,HTTPS 挂在非 443 端口时跳转要显式带端口:return 301 https://$host:8443$request_uri;。第三,CDN 回源若也走 80,源站不能无条件 301,否则 CDN 跟随跳转拿到的是 HTML 而非静态资源,应按转发头判断:

if ($http_x_forwarded_proto = 'http') {
    return 301 https://$host$request_uri;
}

HSTS 要灰度下发。Strict-Transport-Security 一旦下发,浏览器在 max-age 内不会再发任何 HTTP 请求。首次上线建议 max-age=300 跑一周,确认所有子域都能走 HTTPS 再改成 31536000;加了 includeSubDomains 意味着所有子域(包括没配证书的测试域、内网域)都必须支持 HTTPS,这是「上线后子域全挂」最常见的事故源。提交 preload 列表后撤销极慢,务必最后做。

OCSP Stapling 依赖链文件。ssl_stapling on 必须有 ssl_trusted_certificate 指向包含中间与根证书的 PEM,否则 Nginx 只打警告不生效:[warn] 'ssl_stapling' ignored, issuer certificate not found。链文件可用 cat chain.crt root.crt > trusted.pem 拼出。开启后握手少一次外网 OCSP 请求,客户端查询失败也不会阻塞握手。

TLS 1.3 的套件不受 ssl_ciphers 控制。要单独用 ssl_conf_command Ciphersuites TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256;(需 OpenSSL 1.1.1+)。多数场景保持默认即可,强行收窄反而会让部分安卓 WebView 握手失败。

会话复用别关。ssl_session_cache shared:SSL:10m 约可容纳 4 万个会话,配合 ssl_session_timeout 1d 能显著降低 TLS 握手 CPU 开销,对高并发 API 网关收益明显。

七、方案对比表格:证书类型、验证方式与部署成本

选型决策可以拆成三张表:覆盖范围决定买几张,验证等级决定审核周期,验证方式决定运维通道。

覆盖类型 示例 覆盖范围 不覆盖 适用
单域名 example.com 1 个 FQDN 任何子域、裸域之外的域名 单站点、独立 API
多域名 SAN a.com, b.com, api.a.com 默认 5 个,可扩至 100 个 未列出的域名 多品牌、多业务线
通配符 *.example.com 所有一级子域 裸域 example.com、a.b.example.com 子域多、频繁新增
验证方式 原理 是否支持通配符 前置条件 失败高发点
HTTP-01 访问 /.well-known/acme-challenge/ 文件 否 80 端口公网可达 CDN 回源改写、WAF 拦截、webroot 路径错
DNS-01 校验 _acme-challenge TXT 记录 是 DNS API 权限 TTL 未生效、多值 TXT 冲突、CAA 拦截
邮件/文件(商业 CA) 管理员邮箱或指定文件 视 CA 而定 WHOIS 邮箱可用 邮箱不可达、隐私保护屏蔽 WHOIS
方案 有效期 成本 续期方式 适合团队
Let’s Encrypt + acme.sh 90 天 0 元 cron 自动,60 天续 有运维能力的团队
商业 DV(单域/通配符) ≤398 天 数百至数千元/年 手动或 API 重签 需要发票、SLA、责任赔付
商业 OV/EV ≤398 天 千元至数千元/年 人工审核后重签 金融、电商、招投标

一个容易被忽略的成本项:OV/EV 每年续期都要重新走企业审核,1-3 个工作日的空窗必须提前排期;DV 与 Let’s Encrypt 则可完全自动化,故障率反而更低。

八、常见错误排查:真实报错与定位命令

下面这些报错在工单里出现频率最高,按「报错原文 → 根因 → 修复动作」对照处理即可。

报错原文 根因 修复
nginx: [emerg] cannot load certificate ... BIO_new_file() failed 路径写错或 worker 无读权限 ls -l 核对路径,chmod 600 key、目录 chmod 755
SSL_CTX_use_PrivateKey(...) failed: key values mismatch 证书与私钥不配对 比对 modulus md5,重新签发
curl: (60) SSL certificate problem: unable to get local issuer certificate 缺中间证书 改用 fullchain 部署
NET::ERR_CERT_COMMON_NAME_INVALID SAN 未包含访问域名 重签并补 SAN
NET::ERR_CERT_DATE_INVALID 证书过期或服务器时间偏移 timedatectl 校时,立即续期
curl: (35) ... sslv3 alert handshake failure 协议/套件不匹配 开启 TLS 1.2/1.3,放宽 ssl_ciphers
request:fail ssl hand shake error(小程序) 链不完整或仅支持 TLS 1.0/1.1 补 fullchain,改协议版本
[warn] 'ssl_stapling' ignored, issuer certificate not found 缺 ssl_trusted_certificate 拼接 trusted.pem 并指向

证书链是否完整,可用一条命令验证,输出 OK 才算通过:

openssl verify -CAfile root.crt -untrusted chain.crt example.com.crt
# example.com.crt: OK

443 端口不通时先分层排查,不要一上来就改配置:

ss -lntp | grep ':443'
telnet example.com 443
# 云上还需确认安全组放行入方向 443,且未被 iptables/firewalld 拦截
firewall-cmd --list-ports

Let’s Encrypt 报 Error getting validation data 时,用 curl -v http://example.com/.well-known/acme-challenge/test 手工复现验证路径,能最快区分是 DNS、端口还是 WAF 的问题。

九、效果验证与续费自动化

配置完成后至少做三层验证:证书信息、协议能力、跳转行为。

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

# 2) 确认 TLS 1.0/1.1 已被拒绝
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null 2>&1 | grep -i 'alert|error'

# 3) 确认 80 跳 301 到 https
curl -sI http://example.com | head -n 5
curl -sI https://example.com | grep -i 'strict-transport-security'

续期必须自动化。acme.sh 安装时会写入 crontab,确认存在这一行:

crontab -l | grep acme.sh
0 3 * * * '/root/.acme.sh'/acme.sh --cron --home '/root/.acme.sh' > /dev/null

certbot 用户用 systemd timer,并做一次 dry-run 演练,避免真到过期才发现钩子失效:

systemctl list-timers | grep certbot
certbot renew --dry-run

再加一个独立的到期监控,任何非 200 或剩余天数低于阈值就告警,比依赖 CA 邮件更可靠:

#!/usr/bin/env bash
HOST=example.com
END=$(echo | openssl s_client -servername $HOST -connect $HOST:443 2>/dev/null 
      | openssl x509 -noout -enddate | cut -d= -f2)
LEFT=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
[ $LEFT -lt 15 ] && echo "WARN $HOST expires in $LEFT days"

最后用 SSL Labs 或 testssl.sh 做一次全量体检,重点看三项:证书链是否完整、是否支持 TLS 1.2/1.3、是否启用了 HSTS。三项全绿,微信小程序与苹果 ATS 侧基本不会再有握手类问题。

常见问题

SSL 证书最长能用多久?为什么有人说是 398 天、有人说是 1 年?

公有 CA 签发的 TLS 证书单张有效期上限是 398 天,自 2020-09-01 起由 CA/Browser Forum 强制,超出该期限的证书会被 Chrome、Safari 直接判为不受信任。商业 CA 售卖的「1 年证书」实际签发天数就是 397/398 天;Let’s Encrypt 免费证书固定 90 天。所谓「三年期证书」现在只是把三年拆成三张 398 天的证书分批签发,本质仍需每年更换。

一张通配符证书能覆盖 www.example.com 和 example.com 吗?

不能。*.example.com 只匹配一级子域,裸域 example.com 必须作为独立 SAN 一起签发,所以正确写法是 -d example.com -d '*.example.com'。同理 *.example.com 也不覆盖 a.b.example.com,多级子域要单独列 SAN 或另签一张 *.b.example.com。

证书链不完整,为什么浏览器能开、小程序却报错?

桌面浏览器会缓存中间证书,并通过证书里的 AIA 地址自动下载补链,所以看起来「正常」;微信小程序、iOS 原生请求、Java 客户端、curl 等不做补链,缺中间证书就直接握手失败。判断方法:openssl s_client -showcerts 只输出一张证书即为缺链,改用 fullchain(leaf + 中间证书,leaf 在前)重新部署即可。

更换证书后需要重启 Nginx / Tomcat 吗?

Nginx 用 systemctl reload nginx 即可平滑加载新证书,不要 restart,避免连接中断;acme.sh 的 --reloadcmd 就是干这件事。Tomcat 需要重新加载 Connector,通常是重启服务,因此更推荐用 PKCS12 + 版本化文件名,重启前先 keytool -list -v 确认链完整,减少停机排错时间。

免费 Let’s Encrypt 证书和付费 DV 证书在安全性上有区别吗?

加密强度没有区别,两者都是 DV 级别、都走同样的 ACME 或人工验证、都能签 ECDSA P-256 或 RSA 2048。差异在有效期(90 天 vs 398 天)、是否有商业 SLA 与责任赔付、是否提供发票、是否支持自定义有效期和证书透明度日志定制。技术选型上,只要续期自动化到位,免费证书完全能满足小程序与生产 API 的需求。

开启 HSTS 之后,子域访问不了 HTTPS 怎么办?

这是 includeSubDomains 带来的典型事故:浏览器在 max-age 内强制所有子域走 HTTPS,而某个子域没有证书或只支持 HTTP。应急办法是给该子域补一张证书(通配符最省事),或在确认风险后用 max-age=0 覆盖响应头清除缓存。规范做法是先以 max-age=300 灰度一周,逐个确认子域可用后再提升到 31536000,最后才考虑提交 preload。

内容审核

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