跳到主要内容
HTTPS安装配置

通配符 SSL 证书申请与 HTTPS 部署全流程:DV/OV/EV 选型、Nginx 配置与真实报错排查

通配符 SSL 证书申请与 HTTPS 部署全流程:DV/OV/EV 选型、Nginx 配置与真实报错排查 — 通配符 SSL 证书申请与 HTTPS 部署全流程:DV/OV/EV 选型、Nginx 配置与真实报错排查

问题背景与根因:为什么“买个证书装上”远远不够

原文把 HTTPS 当成一次性商品:“100 元/个/年(含安装)”,支持微信公众号、小程序、APP、公司网站、安卓/苹果系统。但在实际部署中,真正导致上线失败的几乎都不是证书本身,而是下面几条硬规则没被遵守:

  • 有效期上限 398 天:CA/Browser Forum 规定,2020-09-01 之后签发的公开信任 SSL/TLS 证书,单张有效期不得超过 398 天。所谓“买三年”,实际是签发 398 天证书再自动重签,任何声称单张证书有效期 2–3 年的说法都已过时。
  • Let’s Encrypt 只有 90 天:免费证书有效期固定 90 天,必须靠 cron 自动续期,手工续期等于给自己埋雷。
  • 通配符只覆盖一级:*.example.com 不覆盖裸域 example.com,也不覆盖 a.b.example.com。
  • EV 没有绿色地址栏:Chrome 77(2019)起已取消 EV 证书的绿色公司名展示,EV 的价值只剩企业主体背书与合规审计。
  • TLS 1.0/1.1 已被弃用:Chrome 98、Firefox、Safari 均已停止支持,服务端必须只开 TLS 1.2 / 1.3。

先做两个 30 秒体检,判断站点到底缺什么:

curl -sI http://www.example.com | head -n 5
openssl s_client -connect www.example.com:443 -servername www.example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates

第一条看是否 301 跳转到 https;第二条看证书的 subject(是否覆盖你的域名)、issuer(谁签发的)、dates(剩余有效期)。如果第二条直接报 connect: Connection refused,说明 443 根本没监听,问题在 Web 服务器配置而不在证书;如果 curl 报 unable to get local issuer certificate,说明中间证书没装。

还要注意验收标准不同:微信小程序 wx.request 强制 HTTPS,且要求 TLS 1.2+、证书链完整、域名已备案;Android 9(API 28)默认禁止明文 HTTP;iOS ATS 要求 TLS 1.2 加前向保密套件。“公司网站能打开”不等于“小程序能调用”。

DV / OV / EV 与通配符证书的选型对比

选型错误是最常见的隐性成本。原文把 DV、EV 并列报价,但两者的签发流程、价格量级、适用场景完全不同,通配符更是只能走 DNS 验证。先看对照表:

类型 验证方式 单张有效期 覆盖范围 浏览器表现 参考价格 典型场景
DV 单域名 DNS TXT 或 HTTP 文件 ≤398 天 1 个精确域名 锁标识 0–100 元/年 测试环境、个人站、单接口
DV 通配符 仅 DNS-01 ≤398 天 *.example.com 一级子域 锁标识 300–1500 元/年 多子域、SaaS、小程序多环境
OV 企业营业执照核验 ≤398 天 单域名或多域名 SAN 锁标识 800–3000 元/年 企业官网、支付回调
EV 企业+电话+律师函核验 ≤398 天 单域名或多域名 SAN 无绿条(Chrome 77+) 2000–8000 元/年 金融、政企合规审计
Let’s Encrypt DNS-01 / HTTP-01 90 天 支持通配符 锁标识 免费 自动化运维、内部服务

三条必须记住的规则:

  1. 通配符只匹配一级子域。*.example.com 匹配 api.example.com,不匹配 example.com,也不匹配 v1.api.example.com。所以申请时 SAN 必须同时写 *.example.com 和 example.com。
  2. 通配符只能做 DNS-01 验证,无法用 HTTP 文件验证,这意味着你必须能操作 DNS 解析记录或调用云厂商 API。
  3. 多数 CA 不签发 EV 通配符,需要 EV 的合规场景请按单域名或多域名 SAN 规划。

拿到 CSR 后,第一件事是核对 SAN 是否写对,别等签发完才发现少了一个域名:

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

输出应为 DNS:*.example.com, DNS:example.com。若只有 CN 没有 SAN,现代浏览器会直接报 ERR_CERT_COMMON_NAME_INVALID,因为 Chrome 58 之后不再回退读取 CN。

第一步:用 OpenSSL 生成私钥与 CSR

私钥在你自己手里生成,只把 CSR 交给 CA,这是基本纪律。以下命令可直接复制执行:

# 方案 A:RSA 2048,兼容性最好
openssl genrsa -out example.com.key 2048

