SSL 证书申请、安装、配置与续费全流程:通配符与多域名(SAN)证书实战
一、问题背景:一张证书为什么会在小程序、APP 和浏览器上同时“翻车”
原文只列了一句“SSL 认证支持微信公众号、小程序、APP、公司网站、安卓、苹果”,这描述的是结果,不是做法。真实项目里,同一张证书要同时被 Chrome/Safari、微信小程序与公众号网页、iOS/Android APP 的 HTTPS 请求、以及各类第三方 SDK 校验,失败往往集中在四类根因:
- 域名覆盖不全:证书只签了 example.com,但小程序
wx.request打的是 api.example.com;或者买的是 *.example.com,却去访问 a.b.example.com(通配符只匹配一级子域)。 - 证书链不完整:服务器只下发叶子证书,没带中间证书(Intermediate CA)。桌面浏览器能靠 AIA 自动补齐,Android WebView、微信小程序、Java/Go 客户端会直接判定证书无效。
- 协议与套件过旧:只开 TLS 1.0/1.1,或保留 3DES、CBC 套件。微信小程序要求 TLS 1.2 及以上,iOS ATS 还要求 SHA-256 签名与前向保密(ECDHE)套件。
- 有效期失控:公有 CA 签发的证书最长有效期 398 天,Let’s Encrypt 只有 90 天。“一次买三年”的方案早已不可行,忘续费就是全站不可访问。
还要纠正两个常见过时说法:一是有效期上限,CA/B Forum 已通过 SC-081,2026-03-15 起单张证书最长 200 天、2027-03-15 起缩短到 100 天,续费必须自动化;二是“装了证书就能过小程序审核”,微信还要求域名已完成 ICP 备案(服务器在中国大陆时)、必须走 443 端口、不能是 IP 地址,并且要在小程序后台“开发管理 → 服务器域名”里配置 request 合法域名。
二、选型:单域名、多域名(SAN)、通配符到底怎么选
买证书前先算清楚要覆盖多少个 FQDN。三类的差别不在价格,而在匹配规则。
- 单域名证书:只匹配一个完全限定域名(FQDN)。example.com 和 www.example.com 算两个域名。
- 多域名证书(SAN / UCC):一张证书里写多个 subjectAltName,可以跨主域,例如 example.com + www.example.com + api.other.com。主流 CA 单张默认含 3–5 个域名,可付费扩展到 100 个。
- 通配符证书:*.example.com 只匹配一级子域,不匹配 example.com 本身,也不匹配 a.b.example.com。因此实际下单要写成 *.example.com + example.com。
决策口诀:子域数量少且固定 → 多域名 SAN;子域数量多且动态(如租户自定义二级域)→ 通配符;既要主域又要多级 → 通配符 + SAN 混合,例如 *.example.com、example.com、*.cdn.example.com 写进同一张证书。
通配符还有一个硬限制:Let’s Encrypt 签通配符只能走 DNS-01 验证,不能用 HTTP-01 文件验证;按 CA/B Forum 规范,EV 证书不允许使用通配符,必须是明确的 FQDN。
下单前先查 CAA 记录,避免 CA 直接拒绝签发:
dig +short CAA example.com
# 返回 0 issue "letsencrypt.org" 表示只有 LE 可签;要换商业 CA 需先添加对应 CAA 记录
dig +short CAA www.example.com
三、实操一:生成私钥与 CSR(一次性写全 SAN)
CSR 里的 SAN 一旦漏写,证书签发出来也救不回来,只能重签。推荐直接用 OpenSSL 1.1.1+ 的 -addext 参数一次性写全。RSA 2048 位是兼容性底线,1024 位会被现代客户端以 EE certificate key too weak 拒绝;ECDSA P-256 握手更快、包更小,但要注意老旧 Android 与部分嵌入式设备不支持。
# 1) RSA 2048(兼容性最好,默认选择)
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out example.com.key
# 2) 或 ECDSA P-256(性能优先)
# openssl genpkey -algorithm EC -pkeyopt ec_paramgen_curve:P-256 -out example.com.key
chmod 600 example.com.key
# 3) 生成 CSR,SAN 一次写全(OpenSSL 1.1.1 及以上)
openssl req -new -key example.com.key -out example.com.csr
-subj "/C=CN/ST=Guangdong/L/Shenzhen/O=Example Tech Co.,Ltd/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com,DNS:api.example.com,DNS:*.cdn.example.com"
# 4) 自检: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"
openssl req -in example.com.csr -noout -text | grep "Signature Algorithm"
三个易错点:第一,-subj 里的 CN 必须与主域名一致,否则部分 CA 的自动审核会卡住;第二,通配符在 SAN 里写成 DNS:*.cdn.example.com,不要写成 DNS:*;第三,CSR 与私钥必须成对保存,私钥丢失只能重新签发,OV/EV 证书还要重新走组织审核。
如果服务器上已有私钥,只想补 CSR,把 -key 指向现有私钥即可,切勿重复生成导致线上证书与私钥不匹配。
四、实操二:签发证书(Let’s Encrypt 自动化 vs 商业 CA 提交)
免费与付费的分水岭不是加密强度,而是验证深度与保障。DV 只验证域名控制权,几分钟出证;OV/EV 需提交营业执照、电话回访,1–5 个工作日。对绝大多数小程序、APP 后端,DV 证书已完全够用。
# 方式 A:webroot 验证(域名已解析到本机,80 端口可访问)
certbot certonly --webroot -w /var/www/html
-d example.com -d www.example.com -d api.example.com
--email ops@example.com --agree-tos --no-eff-email
# 方式 B:通配符必须走 DNS-01,以 Cloudflare 插件为例
cat > /etc/letsencrypt/cloudflare.ini <<'EOF'
dns_cloudflare_api_token = 你的Cloudflare_API_Token
EOF
chmod 600 /etc/letsencrypt/cloudflare.ini
certbot certonly --dns-cloudflare
--dns-cloudflare-credentials /etc/letsencrypt/cloudflare.ini
--dns-cloudflare-propagation-seconds 60
-d "example.com" -d "*.example.com"
# 方式 C:acme.sh(免 root,自带各家 DNS API,支持 ECC)
acme.sh --issue --dns dns_cf -d "example.com" -d "*.example.com" --keylength ec-256
走商业 CA 时,流程是:把 example.com.csr 内容粘贴到 CA 控制台 → 选择验证方式(DNS TXT 或 HTTP 文件)→ 等待签发 → 下载 Nginx/Apache 格式压缩包。下载后务必确认包内有 fullchain(叶子 + 中间证书)与私钥两个文件,只有 .crt 单文件是最常见的翻车点。若拿到的是 .pfx/.p12,需转换:
openssl pkcs12 -in example.com.pfx -clcerts -nokeys -out example.com.crt
openssl pkcs12 -in example.com.pfx -nocerts -nodes -out example.com.key
cat example.com.crt chain.crt > example.com.fullchain.pem
五、配置示例:Nginx 与 Apache 可直接套用
配置的核心只有三条:证书链完整、只开 TLS 1.2/1.3、HTTP 强制跳转。以下 Nginx 片段在 1.25.1 及以上可直接使用,低版本把 http2 on; 改回 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 api.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-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;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
location / { proxy_pass http://127.0.0.1:8080; }
}
Apache 2.4.8 之后不再需要单独的 SSLCertificateChainFile,直接把 fullchain 交给 SSLCertificateFile 即可:
<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 ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256
SSLHonorCipherOrder off
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
生效前先做语法检查,避免 reload 失败导致旧证书继续服务:nginx -t && systemctl reload nginx,Apache 用 apachectl configtest && systemctl reload httpd。注意 HSTS 一旦下发到浏览器就无法撤销,建议先在测试域验证 includeSubDomains 不会把未上 HTTPS 的子域打死。
六、对比表格:证书类型、覆盖范围与免费/付费差异
下表可直接用于选型决策,价格区间为 2025 年市场常见值,仅供量级参考。
| 维度 | DV(域名验证) | OV(组织验证) | EV(扩展验证) |
|---|---|---|---|
| 验证内容 | 域名控制权(DNS/HTTP) | + 营业执照、组织真实性 | + 严格法律实体核验 |
| 签发时长 | 1 分钟–1 小时 | 1–3 个工作日 | 3–7 个工作日 |
| 单张最长有效期 | 398 天(LE 为 90 天) | 398 天 | 398 天 |
| 浏览器展示 | 锁标志 | 锁标志(详情可见组织名) | 锁标志,无地址栏特殊标识 |
| 是否支持通配符 | 支持 | 支持 | 不支持 |
| 年费量级 | 0–200 元 | 800–3000 元 | 3000 元以上 |
| 典型场景 | 小程序、APP 接口、内部系统 | 企业官网、对外支付页 | 金融、大型电商 |
| 对比项 | 多域名 SAN 证书 | 通配符证书 |
|---|---|---|
| 覆盖示例 | example.com、www.example.com、api.other.com | *.example.com(仅一级子域) |
| 是否覆盖主域本身 | 需显式写入 | 否,需额外附加 example.com |
| 是否覆盖 a.b.example.com | 需显式写入 | 否 |
| 域名上限 | 通常 100 个 | 1 个通配符条目 |
| 验证方式 | HTTP-01 或 DNS-01 | 仅 DNS-01 |
| 泄露风险 | 低(域名固定) | 高(私钥泄露则所有子域沦陷) |
一句话结论:接口域名固定就买 SAN,子域随业务动态生成才上通配符;通配符私钥必须单独隔离存放,禁止随代码仓库分发。
七、实操三:续费与自动化(90 天与 398 天上限的现实解法)
Let’s Encrypt 证书 90 天到期,官方建议在剩余 30 天时续签。certbot 安装后会自动创建 systemd timer 或 cron,先确认它真的在跑:
certbot renew --dry-run # 演练,不消耗速率限制
systemctl list-timers | grep -i certbot # 确认定时器存在
systemctl status certbot.timer
# 续签成功后自动 reload,避免新证书不生效
certbot renew --deploy-hook "systemctl reload nginx"
# acme.sh 方式:安装证书时就把 reload 命令绑死
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 "systemctl reload nginx"
商业 CA 的 398 天证书没有自动续签,必须自建到期监控。下面脚本可放进 crontab 每天 9 点执行,剩余 15 天时告警:
#!/bin/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 天(到期:$END)"
[ $LEFT -lt 15 ] && curl -s "https://alert.example.com/hook?msg=cert_expiring_${DOMAIN}_${LEFT}d"
两个坑:其一,certbot renew 只在剩余不足 30 天才真正续签,手动执行看到 “not due for renewal” 属正常;其二,用 Docker/Nginx 挂载证书目录时,reload 只能重载配置不能重读文件句柄,必须 docker exec nginx nginx -s reload 或重启容器。另外 Let’s Encrypt 有每周 5 次重复证书的速率限制,调试阶段务必加 --dry-run 或使用 staging 环境。
八、常见错误排查:真实报错与修复动作
下面每一条都是线上高频报错,按“报错 → 根因 → 修复”给出。
curl: (60) SSL: no alternative certificate subject name matches target host name 'api.example.com':SAN 未包含该域名,或用了 *.example.com 去访问 a.b.example.com。修复:重签并把 FQDN 显式写进 SAN。curl: (60) SSL certificate problem: unable to get local issuer certificate:缺中间证书。修复:cat example.com.crt chain.crt > fullchain.pem,Nginx 指向 fullchain。NET::ERR_CERT_AUTHORITY_INVALID,微信小程序报request:fail ssl handshake error:使用了自签证书或链不完整,小程序只信任受信 CA。修复:换公有 CA 证书并补全链。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):证书与私钥不匹配。修复:用openssl x509 -noout -modulus -in cert.pem | openssl md5与openssl rsa -noout -modulus -in key.pem | openssl md5比对,值必须一致。nginx: [emerg] PEM_read_bio_X509_AUX("/etc/nginx/ssl/a.crt") failed (SSL: error:0909006C:PEM routines:get_name:no start line):文件不是 PEM,常见于误把 .pfx/.der 或 HTML 下载页存成 .crt。修复:head -1 a.crt应输出-----BEGIN CERTIFICATE-----。x509: certificate has expired or is not yet valid:证书过期,或服务器时间漂移。修复:timedatectl检查时区,chronyc sources -v确认 NTP 同步。- certbot 报
Problem binding to port 80: Could not bind to IPv4 or IPv6.:standalone 模式下 80 端口被 Nginx 占用。修复:改用--webroot -w /var/www/html,或先停 Nginx。 - 小程序真机报 handshake 失败但浏览器正常:服务端只开 TLS 1.0/1.1 或残留 CBC 套件。修复:
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null | grep Protocol应返回 TLSv1.2,否则调整ssl_protocols。 - iOS 报
NSURLErrorSecureConnectionFailed:不满足 ATS 要求(TLS 1.2+、SHA-256 签名、ECDHE 套件)。修复:升级协议与套件,勿在 Info.plist 里用NSAllowsArbitraryLoads绕过。
九、效果验证:命令行、在线工具与客户端三关
配置改完不要只看浏览器绿锁,按下面三层验证。
第一层,命令行核对证书内容与协议:
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
curl -vI https://example.com 2>&1 | grep -E "SSL certificate verify|subject:|expire date"
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null | grep "Protocol"
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null # 应握手失败
nmap --script ssl-enum-ciphers -p 443 example.com
docker run --rm -t drwetter/testssl.sh --severity HIGH https://example.com
第二层,在线评分。把域名丢给 SSL Labs(https://www.ssllabs.com/ssltest/analyze.html?d=example.com),目标是 A 或 A+;若出现 “Chain issues: Incomplete”,回到第五节检查 fullchain。同时确认 Certificate Transparency 日志已收录,部分企业客户端会校验 SCT。
第三层,真实客户端。微信开发者工具勾选“不校验合法域名”只能证明代码逻辑,必须在真机上关闭该选项、并在小程序后台配置好 request 合法域名后测试;Android 7 以上不再默认信任用户手动安装的 CA,测试自签证书时需在 App 内配置 network_security_config;iOS 需在“关于本机 → 证书信任设置”中手动开启完全信任。最后用 curl --tlsv1.2 --tls-max 1.2 https://example.com 模拟老客户端,确认降级路径可用。
常见问题
通配符证书能覆盖 example.com 和 a.b.example.com 吗?
都不能。*.example.com 只匹配一级子域(如 www.example.com、api.example.com),主域 example.com 和多级子域 a.b.example.com 必须单独写进 SAN。正确做法是签一张同时包含 *.example.com、example.com、*.b.example.com 的证书。
一张证书能同时给微信小程序、APP 和公司网站用吗?
可以,只要所有请求域名都在该证书的 SAN 列表内,且服务端只开 TLS 1.2/1.3、下发完整证书链。注意小程序要求域名已完成 ICP 备案(服务器在中国大陆)、必须是 443 端口、不能是 IP,并需在小程序后台“服务器域名”中登记。
免费的 Let’s Encrypt 证书在微信小程序里会被拒绝吗?
不会。微信、iOS、Android 校验的是证书是否由受信根 CA 签发、域名是否匹配、链是否完整、协议是否达标,与免费或付费无关。Let’s Encrypt 由 ISRG Root X1 交叉签名,主流客户端均信任。唯一区别是有效期只有 90 天,必须配置自动续签。
证书续费后一定要重启 Nginx 吗?
必须让进程重新加载证书文件。用 nginx -s reload 或 systemctl reload nginx 即可平滑生效,无需停机;容器部署要 docker exec nginx nginx -s reload。建议在 certbot 的 --deploy-hook 或 acme.sh 的 --reloadcmd 中固化该命令,避免“续了但没生效”。
证书最长有效期到底是多少天?
目前公有 CA 签发的证书最长 398 天,Let’s Encrypt 为 90 天。按 CA/B Forum SC-081 决议,2026-03-15 起缩短至 200 天,2027-03-15 起缩短至 100 天。任何“买三年一次装好”的方案都已失效,自动化续签是唯一可持续做法。
服务器在国内但域名没备案,能装 HTTPS 吗?
技术上能装、能握手成功,但大陆机房 80/443 端口对未备案域名会被拦截,微信小程序也无法添加未备案域名到服务器域名白名单。此时应先把域名接入已备案的主体,或把服务部署到境外/港澳节点并接受访问延迟。