SSL 证书申请与 HTTPS 配置实战:DV/OV/EV 选型、通配符覆盖范围与 Nginx 部署全流程
一、问题背景与根因:为什么小程序和浏览器“逼”你上 HTTPS
微信小程序的 wx.request 只接受 HTTPS 请求,并且同时要求四件事:域名已完成 ICP 备案、已在小程序后台「开发管理 → 服务器域名」中登记为 request 合法域名、TLS 版本 ≥ 1.2、证书由受信任 CA 签发且证书链完整。任意一条不满足,真机上就会抛 request:fail ssl hand shake error 或 url not in domain list。这才是“SSL 证书快速签发”类需求大量存在的真实根因——不是买不到证书,而是买完之后对不上。
第二个根因是有效期在持续缩短。CA/Browser Forum 的 SC-17 决议自 2020-09-01 起,把公开信任 TLS 证书的最长有效期限制为 398 天;Let’s Encrypt 免费证书一直是 90 天(2025 年起还提供可选的 6 天超短周期证书);SC-081 进一步规定 2026-03-15 起降至 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天。也就是说“一年一续、人工换证书”的模式必然出事故,自动化续期是硬性要求,不是可选项。
动手之前先做一次现状体检,把问题定位清楚:
# 1. 看证书主题、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. 看服务端实际协商的协议版本与加密套件
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| grep -E "Protocol|Cipher"
# 3. 看是否 301 到 https、证书是否被系统信任
curl -sSI https://example.com | head -n 5
curl -vI https://example.com 2>&1 | grep -E "SSL certificate|subject|issuer|expire"
这三条命令分别对应三类高频故障:-ext subjectAltName 输出为空,说明证书没有把 www.example.com 写进 SAN(现代浏览器早已不再看 CN 字段);Protocol 显示 TLSv1 说明服务端没关旧协议;出现 curl: (60) SSL certificate problem: unable to get local issuer certificate 说明只部署了站点证书、漏了中间 CA。这三点跑通,后面的选型与配置才有意义。
二、证书类型与域名覆盖范围:先选对,再谈快
“10 分钟快速签发”只对 DV 成立,因为 DV 的验证对象是域名控制权,走 HTTP-01(在 /.well-known/acme-challenge/ 放指定文件)或 DNS-01(加一条 TXT 记录)即可自动完成。OV 需要核验营业执照、组织登记信息并做电话回拨,EV 还要额外的第三方数据源核验(如 DUNS 编号、114/百度信用留存的座机),1~7 个工作日属于正常范围,任何声称“EV 十分钟下证”的渠道都值得警惕。
必须先纠正一个过时认知:EV 证书早已没有绿色地址栏。Chrome 77(2019-09)移除了 EV 的绿色标识,Firefox 70 跟进。如今 EV 与 DV/OV 在地址栏外观完全一致,只有点开证书详情才能看到 O= 组织名。除非招标文件或行业合规明确要求 EV,否则不必为“绿锁”多付钱。
| 类型 | 验证内容 | 签发时长 | 浏览器展示 | 典型场景 |
|---|---|---|---|---|
| DV | 域名控制权(HTTP-01 / DNS-01) | 分钟级,全自动 | 普通锁标 | 小程序、内部 API、测试环境 |
| OV | 营业执照 + 组织信息 + 电话回拨 | 1~3 工作日 | 与 DV 无可见差异(详情页含 O) | 对外品牌站、政企采购 |
| EV | 更严格的组织核验 + 第三方数据源 | 3~7 工作日 | 已无绿色地址栏 | 金融、支付类硬性合规要求 |
域名覆盖范围更容易踩坑,务必逐条对照:
| 购买形式 | 写法示例 | 实际覆盖 | 不覆盖 |
|---|---|---|---|
| 单域名 | example.com | 仅 example.com | www.example.com、api.example.com |
| 多域名 SAN | example.com + www.example.com + api.example.com | SAN 列表中列出的每一个 FQDN | 未列出的域名,事后无法追加 |
| 通配符 | *.example.com | a.example.com、b.example.com(仅一级) | example.com 本身、api.ccc.example.com |
两点提醒:第一,*.example.com 不包含 裸域 example.com,实际下单时通常要买 *.example.com + example.com 两条 SAN;第二,通配符只匹配一级子域,原文所说的“三级不支持”是对的,api.ccc.example.com 必须单独签发或改用 *.ccc.example.com。商业渠道上“多域名 4 条起售”是代理商的打包策略,主流 CA 本身支持 1~100 条 SAN,按需比价即可。
三、完整实操:从生成 CSR 到证书签发
自签 CSR 的好处是私钥从头到尾不离开自己的机器,CA 只拿到公钥信息。推荐 ECDSA P-256(握手更快、包更小),兼容性有顾虑就用 RSA 2048。以下命令在 OpenSSL 1.1.1+ 环境可直接执行:
# 1) 生成私钥(ECDSA P-256)
openssl ecparam -genkey -name prime256v1 -out example.com.key
chmod 600 example.com.key
# 2) 生成 CSR,同时把 www 与 api 写进 SAN
openssl req -new -key example.com.key -out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Tech Co., Ltd./CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com,DNS:api.example.com"
# 3) 提交前自检:确认 SAN 与公钥算法
openssl req -in example.com.csr -noout -text | grep -A2 "Subject Alternative Name"
openssl req -in example.com.csr -noout -text | grep "Public Key Algorithm"
如果 OpenSSL 版本低于 1.1.1(不支持 -addext),改用配置文件:新建 san.cnf,内容为 [req] 段 req_extensions = v3_req、[v3_req] 段 subjectAltName = @alt、[alt] 段 DNS.1 = example.com / DNS.2 = www.example.com,再执行 openssl req -new -key example.com.key -out example.com.csr -config san.cnf。CSR 一旦提交给 CA,SAN 列表就无法追加,写错只能重签。
免费证书用 acme.sh 全自动完成,比手工上传省事得多:
# 安装并指定 Let's Encrypt 作为默认 CA
curl https://get.acme.sh | sh -s email=ops@example.com
~/.acme.sh/acme.sh --set-default-ca --server letsencrypt
# 方式 A:HTTP-01 文件验证(站点已能通过 80 端口访问)
~/.acme.sh/acme.sh --issue -d example.com -d www.example.com --webroot /var/www/html
# 方式 B:DNS-01 验证(签通配符必须用这个)
export Ali_Key="LTAI5t******"
export Ali_Secret="******"
~/.acme.sh/acme.sh --issue --dns dns_ali -d example.com -d '*.example.com'
# 安装证书并绑定续期后的 reload 动作
~/.acme.sh/acme.sh --install-cert -d example.com
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.fullchain.pem
--reloadcmd "nginx -t && systemctl reload nginx"
用 Certbot 的等价写法是 certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com --deploy-hook "systemctl reload nginx"。注意 --fullchain-file 输出的是“站点证书 + 中间证书”,Nginx 必须用这个文件而不是裸证书,否则就是前面那个 unable to get local issuer certificate。OV/EV 走商业 CA 时,把 example.com.csr 内容粘贴到申请页即可,私钥始终留在本地。
四、服务端配置示例:Nginx / Apache / Spring Boot
Nginx 配置要点:80 端口无条件 301、只开 TLSv1.2 与 TLSv1.3、用 fullchain 而非单证书、开启 OCSP Stapling 减少握手延迟。注意 http2 on; 需要 Nginx 1.25.1+,老版本请写 listen 443 ssl http2;。
server {
listen 80;
server_name example.com www.example.com;
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_trusted_certificate /etc/nginx/ssl/example.com.chain.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_stapling on;
ssl_stapling_verify on;
add_header Strict-Transport-Security "max-age=31536000" always;
location / {
root /var/www/html;
index index.html;
}
}
HSTS 建议先设 max-age=300 验证全站无 HTTP 资源,再逐步加到 31536000;一旦误配且浏览器缓存了长周期 HSTS,回退会非常痛苦,不要一上来就加 preload。
Apache 2.4 的等价写法:
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
Spring Boot 内嵌 Tomcat 只认 JKS/PKCS12,需要先转换:
openssl pkcs12 -export -in example.com.fullchain.pem -inkey example.com.key
-out example.com.p12 -name example.com -passout pass:$KEYSTORE_PWD
server:
port: 443
ssl:
enabled: true
key-store: classpath:example.com.p12
key-store-type: PKCS12
key-store-password: ${KEYSTORE_PWD}
enabled-protocols: TLSv1.2,TLSv1.3
如果前面挂了 SLB/CDN,证书要同时部署在边缘节点和回源链路;只配边缘、回源走 HTTP 是“页面锁标正常但小程序偶发握手失败”的常见成因。
五、有效期规则与自动续期:把 398 天当成上限而不是目标
很多人还在按“买一年”报价,但公开信任证书最长只能 398 天,且这个上限还会继续下调。把续期做成无人值守,比纠结买哪家更重要。
| 签发方 / 类型 | 单张有效期 | 续期方式 | 注意事项 |
|---|---|---|---|
| Let’s Encrypt(DV) | 90 天 | acme.sh / certbot 自动 | 同一注册域名每周限 50 张,注意速率限制 |
| 商业 DV | 最长 398 天 | API 或控制台手动 | 2026-03-15 起降至 200 天 |
| 商业 OV / EV | 最长 398 天 | 需重新核验组织信息 | 公司名/地址变更必须重签,不能续 |
| 私有 CA(内部系统) | 自定义 | 内部 ACME / 脚本 | 不受 CA/B 规则约束,但要自行分发根证书 |
acme.sh 安装时会自动写入 crontab(0 3 * * * "/root/.acme.sh"/acme.sh --cron --home "/root/.acme.sh"),确认它存在:crontab -l | grep acme。用 systemd 管理更可控:
# /etc/systemd/system/acme-renew.service
[Unit]
Description=Renew ACME certificates
[Service]
Type=oneshot
ExecStart=/root/.acme.sh/acme.sh --cron --home /root/.acme.sh
# /etc/systemd/system/acme-renew.timer
[Unit]
Description=Daily ACME renew
[Timer]
OnCalendar=*-*-* 03:17:00
Persistent=true
[Install]
WantedBy=timers.target
再加一条到期巡检,把“还剩多少天”变成可监控指标:
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- HTTPS证书申请 · SSL证书安装部署 · 证书续费
- Wildcard 通配符 SSL 证书安装部署续费申请
- 服务器维护 · 网站代维护 · 服务器托管代维
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
- SSL证书安装服务 · 腾讯云 HTTPS 部署 · 证书过期更新
#!/bin/bash
DOMAIN="example.com"; PORT=443; WARN=2592000 # 30 天
END=$(echo | openssl s_client -connect $DOMAIN:$PORT -servername $DOMAIN 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
LEFT=$(( $(date -d "$END" +%s) - $(date +%s) ))
[ $LEFT -lt $WARN ] && echo "WARN: $DOMAIN 将在 $((LEFT/86400)) 天后过期" || echo "OK: $((LEFT/86400)) 天"
把这个脚本挂到 Zabbix/Prometheus textfile collector 上,比等用户来投诉划算得多。
六、常见错误排查:这些报错原文你一定见过
1)curl: (60) SSL certificate problem: unable to get local issuer certificate
证书链不完整,只部署了站点证书。解决:改用 fullchain 文件;用 openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem cert.pem 验证链条,输出 OK 才算通过。部分老安卓(Android 7 以下)对缺中间证书尤其敏感。
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)
私钥与证书不配对,通常是把上一次的 key 留着了。比对模数:openssl x509 -noout -modulus -in cert.pem | openssl md5 与 openssl rsa -noout -modulus -in key.pem | openssl md5,两个哈希必须一致;ECDSA 证书用 openssl ec -noout -text -in key.pem 对比公钥。
3)NET::ERR_CERT_COMMON_NAME_INVALID
访问的域名不在 SAN 列表里。典型场景:只买了 example.com 却用 www.example.com 访问,或通配符 *.example.com 去覆盖裸域。只能重签,无法追加。
4)小程序报 request:fail ssl hand shake error
按顺序排查:TLS 版本是否 ≥ 1.2(openssl s_client -tls1_2 -connect ... 能通即可确认)、证书链是否完整、证书是否过期、域名是否备案并已加入后台白名单。开发者工具里勾选了「不校验合法域名」时一切正常、真机失败,几乎都是这四条的其中之一。
5)SSL_ERROR_NO_CYPHER_OVERLAP / no shared cipher
客户端与服务端没有交集。常见于把 ssl_ciphers 收得过窄又保留了 TLSv1.2,或客户端只支持 TLSv1.0。加回 ECDHE-RSA-AES128-GCM-SHA256 这类通用套件即可。
6)x509: certificate signed by unknown authority(Go/Java 客户端)
Java 报 PKIX path building failed 同理。要么链不全,要么 JDK 的 cacerts 未导入私有根证书。keytool -importcert -alias internal-ca -file root.crt -keystore $JAVA_HOME/lib/security/cacerts。
7)nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line)
证书文件不是 PEM 格式(可能是 DER 或 PFX)。转换:openssl x509 -inform DER -in cert.der -out cert.pem;PFX 用 openssl pkcs12 -in cert.pfx -nodes -out all.pem 再拆分。
8)certbot: Problem binding to port 80: Could not bind to IPv4 or IPv6
80 被 Nginx 占用。改用 --webroot -w /var/www/html,或临时 systemctl stop nginx 用 --standalone,签完再启动。
9)Verify error:Invalid response from http://example.com/.well-known/acme-challenge/xxx
HTTP-01 校验文件取不到。检查 webroot 路径是否与站点 root 一致、.well-known 目录是否被伪静态规则或 WAF 拦截、是否有 301 跳到 https 但证书已过期形成死循环。
七、效果验证与上线检查清单
配置改完不要只看浏览器有没有锁标,按下面这套命令逐项验收:
# 1) 验证返回码必须是 0 (ok),且能看到完整的链
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| grep -E "Verify return code|depth="
# 2) 离线校验证书链
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt
-untrusted /etc/nginx/ssl/example.com.chain.pem
/etc/nginx/ssl/example.com.crt
# 3) 枚举服务端支持的协议与套件,确认没有 TLSv1/1.1
nmap --script ssl-enum-ciphers -p 443 example.com
# 4) 确认 HSTS 与跳转
curl -sSI https://example.com | grep -i strict-transport-security
curl -sSI http://example.com | grep -iE "HTTP/|location"
# 5) 模拟小程序常用的 TLS1.2 握手
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>/dev/null | grep "Cipher is"
再配合在线工具做交叉验证:SSL Labs(https://www.ssllabs.com/ssltest/analyze.html?d=example.com)目标是 A 或 A+,出现 B 通常是支持了 TLSv1.0/1.1 或缺 OCSP Stapling;Chrome DevTools 的 Security 面板会直接列出“混合内容”条目,页面上任何一个 http:// 的图片、脚本、字体都会让锁标变成“不安全”。
| 检查项 | 期望结果 | 不通过的典型现象 |
|---|---|---|
| 证书链完整性 | Verify return code: 0 (ok) | curl 60、老安卓报错 |
| SAN 覆盖 | 所有对外域名均在列表中 | ERR_CERT_COMMON_NAME_INVALID |
| 协议版本 | 仅 TLSv1.2 / TLSv1.3 | 小程序握手失败、评级降级 |
| HTTP 跳转 | 301 到 https 同路径 | SEO 权重丢失、混合内容 |
| HSTS | 存在 max-age ≥ 31536000 | SSL Stripping 风险 |
| 续期任务 | cron / systemd timer 已启用 | 90 天后突然全站不可用 |
最后一步是业务侧验证:关闭微信开发者工具的「不校验合法域名、web-view(业务域名)、TLS 版本以及 HTTPS 证书」,在真机上完整跑一遍登录、支付、上传三条主链路。很多握手问题只在真实网络环境(弱网、运营商代理、企业内网 SSL 中间盒)下才暴露。
常见问题
小程序能不能用通配符证书?
可以。小程序后台登记的是具体域名(如 api.example.com),*.example.com 能覆盖这一级,但不能覆盖 api.ccc.example.com 这样的三级域名。另外国内主体的域名必须完成 ICP 备案,否则即使证书完全正确,也无法加入 request 合法域名列表。
买单域名证书,能不能同时用 example.com 和 www.example.com?
不能,除非签发时把两个都写进 SAN 列表。传统上“单域名”只覆盖一个 FQDN,部分厂商会把 www 作为赠送项写进同一张证书,下单前务必确认 SAN 明细。证书一旦签发无法追加域名,只能重新签发,所以 CSR 阶段就要把所有对外域名列全。
EV 证书现在还显示绿色地址栏吗?
不显示了。Chrome 77(2019 年 9 月)起移除 EV 的绿色标识,Firefox 70 随后跟进,现在 EV 与 DV/OV 在地址栏外观完全一致,只有打开证书详情才能看到 O= 组织名。除了招标或行业合规明确要求,否则没必要为“绿锁”支付溢价,把预算放在自动化续期和监控上更划算。
证书最长能签多久?398 天是怎么来的?
公开信任 TLS 证书最长 398 天,来自 CA/Browser Forum 的 SC-17 决议,2020-09-01 生效。Let’s Encrypt 固定 90 天。按 SC-081 的时间表,2026-03-15 起降为 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天。企业私有 CA 签发的内部证书不受此限制,但需要自行分发根证书到所有客户端。
部署完 HTTPS,浏览器仍提示“不安全”怎么办?
先看 Chrome DevTools 的 Security 面板:如果是“混合内容”,页面里还有 http:// 的图片/脚本/字体,改成协议相对或 https 绝对地址;如果是“证书无效”,回到第六节按报错原文排查;如果只是没有锁标但能访问,检查是否被 CDN 回源覆盖、或 HSTS 头被中间层剥离。
通配符证书能覆盖三级域名吗?
不能。*.example.com 只匹配一级子域,api.ccc.example.com 需要单独签发,或再买一张 *.ccc.example.com。同时注意 *.example.com 不包含裸域 example.com,实际部署通常是 *.example.com + example.com 两条 SAN 一起买。