通配符 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 天 | 支持通配符 | 锁标识 | 免费 | 自动化运维、内部服务 |
三条必须记住的规则:
- 通配符只匹配一级子域。
*.example.com匹配api.example.com,不匹配example.com,也不匹配v1.api.example.com。所以申请时 SAN 必须同时写*.example.com和example.com。 - 通配符只能做 DNS-01 验证,无法用 HTTP 文件验证,这意味着你必须能操作 DNS 解析记录或调用云厂商 API。
- 多数 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 天启动,避免审核退回导致空窗。无论哪种,都应配置到期监控脚本,而不是依赖日历提醒。