跳到主要内容
ssl证书按装

通配符 SSL 证书实战:泛解析 HTTPS 部署、小程序与 APP 证书配置、398 天有效期续期治理

通配符 SSL 证书实战:泛解析 HTTPS 部署、小程序与 APP 证书配置、398 天有效期续期治理 — 通配符 SSL 证书实战:泛解析 HTTPS 部署、小程序与 APP 证书配置、398 天有效期续期治理

问题背景与根因:HTTP 站点为什么必须升级到 HTTPS

微信小程序的 wx.request / wx.uploadFile 只允许 https:// 请求,并且强制要求:证书由受信任 CA 签发、TLS 版本不低于 1.2、域名已在「开发管理 → 开发设置 → 服务器域名」中登记、不支持 IP 地址和自定义端口。iOS 的 ATS 同样要求 TLS 1.2 以上、SHA-256 签名、RSA 密钥不少于 2048 位或 ECC 密钥不少于 256 位。Chrome、Edge 对 HTTP 页面直接标记「不安全」,而 HTTP/2、HTTP/3 在浏览器里只运行在 TLS 之上,没有证书连协议优化带来的好处都拿不到。

真正的痛点在于泛解析:当 *.example.com 的全部 A 记录指向同一台 ECS,按子域逐个申请单域名证书,成本随子域数量线性增长,运维上还要为每个域名单独续期、单独排查。通配符证书(Wildcard SSL)用一张证书覆盖 example.com 下所有一级子域,是这类架构的标准答案。

线上故障的根因高度集中,可归纳为四类:

  • 证书链不全:只部署了域名证书(leaf),漏掉中间证书(intermediate)。PC 浏览器可能靠 AIA 自动补链而显示正常,但小程序、低版本 Android、curl、Java 客户端会直接握手失败。
  • 有效期规则变化:公有 CA 签发的 TLS 证书最长有效期已被限制为 398 天(约 13 个月),Let’s Encrypt 默认 90 天,任何「一年一续」的人工流程都会踩坑。
  • 验证方式错配:通配符证书只能走 DNS-01 验证,无法用 HTTP-01 文件验证,TXT 记录未生效就点签发必然失败。
  • 网络层未放通:云上 ECS 安全组、firewalld、ufw 未放通 443,证书配得再对也连不上。

动手前先做一次现状自检,把问题定位在证书、配置还是网络:

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

如果第一条命令输出的 issuer 是自签或与预期 CA 不符、dates 已过期,问题在证书;如果 443 端口连不通,先查安全组再谈证书。

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

原文把「EV 证书会在浏览器地址栏直接显示公司名称」当作卖点,这一说法已经过时:Chrome 自 2019 年起移除了 EV 证书的绿色公司名标识,现在只能在证书详情里看到组织信息。因此对绝大多数业务而言,选型的核心是覆盖范围与自动化能力,而不是等级名称。

类型 审核材料 签发时长 浏览器表现 典型场景
DV 域名型 仅需域名控制权(DNS TXT / 文件) 分钟级,自动化可秒级 锁标,无组织信息 小程序、APP 接口、个人站、API 网关
OV 组织型 营业执照、电话回访核验 1~5 个工作日 锁标,证书详情含企业名 企业官网、对外门户
EV 扩展型 OV 材料 + 更严格的主体核验 3~7 个工作日 锁标(地址栏不再显示公司名) 金融、支付类合规要求场景

覆盖范围是另一个高频误解。以 *.example.com 为例:

域名 *.example.com 是否覆盖 说明
api.example.com 覆盖 一级子域
example.com 不覆盖 必须作为 SAN 一并签发
a.b.example.com 不覆盖 通配符只匹配一层,需 *.b.example.com 或单域名证书
test.example.net 不覆盖 跨主域无效

所以标准做法是:下单时同时提交 example.com 与 *.example.com 两个名字,一张证书、一个私钥、一次部署。若泛解析下还存在二级子域(如租户体系 a.b.example.com),要么再签一张 *.b.example.com,要么改用多域名(SAN)证书。

有效期方面必须按新规规划:公有 CA 单张证书有效期上限 398 天,且 CA/B 论坛已通过分阶段缩短方案(后续将依次收紧至 200 天、100 天、47 天,以官方公告为准),Let’s Encrypt 默认 90 天。结论只有一个:能自动续期就不要手工续期。

实操一:生成私钥与 CSR,准备 DNS-01 验证

先确认环境:OpenSSL 1.1.1 以上(支持 -addext)、Nginx 1.18 以上或 Apache 2.4,服务器时间已与 NTP 同步(时间偏差超过 5 分钟会导致证书被判定为未生效)。

