跳到主要内容
HTTPS小程序证书

SSL 证书通配符申请、安装与 HTTPS 部署全流程:DV/EV 选型、398 天有效期与自动化续期

SSL 证书通配符申请、安装与 HTTPS 部署全流程:DV/EV 选型、398 天有效期与自动化续期 — SSL 证书通配符申请、安装与 HTTPS 部署全流程:DV/EV 选型、398 天有效期与自动化续期

一、问题背景与根因:为什么证书买了、装上了,HTTPS 还是不通

大量站点把 HTTPS 当成一次性采购:付款拿到 .crt 与 .key,交给运维贴到 Nginx 上,结果浏览器依旧报错、App 依旧握手失败、微信小程序依旧提示证书无效。问题往往不在证书没买,而在下面五个环节。

1. 有效期政策已经变了。自 2020 年 9 月 1 日起,所有公开信任 CA 签发的 TLS 证书最长有效期被压缩到 398 天;Let’s Encrypt 的免费证书固定 90 天,并已开始提供 6 天有效期的短期证书选项。CA/Browser Forum 通过的分阶段方案是:2026 年 3 月起 200 天、2027 年 3 月起 100 天、2029 年 3 月起 47 天。任何「一次部署管三年」的方案在今天都不成立,必须默认自动化续期。

2. 通配符的覆盖范围被误解。*.example.com 只匹配一级子域(如 api.example.com),不匹配 example.com 本身,也不匹配 a.b.example.com。要同时覆盖主域,证书必须签成 example.com + *.example.com 的双 SAN。

3. 证书链不完整。只部署叶子证书、不部署中间证书,桌面浏览器可能靠缓存或 AIA 抓取兜底,但 curl、Java 客户端、老版本 Android、微信小程序会直接失败,报 unable to verify the first certificate。

4. DV 与 EV 被混为一谈。EV 证书自 Chrome 77(2019 年)起不再显示绿色地址栏,Firefox 70 也移除了该 UI。今天 EV 与 DV 在地址栏上没有视觉差别,EV 的价值在于证书 Subject 中带有可审计的组织信息(O、C),用于合规与招投标,而不是「看起来更安全」。

5. 验证方式与 DNS 权限脱节。通配符证书只能走 DNS-01 验证,必须有 _acme-challenge 的 TXT 写入权限;用 HTTP-01 申请通配符一定失败。很多「申请不下来」的工单,根因就是安全组没放行 80 端口,或者域名托管在无法调用 API 的 DNS 服务商上。

二、申请前的准备:私钥、CSR 与域名规划

先把「要覆盖哪些域名」写清楚,再动手。列出主域与所有一级子域,明确哪些二级子域(a.b.example.com)必须单独加 SAN。

生成私钥(RSA 2048 位,兼容性最好):

mkdir -p /etc/nginx/ssl && cd /etc/nginx/ssl
openssl genrsa -out example.com.key 2048
chmod 600 example.com.key

如果客户端普遍支持 TLS 1.2 及以上,推荐 ECDSA P-256,握手更快、证书体积更小:

openssl ecparam -genkey -name prime256v1 -out example.com.key

生成带 SAN 的 CSR(OpenSSL 1.1.1+ 支持 -addext):

openssl req -new -sha256 -key example.com.key -out example.com.csr 
  -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Technology Co.,Ltd/CN=*.example.com' 
  -addext 'subjectAltName=DNS:*.example.com,DNS:example.com'

校验 SAN 是否写对,避免签出来才发现少域名:

openssl req -in example.com.csr -noout -text | grep -A2 'Subject Alternative Name'

检查 CAA 记录。如果域名下已有 CAA 且只允许某家 CA,其他 CA 会被拒绝签发,报错为 CAA record for example.com prevents issuance:

dig +short CAA example.com @8.8.8.8
# 需要放行 Let's Encrypt 时添加:
# example.com. 300 IN CAA 0 issue "letsencrypt.org"

预检 DNS 验证通道。确认 _acme-challenge.example.com 可以写 TXT;若使用 CNAME 委托(_acme-challenge.example.com CNAME example.com.acme.example.net.),要确认委托目标存在且可写。私钥全程只留在自己服务器上,商业 CA 只接收 CSR,任何要求你上传私钥的「代申请」都应拒绝。

