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 日过期,老设备需改用带交叉链的商业证书或推动客户端升级。