# 1) ECC 私钥(推荐:握手更快、证书体积更小)
openssl ecparam -genkey -name prime256v1 -out /etc/nginx/ssl/example.com.key
# 兼容极老客户端时可改用 RSA 2048
# openssl genrsa -out /etc/nginx/ssl/example.com.key 2048
chmod 600 /etc/nginx/ssl/example.com.key

# 2) 生成 CSR,SAN 同时写入通配符与主域名
openssl req -new -key /etc/nginx/ssl/example.com.key 
  -out /etc/nginx/ssl/example.com.csr 
  -subj '/C=CN/O=Example Tech/CN=*.example.com' 
  -addext 'subjectAltName=DNS:*.example.com,DNS:example.com'

# 3) 校验 CSR 里的 SAN
openssl req -in /etc/nginx/ssl/example.com.csr -noout -text | grep -A1 'Subject Alternative Name'

DNS-01 的原理是:CA 下发 token,客户端用私钥计算 keyAuthorization,再做 SHA-256 与 base64url 编码,把摘要值以 TXT 记录发布到 _acme-challenge.example.com,CA 全球多点查询到即通过。实操要点:

  • 同一张证书同时包含 example.com 与 *.example.com 时,_acme-challenge.example.com 会下发两条 TXT 记录,必须两条都添加,缺一条即失败。
  • TXT 的 TTL 建议设为 60~600 秒,验证前用 dig +short TXT _acme-challenge.example.com @8.8.8.8 确认已生效,国内解析商通常 10 秒至 10 分钟。
  • 没有 DNS API 权限时可用 CNAME 委派:把 _acme-challenge.example.com CNAME 到 _acme-challenge.auth.other.com,将验证权交给支持 API 的解析商。
  • 务必使用 RAM 子账号并只授予 DNS 解析权限,避免主账号 AccessKey 落在服务器上。

若使用商业 CA(DigiCert、Sectigo、GlobalSign 等),流程是把 CSR 提交给 CA,按其要求添加 TXT 或 CNAME 记录完成域名验证,签发后下载 fullchain 证书包;CSR 与私钥始终留在自己服务器上,绝不上传私钥。

实操二:acme.sh 自动签发通配符证书与自动续期

以阿里云 DNS 为例,完整链路如下(腾讯云换成 dns_dp + Tencent_SecretId/Tencent_SecretKey,Cloudflare 换成 dns_cf + CF_Token):

# 1) 安装 acme.sh(会写入自动续期 crontab)
curl https://get.acme.sh | sh -s email=ops@example.com
source ~/.bashrc

# 2) 注入 DNS API 凭据
export Ali_Key='LTAI5t******'
export Ali_Secret='******'

# 3) 签发通配符 + 主域名证书(ECC 密钥)
~/.acme.sh/acme.sh --issue --dns dns_ali 
  -d example.com -d '*.example.com' 
  --keylength ec-256

# 4) 安装到固定路径,并在续期后自动 reload
~/.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      'nginx -t && systemctl reload nginx'

# 5) 确认定时任务存在
crontab -l | grep acme.sh

几个容易踩坑的参数与约束:

  • --fullchain-file 必须使用 fullchain(域名证书 + 中间证书),不能只装域名证书,否则小程序端会报握手失败。
  • 调试阶段先加 --staging 走测试环境,否则反复失败会触发 Let’s Encrypt 的 failed validation 限流(每小时每账号每域名 5 次)。
  • 重复签发同一组域名受 duplicate certificate 限制(每周 5 张),确认无误再执行 --force。
  • 默认续期在到期前 30 天触发(--days 30 可调),90 天有效期的证书有充足重试窗口;商业证书 398 天有效期,建议提前 45 天在日历与监控中双提醒。
  • 续期日志在 ~/.acme.sh/acme.sh.log,出问题先看这里,不要靠猜。

若证书部署在多台机器,可只在一台签发,用 Ansible 或对象存储分发 fullchain 与私钥,并把 reloadcmd 改成 systemctl reload nginx || systemctl reload httpd 以兼容不同发行版。

配置示例:Nginx、Apache、IIS 三套可直接粘贴的配置

Nginx(同时匹配主域与一级子域,80 强制 301,开启 HSTS 与 OCSP Stapling):

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;

    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/nginx/ssl/example.com.fullchain.pem;
    resolver 223.5.5.5 119.29.29.29 valid=300s;

    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>
    ServerName example.com
    ServerAlias *.example.com
    SSLEngine on
    SSLCertificateFile    /etc/httpd/ssl/example.com.fullchain.pem
    SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
    SSLProtocol -all +TLSv1.2 +TLSv1.3
    SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
    Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>

