跳到主要内容
HTTPS安装配置

SSL 证书申请、安装、配置与续费全流程:通配符与多域名(SAN)证书实战

SSL 证书申请、安装、配置与续费全流程:通配符与多域名(SAN)证书实战 — SSL 证书申请、安装、配置与续费全流程:通配符与多域名(SAN)证书实战

一、问题背景:一张证书为什么会在小程序、APP 和浏览器上同时“翻车”

原文只列了一句“SSL 认证支持微信公众号、小程序、APP、公司网站、安卓、苹果”,这描述的是结果,不是做法。真实项目里,同一张证书要同时被 Chrome/Safari、微信小程序与公众号网页、iOS/Android APP 的 HTTPS 请求、以及各类第三方 SDK 校验,失败往往集中在四类根因:

  1. 域名覆盖不全:证书只签了 example.com,但小程序 wx.request 打的是 api.example.com;或者买的是 *.example.com,却去访问 a.b.example.com(通配符只匹配一级子域)。
  2. 证书链不完整:服务器只下发叶子证书,没带中间证书(Intermediate CA)。桌面浏览器能靠 AIA 自动补齐,Android WebView、微信小程序、Java/Go 客户端会直接判定证书无效。
  3. 协议与套件过旧:只开 TLS 1.0/1.1,或保留 3DES、CBC 套件。微信小程序要求 TLS 1.2 及以上,iOS ATS 还要求 SHA-256 签名与前向保密(ECDHE)套件。
  4. 有效期失控:公有 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 环境。

八、常见错误排查:真实报错与修复动作

下面每一条都是线上高频报错,按“报错 → 根因 → 修复”给出。

  1. curl: (60) SSL: no alternative certificate subject name matches target host name 'api.example.com':SAN 未包含该域名,或用了 *.example.com 去访问 a.b.example.com。修复:重签并把 FQDN 显式写进 SAN。
  2. curl: (60) SSL certificate problem: unable to get local issuer certificate:缺中间证书。修复:cat example.com.crt chain.crt > fullchain.pem,Nginx 指向 fullchain。
  3. NET::ERR_CERT_AUTHORITY_INVALID,微信小程序报 request:fail ssl handshake error:使用了自签证书或链不完整,小程序只信任受信 CA。修复:换公有 CA 证书并补全链。
  4. 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 比对,值必须一致。
  5. 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-----。
  6. x509: certificate has expired or is not yet valid:证书过期,或服务器时间漂移。修复:timedatectl 检查时区,chronyc sources -v 确认 NTP 同步。
  7. certbot 报 Problem binding to port 80: Could not bind to IPv4 or IPv6.:standalone 模式下 80 端口被 Nginx 占用。修复:改用 --webroot -w /var/www/html,或先停 Nginx。
  8. 小程序真机报 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。
  9. 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 端口对未备案域名会被拦截,微信小程序也无法添加未备案域名到服务器域名白名单。此时应先把域名接入已备案的主体,或把服务部署到境外/港澳节点并接受访问延迟。

内容审核

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