跳到主要内容
SSL 证书付费服务

HTTPS 泛域名证书注册与配置实战:从 CSR、DNS-01 签发到 Nginx/Apache 部署

HTTPS 泛域名证书注册与配置实战:从 CSR、DNS-01 签发到 Nginx/Apache 部署 — 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 验证方式的差异同样关键:

验证方式 依赖端口/记录 支持通配符 是否需要停机 自动化难度
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、Firefox SSL_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、限制部署账号权限。

内容审核

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