IIS:先双击 .pfx 导入(若为分离文件,需先把中间证书导入「中间证书颁发机构」再导入域名证书),在「站点 → 绑定」新增 https、端口 443、勾选「需要服务器名称指示」;随后用 URL Rewrite 添加 301 规则,或直接在 web.config 写入:

<rule name='ForceHTTPS' stopProcessing='true'>
  <match url='(.*)' />
  <conditions><add input='{HTTPS}' pattern='off' /></conditions>
  <action type='Redirect' url='https://{HTTP_HOST}/{R:1}' redirectType='Permanent' />
</rule>

改完配置务必先 nginx -t / httpd -t 校验语法,再 reload;reload 是平滑生效,不会中断既有连接,而 restart 会短暂丢包。

对比表格:验证方式、部署形态与证书来源怎么选

选型的第一个岔路口是验证方式,它直接决定了能不能签通配符、能不能在内网完成:

验证方式 能否签通配符 前置条件 自动化难度 适用场景
HTTP-01 否 80 端口对公网开放,可写 .well-known 低 单域名站点、有公网入口的 Nginx
DNS-01 是 DNS 解析商提供 API 中(需保管 AK/SK) 通配符、内网服务器、无 80 端口
TLS-ALPN-01 否 443 端口由 ACME 客户端独占 中高 无法开放 80 的特殊环境

第二个岔路口是部署形态,三种主流 Web 服务器的差异:

维度 Nginx Apache 2.4 IIS
证书文件 fullchain.pem + key fullchain.pem + key .pfx(含中间证书)
多域名共存 server_name 或 SNI 多 server 块 VirtualHost + ServerAlias SNI 绑定,无需独立 IP
HTTP 跳转 return 301 Redirect permanent / RewriteRule URL Rewrite 模块
生效方式 reload 平滑 graceful 平滑 iisreset / 回收应用程序池

第三个岔路口是证书来源:Let’s Encrypt 免费、90 天、全自动,信任链与商业 CA 一致,适合绝大多数 API 与小程序后端;商业 DV 通常 398 天,附带一定金额的赔付保障与人工支持,适合不想维护 ACME 链路的团队;OV/EV 只在有明确合规或投标要求时才需要。小程序与 APP 校验的是「CA 是否受信任 + 域名是否匹配 + 证书链是否完整」,与 DV/OV/EV 等级无关。

常见错误排查:从真实报错定位到根因

① nginx: [emerg] cannot load certificate … BIO_new_file() failed (SSL: error:80000002:system library::No such file or directory):路径写错、证书未上传,或 SELinux 禁止 Nginx 读取 /root 下的文件。用 ls -l 确认路径,执行 restorecon -Rv /etc/nginx/ssl 或把证书移到 /etc/nginx/ssl 并 chmod 600。

② 浏览器报 NET::ERR_CERT_AUTHORITY_INVALID,curl 报 curl: (60) SSL certificate problem: unable to get local issuer certificate:典型证书链不全。执行 openssl s_client -connect example.com:443 -showcerts,若只输出 1 张证书即为缺中间证书。修复:cat example.com.crt intermediate.crt > example.com.fullchain.pem,配置指向 fullchain 后 reload。

③ 小程序报 request:fail ssl hand shake error:四类原因按概率排序——证书链不全(最常见)、TLS 版本低于 1.2、域名未在微信后台「服务器域名」登记、使用了不被信任的自签证书。先用 openssl s_client -connect api.example.com:443 -tls1_2 验证握手,再检查后台域名配置(不能带端口、不能是 IP)。

④ NET::ERR_CERT_COMMON_NAME_INVALID:访问的域名不在证书 SAN 中。典型是把 *.example.com 用在了 a.b.example.com 上——通配符只覆盖一层。用 openssl x509 -noout -ext subjectAltName -in fullchain.pem 核对,必要时补签 *.b.example.com。

⑤ acme.sh 报 Verify error: DNS problem: NXDOMAIN looking up TXT for _acme-challenge.example.com:TXT 记录未添加、添加到了错误的子域、或主域与通配符的两条记录只加了一条。用 dig +short TXT _acme-challenge.example.com @8.8.8.8 复核,确认两条都在后重试。

⑥ Error creating new order :: too many certificates already issued for: example.com:触发 CA 限流。加 --staging 在测试环境调通流程,等待限流窗口(通常 1 周)过后再正式签发,切勿反复 –force。