三、通配符证书申请实操:acme.sh 自动签发与商业证书两条路径

路径 A:Let’s Encrypt 免费证书(90 天,自动续期)。安装 acme.sh 并配置 DNS API 凭据,以阿里云 DNS 为例:

curl https://get.acme.sh | sh -s email=ops@example.com
source ~/.bashrc
export Ali_Key='LTAI5txxxxxxx'
export Ali_Secret='xxxxxxxxxxxxxxxx'
~/.acme.sh/acme.sh --issue --dns dns_ali -d example.com -d '*.example.com' --keylength ec-256

Cloudflare 托管则换成 dns_cf 与 CF_Token:

export CF_Token='xxxxxxxxxxxxxxxxxxxx'
~/.acme.sh/acme.sh --issue --dns dns_cf -d example.com -d '*.example.com' --keylength ec-256

签好后安装到固定路径,并绑定 reload 命令,之后每次自动续期都会同步文件并重载 Nginx:

~/.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 
  --ca-file        /etc/nginx/ssl/example.com.chain.pem 
  --reloadcmd      'systemctl reload nginx'

acme.sh 安装时会写入 cron(crontab -l | grep acme 可确认),每天检查一次到期时间,剩余 30 天内自动续期。手动强制续期用于验证流程:~/.acme.sh/acme.sh --renew -d example.com --ecc --force。

没有 DNS API 时可用手动模式,但它无法自动续期,只适合临时验证:

~/.acme.sh/acme.sh --issue --dns -d example.com -d '*.example.com' 
  --yes-I-know-dns-manual-mode-enough-go-ahead-please
# 按提示添加 TXT 记录后执行
~/.acme.sh/acme.sh --renew -d example.com -d '*.example.com' 
  --yes-I-know-dns-manual-mode-enough-go-ahead-please

路径 B:商业 DV/OV/EV 通配符证书。流程是:提交上一步生成的 CSR → 选择 DNS 验证 → 按 CA 要求在指定主机记录下添加 TXT 或 CNAME → 等待签发。DV 通常 10 分钟内完成;OV 需要 1–3 个工作日核验营业执照与电话回拨;EV 还需律师函或第三方尽调,3–7 个工作日。签发后下载 Nginx 格式包,其中的 fullchain 文件即叶子证书加中间证书,直接用于 ssl_certificate。商业证书同样受 398 天上限约束,到期必须重签,不存在「买三年免维护」。

四、部署配置示例:Nginx 与 Apache 的 HTTPS 落地

Nginx 完整站点配置(证书路径与第三节一致)。注意 http2 on 需要 Nginx 1.25.1+,旧版本改为 listen 443 ssl http2;:

