HTTPS 全站加密实战:通配符证书申请、Nginx 部署与 SSL 优化检测
一、问题背景与根因:小程序为什么“必须”HTTPS
微信小程序的 wx.request、wx.downloadFile、wx.uploadFile 等网络 API 只接受 https:// 开头的合法域名。开发者工具里那个“不校验合法域名、web-view(业务域名)、TLS 版本以及 HTTPS 证书”的勾选项,在真机预览和正式发布后完全失效。服务端证书一旦有问题,小程序端直接抛出 request:fail ssl hand shake error 或 errCode: -1,页面白屏,用户侧看不到任何可读的错误提示。
与此同时,Chrome、Edge、Firefox 会对 http:// 页面在地址栏标记“不安全”,HTTP 表单提交和部分新 API(地理位置、摄像头、Service Worker、Clipboard)也被限制在安全上下文中。对一家旗下有 domain.com、并解析出 www.domain.com、login.domain.com、shop.domain.com、bill.domain.com 等几十上百个子域名的公司来说,真正的成本痛点不是“买一张证书”,而是证书数量与续期管理。
根因在证书的域名匹配机制:TLS 握手时,客户端会用 SNI 里的主机名去比对证书的 SAN(Subject Alternative Name)列表。一个主机名要通过校验,必须被显式列在 SAN 中,或者被证书里的通配符条目覆盖。而 *.domain.com 只覆盖“任意一级前缀”,既不覆盖裸域 domain.com,也不覆盖二级的 a.b.domain.com。很多人买了通配符证书后仍然报 NET::ERR_CERT_COMMON_NAME_INVALID,原因就在这里。
还有两个常被忽略的事实:其一,自 2020-09-01 起,公开信任的 TLS 证书最长有效期被限制在 398 天(Apple 与 Chrome 强制执行),所以“一次购买多年”并不等于“一张证书用多年”,服务商只是把多次签发打包售卖,续期动作依然每年要做;其二,Let’s Encrypt 签发的证书有效期只有 90 天,必须靠自动化续期。域名多、证书多、续期频繁、验证链路长,这四点叠加,才是 HTTPS 全站部署的真实难点。
二、证书选型:DV 通配符、单域名与 398 天有效期新规
先说结论:一级子域名数量 ≥ 3 时,直接上 DV 通配符(*.domain.com)最划算;只有 1–2 个固定域名时选 DV 单域名即可;需要向访客展示企业实名信息(金融、政务、电商收银台)时才考虑 OV/EV。
| 类型 | 覆盖范围 | 典型签发时长 | 最长有效期 | 适合场景 |
|---|---|---|---|---|
| DV 单域名 | 1 个精确主机名,可在 SAN 中追加 www 版本 | 10 分钟–2 小时 | 398 天 | 官网单页、单一 API 入口 |
| DV 通配符 | *.domain.com 下所有一级子域名 |
10 分钟–2 小时 | 398 天 | 多子域名、SaaS、小程序多业务线 |
| OV 单域名 / 通配符 | 覆盖范围同上,额外校验营业执照 | 1–3 个工作日 | 398 天 | 需要展示企业身份 |
| Let’s Encrypt(免费) | 单域名或多域名 SAN,通配符需 DNS-01 验证 | 约 1 分钟 | 90 天 | 自动化运维、测试环境、成本敏感项目 |
选型时必须确认三件事:
① 裸域是否包含。绝大多数 CA 的通配符证书只签 *.domain.com,裸域 domain.com 需要在下单时额外添加进 SAN(DNS:domain.com),否则用户直接输入域名访问就会报证书不匹配。
② 通配符只匹配一级。*.domain.com 覆盖 shop.domain.com,但不覆盖 shop.api.domain.com。多级子域名要么单独加入 SAN,要么另外规划。
③ 有效期按 398 天理解。任何宣称“一张证书用三年”的销售话术,实质是三年内多次重签,你需要准备好每年配合做一次域名验证。
另外提醒:DV 证书只验证域名控制权,不验证企业身份;小程序对证书类型没有额外要求,DV 通配符完全够用,不必为“小程序专用证书”这类营销概念多付钱。
三、实操:生成 CSR 与私钥,完成域名验证
通配符证书的私钥必须自己生成,不要把私钥交给代购方。下面的命令可直接复制执行:
mkdir -p /etc/nginx/ssl/domain.com && cd /etc/nginx/ssl/domain.com
# 1) 生成 2048 位 RSA 私钥 + CSR,通配符证书的 CN 写 *.domain.com
openssl req -new -newkey rsa:2048 -sha256 -nodes
-keyout domain.com.key
-out domain.com.csr
-subj '/C=CN/ST=Guangdong/L=Shenzhen/O=Example Technology Co Ltd/OU=IT/CN=*.domain.com'
-addext 'subjectAltName=DNS:*.domain.com,DNS:domain.com'
# 2) 私钥权限收紧
chmod 600 domain.com.key
# 3) 核对 CSR 内容,重点看 Subject 与请求的 SAN
openssl req -in domain.com.csr -noout -subject -text | grep -A2 'Subject Alternative Name'
如果 CA 的申请表单不支持自动读取 CSR 里的 SAN,就要在下单页面手动填写 *.domain.com 与 domain.com 两条记录。
域名验证有三种方式,按优先级选择:
DNS-01(推荐,通配符必选):CA 给出一条 TXT 记录,例如 _dnsauth.domain.com 或随机值 _abc123.domain.com,在域名解析后台添加后等待 TTL 生效,一般 5–30 分钟可签发。通配符证书只能用这种方式,因为文件验证无法证明“所有子域名”的控制权。
HTTP 文件验证:在站点根目录放置 /.well-known/pki-validation/xxxx.txt,要求 80 端口可访问且无跳转。已上线的 HTTPS 站点做验证时,注意别让 301 跳转打断验证请求。
邮箱验证:向 admin@domain.com、administrator@domain.com 等五个标准邮箱发确认信,适合无法改 DNS 的场景,但通配符证书不适用。
签发完成后你会拿到 domain.com.crt(服务器证书)和中间证书文件,务必把两者拼接成 fullchain,否则后面一定踩“证书链不完整”的坑:
cat domain.com.crt chain.pem > fullchain.pem
# 校验私钥与证书是否配对,两条命令输出的 md5 必须完全一致
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in domain.com.key | openssl md5
四、实操:Nginx 全站 HTTPS 配置与 80→443 跳转
把通用 TLS 参数抽成独立片段,多个 server 块复用,避免每个虚拟主机各写一份导致参数漂移:
# /etc/nginx/conf.d/ssl-common.conf
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: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;
ssl_stapling on;
ssl_stapling_verify on;
resolver 223.5.5.5 119.29.29.29 valid=300s;
resolver_timeout 5s;
# /etc/nginx/conf.d/domain.com.conf
server {
listen 80;
listen [::]:80;
server_name domain.com *.domain.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
listen [::]:443 ssl;
http2 on; # nginx >= 1.25.1 写法;旧版本改为 listen 443 ssl http2;
server_name domain.com www.domain.com login.domain.com shop.domain.com;
ssl_certificate /etc/nginx/ssl/domain.com/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/domain.com/domain.com.key;
ssl_trusted_certificate /etc/nginx/ssl/domain.com/chain.pem;
include /etc/nginx/conf.d/ssl-common.conf;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
add_header X-Content-Type-Options 'nosniff' always;
add_header X-Frame-Options 'SAMEORIGIN' always;
root /var/www/domain.com;
index index.html;
location / {
try_files $uri $uri/ /index.html;
}
}
几个必须注意的点:
① 跳转码的选择。301 会被浏览器长期缓存,改回来很麻烦;如果站点有 POST 接口,用 return 308 https://$host$request_uri; 才能保留请求方法和 body,301 会把 POST 变成 GET。
② HSTS 谨慎开启。includeSubDomains 意味着所有子域名必须已经全量支持 HTTPS,只要有一个子域名还在跑 HTTP,用户就再也打不开它了。首次上线建议先用 max-age=300 试运行一周,确认无误后再改成 31536000。
③ OCSP Stapling 依赖 ssl_trusted_certificate。只配 ssl_certificate 而不配 chain.pem,nginx 会告警 "ssl_stapling" ignored, issuer certificate not found,装订功能实际未生效。
改完后先语法检查再热加载,不要直接 restart:
nginx -t && nginx -s reload
五、通配符证书的匹配规则与多子域名统一管理
部署前先把匹配规则搞清楚,能省掉 80% 的“证书明明装了却报错”问题:
| 访问的主机名 | *.domain.com 是否覆盖 |
说明 |
|---|---|---|
| www.domain.com | ✅ 覆盖 | 一级子域名,正常匹配 |
| login.domain.com | ✅ 覆盖 | 一级子域名,正常匹配 |
| shop.domain.com | ✅ 覆盖 | 一级子域名,正常匹配 |
| domain.com | ❌ 不覆盖 | 裸域不在通配符范围内,必须写进 SAN |
| a.b.domain.com | ❌ 不覆盖 | 通配符只匹配一级前缀,多级需单独签发 |
| *.domain.com(字面量) | ❌ 不覆盖 | 星号不是合法主机名,无法直接访问 |
子域名成百上千时,不要为每个子域名写一个 server 块。两种做法:
做法一:DNS 泛解析 + 泛域名 server_name。把 *.domain.com A 记录指向同一台服务器,然后:
server {
listen 443 ssl;
http2 on;
server_name ~^(?<sub>[a-z0-9-]+).domain.com$;
ssl_certificate /etc/nginx/ssl/domain.com/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/domain.com/domain.com.key;
ssl_trusted_certificate /etc/nginx/ssl/domain.com/chain.pem;
include /etc/nginx/conf.d/ssl-common.conf;
root /var/www/$sub;
}
# 兜底 server,防止未匹配的请求落到第一个 server 块
server {
listen 443 ssl default_server;
server_name _;
ssl_certificate /etc/nginx/ssl/domain.com/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/domain.com/domain.com.key;
return 444;
}
做法二:include 片段。每个业务子域名单独写 server 块,但把 ssl_certificate 三行放进 ssl-cert.conf 用 include 引入,换证书时只改一处。
再配一个到期巡检脚本,丢进 crontab 每天跑,避免 398 天到期那天才发现:
#!/bin/bash
DOMAIN='www.domain.com'
END=$(echo | openssl s_client -connect $DOMAIN:443 -servername $DOMAIN 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 ))
printf '%s 证书剩余 %s 天n' "$DOMAIN" "$DAYS"
[ "$DAYS" -lt 30 ] && printf 'WARN: 证书将在 %s 天后过期n' "$DAYS" && exit 1
六、常见错误排查:真实报错与逐条解法
1. nginx 启动失败
nginx: [emerg] SSL_CTX_use_PrivateKey_file("/etc/nginx/ssl/domain.com/domain.com.key") failed
(SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
私钥和证书不配对,通常是重签后只换了 crt 没换 key。用第三节的两条 openssl ... -modulus | openssl md5 对比,md5 不一致就重新签发或找回匹配的私钥。
2. curl 报证书链不完整
curl: (60) SSL certificate problem: unable to get local issuer certificate
浏览器能打开、命令行打不开,99% 是 ssl_certificate 只配了服务器证书、没拼中间证书。用 cat domain.com.crt chain.pem > fullchain.pem 重新拼接并 reload。顺带一提,Android 7 以下和部分小程序基础库对链完整性的要求比桌面浏览器严格得多,所以“我电脑上好好的”不能作为验证通过的依据。
3. 浏览器报域名不匹配
NET::ERR_CERT_COMMON_NAME_INVALID
SSL_ERROR_BAD_CERT_DOMAIN
访问的主机名不在 SAN 里。对照第五节的表格:是不是直接访问了裸域?是不是用了二级子域名?用 openssl x509 -noout -ext subjectAltName -in fullchain.pem 打印实际 SAN 逐条核对。
4. 浏览器报证书过期
NET::ERR_CERT_DATE_INVALID
先确认不是服务器系统时间跑偏:date -u 与真实 UTC 时间比对,偏差超过几分钟就会误判。再查证书实际有效期:openssl x509 -noout -dates -in fullchain.pem。
5. 小程序真机报握手失败
request:fail ssl hand shake error
按顺序排查:① 证书链是否完整(同第 2 条);② 服务端是否还开着 TLS 1.0/1.1,小程序要求 TLS 1.2 及以上;③ 是否用了自签证书或内部 CA;④ 请求域名与证书 SAN 是否一致(含 www 与否);⑤ 443 端口是否被安全组拦截。定位最快的方式是手机连电脑热点后用 Charles/Stream 抓包看握手阶段断在哪一步。
6. OCSP 装订告警
nginx: [warn] "ssl_stapling" ignored, issuer certificate not found
补上 ssl_trusted_certificate /path/chain.pem; 并确保 resolver 可用(内网服务器必须显式配 resolver 223.5.5.5;)。
7. 页面仍提示不安全
这是混合内容(Mixed Content),不是证书问题。F12 控制台会明确列出被拦截的 http:// 资源,把图片、JS、CSS、接口地址统一改成 https:// 或协议相对写法即可。
七、SSL 优化与效果验证:从 B 到 A+ 的实操
配置改完后,用下面几条命令做闭环验证,每条都能给出明确结论:
# 1) 查看线上证书的主题、签发者、有效期和 SAN
echo | openssl s_client -connect www.domain.com:443 -servername www.domain.com 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 2) 确认协商到的协议版本与加密套件(分别测 TLS 1.2 / 1.3)
echo | openssl s_client -connect www.domain.com:443 -servername www.domain.com -tls1_2 2>/dev/null
| grep -E 'Protocol|Cipher'
# 3) 确认 80 端口已跳转
curl -sSI http://www.domain.com | grep -iE 'HTTP/|location'
# 4) 确认 HTTP/2 生效
curl -sSI --http2 https://www.domain.com | head -n1
# 5) 本地校验证书链
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem domain.com.crt
SSL Labs(ssllabs.com/ssltest)评级要拿 A 及以上,关键项与对应配置如下:
| 评级扣分项 | 对应配置 |
|---|---|
| 支持 TLS 1.0 / 1.1 | ssl_protocols TLSv1.2 TLSv1.3; |
| 支持 RC4、3DES、导出级套件 | 用 ECDHE + AES-GCM / CHACHA20 白名单 |
| 未开启 HSTS | add_header Strict-Transport-Security 'max-age=31536000' always; |
| 未开启 OCSP Stapling | ssl_stapling on; ssl_stapling_verify on; + trusted cert |
| 未启用 HTTP/2 | http2 on;(nginx ≥ 1.25.1) |
| 证书链不完整 | 使用 fullchain.pem |
上线验收清单建议固定为四项:① curl -sSI https://域名 返回 200 且首行是 HTTP/2;② curl -sSI http://域名 返回 301/308 并带 Location;③ SSL Labs 评级 A 及以上、证书链显示 “Chain issues: None”;④ 微信开发者工具切到真机模式,实际发起一次 wx.request 请求成功。四项全过,才算真正完成全站加密,而不是“浏览器地址栏有把锁”。
常见问题
一张 *.domain.com 通配符证书,能同时保护 domain.com 裸域吗?
不能。通配符只匹配一级子域名,裸域必须单独写进 SAN(DNS:domain.com)。下单时务必勾选或手动添加,否则用户直接输入域名访问会报 NET::ERR_CERT_COMMON_NAME_INVALID。部分 CA 默认赠送裸域 SAN,部分要额外收费,购买前确认清楚。
证书有效期到底是 398 天还是 1 年?
398 天是公开信任证书的有效期上限,自 2020-09-01 起由 Apple 与 Chrome 强制推行,所有 CA 都必须遵守。销售页面上的“1 年”通常指服务周期而非单张证书的有效期,实际是 398 天内有效、到期前重签一次。Let’s Encrypt 更短,固定 90 天,必须配合 certbot 或 acme.sh 做自动续期。
小程序提示 request:fail ssl hand shake error 怎么排查?
按顺序查五件事:证书链是否完整(cat crt chain > fullchain.pem)、服务端是否禁用了 TLS 1.0/1.1、是否使用了自签或内部 CA 证书、请求域名是否在证书 SAN 中、443 端口是否放通。可以用 openssl s_client -connect 域名:443 -servername 域名 在服务器上先自测,握手成功且 Verify return code: 0 (ok) 说明服务端没问题,故障在客户端网络或域名解析。
通配符证书能覆盖 a.b.domain.com 这种二级子域名吗?
不能。通配符只匹配一个层级的标签,*.domain.com 覆盖 b.domain.com,但不覆盖 a.b.domain.com。遇到多级子域名,要么把每个具体主机名加进 SAN(有数量上限),要么为 *.b.domain.com 单独签一张通配符证书。
用 Let’s Encrypt 免费证书给小程序用可以吗?
可以。小程序只要求证书受信任、域名匹配、TLS 1.2 及以上,对 CA 没有偏好,Let’s Encrypt 完全满足。风险在于 90 天有效期,一旦自动续期失败,到期当天小程序就会全线不可用。建议用 acme.sh 配 DNS-01 方式续期,并加上续期后自动 nginx -s reload 的 hook,同时保留到期巡检告警。
部署完 HTTPS 后,浏览器地址栏还是提示“不安全”怎么办?
这通常不是证书问题,而是页面里还残留 http:// 资源,触发混合内容拦截。打开 F12 控制台,Mixed Content 报错会逐条列出被拦截的 URL,把图片、脚本、样式、接口地址统一改成 https:// 即可。另外确认没有通过 <form action="http://..."> 提交表单,也没有用绝对地址硬编码 HTTP 协议。