# 方案 B:ECDSA P-256,握手更快,TLS 1.3 友好
openssl ecparam -genkey -name prime256v1 -out example.com.key

chmod 600 example.com.key
chown root:root example.com.key

openssl req -new -key example.com.key -out example.com.csr 
  -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Technology Co.,Ltd/CN=*.example.com' 
  -addext 'subjectAltName=DNS:*.example.com,DNS:example.com'

参数要点:

  • -subj 避免交互式输入,适合脚本化;OV/EV 证书的 O 字段必须与营业执照名称完全一致,中文需用拼音或英文,否则 CA 审核会退回。
  • -addext 是 OpenSSL 1.1.1+ 的写法;若你的 OpenSSL 是 1.0.2,需要手写 openssl.cnf 的 [v3_req] 段并在签发时加 -extensions v3_req。
  • 不要用 1024 位 RSA,主流 CA 已拒绝签发;签名算法必须是 SHA-256,SHA-1 早已被浏览器判定为不安全。

生成后做两项自检:

# 校验 CSR 签名有效性
openssl req -in example.com.csr -noout -verify

# 校验私钥与 CSR 是否配对
openssl req -in example.com.csr -noout -verify -key example.com.key

# 查看密钥强度
openssl rsa -in example.com.key -text -noout | head -n 1

两条校验都返回 verify OK 才提交给 CA。私钥请立即离线备份一份(加密存储),因为证书续期时若沿用同一私钥,旧备份就是你的救命稻草;若每次续期都换新私钥(推荐),则备份仅用于应急回滚。切记不要把 .key 发给任何 CA 或第三方“代安装”人员。

第二步:通配符证书申请,用 acme.sh 走 DNS-01 全自动

通配符证书无法用 HTTP-01 验证,必须走 DNS-01。手工去控制台加 TXT 记录可行但不可持续(90 天一次),推荐用 acme.sh 调用云厂商 API 自动写入。以阿里云 DNS 为例:

curl https://get.acme.sh | sh -s email=admin@example.com
source ~/.bashrc

export Ali_Key='LTAI5tXXXXXXXXXXXX'
export Ali_Secret='XXXXXXXXXXXXXXXXXXXX'

acme.sh --issue --dns dns_ali 
  -d example.com -d '*.example.com' 
  --keylength ec-256 
  --server letsencrypt

常用 DNS 插件对应关系:阿里云 dns_ali、腾讯云 DNSPod dns_dp、Cloudflare dns_cf、华为云 dns_huaweicloud。子账号权限只需 AliyunDNSFullAccess 即可,不要用主账号 AK。

签发成功后,把证书安装到固定路径,并绑定重载命令,这一步决定了后续能否自动续期:

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      'nginx -t && nginx -s reload'

验证自动续期任务是否已写入:

crontab -l | grep acme.sh
acme.sh --list
acme.sh --renew -d example.com --ecc --force

如果没有 DNS API 权限,可用手动模式先拿到 TXT 值,去控制台添加后再继续:

acme.sh --issue --dns -d example.com -d '*.example.com' 
  --yes-I-know-dns-manual-mode-enough-go-ahead-please
# 按提示添加 _acme-challenge.example.com 的 TXT 记录后
acme.sh --renew -d example.com --yes-I-know-dns-manual-mode-enough-go-ahead-please

注意:手动模式不会自动续期,仅作应急。生产环境务必用 API 模式,并把 --reloadcmd 配好,否则证书文件更新了但 Nginx 还在用旧证书,这是最常见的“续期了却还报过期”的根因。

第三步:Nginx / Apache / 宝塔配置示例

配置的核心只有一条:ssl_certificate 必须指向包含中间证书的 fullchain,而不是只含服务器证书的 cert.pem。缺中间证书会导致 Android、微信小程序、Java 客户端握手失败,而桌面浏览器因为会自动补链反而正常,极具迷惑性。

Nginx 完整示例:

server {
    listen 80;
    server_name example.com *.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 *.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;

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

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto https;
    }
}

Apache 2.4 示例:

<VirtualHost *:443>
    SSLEngine on
    SSLCertificateFile      /etc/httpd/ssl/example.com.fullchain.pem
    SSLCertificateKeyFile   /etc/httpd/ssl/example.com.key
    # Apache 2.4.8+ 若 fullchain 已含中间证书,可省略下一行
    SSLCertificateChainFile /etc/httpd/ssl/example.com.chain.pem
    SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
    Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>

宝塔面板用户直接在“网站 → SSL → 其他证书”里粘贴 fullchain.pem 的完整内容和私钥,保存后强制 HTTPS。切忌只粘第一段 BEGIN CERTIFICATE,那正是链不完整的来源。

改完先测再重载:nginx -t 通过后再 systemctl reload nginx。nginx -s reload 是平滑重载,不会断开现有连接。

