AlphaSSL 通配符 SSL 证书申请、Nginx 配置、小程序 HTTPS 与续费排错指南
问题背景与根因:为什么小程序和泛域名场景总在证书上翻车
AlphaSSL 是 GlobalSign 旗下的 DV 品牌,常见产品是通配符域名证书。它不绑定服务器和 IP,Nginx、Apache、IIS 都可部署,浏览器地址栏只显示锁标识,不显示企业名称。很多旧文把“绿色小锁”当成企业身份,这是过时说法:Chrome、Firefox 已取消 EV 绿色地址栏,DV 证书更不会展示公司名。
真正导致小程序 HTTPS 失败的原因通常不是“证书不够贵”,而是四类硬问题:一是证书链不完整,服务器只下发叶证书,Android 和微信无法补链;二是域名不匹配,*.example.com 只覆盖一级子域,api.example.com 可以,a.api.example.com 不行,example.com 也不自动包含;三是有效期超限或已过期,公共 TLS 证书单张最长 398 天,Let’s Encrypt 为 90 天;四是小程序后台未配置 request 合法域名,或域名未完成 ICP 备案。先定位根因,再谈购买和配置,能少走很多弯路。
此外,TLS 1.0/1.1 已不被主流客户端接受,小程序要求 TLS 1.2 及以上;如果服务器仍启用旧协议或使用不完整的 SHA-1 证书链,也会出现握手失败。Apple ATS 同样要求 TLS 1.2、SHA-256 和 2048 位以上 RSA(或 ECDSA),这也是 AlphaSSL 证书需要正确配置中间证书和加密套件的原因。
证书选型与有效期规则:398 天、90 天和通配符边界
选型先看覆盖范围,再看有效期和验证方式。AlphaSSL 通配符证书属于 DV(域名验证),签发时只验证域名控制权,不审核企业资料;单张证书有效期最长 398 天,市面上所谓 2 年、3 年产品通常是多年期订单,CA 仍按年签发或到期重签,不能理解成一张证书连续用 3 年。Let’s Encrypt 通配符证书有效期 90 天,适合用 acme.sh、certbot 做 DNS-01 自动续期。
通配符边界必须写进申请单:*.example.com 只匹配 example.com 下一级主机名,例如 api.example.com、m.example.com;不匹配 a.api.example.com,也不自动包含裸域 example.com。若小程序请求的是 api.example.com,申请时应在 SAN 中同时写入 DNS:*.example.com 和 DNS:example.com,或单独为裸域签发证书。现代浏览器和微信不再依赖 CN 字段,必须检查 SAN 是否包含实际访问域名。
小程序场景还要求:request 合法域名必须是 HTTPS、不能带端口、不能是 IP、不能是 localhost;证书由受信任 CA 签发;证书链完整;TLS 1.2 及以上。AlphaSSL 可用于微信小程序和公众号,但 DV 不展示企业身份,若页面需要体现组织信息,应选择 OV 或 EV,并接受 EV 不再显示绿色地址栏的事实。
完整实操:生成 CSR、完成域名验证并签发 AlphaSSL 通配符证书
第一步,在服务器上生成私钥和 CSR。建议使用 2048 位以上 RSA,或按 CA 支持情况使用 ECDSA P-256。私钥权限设为 600,不要发给代理商。
openssl genrsa -out example.com.key 2048
chmod 600 example.com.key
openssl req -new -sha256 -key example.com.key -out example.com.csr -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example/CN=*.example.com' -addext 'subjectAltName=DNS:*.example.com,DNS:example.com'
检查 CSR 的 SAN 是否正确:
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
第二步,在 GlobalSign/AlphaSSL 代理商控制台下单,选择通配符 DV,粘贴 CSR,验证方式选 DNS。按控制台给出的记录添加 TXT 或 CNAME,例如 _dnsauth.example.com,等待 TTL 生效后用公共 DNS 检查:
dig +short TXT _dnsauth.example.com @8.8.8.8
dig +short CNAME _dnsauth.example.com @1.1.1.1
第三步,CA 签发后下载证书。通常得到叶证书和中间证书,部署时必须合并为 fullchain.pem:
cat example.com.crt intermediate.crt > fullchain.pem
openssl x509 -in fullchain.pem -noout -subject -issuer -dates -ext subjectAltName
如果控制台只给一个 .crt,先用 openssl s_client 或 CA 下载页确认中间证书。不要用 whois 邮箱验证时填错邮箱,否则订单会卡在待验证。DNS 验证记录不要提前删除,部分 CA 会复查。
Nginx、Apache、IIS 配置示例:证书链和 TLS 1.2 是硬指标
Nginx 推荐配置如下,关键是 ssl_certificate 指向 fullchain.pem,而不是单张叶证书;私钥与证书必须匹配;协议只留 TLS 1.2 和 TLS 1.3。
server {
listen 443 ssl http2;
server_name api.example.com;
ssl_certificate /etc/nginx/ssl/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-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384';
ssl_prefer_server_ciphers on;
ssl_session_cache shared:SSL:10m;
add_header Strict-Transport-Security 'max-age=31536000' always;
}
执行 nginx -t 检查语法,再 nginx -s reload 平滑加载。Apache 2.4.8 及以上把叶证书和中间证书写进同一个 SSLCertificateFile;旧版本才需要 SSLCertificateChainFile。
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
IIS 先把证书和中间证书导入为 PFX,导入时勾选“包括所有证书”,把中间证书放入“中间证书颁发机构”,站点绑定 443 时勾选 SNI。小程序后台在“开发管理-开发设置-服务器域名”添加 https://api.example.com,不能带路径和端口。所有节点都要更新 fullchain.pem,否则负载均衡后面仍可能返回旧链。
通配符、单域名与小程序证书对比表:别为省一张证书埋雷
下面按实际部署关注点对比,价格因渠道波动,表中不写具体金额。注意“小程序可用”不是证书类型特权,而是受信任 CA、完整证书链、TLS 1.2 和域名合规共同决定。
| 类型 | 覆盖范围 | 单张有效期 | 验证方式 | 小程序可用 | 自动化 | 适用场景 |
|---|---|---|---|---|---|---|
| AlphaSSL 通配符 DV | *.example.com 一级,可加裸域 SAN | 最长 398 天 | DNS/Whois 邮箱 | 是,需完整链和 TLS 1.2 | 控制台/代理商 API,通常无公开 ACME | 多个一级子域统一管理 |
| Let’s Encrypt 通配符 | 同上 | 90 天 | DNS-01 | 是 | certbot/acme.sh 自动续期 | 可自动化、预算敏感 |
| 单域名 DV | api.example.com | 最长 398 天 | HTTP/DNS | 是 | 视 CA 而定 | 只有一个入口域名 |
| OV/EV | 单域或多域 | 最长 398 天 | 组织验证 | 是 | 多为手动 | 需要企业身份审核 |
如果小程序只请求 api.example.com,单域名证书足够;如果有 api、m、pay 多个一级子域,AlphaSSL 通配符更省管理成本;如果团队能维护 DNS API,Let’s Encrypt 通配符的 90 天自动续期更稳。不要用 *.example.com 去覆盖 a.api.example.com,这是最常见的选型错误。
续费与过期处理:从监控到热加载的完整流程
先建立到期监控,不要依赖控制台邮件。线上证书检查命令:
echo | openssl s_client -connect api.example.com:443 -servername api.example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -checkend 2592000 && echo OK || echo RENEW
checkend 2592000 表示剩余不足 30 天返回非零,可放入 cron 每天执行并告警。AlphaSSL 多年期订单到期前在控制台续费或重签,建议生成新私钥和新 CSR,不要长期复用旧私钥;下载新 fullchain.pem 后先备份,再执行 nginx -t 和 nginx -s reload。Let’s Encrypt 用 certbot renew –dry-run 验证自动续期,acme.sh 用 acme.sh –renew -d example.com –force 测试。
续费后必须做三件事:用 openssl s_client 确认线上返回的新到期时间;用 openssl verify 检查证书链;在小程序真机重新请求接口。若使用 CDN、WAF、负载均衡,证书要上传到每一层,只更新源站不够。过期后不要只改系统时间,客户端校验证书有效期,改时间无效且会引发更多 TLS 错误。
常见错误排查:真实报错逐条定位
下面这些报错在 AlphaSSL 通配符证书部署中最常见,按“报错-原因-处理”排查。
| 报错 | 原因 | 处理 |
|---|---|---|
| curl: (60) SSL certificate problem: unable to get local issuer certificate | 服务器只发送叶证书,缺中间证书 | cat 叶证书 + 中间证书 > fullchain.pem,Nginx 指向 fullchain |
| curl: (60) SSL certificate problem: certificate has expired | 证书过期或客户端时间错误 | 续费并 reload;检查服务器时间 |
| nginx: SSL_CTX_use_PrivateKey() failed … key values mismatch | 私钥与证书不匹配 | 分别计算 modulus 的 md5 对比 |
| Java: PKIX path building failed | JDK truststore 缺根证书或中间链 | 部署完整链,必要时导入根证书 |
| Android/微信: Trust anchor for certification path not found | 证书链不完整或根证书不受信 | 补中间证书,换受信任 CA |
| 微信: request:fail ssl hand shake error | TLS 版本低、链不完整、域名未配置 | 开 TLS 1.2,检查链和后台域名 |
| hostname mismatch | 通配符层级不匹配或 SAN 未写域名 | 用 openssl x509 -checkhost 验证,重签 SAN |
匹配私钥和证书可执行:openssl x509 -noout -modulus -in fullchain.pem | openssl md5;openssl rsa -noout -modulus -in example.com.key | openssl md5。两个值必须一致。检查域名:openssl x509 -in fullchain.pem -noout -checkhost api.example.com。检查链:openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted intermediate.crt example.com.crt。
效果验证:浏览器、命令行、小程序三端验收
命令行验收最可靠。先看线上实际下发的证书链和到期时间:
openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null
openssl s_client -connect api.example.com:443 -servername api.example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
再用 curl 强制 TLS 1.2 请求,确认没有证书错误:
curl -I --tlsv1.2 --tls-max 1.2 https://api.example.com/health
curl -I https://api.example.com/health
浏览器打开开发者工具 Security 面板,确认证书由 GlobalSign/AlphaSSL 链签发、SAN 包含当前域名、协议为 TLS 1.2 或 1.3。不要只看地址栏锁标识,DV 证书的锁只代表加密连接,不代表企业身份。小程序端用真机调试,在“开发调试”里观察 request 域名是否命中合法域名,iOS 和 Android 各测一次,因为系统根证书和补链行为不同。
最后做一次 SSL Labs 或内部扫描,目标不是盲目追 A+,而是确认:证书链完整、无过期、无 SHA-1、TLS 1.0/1.1 关闭、HSTS 按需开启。若使用多节点,逐台执行 openssl s_client,避免只验到其中一台。
常见问题
*.example.com 只匹配一级,如 api.example.com;不匹配 a.api.example.com,也不自动包含 example.com。需要把根域写入 SAN 或单独申请证书。
不必须。只要 request 合法域名使用受信任 CA 签发、证书链完整、TLS 1.2 及以上,单域名证书也可。通配符适合多个子域统一管理。
公共 TLS 证书单张最长 398 天,不是自然年。Let’s Encrypt 为 90 天。多年期订单通常按年重签,到期前 30 天续费。
浏览器可能缓存或自动补链;小程序对证书链、TLS 版本和域名备案更严格。用 openssl s_client -showcerts 检查是否缺中间证书,并确认域名已加入小程序后台。
不需要重启,替换 fullchain.pem 和私钥后先 nginx -t,再 nginx -s reload 平滑加载。若用容器或负载均衡,要同步更新所有节点。
不会。Chrome、Firefox 等已取消 EV 绿色地址栏,只显示锁标识。AlphaSSL 属于 DV,证书不展示企业名称,企业身份需通过 OV/EV 审核体现。