泛域名(通配符)SSL 证书全流程实战:CSR 生成、DNS 验证、Nginx/Apache/IIS 部署与排错
问题背景与根因:泛域名站点为什么绕不开 HTTPS
2017 年起微信小程序强制所有网络请求走 HTTPS,iOS 的 ATS 默认拦截明文 HTTP,Chrome 对 http 页面直接标注「不安全」。但真正的痛点不在于「要不要上证书」,而在于「子域名太多」。一个典型业务站点往往同时存在 www、m、api、static、admin、pay 六七个二级域名,如果逐个申请单域名证书,意味着 6 份订单、6 次域名验证、6 套私钥、6 个到期提醒;漏续一张,对应子域立刻白屏,小程序侧表现为 request:fail。
第二个根因是有效期。自 2020 年 9 月 1 日起,CA/Browser Forum 规定公开信任的 TLS 证书最长有效期不得超过 398 天;Let’s Encrypt 免费证书固定 90 天。按 SC-081 决议,2026 年 3 月 15 日起降为 200 天,2027 年 3 月 15 日起降为 100 天,2029 年 3 月 15 日起仅 47 天。续期频率翻了几倍,靠人工记台账已不现实。
第三个根因是劫持。部分运营商会在 HTTP 响应中注入广告脚本,表现为页面右下角弹窗、App 内嵌 WebView 被插广告。HTTPS 的完整性校验能直接阻断这类中间人注入,这也是「苹果防广告劫持」的真正原理。
通配符(Wildcard)证书正是针对上述场景:一张证书覆盖 *.example.com 下所有一级子域,一次验证、一个私钥、一条续期流水线。这里必须纠正两个常见过时认知:Comodo 的 CA 业务已于 2018 年更名为 Sectigo,市面上「Comodo 泛域名证书」的实际签发主体是 Sectigo;另外 Chrome 77(2019 年)已移除 EV 证书的绿色地址栏,EV 现在只在证书信息面板中显示公司名,不要再为「地址栏变绿」多付钱。
通配符证书的覆盖边界:*.example.com 到底管哪些域名
通配符匹配规则由 RFC 6125 定义:只做「最左一级」通配,且星号必须占据整个最左标签,不能写成 api*.example.com。这一点决定了采购数量,买错就是白花钱。
| 实际访问域名 | *.example.com 是否覆盖 | 说明 |
|---|---|---|
| example.com | 否 | 主域需在 SAN 中单独添加一条 |
| www.example.com | 是 | 一级子域 |
| api.example.com | 是 | 一级子域 |
| a.b.example.com | 否 | 二级子域,需 *.b.example.com |
| example.com.cn | 否 | 完全不同的注册域 |
因此下单时正确做法是同时提交 example.com 和 *.example.com 两个条目(多数 CA 允许在同一张证书里放主域 + 通配符,共 2 条 SAN),否则用户直接访问裸域会报 NET::ERR_CERT_COMMON_NAME_INVALID。
另外两条安全边界:其一,通配符私钥一旦泄露,全部子域同时沦陷,所以不要把通配符私钥交给外包团队或测试环境;建议生产用 *.example.com,测试用 *.test.example.com 单独一张。其二,Let’s Encrypt 等免费 CA 签发通配符只支持 DNS-01 验证,无法走 HTTP 文件验证,因为 ACME 服务器无法为任意子域构造验证路径。
实操第一步:生成私钥与 CSR
CSR(Certificate Signing Request)包含公钥和主体信息,私钥必须本地生成、本地保存,绝不外发。推荐 RSA 2048 位(兼容性最好)或 ECDSA P-256(性能更好,但老 Android 4.x 不支持)。
# 1. 生成 2048 位 RSA 私钥并加固权限
openssl genrsa -out example.com.key 2048
chmod 600 example.com.key
# 2. 生成 CSR,CN 必须写通配符形式
openssl req -new -key example.com.key -out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Tech Co Ltd/CN=*.example.com"
# 3. 校验 CSR 内容,确认 CN 与公钥长度
openssl req -noout -text -in example.com.csr | head -20
# 4. 记录私钥指纹,便于后续核对
openssl rsa -in example.com.key -noout -modulus | openssl md5
如果改用 ECDSA,命令替换为 openssl ecparam -genkey -name prime256v1 -out example.com.key,后续 CSR 命令不变。注意 CN 字段长度上限 64 字符,通配符必须位于最左侧;现代浏览器实际只校验 SAN 扩展,CN 已废弃,但多数 CA 仍会依据 CN 自动写入通配符 SAN,所以 CN 不能留空。
生成后把 CSR 全文(含 —–BEGIN CERTIFICATE REQUEST—– 到 END 行)提交给 CA。OV/EV 类型还需额外提交营业执照、法人信息并接受电话回访,审核周期 1 至 7 个工作日不等。
实操第二步:DNS 验证与证书签发
DV 通配符证书唯一可行的验证方式是 DNS-01。CA 会给出一个 TXT 记录,例如主机记录 _dnsauth.example.com,记录值为一长串 base64 字符串,有效期通常 30 分钟到 7 天。必须在主域而非子域下添加该记录,且要等 TTL 生效。
# 本地权威 DNS 与公共 DNS 双向确认,避免缓存导致验证失败
dig +short TXT _dnsauth.example.com
dig @8.8.8.8 +short TXT _dnsauth.example.com
dig @223.5.5.5 +short TXT _dnsauth.example.com
手工验证容易漏掉「记录已加但公共 DNS 未同步」的坑,生产环境建议用 ACME 客户端自动完成。以阿里云 DNS 为例:
# acme.sh 方式,同时申请主域与通配符
curl https://get.acme.sh | sh -s email=ops@example.com
export Ali_Key="你的AccessKeyId"
export Ali_Secret="你的AccessKeySecret"
~/.acme.sh/acme.sh --issue --dns dns_ali
-d example.com -d '*.example.com' --keylength ec-256
# certbot 方式(手工 DNS 插件,适合验证流程)
certbot certonly --manual --preferred-challenges dns
-d '*.example.com' -d example.com
签发成功后你会得到三份文件:域名证书(leaf)、中间证书(intermediate)、根证书(root)。部署时必须使用 leaf + intermediate 拼接的 fullchain 文件,根证书不需要也不应该下发,否则会增大握手包体积。商业 CA 的 OV 通配符审核通过后,证书会以压缩包形式提供,注意区分 Apache 目录(含 fullchain)与 Nginx 目录(含 bundle)。
部署配置示例:Nginx、Apache、IIS
Nginx 配置要点:80 端口做 301 跳转、443 只开 TLSv1.2/1.3、开启 OCSP Stapling 减少握手延迟。http2 指令在 Nginx 1.25.1 之后改为独立写法。
server {
listen 80;
server_name example.com *.example.com;
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;
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 119.29.29.29 valid=300s;
add_header Strict-Transport-Security 'max-age=31536000' always;
}
Apache 2.4.8 之后不再需要 SSLCertificateChainFile,把中间证书拼进 SSLCertificateFile 即可:
<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 -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>
IIS 侧流程为:MMC 导入 PFX(含私钥)→ 站点绑定 443 并勾选「需要服务器名称指示 SNI」→ 用 certutil -store My 确认证书已进入个人存储。云服务器还需确认安全组放行 443 入方向,这是「配置全对但外网打不开」的第一大原因。
证书类型与品牌对比:怎么选才不花冤枉钱
先看验证等级,再看覆盖范围,最后看签发主体。EV 绿色地址栏已取消,纯粹为「显示公司名」买 EV 已无必要,除非行业合规硬性要求。
- 服务器维护 · 网站代维护 · 服务器托管代维
- APP/小程序 HTTPS · SSL网站加密证书 · CA证书配置
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
| 等级 | 验证内容 | 签发时长 | 浏览器表现 | 典型场景 |
|---|---|---|---|---|
| DV 域名型 | 仅验证域名控制权 | 5-30 分钟 | 锁图标,无组织信息 | 个人站、小程序后端、API 网关 |
| OV 组织型 | 营业执照 + 电话回访 + 域名 | 1-5 个工作日 | 证书详情显示企业名 | 企业官网、SaaS 平台 |
| EV 扩展型 | OV 全部 + 第三方数据库核验 | 3-7 个工作日 | 详情页显示企业名(绿色地址栏已取消) | 金融、支付合规场景 |
| 覆盖类型 | 示例 | 覆盖范围 | 参考价格(元/年) |
|---|---|---|---|
| 单域名 | www.example.com | 1 个 FQDN | 0-300 |
| 多域名 SAN | a.com、b.com、c.com | 指定列表,通常 5-100 条 | 500-2000 |
| 通配符 | *.example.com | 无限个一级子域 | 800-5000 |
| 方案 | 有效期 | 支持通配符 | 验证方式 | 续期 |
|---|---|---|---|---|
| Let’s Encrypt | 90 天 | 是 | 仅 DNS-01 | 全自动,60 天触发 |
| Sectigo(原 Comodo)DV 通配符 | 最长 398 天 | 是 | DNS-01 | 手动或 API |
| DigiCert OV 通配符 | 最长 398 天 | 是 | 组织验证 + DNS-01 | 手动 |
结论很直接:个人项目与中小业务用 Let’s Encrypt 通配符加自动续期即可;需要 398 天少折腾、或需要 OV 企业身份背书的,选 Sectigo/DigiCert 商业通配符。别买单域名证书去拼凑多子域,管理成本远高于差价。
常见错误排查:真实报错与定位方法
1. nginx: [emerg] cannot load certificate … PEM_read_bio_X509_AUX() failed (SSL: error:0480006C:PEM routines::no start line):证书文件格式不对。常见于把 DER/PKCS7 直接改名成 .pem,或 Windows 编辑后带入 BOM/CRLF。用 openssl x509 -in cert.pem -noout -subject 验证,失败则 dos2unix cert.pem 或 openssl x509 -inform DER -in cert.cer -out cert.pem 转换。
2. SSL_CTX_use_PrivateKey_file() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch):证书与私钥不配对,多为换证书时忘了换 key。核对命令:openssl x509 -noout -modulus -in cert.pem | openssl md5 与 openssl rsa -noout -modulus -in key.pem | openssl md5,两个 MD5 必须一致。
3. curl: (60) SSL certificate problem: unable to get local issuer certificate:只部署了域名证书,缺中间证书。浏览器有 AIA 自动补链所以看着正常,Java、Python、curl 客户端会直接失败。把 intermediate 拼到 leaf 之后重新部署。
4. NET::ERR_CERT_COMMON_NAME_INVALID(访问 a.b.example.com 时):通配符只覆盖一级子域,二级子域不在 SAN 中。要么另签 *.b.example.com,要么把这些域名加进多域名 SAN。
5. curl: (35) error:14094410:SSL routines:ssl3_read_bytes:sslv3 alert handshake failure:协议或加密套件不匹配。多见于关闭 TLSv1.0/1.1 后,老客户端或老旧 SDK 无法握手;也可能是双证书(RSA+ECC)只配了一半。
6. x509: certificate has expired or is not yet valid: current time … is after …:证书过期或服务器时间错误。先 date -u 校准 NTP,再 openssl x509 -noout -dates -in cert.pem 确认 notAfter。398 天有效期下,务必把到期前 30 天设为告警阈值。
效果验证与续期自动化
部署完成后不要只看浏览器锁图标,必须用命令行验证证书链、SAN 与有效期,这是唯一能确认中间证书正确的方式。
# 查看服务端实际下发的证书链信息
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 验证 OCSP Stapling 是否生效
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>&1
| grep -i 'OCSP Response Status'
# 验证 301 跳转与证书校验结果(0 表示校验通过)
curl -sSI http://example.com | head -1
curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result}n' https://www.example.com
# 剩余天数监控,纳入 Zabbix/Prometheus
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2
自动续期方面,acme.sh 安装证书时务必带 –reloadcmd,否则新证书落盘但 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
--reloadcmd 'nginx -t && nginx -s reload'
crontab -l | grep acme # 确认存在 0 0 * * * 的续期任务
最后用 SSL Labs 或 openssl s_client -tls1_1 做一次回归:前者给出 A+ 评级与协议分布,后者应明确返回 handshake failure,证明旧协议已关闭。三项全绿(证书链完整、有效期充足、旧协议禁用)才算交付完成。
常见问题
通配符证书能覆盖 example.com 主域本身吗?
不能。*.example.com 只匹配一级子域,裸域 example.com 必须单独加入 SAN。正确下单方式是一张证书同时包含 example.com 与 *.example.com 两条 SAN,多数 CA 支持这种组合且不加价。若只买通配符,用户直接访问 https://example.com 会报证书名称不匹配。
Let’s Encrypt 免费通配符能用于生产环境吗?
可以,兼容性与商业 DV 证书没有区别,主流浏览器和微信小程序均信任。代价是有效期只有 90 天,必须做自动化续期(acme.sh 或 certbot 加 cron),并配置到期告警。若团队没有自动化能力,或业务要求证书有效期接近 398 天上限以减少运维频次,再考虑 Sectigo、DigiCert 等商业通配符。
一张通配符证书可以部署到多台服务器吗?
可以,同一张证书和私钥可部署到任意数量的服务器、SLB、CDN 节点。但私钥副本越多泄露风险越大,建议通过配置管理系统分发、私钥文件权限设为 600、禁止提交进 Git 仓库。若涉及外包或测试环境,应单独申请 *.test.example.com 的通配符,隔离爆炸半径。
通配符证书支持三级或更深层级的子域吗?
不支持。*.example.com 只覆盖 a.example.com 这一层,a.b.example.com 需要 *.b.example.com 这张独立证书。RFC 6125 规定星号只能占据最左一个完整标签,写成 a.*.example.com 或 api*.example.com 均属无效证书请求,CA 会直接拒绝签发。
证书有效期 398 天到期后怎么续?
商业证书续费时 CA 会重新走一遍域名验证(DNS TXT 或 CNAME),签发新证书后替换服务器上的 fullchain 与 key 并 reload。注意 2026 年 3 月起上限降至 200 天、2027 年降至 100 天、2029 年降至 47 天,续期将变成高频操作,建议从现在就切换到 ACME 自动化流程,而不是依赖人工台账。
OV 或 EV 通配符证书值得买吗?
看场景。DV 通配符只证明域名控制权,适合绝大多数业务;OV 通配符在证书详情中显示企业名称,适合需要向客户展示主体资质的企业官网与 SaaS 平台;EV 通配符价格最高、审核最久,且 Chrome 77 起已取消绿色地址栏,除非金融、支付类合规明确要求,否则性价比很低。选购时优先确认「是否含中间证书」「是否支持重签发」「到期提醒方式」这三项服务条款。