微信小程序 / 公众号 / APP / 安卓 iOS 的额外要求

原文说“支持微信公众号、小程序、APP、安卓/苹果系统”,这句话成立的前提是满足各端的额外校验,证书类型只是其中一环:

  • 微信小程序:wx.request 仅允许 HTTPS,要求 TLS 1.2 及以上,证书必须被系统信任(自签名无效),域名需完成 ICP 备案,且不能只填 IP。同时小程序后台要配置 request 合法域名。
  • 公众号:JS 接口安全域名、网页授权回调域名同样要求 HTTPS,且不能带端口以外的非标路径。
  • iOS ATS:默认要求 TLS 1.2、支持前向保密的密码套件(ECDHE)、证书链完整且签名算法为 SHA-256 以上,否则需在 Info.plist 里开例外(审核风险高,不推荐)。
  • Android 9+:默认禁止明文流量,需要在 network_security_config 中显式声明。
<network-security-config>
    <base-config cleartextTrafficPermitted='false'/>
</network-security-config>

用以下命令逐项验证服务端是否达标(把域名换成你的 API 域名):

# 检查是否支持 TLS 1.2
openssl s_client -connect api.example.com:443 -servername api.example.com -tls1_2 </dev/null | grep -E 'Protocol|Cipher'

# 检查是否误开了 TLS 1.0(应报 handshake failure)
openssl s_client -connect api.example.com:443 -servername api.example.com -tls1 </dev/null

# 检查证书链是否完整下发
openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null | grep -c 'BEGIN CERTIFICATE'

最后一条返回 2 或 3 才算链完整(服务器证书 + 中间证书,部分 CA 有交叉链)。如果返回 1,安卓端大概率报 javax.net.ssl.SSLHandshakeException: Trust anchor for certification path not found,而浏览器却一切正常。

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

下面 6 条是 HTTPS 部署中出现频率最高的报错,附定位命令与根因:

1. 浏览器 NET::ERR_CERT_COMMON_NAME_INVALID
根因:域名不在证书 SAN 里,或通配符没覆盖二级子域。定位:openssl x509 -in fullchain.pem -noout -text | grep -A1 'Subject Alternative Name'。修复:重新签发并补 SAN。

2. curl: (60) SSL certificate problem: unable to get local issuer certificate
根因:服务端只下发了服务器证书,没下发中间证书。定位:openssl s_client -connect example.com:443 -showcerts </dev/null,数 BEGIN CERTIFICATE 出现次数。修复:ssl_certificate 改用 fullchain 文件。

3. nginx: [emerg] SSL_CTX_use_PrivateKey_file(…) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
根因:私钥与证书不配对(换了 key 没换证书)。定位:openssl x509 -in cert.pem -noout -modulus | md5sum 与 openssl rsa -in key.pem -noout -modulus | md5sum 对比,两值必须一致。

4. 小程序 request:fail ssl handshake error
根因:服务端仅支持 TLS 1.0/1.1,或证书链不全,或用了不被信任的 CA。定位:openssl s_client -connect api.example.com:443 -servername api.example.com -tls1_2 </dev/null,若报 handshake failure 即协议版本问题。

5. acme.sh 报错 Error add txt for domain:_acme-challenge.example.com
根因:DNS API 密钥权限不足、AK 被禁用、或域名不在该账号下。定位:acme.sh --issue --dns dns_ali -d example.com --debug 2,查看 API 返回码。修复:确认子账号有 DNS 完全控制权限。

6. 续期后浏览器仍显示旧证书
根因:证书文件更新了但没有 reload,或 CDN/反向代理层缓存了旧证书。定位:openssl s_client -connect example.com:443 </dev/null | openssl x509 -noout -dates,与本地文件 openssl x509 -in fullchain.pem -noout -dates 对比 notAfter。修复:检查 --reloadcmd,并逐层刷新 CDN 证书。

效果验证:五步确认线上真的生效

配置完成后不要只看浏览器小锁,按下面五步逐层验证,每步都有明确期望值:

第一步,协议与套件。

openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep -E 'Protocol|Cipher|Verify return code'
# 期望:Protocol : TLSv1.3(或 TLSv1.2),Verify return code: 0 (ok)

第二步,证书有效期与主体。

echo | openssl s_client -servername example.com -connect example.com:443 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 期望:notAfter 距今天 < 398 天,SAN 含 example.com 与 *.example.com

第三步,HTTP 强制跳转与 HSTS 头。

curl -sI http://example.com | head -n 3
# 期望:HTTP/1.1 301 Moved Permanently + Location: https://example.com/

curl -sI https://example.com | grep -i strict-transport-security
# 期望:strict-transport-security: max-age=31536000

第四步,完整链路与 TLS 1.0 拒绝。