⑦ curl: (7) Failed to connect to example.com port 443: Connection refused:与证书无关。依次检查 ECS 安全组入方向 443、firewall-cmd --list-ports、ss -lntp | grep 443,确认服务已监听且未只绑定 127.0.0.1。

⑧ NET::ERR_CERT_DATE_INVALID:证书过期或服务器时间错误。先 date -u 核对时间,再 openssl x509 -noout -dates -in fullchain.pem 看 notAfter,同时检查 crontab 里 acme.sh 的续期任务是否被注释掉。

效果验证与到期监控

配置完成后不要只看浏览器锁标,逐项验证才算完成交付:

# 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) 协商到的协议与套件(应为 TLSv1.2 或 TLSv1.3)
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | grep -E 'Protocol|Cipher'

# 3) 剩余有效期是否大于 30 天
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -checkend 2592000 && echo '有效期充足'

# 4) 子域是否复用同一张通配符证书
for h in api.example.com m.example.com; do
  echo | openssl s_client -servername $h -connect $h:443 2>/dev/null 
    | openssl x509 -noout -subject
done

# 5) 301 跳转与 HSTS 头
curl -sSI http://example.com | head -n 3
curl -sSI https://example.com | grep -i strict-transport-security

到期监控建议做成主动告警,而不是靠人记日历。下面这个脚本可放进 crontab 每天跑一次:

#!/usr/bin/env bash
DOMAIN=example.com
END=$(echo | openssl s_client -servername $DOMAIN -connect $DOMAIN:443 2>/dev/null 
      | openssl x509 -noout -enddate | cut -d= -f2)
LEFT=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
echo "$DOMAIN 证书剩余 $LEFT 天"
[ "$LEFT" -lt 15 ] && echo "WARN: $DOMAIN 证书将在 $LEFT 天后过期" | mail -s cert-alert ops@example.com

用 Prometheus 的 blackbox_exporter 时,直接采集 probe_ssl_earliest_cert_expiry 指标并配置 < 86400 * 20 的告警规则更省事。最后做三项业务侧验证:微信开发者工具关闭「不校验合法域名」后真机请求接口成功;用 SSL Labs 检测达到 A 及以上(避免 TLS 1.0/1.1、避免 RC4/3DES);APP 端在弱网下抓包确认无混合内容告警。至此,一张通配符证书即可长期稳定支撑泛解析下的全部 HTTPS 子域。

常见问题

通配符证书能覆盖 a.b.example.com 这种二级子域吗?

不能。*.example.com 只匹配一层,a.b.example.com 不在覆盖范围内,也不覆盖裸域 example.com。解决办法是签发时把 example.com 作为 SAN 一并写入,并对二级子域单独申请 *.b.example.com 或多域名证书。

一张通配符证书可以部署到多台服务器吗?

可以。同一份 fullchain 与私钥部署到任意多台机器即可,但私钥扩散会放大泄露风险:建议权限设为 600、只允许 Web 进程用户读取,并通过 Ansible Vault 或 KMS 分发,不要提交到 Git 仓库。若安全要求高,可为每台机器单独签发证书。

证书最长有效期到底是多久?

公有 CA 签发的 TLS 证书单张有效期上限为 398 天(约 13 个月),Let’s Encrypt 默认 90 天且可自动续期。行业已确定进一步缩短路线(后续将依次收紧至 200 天、100 天、47 天,以 CA/B 论坛与各 CA 官方公告为准),因此务必采用 acme.sh、certbot 等自动化工具,而不是人工一年一换。

微信小程序必须使用 OV 或 EV 证书吗?

不需要。小程序校验的是证书是否由受信任 CA 签发、域名是否匹配、证书链是否完整、TLS 是否不低于 1.2,与 DV/OV/EV 等级无关。受信任 CA 签发的 DV 通配符证书完全可用,只有在招标、合规审计明确要求组织信息时才需要 OV/EV。

换证书必须重启 Nginx 吗?会中断业务吗?

不需要重启,执行 nginx -t && systemctl reload nginx 即可平滑加载新证书,既有连接不受影响。Apache 用 apachectl -k graceful,IIS 需回收对应应用程序池。acme.sh 的 –reloadcmd 就是把这一步自动化。

免费证书和付费证书的信任度有区别吗?

在浏览器、小程序、APP 的信任链上没有区别,都是同一套根证书体系。差异在于:有效期长短(90 天 vs 398 天)、是否附带赔付保障、是否有工单支持、是否提供组织身份信息。预算有限且具备自动化能力的团队,Let’s Encrypt 是首选。

内容审核

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