server {
    listen 80;
    server_name example.com *.example.com;
    location /.well-known/acme-challenge/ { root /var/www/acme; }
    location / { return 301 https://$host$request_uri; }
}

server {
    listen 443 ssl;
    http2 on;
    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:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
    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.chain.pem;
    resolver 223.5.5.5 1.1.1.1 valid=300s;

    add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
    add_header X-Content-Type-Options nosniff always;

    root /var/www/example;
    index index.html;
}

几个容易踩坑的参数:ssl_certificate 必须是 fullchain(叶子+中间),否则链不完整;ssl_trusted_certificate 只放中间证书(chain 文件),用于 OCSP Stapling 校验,不能放 fullchain;开启 stapling 必须配置 resolver,否则 Nginx 无法解析 OCSP 响应地址;HSTS 的 includeSubDomains 会强制所有子域走 HTTPS,在通配符只覆盖一级子域的场景下,若存在无法上 HTTPS 的二级子域(a.b.example.com),不要加这个指令。

Apache 2.4.8+ 写法(不再需要 SSLCertificateChainFile,链已包含在 fullchain 中):

<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
    SSLOpenSSLConfCmd Curves X25519:secp256r1:secp384r1
    Header always set Strict-Transport-Security 'max-age=31536000'
    DocumentRoot /var/www/example
</VirtualHost>

配置写好后先执行 nginx -t 或 apachectl configtest 校验语法,再 reload。用重载而不是重启,可以避免中断现有连接。

五、DV、OV、EV 与通配符、多域名证书选型对比

先看验证等级。EV 的「绿色地址栏」已经不存在,选型应以验证成本和合规要求为准,而不是视觉效果。

维度 DV OV EV
验证内容 仅域名控制权 域名 + 组织真实存在 域名 + 组织 + 法律实体扩展核验
签发时长 分钟级 1–3 个工作日 3–7 个工作日
证书 Subject 中的 O 通常为空 有 有,且核验更严
浏览器 UI 锁标 锁标 锁标(Chrome 77+/Firefox 70+ 无绿色公司名)
参考年费 0–300 元 1000–4000 元 3000 元以上
典型场景 个人站、API、测试环境 企业官网、电商 金融、政企招投标、强合规

再看覆盖范围。价格差异主要由 SAN 数量决定:

类型 典型 SAN 覆盖范围 新增子域是否重签
单域名 example.com 1 个精确域名 是
通配符 *.example.com + example.com 一级子域不限数量 + 主域 否
多域名 SAN a.com, b.com, c.com 证书中列出的 N 个域名 是

选型结论:子域多且增长快(SaaS 租户、多语言站点、灰度环境)选通配符;跨主体、跨根域(example.com 与 example.net)选多域名 SAN;两者都需要时签「通配符 + 多域名 SAN」的组合证书。表中的年费仅为市场参考区间,以 CA 或代理商当期报价为准。原文中 300 元/年含安装的特价属于 DV 单域名或促销型 DV 通配符的服务报价,采购时要问清是否含中间证书、是否含自动续期与 reload 脚本,否则「含安装」只等于一次人工部署,398 天后仍需再付一次。

六、常见错误排查:真实报错与修复命令

1. curl: (60) SSL certificate problem: unable to verify the first certificate
链不完整,服务端只下发了叶子证书。检查下发数量:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'

结果小于 2 就说明缺中间证书,把 ssl_certificate 换成 fullchain 即可。

2. 浏览器 NET::ERR_CERT_COMMON_NAME_INVALID 或 Firefox SSL_ERROR_BAD_CERT_DOMAIN
当前访问的域名不在 SAN 里。通配符只覆盖一级子域,访问 a.b.example.com 必然失败。用命令确认证书实际包含哪些域名:

echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -ext subjectAltName

3. nginx: [emerg] SSL_CTX_use_PrivateKey_file(…) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
私钥与证书不配对,通常是覆盖文件时只换了其中一个。比对模数:

openssl x509 -noout -modulus -in example.com.fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5

两行 md5 必须一致,不一致就用同一对 key/CSR 重新签发。ECDSA 证书没有 modulus,改用 openssl pkey -pubout 对比公钥指纹。

4. acme.sh 报 Verify error:Invalid response from http://example.com/.well-known/acme-challenge/xxx: 404
HTTP-01 校验被拦。依次排查:安全组是否放行 80、CDN 是否回源到本机、80 的 location 是否被 301 到 HTTPS。通配符不要走 HTTP-01,改 DNS-01。

5. CAA record for example.com prevents issuance
域名下存在 CAA 白名单且不含当前 CA。先 dig +short CAA example.com 查询,再补一条 0 issue 记录指向目标 CA 的域名。

6. curl: (35) error:0A000410:SSL routines::sslv3 alert handshake failure
客户端与服务端没有共同协议或套件。多为客户端只支持 TLS 1.0/1.1,而服务端已禁用;也可能是客户端不发 SNI,Nginx 返回了默认站点证书。用 openssl s_client -tls1_2 逐版本复测定位。

7. 控制台 Mixed Content: The page at ‘https://example.com/’ was loaded over HTTPS, but requested an insecure resource
页面内仍有 http:// 资源。全站替换为 // 或 https://,并加 CSP 的 upgrade-insecure-requests 兜底。

七、效果验证与续期监控

部署完成后按四层验证:证书内容、证书链、协议与套件、业务侧真实请求。

第一层:证书内容与有效期。

echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates -ext subjectAltName

确认 SAN 同时包含 *.example.com 与 example.com,notAfter 与 notBefore 的间隔不超过 398 天。

第二层:链与 OCSP Stapling。

openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null 
  | grep -E 'OCSP Response Status|Verify return code'

期望看到 OCSP Response Status: successful 与 Verify return code: 0 (ok)。若 stapling 未生效,先确认 resolver 与 ssl_trusted_certificate 配置。

第三层:协议版本。分别用 -tls1_2 与 -tls1_3 连接,确认 TLS 1.0/1.1 已被拒绝;再跑一次 SSL Labs 评级,目标 A 及以上。

第四层:业务侧。curl -vI https://api.example.com 查看 HTTP/2 与证书信息;微信小程序需在后台配置 request 合法域名;Android 7.1.1 以下设备不信任 ISRG Root X1,需评估是否保留商业 CA 交叉链。

续期监控脚本(GNU date,可接入 Prometheus textfile 或 Zabbix 自定义监控):

#!/usr/bin/env bash
set -euo pipefail
DOMAIN="${1:?usage: check_cert.sh example.com}"
END=$(echo | openssl s_client -connect "${DOMAIN}:443" -servername "${DOMAIN}" 2>/dev/null 
      | openssl x509 -noout -enddate | cut -d= -f2)
LEFT=$(( ( $(date -d "${END}" +%s) - $(date +%s) ) / 86400 ))
echo "${DOMAIN} 证书剩余 ${LEFT} 天"
if [ "${LEFT}" -lt 21 ]; then echo 'WARN: 证书即将过期'; exit 2; fi
exit 0

阈值设在 21 天,是因为 Let’s Encrypt 剩余 30 天自动续期,留出 9 天排障窗口。同时监控续期任务本身是否仍在执行:crontab -l | grep acme,或 systemctl list-timers | grep -i acme(用 systemd timer 部署时)。续期失败最常见的两个原因是 DNS API Token 过期,以及证书路径被手工改动导致 reloadcmd 失败。

常见问题

一张通配符证书能覆盖多少个子域,有数量上限吗?

没有硬性数量上限,*.example.com 覆盖任意数量的一级子域;但不覆盖主域 example.com 本身,也不覆盖 a.b.example.com 这类二级子域。若两者都需要,签发时把 example.com 一并写入 SAN,或为二级子域单独签 *.b.example.com。部分 CA 对单张证书的 SAN 条目数有上限(常见 100 条),采购前需确认。

免费的 Let’s Encrypt 通配符和付费 DV 通配符,差别在哪?

验证等级同为 DV,加密强度一致。差别在有效期(90 天 vs 最长 398 天)、是否有商业 SLA 与人工支持、能否升级为 OV/EV,以及 OCSP/CRL 的可用性承诺。Let’s Encrypt 没有人工客服,签发异常只能靠社区排查;商业 CA 通常提供签发失败协助和赔付条款。技术上两者都能满足小程序、APP 与公众号的 HTTPS 要求。

证书最长 398 天,为什么 Let’s Encrypt 只有 90 天?

398 天是 CA/Browser Forum 对公开信任证书的上限,不是统一值,CA 可以签得更短。Let’s Encrypt 采用 90 天是为了推动自动化续期,缩短私钥泄露后的影响窗口。CA/B 已通过进一步缩短方案:2026 年 3 月起 200 天、2027 年 3 月起 100 天、2029 年 3 月起 47 天,无论用哪家 CA,自动化都是必选项。

EV 证书现在还值得买吗?

如果目标是浏览器绿色地址栏,不值得——Chrome 77 与 Firefox 70 之后已取消该 UI。如果目标是招投标资质、金融合规、需要证书 Subject 中带有经核验的组织信息,或者客户会主动查看证书详情页,EV 仍有价值。多数企业站用 OV 或 DV 通配符配合 HSTS 即可满足需求。

更换证书需要重启 Nginx 吗?

不需要。systemctl reload nginx 会平滑加载新证书,已有连接不受影响。只有更换私钥算法(如 RSA 换 ECDSA)且同时调整了 ssl_ciphers 时,才建议在低峰期操作。acme.sh 的 –reloadcmd 应写 reload,不要写 restart。

部署后浏览器正常,但部分安卓 App 仍提示证书不受信任,为什么?

三类原因:一是服务端未下发中间证书,桌面浏览器有缓存兜底而移动端没有;二是 App 内置了证书 Pinning,换证后需要发版更新指纹;三是 Android 7.1.1 以下系统不信任 ISRG Root X1,而旧的 DST Root CA X3 已于 2021 年 9 月 30 日过期,老设备需改用带交叉链的商业证书或推动客户端升级。

内容审核

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