curl -vI https://example.com 2>&1 | grep -E 'SSL certificate verify|TLS'
# 期望:SSL certificate verify ok.

openssl s_client -connect example.com:443 -tls1 </dev/null
# 期望:alert protocol version 或 handshake failure

第五步,外部评级。把域名提交到 SSL Labs(ssllabs.com/ssltest),目标评级 A 或 A+;若出现 “Chain issues: Incomplete”,回到第 3 节检查 fullchain。也可本地跑 testssl.sh --severity HIGH example.com 做批量检查。五步全部通过,再去小程序开发者工具里真机调试,才能确认端到端可用。

证书生命周期管理:398 天与 90 天的自动化运维

证书不是装完就结束。398 天与 90 天的有效期意味着你必须有一套到期监控,否则某天凌晨必然出事。建议提前 30 天续期,通配符证书涉及多个子域,建议提前 45 天。

下面这个脚本可直接放进 crontab 每天跑一次:

#!/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)
END_TS=$(date -d "$END" +%s)
NOW_TS=$(date +%s)
DAYS=$(( (END_TS - NOW_TS) / 86400 ))
echo "$DOMAIN 证书剩余 $DAYS 天(到期:$END)"
if [ "$DAYS" -lt 30 ]; then
  echo "WARN: $DOMAIN 证书将在 $DAYS 天后过期" | mail -s '[SSL 告警]' ops@example.com
fi

写入定时任务:crontab -e 加一行 0 9 * * * /opt/scripts/ssl_check.sh >> /var/log/ssl_check.log 2>&1。

几条运维纪律:

  • Let’s Encrypt 90 天证书:确认 crontab -l | grep acme.sh 有自动任务,且 --reloadcmd 生效;acme.sh 默认在到期前 30 天自动续。
  • 商业 DV/OV/EV 398 天证书:在监控里设置 60 天提醒,因为 OV/EV 需要重新提交营业执照审核,耗时 1–5 个工作日,不能按 DV 的节奏来。
  • 换私钥时必须同步替换 .key 与 .fullchain.pem,并重载服务,避免出现上文第 3 条的 key mismatch。
  • 多节点部署(负载均衡、CDN、容器)要确认证书同步机制,否则会出现“部分用户正常、部分用户报错”的随机故障。

常见问题

通配符证书能同时覆盖 www.example.com、example.com 和 a.b.example.com 吗?

只能覆盖一级子域。*.example.com 匹配 www.example.com、api.example.com,但不匹配裸域 example.com,也不匹配 a.b.example.com。所以申请时 SAN 必须写 DNS:*.example.com,DNS:example.com 两条;二级以上子域只能单独加 SAN 或再签一张通配符。

免费的 Let’s Encrypt 和 100 元的 DV 证书,小程序能用吗?

都能用。微信小程序只校验证书是否被系统信任、TLS 版本是否 ≥1.2、证书链是否完整,不区分付费与免费。区别在有效期(90 天 vs ≤398 天)与保障赔付。免费证书的唯一风险是忘记自动续期,只要 acme.sh 的 cron 与 --reloadcmd 配好,生产环境完全可用。

EV 证书还能让浏览器地址栏显示绿色公司名吗?

不能。Chrome 77(2019 年)起移除了 EV 证书的绿色地址栏与公司名展示,Firefox、Safari 也已跟进。EV 现在的价值在于 CA 对企业主体的深度核验(营业执照、电话回访、部分 CA 要求律师函),适合金融、政企招投标与合规审计场景,不要指望视觉差异。

证书已经装好,浏览器正常,但小程序或 APP 仍报 ssl handshake error,怎么查?

九成是证书链不完整或 TLS 版本不达标。先执行 openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null | grep -c 'BEGIN CERTIFICATE',返回值小于 2 说明中间证书没下发,把 ssl_certificate 改成 fullchain 文件即可;再执行 openssl s_client -connect api.example.com:443 -tls1_2 </dev/null,若报 handshake failure 说明服务端没开 TLS 1.2。

一张证书能不能同时给公众号、小程序、公司网站和 APP 用?

可以,前提是它们用的是同一个域名或该域名的一级子域。例如小程序调用 api.example.com、官网是 www.example.com、APP 走 m.example.com,一张 *.example.com 加裸域 SAN 的通配符证书即可全部覆盖。若跨了不同主域(如 example.com 与 example.net),则必须用多域名 SAN 证书或分别签发。

证书到期前多久续期最稳妥?

DV 与 Let’s Encrypt 建议提前 30 天(acme.sh 默认就是这个策略);OV/EV 因为需要重新做企业资质审核,建议提前 45–60 天启动,避免审核退回导致空窗。无论哪种,都应配置到期监控脚本,而不是依赖日历提醒。

内容审核

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