HTTPS 泛域名证书注册与配置实战:从 CSR、DNS-01 签发到 Nginx/Apache 部署
一、为什么泛域名证书“买得到却配不对”:三类根因
泛域名证书(Wildcard Certificate,又称通配符证书)用一条 *.example.com 覆盖同一主域下的全部一级子域,看起来是最省事的选择。但在实际运维工单里,绝大多数故障与“证书有没有买”无关,而是集中在下面三类根因上。
- 覆盖范围理解错误。按 RFC 6125 与 CA/Browser Forum 基线要求,
*.example.com只匹配一个标签层级:api.example.com、www.example.com命中;a.b.example.com不命中;裸域example.com同样不命中。要覆盖裸域,必须在 SAN 里显式追加DNS:example.com。 - 验证方式选错。通配符证书不允许使用 HTTP-01 或 TLS-ALPN-01 校验,只能走 DNS-01。用面板默认的 HTTP 校验去签通配符,acme.sh 会直接报
Error, can not get domain token。 - 证书链不完整。只部署 leaf(服务器)证书、不拼接中间 CA,桌面浏览器可能靠 AIA 自动补齐,但 Android、Java、Go、Python requests 等客户端会报
unable to get local issuer certificate。
再叠加有效期规则:自 2020-09-01 起,所有公开信任 CA 签发的 TLS 服务器证书最长有效期被限制为 398 天;Let’s Encrypt 等 ACME CA 为 90 天。按 CA/Browser Forum SC-081 决议,2026 年 3 月起上限进一步降到 200 天,2027 年降到 100 天,2029 年降到 47 天。也就是说,“买一年就不用管”在技术上早已不成立,续期必须自动化。
二、先钉死边界:覆盖规则、有效期与选型
动手之前把三件事定下来,可以避免后面大量返工。
1)域名清单。把所有需要 HTTPS 的主机名按层级列出来,标注哪些是一级子域、哪些是多级子域、哪些是裸域。多级子域(如 a.b.example.com)只能单独签发,或改用多域名(SAN)证书。
2)证书类型。DV(Domain Validation)只校验域名控制权,通常 10 分钟内签发,适合 API 网关、SaaS 多租户、灰度环境;OV(Organization Validation)需校验组织主体,证书详情含 O= 字段,适合对外官网、支付与登录域名。通配符只是覆盖范围的属性,DV 和 OV 都可以是通配符。
3)有效期与续期窗口。公开 CA 单张证书上限 398 天;ACME 证书 90 天,acme.sh 默认在证书签发满 60 天(剩余约 30 天)时自动续期。内网私有 CA 可以自行签发更长有效期,但不要混用到公网。
另外准备两个环境细节:一是 DNS 服务商 API 的权限(DNS-01 自动验证完全依赖它);二是 443 端口与 server_name/ServerAlias 的匹配关系——泛域名证书只保证握手通过,请求最终落到哪个站点仍由 SNI 与 server_name 决定。
三、实操:生成 CSR 并用 DNS-01 签发通配符证书
第一步,生成私钥与 CSR,并显式写入 SAN。注意 -addext 需要 OpenSSL 1.1.1 及以上版本,低版本请改用配置文件方式。
mkdir -p /etc/nginx/ssl && cd /etc/nginx/ssl
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key
-out example.com.csr
-subj "/C=CN/O=Example Technology Ltd/CN=*.example.com"
-addext "subjectAltName=DNS:*.example.com,DNS:example.com"
# 确认 CSR 中的 SAN 同时包含通配符与裸域
openssl req -in example.com.csr -noout -text | grep -A2 "Subject Alternative Name"
第二步,用 acme.sh 走 DNS-01 签发。以阿里云 DNS 为例,API 密钥建议使用仅授权 DNS 解析权限的子账号:
curl https://get.acme.sh | sh -s email=ops@example.com
export Ali_Key="LTAI5t******"
export Ali_Secret="******"
~/.acme.sh/acme.sh --issue --dns dns_ali
-d example.com -d '*.example.com'
--keylength ec-256 --server letsencrypt
~/.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 && systemctl reload nginx"
要点:--dns dns_ali 会自动写入 _acme-challenge.example.com 的 TXT 记录,等待传播后回调校验,无需手工操作;--fullchain-file 输出的是“服务器证书 + 中间 CA”,部署时必须用它,而不是 --cert-file。若用 certbot,等价命令是 certbot certonly --manual --preferred-challenges dns -d example.com -d '*.example.com',但手动模式无法自动续期,只适合一次性应急。签发完成后可用 openssl x509 -in example.com.fullchain.pem -noout -issuer -dates 核对签发者与有效期。
四、配置示例:Nginx 与 Apache 的正确写法
Nginx 侧最关键的是 ssl_certificate 与 ssl_certificate_key 两行,前者必须指向 fullchain,且 server_name 要同时写上裸域和通配符:
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.fullchain.pem;
add_header Strict-Transport-Security "max-age=31536000" always;
}
Apache 2.4 的等价配置:
<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
SSLSessionTickets off
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
两个细节常被忽略:一是 HSTS 不要轻易加 includeSubDomains,泛域名场景下若还有子域走 HTTP,会被浏览器强制跳转;二是必须确认证书与私钥匹配,否则 reload 直接失败:
openssl x509 -noout -modulus -in example.com.fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
两行输出必须完全一致;ECC 证书请把 openssl rsa 换成 openssl ec。
五、对比表格:类型、验证方式与成本
下表按公开 CA 的实际情况整理,价格为市场参考区间(人民币/年,含常见安装配置服务),仅供选型参考:
| 证书类型 | 覆盖范围 | 校验方式 | 签发耗时 | 最长有效期 | 参考价格 | 典型场景 |
|---|---|---|---|---|---|---|
| DV 单域名 | 1 个精确主机名 | HTTP-01 / DNS-01 | 1-10 分钟 | 398 天 | 0-200 元 | 测试环境、单一接口 |
| DV 泛域名 | *.example.com,一级子域不限量 | 仅 DNS-01 | 10-30 分钟 | 398 天 | 600-1500 元 | SaaS 多租户、动态子域 |
| OV 单域名 | 1 个精确主机名 | HTTP-01/DNS-01 + 组织核验 | 1-3 工作日 | 398 天 | 800-2000 元 | 官网、登录页 |
| OV 泛域名 | *.example.com | 仅 DNS-01 + 组织核验 | 1-5 工作日 | 398 天 | 3000-8000 元 | 金融、政企对外服务 |
| 多域名 SAN | 多个不同主域,可含裸域 | 按域名逐一校验 | 视类型而定 | 398 天 | 按域名数加价 | 跨主域、多级子域 |
| 私有 CA 自签 | 任意 | 无,自行分发根证书 | 分钟级 | 自定 | 0 元 | 内网、mTLS |
三种 ACME 验证方式的差异同样关键:
- HTTPS证书申请 · SSL证书安装部署 · 证书续费
- SSL证书申请 · SSL证书购买 · SSL证书安装配置
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
| 验证方式 | 依赖端口/记录 | 支持通配符 | 是否需要停机 | 自动化难度 |
|---|---|---|---|---|
| HTTP-01 | 80 端口 + /.well-known/acme-challenge/ |
否 | 否 | 低 |
| DNS-01 | _acme-challenge 的 TXT 记录 |
是 | 否 | 中,需 DNS API |
| TLS-ALPN-01 | 443 端口 + ALPN 协议 | 否 | 需独占 443 | 高 |
结论很直接:只要涉及泛域名,DNS-01 是唯一可行路径,因此 DNS 服务商的 API 能力(是否支持子账号最小权限、TTL 能否设为 60 秒、是否有调用频率限制)直接决定续期成功率。阿里云、腾讯云、DNSPod、Cloudflare、Route53 在 acme.sh 中都有内置的 dns_* 插件,优先选择。
六、常见错误排查:真实报错与定位命令
下面这些报错在泛域名证书场景中出现频率最高,逐条给出原因与处理方式。
curl: (60) SSL certificate problem: unable to get local issuer certificate:服务端未下发中间 CA。检查是否误用了--cert-file输出的单证书文件,改为 fullchain;验证命令openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null,输出中应至少能看到两级证书。- 浏览器
NET::ERR_CERT_COMMON_NAME_INVALID、FirefoxSSL_ERROR_BAD_CERT_DOMAIN:访问的主机名不在 SAN 中,典型是裸域example.com或多级子域a.b.example.com。用openssl x509 -in cert.pem -noout -ext subjectAltName核对。 nginx: [emerg] cannot load certificate "/etc/nginx/ssl/example.com.pem": PEM_read_bio_X509_AUX() failed:文件格式不对(DER 而非 PEM)、文件里混入了私钥、或证书链顺序颠倒。用openssl x509 -in example.com.pem -noout -subject能正常解析即为 PEM。- acme.sh 报
_acme-challenge.example.com: Incorrect TXT record "xxxx" found或Error, can not get domain token:DNS 尚未传播,或域名下存在多条同名 TXT 记录。清掉历史记录、等旧 TTL 过期后重试,必要时加--dnssleep 120。 x509: certificate has expired or is not yet valid:服务器时间偏差,或证书刚签发尚未生效。用date -u与openssl x509 -noout -dates对比。nginx: [warn] "ssl_stapling" ignored, issuer certificate not found:OCSP Stapling 需要完整链与ssl_trusted_certificate,缺中间 CA 时必然告警,先补齐证书链再观察。
定位顺序建议固定为:先 openssl s_client 看链路,再看 SAN 与有效期,最后翻 Nginx/Apache 的 error.log。九成问题在前两步就能定位。
七、自动续期与过期监控
ACME 证书 90 天有效期意味着一年至少要续 4 次,纯手工操作必然出事故。acme.sh 安装时会写入 crontab,默认每天检查一次、签发满 60 天后自动续期,可用 crontab -l | grep acme 确认。
关键点是续期后的 reload 动作要带语法检查,避免证书更新成功但服务起不来:
~/.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 && systemctl reload nginx"
再加一层过期监控,不要只依赖续期脚本:
#!/usr/bin/env bash
DOMAIN="example.com"; PORT=443; WARN_DAYS=20
END=$(echo | openssl s_client -servername "$DOMAIN" -connect "$DOMAIN:$PORT" 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
LEFT=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
if [ "$LEFT" -lt "$WARN_DAYS" ]; then
echo "WARN: $DOMAIN 证书剩余 ${LEFT} 天" | mail -s "证书到期告警" ops@example.com
fi
本地文件也可用 openssl x509 -checkend 2592000 -noout -in example.com.fullchain.pem 判断 30 天内是否过期,返回码非 0 即需要处理。多节点部署时,建议把证书文件纳入配置管理或对象存储统一分发,并让每台机器 reload 后回报证书序列号,避免出现“部分节点还是旧证书”的隐性故障。
八、效果验证与上线检查清单
配置完成后按下面四步验证,全部通过再切流量。
# 1. 查看实际下发的证书主体、签发者、有效期与 SAN
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 2. 完整链路校验,必须输出 Verify return code: 0 (ok)
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null
# 3. 子域实测(含尚未解析到本机的灰度域名)
curl -sSI https://api.example.com | head -1
curl -sSI --resolve api.example.com:443:203.0.113.10 https://api.example.com
# 4. 确认 TLS 1.0/1.1 已关闭
openssl s_client -connect example.com:443 -tls1_1 </dev/null # 预期握手失败
上线检查清单:
- 证书链完整(leaf + 中间 CA),且不包含多余的根证书;
- SAN 同时包含
*.example.com与example.com; - HTTP 自动 301 跳转到 HTTPS,且跳转后的站点使用同一张证书;
- HSTS 响应头已下发,但确认没有未改造的子域;
- 页面无混合内容(Mixed Content),可在浏览器控制台过滤
http://检查; - 证书已进入 CT 日志,可在 crt.sh 搜索主域确认;
- 第三方在线评分(如 SSL Labs)达到 A 及以上,且无链不完整告警。
最后提醒一句:泛域名证书降低了运维成本,但也意味着一个私钥保护着全部子域。私钥文件权限应设为 600、属主为服务账号,一旦泄露必须立即吊销重签并更换密钥,不能只换个子域了事。
常见问题
泛域名证书能覆盖多少个子域?有数量限制吗?
数量上没有限制,但层级上只覆盖一个标签。*.example.com 可以匹配 a.example.com、b.example.com 等任意一级子域,但 a.b.example.com 这类多级子域不匹配,需要单独签发或购买多域名(SAN)证书。证书本身不限制子域个数,限制的是 DNS 解析和服务器配置。
泛域名证书能同时用于 example.com 裸域吗?
不能。通配符只匹配“至少一个标签”的子域,裸域必须显式写进 SAN。签发时把两个名字都带上即可:acme.sh --issue --dns dns_ali -d example.com -d '*.example.com',签出的证书 SAN 中会同时出现 DNS:example.com 与 DNS:*.example.com,一张证书即可覆盖裸域与全部一级子域。
Let’s Encrypt 的泛域名证书收费吗?有效期多久?
免费,有效期 90 天,且只能通过 DNS-01 验证签发。90 天意味着必须做自动续期,否则每季度都会有一次故障窗口;acme.sh、certbot 都支持在 DNS API 的配合下全自动续期并 reload 服务。若无法提供 DNS API,只能使用商业 CA 的 398 天证书并人工续期。
为什么浏览器访问正常,但 Java、Android 客户端报证书错误?
常见原因有三个:一是服务端只下发了 leaf 证书,缺少中间 CA,浏览器靠 AIA 补齐而其他客户端不会;二是客户端根证书库过旧,不信任新根;三是 Let’s Encrypt 的 ISRG Root X1 交叉签名已于 2024-09-30 到期,Android 7.1 及更早系统需要额外配置。排查命令:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null。
证书续期后需要重启 Nginx 吗?
需要 reload,不需要 restart。reload 会平滑加载新证书、不中断现有连接;restart 会造成短暂中断。建议在 --reloadcmd 中先执行 nginx -t 做语法校验再 reload,避免证书文件异常导致整个服务起不来。
泛域名证书的私钥泄露了怎么办?
立即吊销并重新签发、更换密钥对,不能只替换某个子域的证书。吊销可用 acme.sh --revoke -d example.com -d '*.example.com' --ecc,商业 CA 则通过其控制台吊销。同时检查 CT 日志(crt.sh)确认没有异常签发记录,并收紧私钥文件权限到 600、限制部署账号权限。