ssl小程序证书购买:微信小程序 HTTPS 证书选型、部署与验证全流程(含 Nginx 配置与报错排查)
微信小程序只要求“受信任 CA 签发 + TLS 1.2 及以上 + 证书链完整”,DV 证书即可满足,单域名 DV 年费约 100–800 元,免费 Let's Encrypt 同样可用,关键在自动续期。 80% 的 request:fail ssl hand shake error 不是证书买错了,而是 Nginx 只部署了叶子证书、漏掉中间证书;用 cat leaf.crt intermediate.crt > fullchain.pem 修复。 服务端必须显式开启 TLSv1.2 与 TLSv1.3 并禁用 TLSv1.0/1.1:Nginx 配置 ssl_protocols TLSv1.2 TLSv1.3,否则 iOS 因 ATS 策略直接握手失败。 证书有效期将持续缩短(CA/B 论坛 SC-081:2026-03-15 起 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天),手工续期不可持续,建议用 acme.sh 3.0.x 或 certbot 2.x 的定时任务。 上线验证三步:openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts 看 verify return code: 0,curl --tlsv1.2 看 ssl_verify_result=0,再用 SSL Labs 确认 Chain issues 为 None。
一、小程序为什么必须买“合规”的 SSL 证书?根因拆解
“浏览器能正常打开 https://api.example.com,微信开发者工具也不报错,真机却提示 request:fail ssl hand shake error”——这是 ssl 小程序证书购买决策中最典型的误判场景:证书本身往往没买错,而是“合规”的某一道硬门槛没满足。先分清下面六道门槛,再决定买什么、买多久。
问题一:能不能直接用 IP、localhost 或带端口的地址?不能。据微信官方《小程序网络》文档,wx.request、wx.uploadFile、wx.downloadFile、wx.connectSocket 的请求地址必须是 https:// 或 wss://,且域名要提前加入“开发管理 → 开发设置 → 服务器域名”白名单;request 合法域名默认上限 20 个(uploadFile/downloadFile 各 20 个,tcp/udp 各 5 个),白名单每个自然月仅可修改 5 次。填 https://203.0.113.10、localhost 或 https://api.example.com:8443,真机一律返回 request:fail url not in domain list。注意白名单只接受精确域名、不接受 *.example.com 通配符,但证书本身可以是通配符证书。
问题二:证书有效,为什么还是握手失败?TLS 版本是硬门槛。微信客户端要求 TLS 1.2 及以上;只开 TLS 1.0/1.1 的服务端在 iOS 上会被 ATS(App Transport Security,配置基线见 RFC 7525)拒绝,日志里是 NSURLErrorDomain -1200 / -9802,表现是握手失败而非证书报错。用下面两条命令确认真实协商结果:
# 1) 强制 TLS 1.2 握手:若报 handshake failure,说明服务端未启用 TLS 1.2
# Nginx 侧需保证 ssl_protocols TLSv1.2 TLSv1.3;(TLSv1.3 需 nginx 1.13.0+ 且 OpenSSL 1.1.1+)
openssl s_client -connect api.example.com:443 -servername api.example.com -tls1_2 &1
| grep -E "Protocol|Cipher|Verify return code"
# 2) 反向验证:TLS 1.1 必须被拒绝,输出 handshake failure 才是正确状态
openssl s_client -connect api.example.com:443 -servername api.example.com -tls1_1 &1 | tail -3
问题三:桌面浏览器正常、微信里失败,为什么?九成是证书链不全。只部署叶子证书、漏掉中间证书时,桌面浏览器会通过 AIA(Authority Information Access)自动补链而“看起来正常”,iOS 则不做可靠的 AIA 抓取。据 Let’s Encrypt 文档,fullchain.pem 必须是叶子证书在前、中间证书在后,顺序不可颠倒。一条命令自检:
# 期望输出 ≥2(叶子 + 中间证书);只输出 1 即链不全
openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts /dev/null
| grep -c "BEGIN CERTIFICATE"
问题四:自签或企业内部 CA 行不行?不行。iOS 走系统信任库,并额外要求证书提交 CT(Certificate Transparency)日志、有效期不超过 398 天;Android 走系统 CA store。自签证书、企业私有 CA、已过期的根证书(典型如 2020-05-30 过期的 AddTrust External CA Root)都会失败。
| 证书类型 | iOS 微信 | Android 微信 | CT 日志 | 小程序适用性 |
|---|---|---|---|---|
| 自签证书 | 失败 | 失败 | 无 | 仅本地调试 |
| 企业私有 CA | 失败(需手动装根证书,小程序不支持) | 失败 | 无 | 不可用 |
| 公开 CA DV 单域名 | 通过 | 通过 | 需支持 | 推荐 |
| 公开 CA 通配符 | 通过 | 通过 | 需支持 | 可用(域名白名单仍须逐个填写) |
| Let’s Encrypt(ACME) | 通过 | 通过 | 默认提交 | 推荐,90 天有效期需自动续期 |
问题五:有 ICP 备案是不是就不用买证书?两件事互相独立。使用中国大陆服务器时域名需完成 ICP 备案,否则小程序审核和域名校验不通过;但备案不能替代证书。用境外服务器可免备案,仍然必须部署受信任证书并开启 TLS 1.2。
问题六:一次买三年是不是更省事?CA/B 论坛 SC-081 规定,公开信任 TLS 证书最长有效期自 2026-03-15 起降至 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天。这直接改变了 ssl 小程序证书购买的性价比逻辑:优先选支持 ACME 自动签发的 CA,把续期交给工具链,而不是靠“长约”省事。
二、从选型到上线的完整实操步骤(7 步)
把 ssl小程序证书购买拆成可执行动作,实际只有 7 步:先确定”要保护哪些域名”,再决定”买哪种证书”,然后才是生成密钥、验证、部署、登记、灰度。顺序错了,最典型的后果是证书买完才发现通配符覆盖不到 a.b.example.com,只能重新下单。
第 1 步:一次性导出全部请求域名。小程序里除了 API,还有 CDN 图片、支付回调、WebSocket,漏一个就会在真机上报 request:fail url not in domain list。而微信公众平台的服务器域名修改次数有限(历史规则为每月 5 次,以控制台提示为准),反复改动成本很高,所以先扫全:
# 扫描小程序源码中的 https 与 wss 域名,去重后得到候选清单
grep -rn "https://" miniprogram/ | awk -F/ '{print $3}' | sort -u
# 更严格:同时抓 wss:// 与配置文件中拼接的域名
grep -rhoE "(https|wss)://[a-zA-Z0-9.-]+" miniprogram/
--include=*.js --include=*.ts --include=*.json | sort -u
第 2 步:确定证书形态。据微信开放文档,小程序只校验证书链与 TLS 版本(要求 TLS 1.2 及以上),不校验 OV/EV 的组织信息,所以纯 API 域名用 DV 就够。多套环境(uat/prod)用通配符更省事,但要注意 RFC 6125 的匹配规则:*.example.com 既不覆盖 example.com 本身,也不覆盖 a.b.example.com,这两类必须额外加 SAN。
| 证书形态 | 覆盖范围 | 验证方式与耗时 | 适用场景 |
|---|---|---|---|
| DV 单域名 | 仅 api.example.com |
DNS-01,通常 1–10 分钟 | 单环境 API,成本最低 |
| DV 通配符 | *.example.com(不含裸域与多级子域) |
DNS-01,1–10 分钟 | uat/prod 多套环境,推荐 |
| DV 多域名(SAN) | 通配符 + 裸域 + 多级子域混搭 | DNS-01,1–10 分钟 | 域名形态不规整时 |
| OV / EV | 同 DV 对应形态 | 营业执照 + 电话回访,1–3 个工作日 | 有合规审计要求,小程序本身用不上 |
第 3 步:本地生成 CSR 与私钥。私钥不要交给 CA 生成,自己生成只上传 CSR:
# RSA 2048(兼容性最好)
openssl req -new -newkey rsa:2048 -nodes
-keyout api.example.com.key -out api.example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Technology/CN=api.example.com"
# 或 ECC P-256(体积小、握手快,需确认服务端 OpenSSL 1.0.2+)
openssl req -new -newkey ec -pkeyopt ec_paramgen_curve:prime256v1 -nodes
-keyout api.example.com.key -out api.example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Technology/CN=api.example.com"
chmod 600 api.example.com.key # 关键行:私钥只允许 root 读写
openssl req -in api.example.com.csr -noout -subject # 复核 CN 与域名一致
第 4 步:完成域名验证。DV 首选 DNS-01:在权威 DNS 添加 CA 指定的 TXT 或 CNAME 记录。注意记录名因 CA 而异——Let’s Encrypt(遵循 RFC 8555 ACME)用 _acme-challenge.api.example.com,部分商业 CA 在订单页给出 _dnsauth.api.example.com,以控制台为准。建议把该记录 TTL 临时调到 60 秒,改完立刻验证:
dig +short TXT _acme-challenge.api.example.com @8.8.8.8 # 换成 CA 实际给的主机记录
# 公共 DNS 已生效再点"验证",可避免 "DNS problem: NXDOMAIN" 类报错
第 5 步:部署 fullchain,而不是裸叶子证书。这是 Android 端最常见的坑:只配叶子证书时,iOS 可能正常,Android 老机型报 SSL handshake aborted。据 Mozilla SSL Configuration Generator 的建议,Nginx 应指向”叶子 + 中间证书”拼接的 fullchain:
server {
listen 443 ssl http2;
server_name api.example.com;
ssl_certificate /etc/nginx/ssl/api.example.com.fullchain.pem; # 叶子在前、中间证书在后,顺序不能反
ssl_certificate_key /etc/nginx/ssl/api.example.com.key; # 权限 600、属主 root
ssl_protocols TLSv1.2 TLSv1.3; # 微信要求 TLS 1.2 及以上
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;
}
权限或路径不对时,nginx -t 会直接给出:nginx: [emerg] cannot load certificate "/etc/nginx/ssl/xxx.pem": BIO_new_file() failed (SSL: error:0200100D:system library:fopen:Permission denied)。部署后用 openssl 复核链是否完整:
openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts /dev/null
| openssl x509 -noout -subject -issuer -dates
# 输出中应能看到 issuer 为中间 CA;若只看到叶子,说明 fullchain 拼错了
第 6 步:在小程序后台登记域名。路径:微信公众平台 → 开发 → 开发管理 → 开发设置 → 服务器域名。格式必须是纯域名 https://api.example.com,不带路径、不带端口、不能填 IP。保存后在开发者工具执行”清缓存 → 全部清除”再重新编译;真机测试需杀掉小程序进程重进,否则旧的域名白名单仍会缓存命中。
第 7 步:灰度与回滚。先发体验版,iOS 与 Android 各一台验证,Android 建议包含 7/8 老机型(系统证书库旧,最容易暴露中间证书缺失)。生产切换用 reload 平滑生效:
nginx -t && nginx -s reload # 先校验再热加载,不断开现有连接;避免 restart
# 回滚:旧证书与私钥至少保留 7 天,重命名切回后同样 reload
需要提醒的是,ssl小程序证书购买只是链路中的一环:真正决定上线成败的往往是第 1 步的域名清单是否完整、第 5 步的 fullchain 是否拼对。若后续要接自动化续期,可关注 ACME 客户端与证书透明度(RFC 6962)日志监控,这两块与本文的部署步骤直接衔接。
三、配置与命令示例:Nginx、acme.sh、certbot 与 OpenSSL 实测
Nginx 上最小可用的 HTTPS server 段到底该写哪些行?
先给两条容易踩坑的前提:ssl_certificate 必须指向 fullchain(叶子 + 中间证书),而不是只含叶子证书的 crt 文件;私钥权限应为 600、属主 root。另外 http2 on; 是 Nginx 1.25.1 才引入的独立指令,在 1.24.x 上写它会直接报 nginx: [emerg] unknown directive "http2" in /etc/nginx/conf.d/api.conf:3,1.24 及更早必须沿用 listen 443 ssl http2;。
# Nginx 1.25.1+ 写法。1.24.x 请删掉 http2 on; 并把 listen 改为 listen 443 ssl http2;
server {
listen 443 ssl;
http2 on; # 1.25.1+ 才有;1.24.x 无此指令
server_name api.example.com;
ssl_certificate /etc/nginx/ssl/api.example.com.fullchain.pem; # 叶子+中间证书
ssl_certificate_key /etc/nginx/ssl/api.example.com.key; # chmod 600
ssl_protocols TLSv1.2 TLSv1.3; # TLSv1.3 需 OpenSSL 1.1.1+
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; # 与 Mozilla "intermediate" 配置一致,TLS1.3 下此指令本就无效
ssl_session_cache shared:SSL:10m; # 10m 约可缓存 4 万个会话
ssl_session_timeout 1d;
ssl_session_tickets off; # 关 ticket 便于密钥轮换后的前向安全
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/api.example.com.chain.pem; # 只放中间证书,绝不能放 fullchain
}
ssl_trusted_certificate 是验证 OCSP 响应签名用的信任链,只接受中间证书。若误填 fullchain,Nginx 会打警告 "ssl_stapling" ignored, issuer certificate not found for certificate ...,stapling 静默失效——小程序端不会报错,但握手会多一次 OCSP 往返,弱网下首屏明显变慢。
怎么自查证书链顺序对不对?
拼接顺序错了是「部分 Android 打不开、iOS 正常」的头号原因。用 OpenSSL 一条命令即可验:
cat api.example.com.crt intermediate.crt > fullchain.pem # 顺序:叶子在前,中间证书在后
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout
输出应依次为叶子证书、中间证书的 subject= / issuer=。顺序颠倒时,部分 Android 机型会抛 Trust anchor for certification path not found,而浏览器因自带 AIA 补链能力照样正常——这正是做 ssl小程序证书购买 时最容易被忽略的验收项。
acme.sh 和 certbot 该用哪个?
| 维度 | acme.sh 3.0.x | certbot 2.x |
|---|---|---|
| 运行时依赖 | 纯 shell,无 Python | 需 Python 3.7+ |
| 默认 CA | 3.0 起默认 ZeroSSL,需 --server letsencrypt 切回 |
Let’s Encrypt |
| 续期机制 | 安装时写入 cron,到期前约 30 天自动续 | certbot.timer 每日两次检查,剩余 30 天续 |
| 部署钩子 | --install-cert + --reloadcmd |
--deploy-hook |
| 证书落盘 | 自定义路径 | /etc/letsencrypt/live/<domain>/ |
# acme.sh 3.0.x:签发 ECDSA P-256 证书并热加载
acme.sh --issue --server letsencrypt -d api.example.com -w /var/www/html --keylength ec-256 --force
acme.sh --install-cert -d api.example.com
--key-file /etc/nginx/ssl/api.key
--fullchain-file /etc/nginx/ssl/api.fullchain.pem
--reloadcmd "nginx -s reload"
# certbot 2.x 等价写法
certbot certonly --webroot -w /var/www/html -d api.example.com
--deploy-hook "systemctl reload nginx"
据 Let’s Encrypt 官方文档,其证书有效期为 90 天,续期应在到期前 30 天窗口内完成;两者都默认遵守该节奏,无需手工干预。
老安卓兼容要不要上双证书?
Nginx ≥ 1.11.0 支持在同一 server 内写两组证书,客户端按自己支持的套件自动挑选,ECDSA 省电、RSA 兜底:
# 同一 server 内两组 ssl_certificate / ssl_certificate_key,顺序无关
ssl_certificate /etc/nginx/ssl/api.ecdsa.fullchain.pem; # P-256
ssl_certificate_key /etc/nginx/ssl/api.ecdsa.key;
ssl_certificate /etc/nginx/ssl/api.rsa.fullchain.pem; # RSA 2048
ssl_certificate_key /etc/nginx/ssl/api.rsa.key;
若仍需覆盖 Android 4.4 等不支持 SNI 的终端,双证书也救不了——必须用独立 IP 或走支持 SNI 的 CDN。至于证书类型选择(DV / OV / 通配符)与预算,可参考本站《ssl小程序证书购买》选型篇。
四、证书类型与价格对比:小程序场景该买哪一档
小程序后台配置 request 合法域名时,微信只校验一件事:服务器是否能在 443 端口返回一条由受信任 CA 签发、且与域名匹配的完整证书链。它不关心你花 0 元还是 8000 元。据微信开放文档《服务器域名配置》,域名必须为 HTTPS 且证书有效,TLS 版本要求 1.2 及以上(iOS 端由 ATS 强制)。这意味着 DV 与 OV 在微信侧的信任链完全一致——预算应优先投给”自动续期能力 + SAN 规划”,而非 EV 的品牌溢价。
| 类型 | 价格区间(2026 国内,含税) | 签发时长 | 覆盖范围 | 小程序适用性 |
|---|---|---|---|---|
| 免费 DV(Let’s Encrypt / ZeroSSL,ACME) | 0 元 | 1–5 分钟 | 单域名,最多 100 个 SAN | 完全可用,必须配自动续期 |
| 云厂商免费 DV(阿里云/腾讯云) | 0 元,单张 3 个月 | 约 10 分钟 | 单域名 | 可用,需控制台手动续 |
| 付费 DV 单域名 | 100–800 元/年 | 10 分钟–2 小时 | 单域名 | 无运维脚本团队的首选 |
| DV 通配符 | 500–2500 元/年 | 10 分钟–4 小时 | *.example.com 一级子域 | 多环境(uat/prod)首选 |
| OV 单域名 | 1000–3500 元/年 | 1–3 个工作日 | 单域名 | 小程序不额外加分,仅用于合规展示 |
| EV 单域名 | 3000–10000 元/年 | 3–7 个工作日 | 单域名 | 浏览器已不显示绿色地址栏,一般不必 |
为什么不建议为小程序采购国密 SM2 证书?微信客户端默认走国际 TLS 握手(TLS_AES_128_GCM_SHA256 等标准套件),SM2/SM3 需要双证书网关(如 Nginx 加载 GmSSL 或国密网关)+ 客户端侧改造,除非业务受等保或行业合规强制,否则纯属自增复杂度。
下单前必须核对的三项技术指标(比”保险金额”更有价值):
- 是否提供 fullchain(叶子证书 + 中间证书)。只给
.crt不给中间证书的低价证书,在 Android 微信上会直接报net::ERR_CERT_AUTHORITY_INVALID。 - 是否支持 ACME 或 API 自动签发。可用以下命令在采购前自测现有证书链是否完整:
# 检查服务端是否返回完整链(应看到至少 2 段 BEGIN CERTIFICATE)
openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null 2>/dev/null | grep -c "BEGIN CERTIFICATE"
# 校验证书有效期与 SAN 列表(微信只认 SAN,不认 CN)
openssl s_client -connect api.example.com:443 -servername api.example.com </dev/null 2>/dev/null | openssl x509 -noout -dates -ext subjectAltName
# 验证 TLS 1.2 握手是否可用(微信 iOS 端最低要求)
openssl s_client -connect api.example.com:443 -servername api.example.com -tls1_2 </dev/null 2>/dev/null | grep "Protocol"
# 期望输出:Protocol : TLSv1.2
以上命令适用于 OpenSSL 1.1.1 及 3.x(1.1.1 起默认启用 SNI,-servername 建议显式指定;若省略,在多域名共用 IP 的场景可能拿到错误证书)。
避坑清单:不要买”永久证书””不受信任的内部证书”;不要接受只提供 PEM 单文件的商家。合同层面写明:重签发次数不限、同时支持 ECC(P-256)与 RSA 2048 双算法、故障响应 SLA ≤ 4 小时、提供中间证书下载地址。这样一次 ssl小程序证书购买 决策就能覆盖后续两三年的续期与扩容,避免 uat/prod 环境重复采购——这正是通配符或多 SAN 方案的实际价值所在。
五、常见错误与真实报错排查清单
微信小程序把绝大多数 TLS 失败都折叠成同一句话——request:fail ssl hand shake error,所以你看到的报错往往不是真因。真正高效的做法是先建立“现象 → 真因”的映射,再用 OpenSSL 在服务端复现一次握手,把问题定位到链、协议版本还是域名层面。下面这张表是排查时的第一站:
| 现象 / 报错原文 | 常见平台 | 最可能的真因 | 一句话验证 |
|---|---|---|---|
request:fail ssl hand shake error |
微信全平台(统一包装) | TLS 版本过低、套件不匹配、证书链不全 | openssl s_client 看 verify code 与链深度 |
errCode: -1, errMsg: request:fail ssl certificate verify failed |
iOS(底层 NSURLErrorDomain -1202) |
证书不受信任:自签、私有 CA、根证书被移除 | 换公共 CA 证书重试 |
CertPathValidatorException: Trust anchor for certification path not found |
Android | 缺中间证书或链顺序错误 | 拼接 fullchain 后重载 |
request:fail url not in domain list |
微信全平台 | 域名未加白名单、用 IP、带端口/路径、填了 http:// |
核对小程序后台域名配置 |
ERR_CERT_DATE_INVALID |
浏览器可见,微信仍报 hand shake error | 证书过期或系统时间偏差 | openssl x509 -dates |
| hostname mismatch | 全平台 | CN/SAN 未覆盖请求域名 | 导出 SAN 列表逐条比对 |
第一步永远是复现握手。据 OpenSSL 官方文档,s_client 的 -servername 用于发送 SNI,缺失它会连到默认虚拟主机、拿到错误证书:
# 以 TLS 1.2 模拟微信客户端握手,输出完整证书链与校验结论
openssl s_client -connect api.example.com:443
-servername api.example.com -tls1_2 -showcerts 非 0 说明链或信任有问题
# Certificate chain 下的 s:/i: 行数 -> 链深度,正常为 2~3 层(叶证书 + 1~2 张中间证书)
# 若只有 1 层,基本可判定服务端没下发中间证书
Android 的 Trust anchor 报错几乎 100% 是链不完整。Nginx 的 ssl_certificate 只接受单个文件,必须把叶证书与中间证书按“叶在前、中间在后”的顺序拼成一个 fullchain,根证书不要放(客户端信任库自带):
# 顺序不能反:站点证书在前,中间证书在后
cat api.example.com.crt intermediate.crt > fullchain.pem
# nginx.conf 中指向拼接后的文件
# ssl_certificate /etc/nginx/ssl/fullchain.pem;
# ssl_certificate_key /etc/nginx/ssl/api.example.com.key;
nginx -t && nginx -s reload
顺带提醒:ssl_protocols 在 nginx 1.23.4 之前的默认值是 TLSv1 TLSv1.1 TLSv1.2,之后才改为 TLSv1.2 TLSv1.3。如果你的实例是老版本又手动关掉了 TLS 1.2,就会直接命中 hand shake error。
iOS 的 -1202 是信任问题,不是配置问题。自签证书、企业私有 CA 都会触发;历史上最典型的是 2020 年 5 月 30 日 Sectigo 的 AddTrust External CA Root 过期事件,导致大量仍交叉签名到该根的站点在 iOS 上突然全量报 -1202——证书本身没过期,但链上的根被移出了信任库。据 Apple 开发者文档,iOS 对证书链的校验走系统信任评估,任何一环不被信任即整体失败。
域名类报错先排除低级错误。request:fail url not in domain list 的触发条件包括:域名没加入小程序后台白名单、直接用了 IP、URL 里带了非 443 端口或多余路径、白名单里误填 http:// 前缀。另外 wss:// 的域名必须在 socket 合法域名里单独配置,不能只加在 request 合法域名里。
- APP/小程序 HTTPS · SSL网站加密证书 · CA证书配置
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
- 服务器维护 · 网站代维护 · 服务器托管代维
有效期与域名匹配用两条命令就能查清:
# 查有效期,输出为 UTC,注意换算本地时区,避免误判为“刚过期”
openssl x509 -noout -dates -in fullchain.pem
# notBefore=Mar 1 00:00:00 2025 GMT
# notAfter=Mar 1 23:59:59 2026 GMT
# 查 SAN,确认所有业务域名都被覆盖
openssl x509 -noout -text -in fullchain.pem | grep -A1 "Subject Alternative Name"
域名匹配规则按 RFC 6125:通配符 *.example.com 只匹配一级子域,不覆盖 example.com 本身,也不覆盖 a.b.example.com。所以很多人在 ssl小程序证书购买 阶段买了单域名或通配符证书,上线后才发现 api.example.com 与 m.example.com 需要各自签发,或改用多域名(SAN)证书——下单前把小程序要请求的全部域名列出来,逐一核对 SAN 列表,比事后重签便宜得多。同样,ssl小程序证书购买 时优先选 Let’s Encrypt、DigiCert 等公共信任链的证书,自签或私有 CA 在 iOS 上必然踩 -1202。
六、效果验证:如何确认证书真的生效了
证书装完、Nginx reload 之后,curl -I 返回 200 就等于”生效”了吗?不一定——200 只能证明服务活着,证明不了证书链完整、协议版本合规、小程序端能握手成功。下面这套验证链,从命令行一路查到真机和监控。
第一步:证书本身签给了谁、什么时候到期?用 s_client 抓取服务端实际下发的证书并解析:
# -servername 必须显式带上,否则 SNI 多域名场景可能拿到默认站点证书
openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 期望输出示例:
# subject=CN = api.example.com
# issuer=C = US, O = Let's Encrypt, CN = R3 ← 中间 CA,不是 ISRG Root X1
# notAfter=Jun 12 08:00:00 2026 GMT
issuer 显示为根 CA(如 ISRG Root X1)通常是配置时把根证书也塞进了 ssl_certificate,浏览器能容忍,但部分 Android 与小程序基础库会报链错误。据 Let’s Encrypt 官方文档《Chain of Trust》,服务端应下发”叶子证书 + 中间证书”,根证书由客户端自带。
再单独确认校验结果码:
openssl s_client -connect api.example.com:443 -servername api.example.com </dev/null 2>/dev/null
| grep "Verify return code"
# 期望:Verify return code: 0 (ok)
# 典型失败:
# unable to get local issuer certificate → 漏装中间证书
# self-signed certificate in certificate chain → 链里混入自签根
第二步:协议版本是否收敛?分别用 curl 与 openssl 卡版本:
# 强制 TLS 1.2 访问健康检查接口,输出 "HTTP状态码 证书校验结果"
# ssl_verify_result 为 0 即 X509_V_OK,非 0 说明链有问题
curl -sS -o /dev/null -w "%{http_code} %{ssl_verify_result}n"
--tlsv1.2 --tls-max 1.2 https://api.example.com/health
# 期望:200 0
# 确认 TLS 1.0/1.1 已关闭(需要 openssl 1.1.1+ 才支持 -tls1_1 参数)
openssl s_client -connect api.example.com:443 -tls1_1 </dev/null
# 期望:alert handshake failure 或 no protocols available
第三步:外部扫描怎么选?两种工具覆盖点不同,建议都跑:
| 工具 | 重点看什么 | 耗时 | 局限 |
|---|---|---|---|
| Qualys SSL Labs | 总评级(目标 A 及以上)、Chain issues 是否为 None、是否启用 TLS 1.3、弱套件 | 1–3 分钟 | 要求公网可达;国内访问慢,偶尔超时 |
| MySSL(国内) | 证书链完整性、OCSP Stapling 是否生效、是否被国内 CA 信任 | 秒级 | 评级体系与 SSL Labs 不一致,不能互认 |
SSL Labs 的评级方法论遵循其官方 SSL Server Rating Guide;Chain issues 出现 “Incomplete” 是最常见扣分项,和你上一步 Verify return code 报的错是同一个根因。
第四步:小程序侧怎么看?微信开发者工具 → 详情 → 域名信息,会直接列出当前请求域名的 TLS 协议版本与证书有效期,比猜快。真机排查请用 vConsole 的 Network 面板:控制台往往只给一句 request:fail,而 Network 面板能显示到 SSL 握手层面,失败原因更准确。这也是很多人反复做 ssl小程序证书购买、却始终定位不到问题的症结——买对了证书,错在链或协议上。
第五步:多端覆盖。至少准备 iOS 15+ 与 Android 7、Android 8 各一台真机跑体验版。老 Android 是证书链缺失和 SNI 不兼容的高发区:Android 7.0 起应用默认不再信任用户安装的 CA,7/8 对中间证书顺序也更挑剔。上线后 24 小时内复查一次访问成功率。
第六步:让它持续可观测。用 Prometheus blackbox_exporter(v0.13+ 提供 SSL 指标)的 http 探针采集证书到期时间:
# blackbox.yml 片段(blackbox_exporter v0.24+)
modules:
https_2xx:
prober: http
timeout: 5s
http:
valid_status_codes: [200]
preferred_ip_protocol: ip4
tls_config:
insecure_skip_verify: false # 必须 false,否则证书错误也不会触发失败
# 证书剩余天数少于 21 天告警(probe_ssl_earliest_cert_expiry 单位为 Unix 秒)
(probe_ssl_earliest_cert_expiry - time()) / 86400 < 21
# 同时观察可用性与握手耗时,可区分"续期失败"和"网络抖动"
probe_success == 0
probe_duration_seconds > 2
把到期告警设在 21 天,是给 Let’s Encrypt 90 天证书留出两次自动续期重试的窗口——续期失败往往不是第一次就暴露,而是静默失败到第 60 天才炸。据 Let’s Encrypt 文档,其续期建议是在剩余 30 天时开始尝试。
七、续期与证书生命周期管理:别让证书在凌晨过期
证书为什么总在凌晨过期?因为 90 天里你有 89 次机会忘记它
微信小程序要求的 HTTPS 证书,无论你当初 ssl小程序证书购买 时选的是免费 DV 还是商业 OV,到期前都不会有人给你打电话。Let’s Encrypt 免费证书有效期 90 天;据 CA/Browser Forum 通过的 SC-081 提案排期,公有信任 TLS 证书的最长有效期将分三步缩短:2026-03-15 起 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天。据 Let’s Encrypt 官方文档《Challenge Types》与 RFC 8555(ACME 协议),客户端可全自动完成 HTTP-01 与 DNS-01 验证,因此自动化续期是唯一可持续的方案,人工续期在 47 天时代已不可行。
acme.sh 怎么装定时任务?默认提前几天续?
# 1) 安装 cron 条目,实际写入 /var/spool/cron/root:
# 0 0 * * * "/root/.acme.sh"/acme.sh --cron --home "/root/.acme.sh" > /dev/null
acme.sh --install-cronjob
# 2) 签发时就必须绑定 reloadcmd,否则续期成功后 Nginx 仍加载旧证书
# acme.sh 默认续期窗口为到期前 60 天(源码 DEFAULT_RENEW=60),可用 --days 调整
acme.sh --issue -d api.example.com -d cdn.example.com -w /var/www/acme
--days 30
--reloadcmd "nginx -t && nginx -s reload"
# 3) 核对每张证书的到期时间与剩余天数
acme.sh --list
要点:--reloadcmd 里的 nginx -t 必须先过配置检查,否则一次坏配置会在凌晨把线上打挂。
certbot 的 systemd timer 怎么确认真的在跑?
# certbot.timer 默认 OnCalendar=*-*-* 00,12:00:00,即每日两次,
# 并带 RandomizedDelaySec=12h 随机抖动,避免全网同一秒打爆 ACME 服务端
systemctl list-timers | grep certbot
# NEXT LEFT LAST PASSED UNIT
# Tue 2025-06-10 03:14:00 CST 5h 12min Mon 2025-06-09 15:14:02 CST 6h ago certbot.timer
# 先用 dry-run 验证续期链路可用(走 staging 环境,不消耗速率限制)
certbot renew --dry-run
# certbot 默认在剩余 30 天内才真正续期;强制立即续期用于演练
certbot renew --force-renewal --deploy-hook "systemctl reload nginx"
典型失败现场是证书文件被删但配置还在,Nginx 报:nginx: [emerg] cannot load certificate "/etc/letsencrypt/live/api.example.com/fullchain.pem": BIO_new_file() failed (SSL: error:80000002:system library::No such file or directory)——出现它说明 renew 早就失败了,只是没人看日志。
多域名证书更省事吗?续期点更少,但故障爆炸半径更大:
| 方案 | 续期点数量 | 续期失败影响面 | 建议 |
|---|---|---|---|
| 每域名一张单 SAN | N 张 | 仅该域名 | 域名少、生命周期各异时用 |
| 5 SAN 合一张 | 1 张 | 5 个域名同时不可用 | 仅限同一业务线、同一部署单元 |
| 按业务线拆 2–3 张 | 2–3 张 | 局部降级 | 推荐,兼顾运维量与隔离性 |
私钥和指纹怎么归档?私钥永不进 Git(git check-ignore -v privkey.pem 兜底校验),交由 Vault 或云 KMS 托管;每次重签发后把新指纹同步进 CMDB:
# 输出指纹与到期时间,写入 CMDB 资产字段
openssl x509 -in /etc/letsencrypt/live/api.example.com/cert.pem -noout
-fingerprint -sha256 -enddate -subject
# notAfter=Aug 30 23:59:59 2025 GMT
# SHA256 Fingerprint=3A:1F:...:9C
同时给到期时间挂一条告警(剩余 < 21 天即触发),这是 ssl小程序证书购买 之后最容易被忽略、也最容易被微信开发者工具「证书链不完整 / 已过期」报错打脸的一环。
八、采购注意事项:发票、主体与合规细节
Q:小程序用 DV 证书,个人主体能申请吗?发票怎么开?
能。DV(域名验证型)只校验证书申请人对域名的控制权,个人身份证或企业营业执照均可提交;OV(组织验证)和 EV(扩展验证)则必须提供营业执照,并由 CA 通过电话回拨、邓白氏编码或第三方数据库完成组织信息核验,通常需要 1–3 个工作日。据 CA/Browser Forum《Baseline Requirements》对组织身份验证的规定,OV/EV 证书的 subject 字段必须包含经核验的 O(组织名),这也是判断一张证书是否真为 OV 的可靠依据。发票方面:主流云厂商的证书市场默认开具 6% 税率的增值税专用发票(税目为“信息技术服务”),下单后可在控制台自助申请;代理商渠道的发票由代理商自身开具,抬头、税率和开票时效都可能不同,必须在付款前书面确认,否则报销时才发现开不出专票的情况非常常见。这也是 ssl小程序证书购买 时最容易被忽略的一环。
| 采购渠道 | 主体要求 | 发票情况 | 重签发 | 主要风险 |
|---|---|---|---|---|
| 云厂商证书市场 | DV 个人/企业均可;OV/EV 需营业执照 | 6% 增值税专票,控制台自助申请 | 免费、不限次 | 价格略高,但链路与售后清晰 |
| CA 官方直销 | 同上,审核最严格 | 境外 CA 多为形式发票,需代理开票 | 免费、不限次 | 跨境付款、汇率与税务处理复杂 |
| 代理商/低价渠道 | 同上 | 由代理商开具,税率与抬头需提前确认 | 需看合同约定 | 中间证书缺失、根证书不被信任 |
Q:换了服务器、补装中间证书,需要重新购买吗?重签发收费吗?
不需要重新付费。重签发(reissue)在同一有效期内一般免费且不限次数,但它不会延长原有效期——新证书的 notAfter 与原证书一致。换服务器、私钥泄露、漏装中间证书,直接走重签发即可。签发后用以下命令核对主体、有效期与证书链,避免“看起来装好了但链不完整”:
# 查看证书主体、签发者、有效期与 SAN,判断是否为 OV、是否临近过期
openssl x509 -in fullchain.pem -noout -subject -issuer -dates -ext subjectAltName
# 输出示例:
# subject=CN = api.example.com, O = 某某科技有限公司, C = CN
# issuer=C = US, O = Let's Encrypt, CN = R11
# notBefore=Feb 1 00:00:00 2025 GMT
# notAfter=May 2 23:59:59 2025 GMT
# 验证服务端是否下发完整中间证书(缺链时浏览器/小程序会报 chain 错误)
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt
-untrusted chain.pem cert.pem
# 用 acme.sh 申请 ECC P-256 证书并启用自动续期(Let's Encrypt 有效期 90 天)
acme.sh --issue -d api.example.com --webroot /var/www/html --keylength ec-256
Q:有小程序证书了,还需要 ICP 备案吗?
需要,二者相互独立、不可互替。据工信部《互联网信息服务管理办法》,使用中国大陆境内服务器提供服务的域名必须完成 ICP 备案;而微信小程序要求 request 合法域名走 HTTPS 且域名已备案——备案号不能替代证书,证书也不能免除备案。反过来,境外服务器虽可跳过备案,但小程序后台配置合法域名时仍受“必须 HTTPS”的约束。做 ssl小程序证书购买 决策时,请把备案状态与证书状态分开核对,别把两件事混成一个前置条件。
Q:对公采购该把哪些技术条款写进合同?“一次买 5 年”可信吗?
建议在合同中明确:支持 ACME 协议或 API 自动签发与续期、交付完整中间证书链、支持 ECC P-256 与 RSA 2048 双算法、证书有效期与 CA/B 论坛新规同步、故障 4 小时内响应。关于“低价高年限”,据 CA/Browser Forum 已通过的 SC-081 决议,公开信任 TLS 证书的最长有效期将于 2026-03-15 起降至 200 天、2027-03-15 起降至 100 天、2029-03-15 起降至 47 天。因此任何宣称“一次买 5 年长期有效”的产品,本质都是多年期订阅加多次重签发,务必核实其根证书是否在 iOS/Android 信任库中——苹果对 TLS 服务器证书设有有效期上限,超限证书在 iOS 上会直接报 NSURLErrorServerCertificateUntrusted。这也是 ssl小程序证书购买 时最值得多问一句的地方。
可以。微信只校验证书是否由受信任 CA 签发、TLS 版本是否 ≥ 1.2、证书链是否完整,不区分 DV/OV/EV。Let's Encrypt 的 DV 证书完全满足要求,代价是有效期约 90 天,必须用 acme.sh 或 certbot 配置自动续期,否则过期当天小程序全部请求失败。
不可以。服务器域名白名单只接受纯域名格式(如 https://api.example.com),不支持 IP、localhost,也不能带 :8443 之类的端口,默认走 443。如果后端确实在非标端口,需要在前置 Nginx 或负载均衡上做 443 转发。
先跑 openssl s_client -connect api.example.com:443 -servername api.example.com -tls1_2 -showcerts fullchain.pem 后 nginx -s reload 即可恢复。
不能覆盖多级。*.example.com 只匹配 api.example.com 这一级,不匹配 example.com 本身,也不匹配 a.b.example.com。如果小程序同时用到 api.example.com 和 uat.api.example.com,需要购买带多个 SAN 的通配符加单域名组合证书,或分别签发。
没有本质区别,两者都由受信任根 CA 签发,iOS 与 Android 的校验结果一致。差异主要在有效期长度(免费多为 90 天或 3 个月)、签发 SLA、是否提供发票与合同、是否支持人工客服,以及是否提供自动签发 API。
所有 https 请求都会失败,用户端表现为页面白屏或数据加载不出来,微信侧通常只提示 request:fail ssl hand shake error 或 ssl certificate verify failed,不会明确说“证书过期”。恢复只需部署新证书并 reload,但期间的用户流失无法追回,建议用 blackbox_exporter 在剩余 21 天时告警。
需要,两者是独立的两件事。使用中国大陆服务器时域名必须完成 ICP 备案,否则小程序审核和域名校验无法通过;证书只解决传输加密与身份验证。如果服务器在境外,可不备案,但仍必须部署受信任证书并开启 TLS 1.2。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。