跳到主要内容
基础知识

ssl.com 通配符证书申请与自动续期实操:ACME、DNS-01 验证与 Nginx 部署

ssl.com 通配符证书 — ssl.com 通配符证书申请与自动续期实操:ACME、DNS-01 验证与 Nginx 部署
核心结论

SSL.com 通配符证书一张覆盖 *.example.com 下所有一级子域,但不覆盖 example.com 裸域和 a.b.example.com 二级子域;下单时必须把裸域加进 SAN,否则访问 https://example.com 直接报证书名称不匹配。 据 RFC 8555 §7.1.3,通配符只能用 dns-01 验证,HTTP-01 会在订单阶段被拒;SSL.com 的 ACME 目录是 https://acme.ssl.com/directory,需先在控制台生成 EAB 的 kid 与 hmacKey。 acme.sh 3.0.x 签发命令为 acme.sh --issue --dns dns_cf -d example.com -d '*.example.com' --server https://acme.ssl.com/directory --eab-kid ... --eab-hmac-key ... --keylength ec-256,续期成功后必须执行 nginx -s reload。 有效期按 CA/B Forum SC-081 逐步缩短:2026-03-15 起 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天,续期检查建议每天 1–2 次、到期前 30 天进入告警。 排错先看链:curl: (60) unable to get local issuer certificate 基本都是 fullchain 里少了中间证书,用 openssl verify -untrusted chain.pem fullchain.pem 一条命令即可确认。

为什么 *.example.com 签下来能用,三个月后却开始报错?

问:*.example.com 明明签发成功了,为什么访问 example.com 和 api.cn.example.com 还是报证书错误?

因为通配符只顶一个标签。按 RFC 6125 §6.4.3 的标识符匹配规则,以及 CA/Browser Forum 基线要求(BR §3.2.2.6),*.example.com 里的 * 只能替换最左侧一个 label,不能跨越点号,也不覆盖裸域:

访问的主机名 是否被 *.example.com 覆盖 原因
api.example.com ✅ 命中 只替换了 api 一个标签
www.api.example.com ❌ 不命中 两个标签,通配符不能跨 .
api.cn.example.com ❌ 不命中 同上,必须单独签发或再加一条 *.cn.example.com
example.com ❌ 不命中 裸域不含任何标签可替换,须作为独立 SAN 条目

裸域是最常见的坑:SSL.com 下单页的 CN 默认就是 *.example.com,example.com 必须在 Additional Domains / SAN 区域手工勾选或填入,否则签出来的证书天然“少一条”。漏填后的真实报错很固定——Chrome/Edge 抛 NET::ERR_CERT_COMMON_NAME_INVALID,curl 则直说没有匹配的 SAN:

# 证书签发后第一件事:核对 SAN,而不是只看 CN
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -subject -ext subjectAltName
# 正确输出应同时包含两条:
#   subject=CN = *.example.com
#   X509v3 Subject Alternative Name:
#       DNS:*.example.com, DNS:example.com

# 从客户端侧验证某个具体域名
curl -sv https://example.com/ 2>&1 | grep -i "subject name"
# curl: (60) SSL: no alternative certificate subject name matches target host name 'example.com'

问:为什么通配符订单一提交就被 ACME 服务端拒绝,HTTP-01 明明在其他域名上能过?

这是协议层限制,不是 SSL.com 的策略。据 RFC 8555 §7.1.3,含通配符的标识符只能用 dns-01 验证——CA 必须确认你控制的是整个域,而 HTTP-01 只能证明某一台主机可控。用 HTTP-01 提交会在 newOrder 阶段直接失败,返回 urn:ietf:params:acme:error:rejectedIdentifier(或参数不合法的 malformed)。可用的完整流程示例(acme.sh):

# SSL.com 的 ACME 目录(DV 证书);OV 通配符不走 ACME,需在控制台/API 下单并完成组织验证
export SSLCOM_Key="你的 API Key"
export SSLCOM_Secret="你的 API Secret"

acme.sh --issue --dns dns_sslcom 
  -d '*.example.com' -d example.com 
  --server https://acme.ssl.com/sslcom-dv-rsa
# 注意:通配符与裸域同时签时,_acme-challenge.example.com 下会出现
# 两条同名 TXT 记录(两条都要保留,删一条就会 validation failed)

问:三个月后开始报错,是证书本身变了,还是续期没跑成?

多半是续期链路断了,而且这个窗口只会越来越窄。CA/B Forum 2025 年通过的 SC-081 已把公信证书最长有效期写死:

生效日期 最长有效期 对运维的含义
2026-03-15 起 200 天 一年一续的人工流程首次失效
2027-03-15 起 100 天 必须全自动,人工排期不可行
2029-03-15 起 47 天 续期失败告警窗口只有几天

所以别把 --cron 当成“配了就行”,要给续期加失败告警:acme.sh --install-cert -d '*.example.com' --key-file /etc/nginx/ssl/privkey.pem --fullchain-file /etc/nginx/ssl/fullchain.pem --reloadcmd "nginx -t && systemctl reload nginx",并监控 openssl x509 -checkend 1209600 -noout -in fullchain.pem 的返回码。

问:通配符把私钥铺到几十台边缘节点,风险到底集中在哪?

两点叠加:其一,同一份私钥在任意一台 /etc/nginx/ssl/privkey.pem 泄露即等于全域失守,因此权限必须收敛到 chmod 600、chown root:root,并纳入配置管理的加密存储(Vault/KMS),而不是 scp 到各机器;其二,证书一经签发就会进入 CT 日志,任何人都能在 crt.sh 上枚举出你的全部子域,等于免费送出一张资产清单。据 Let’s Encrypt 文档,CT 日志是强制要求,无法选择退出。

问:公司更名后老证书“看起来还能用”,为什么过不了合规核对?

SSL.com 的通配符属于组织验证(OV)级别,Subject 中的 O、L、C 必须与营业执照逐字一致。更名或迁址后证书仍在有效期内、浏览器也不报错,但在支付机构准入、等保测评的材料比对中会直接对不上号——这类问题不会在 TLS 握手阶段暴露,只能靠 openssl x509 -noout -subject 定期自查并重签。

从下单到上线:SSL.com 通配符证书的 7 个步骤

把 SSL.com 的通配符证书从下单推到线上,真正的坑几乎都不在”加密”本身,而在域名盘点、组织验证和证书链拼接这三处。下面 7 步按实际操作顺序排列,每步都给出可直接复制的命令与判据。

  1. 步骤 1|先画域名矩阵,再决定买几张证书

    通配符只匹配一层标签,这是 RFC 6125 与 CA/B Forum 基线要求共同约束的行为:*.example.com 匹配 api.example.com,但不匹配 a.b.example.com,也不匹配裸域 example.com。据 Let’s Encrypt 文档对通配符的说明,裸域必须单独列进 SAN。先按层级把现有子域列成表,再决定签几张:

    子域示例 层级 *.example.com 是否覆盖 处理方式
    www / api / m / cdn 一级 是 归入同一张 ssl.com 通配符证书
    a.b.example.com 二级 否 另签 *.b.example.com,或改用多域名(SAN)证书
    example.com(裸域) — 否 下单时在 SAN 列表里显式勾选/确认
    example.net 另一主域 否 多域名证书合并,或第二张证书分开管理
  2. 步骤 2|账号与组织验证(OV/EV 卡在哪)

    在 ssl.com 注册后提交加盖公章的营业执照扫描件、组织英文名、注册地址,以及能在 114 或黄页查到的组织电话,等待电话回拨核实。据 SSL.com 官方文档,OV 证书通常 1–3 个工作日、EV 为 3–5 个工作日;材料不全会挂起并邮件通知,此时证书状态停留在 Order Submitted,不会自动重试——务必盯邮箱。个人/无营业执照场景应改选 DV 通配符,不要硬走 OV。

  3. 步骤 3|选密钥算法并生成 CSR(走 ACME 可跳过)

    算法 兼容性 握手开销 建议场景
    RSA 2048 最广,含老旧 Android / Java 客户端 较大 对外公共站点、IoT、老客户端
    ECC P-256 现代浏览器与 OpenSSL 1.0.2+ 均可 更小,握手更快 移动端、内部 API、可控制客户端的场景
    # OpenSSL 1.1.1+ 支持 -addext;1.0.2 需改用配置文件写 req_extensions
    openssl req -new -newkey rsa:2048 -nodes 
      -keyout 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"
    # 校验 CSR 里的 SAN,确认星号与裸域都在
    openssl req -in example.com.csr -noout -text | grep -A2 "Subject Alternative Name"

    -subj 中的 CN 必须写 *.example.com;在 shell 里要给星号加引号或反斜杠转义,否则会被展开成当前目录文件名,CSR 里的 CN 变成一串 xxx.key,签发后浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID。

  4. 步骤 4|配置 DNS-01 验证

    为 _acme-challenge.example.com 建 TXT 记录;若不想把主域 DNS 权限交给 CI,可做 CNAME 委派到独立账号下的 _acme-challenge.example.com.acme.zone,后续续期只改委派区。TTL 设 60–300 秒,改完先验证再点”验证”按钮:

    # 指定公共 DNS,避免本地缓存误导;需与权威 NS 返回一致
    dig +short TXT _acme-challenge.example.com @8.8.8.8
    dig +short NS example.com            # 确认权威服务器,必要时直查权威
    dig +short TXT _acme-challenge.example.com @ns1.yourdns.com

    常见失败是权威已生效但公共递归未刷新,表现为控制台报 DNS problem: NXDOMAIN looking up TXT,等 TTL 过后重试即可。

  5. 步骤 5|提交订单并下载证书包

    控制台 Orders → Wildcard SSL,核对 SAN 列表是否含裸域,签发后下载 .crt(叶子证书)、.ca-bundle(中间链)与 .p7b。文件命名带日期与批次,例如 example.com-2025Q4.crt,方便灰度与回滚。

  6. 步骤 6|部署并接入自动续期

    Nginx 的 ssl_certificate 必须指向 fullchain(叶子+中间),只放 .crt 会让部分客户端报 unable to verify the first certificate:

    # 拼接 fullchain:叶子在前,中间链在后
    cat example.com.crt ca-bundle.crt > /etc/nginx/ssl/fullchain.pem
    # nginx.conf 片段
    # ssl_certificate     /etc/nginx/ssl/fullchain.pem;
    # ssl_certificate_key /etc/nginx/ssl/example.com.key;
    # ssl_protocols       TLSv1.2 TLSv1.3;

    走 ACME 时用 acme.sh(v3.0 起默认 CA 已改为 ZeroSSL,必须显式 --server 指定 SSL.com 控制台给出的目录地址),并注册 reloadcmd:

    acme.sh --issue --dns dns_ali -d example.com -d '*.example.com' 
      --server "$SSLCOM_ACME_DIRECTORY" --keylength ec-256
    acme.sh --install-cert -d example.com --ecc 
      --key-file       /etc/nginx/ssl/example.com.key 
      --fullchain-file /etc/nginx/ssl/fullchain.pem 
      --reloadcmd      "nginx -t && systemctl reload nginx"

    同时在监控里把到期告警阈值设为 21 天——远早于 30 天的常规通知邮件,避免告警被收件规则吞掉。

  7. 步骤 7|上线自检与回滚

    # 看实际下发的链、SAN 与有效期
    openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
      | openssl x509 -noout -subject -dates -ext subjectAltName
    # 确认中间证书已随服务端下发(输出应含 2 段及以上)
    openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c "BEGIN CERTIFICATE"

    回滚只需把 fullchain.pem 换回上一批次文件并 systemctl reload nginx,因此保留带日期的旧包是必须的运维动作。

命令与配置示例:acme.sh、certbot、Nginx 三套写法

acme.sh 3.0.x 如何走 SSL.com 的 ACME?先准备 EAB(External Account Binding)凭据,再让 acme.sh 用 DNS-01 签发。EAB 的协议依据是 RFC 8555 §7.3.4;缺少 EAB 时,acme.sh 会报 Please specify --eab-kid and --eab-hmac-key。

# 适用 acme.sh 3.0.x;dns_cf 插件需 Cloudflare API Token
export SSLCOM_EAB_KID="你的-kid"
export SSLCOM_EAB_HMAC_KEY="你的-hmac-key"
export CF_Token="cloudflare-api-token"
export CF_Account_ID="cloudflare-account-id"

acme.sh --issue --dns dns_cf 
  -d example.com -d '*.example.com' 
  --server https://acme.ssl.com/directory 
  --eab-kid "$SSLCOM_EAB_KID" 
  --eab-hmac-key "$SSLCOM_EAB_HMAC_KEY" 
  --keylength ec-256 
  --valid-to "+200d"   # 无默认值;仅当 CA 支持时生效,实际以签发结果为准

--keylength 在 acme.sh 中默认是 2048 位 RSA;ec-256 生成 P-256 ECDSA 密钥。SSL.com 通配符证书要求同时覆盖裸域和一级子域时,必须像上面一样把 example.com 与 *.example.com 都写进 -d。

certbot 2.11+ 的等价写法是什么?手工 DNS 模式如下,但 --manual 会提示 Please deploy a DNS TXT record under the name _acme-challenge.example.com...,无法无人值守续期。

# 适用 certbot 2.11+;显式 --key-type ecdsa,避免依赖版本默认值
export KID="你的-kid"
export HMAC="你的-hmac-key"
certbot certonly --manual --preferred-challenges dns 
  --server https://acme.ssl.com/directory 
  --eab-kid "$KID" --eab-hmac-key "$HMAC" 
  -d example.com -d '*.example.com' 
  --key-type ecdsa

# 生产环境改用 DNS 插件,例如:
# certbot certonly --dns-cloudflare 
#   --dns-cloudflare-credentials /root/.secrets/cf.ini 
#   --server https://acme.ssl.com/directory 
#   --eab-kid "$KID" --eab-hmac-key "$HMAC" 
#   -d example.com -d '*.example.com' --key-type ecdsa

据 Let’s Encrypt 文档与 RFC 8555 §8.4,通配符域名必须用 DNS-01 验证,因为 CA 无法对 *.example.com 做 HTTP-01。手工 CSR 路径适合不能开放 DNS API 的场景:

openssl req -new -newkey rsa:2048 -nodes 
  -keyout example.com.key -out example.com.csr 
  -subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Technology Co., Ltd./CN=*.example.com"

openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"

第二条命令无输出即表示 CSR 没有 SAN;SSL.com 通配符证书会在签发时按订单补齐 SAN。注意 *.example.com 不覆盖 example.com 本身,也不覆盖 a.b.example.com,这是 RFC 6125 的通配符一级标签匹配规则。

写法 版本/依赖 自动续期 关键限制
acme.sh 3.0.x + dns_cf 可 cron 自动 必须传 EAB;--valid-to 不一定被 CA 接受
certbot 2.11+ + DNS 插件 插件模式可 systemd timer --manual 不能自动续期;需 EAB
手工 CSR OpenSSL 1.1.1+/3.x 否 需人工上传/下载,SAN 由订单补齐

证书链拼接只放叶子证书和中间证书,不要把根证书 cat 进去:

# 叶子证书 + 中间证书;根证书不要拼入
cat example.com.crt ca-bundle.crt > fullchain.pem
cp ca-bundle.crt chain.pem   # 仅中间证书,供 OCSP stapling
chmod 600 example.com.key
chown root:root example.com.key

多带一张根证书会让部分客户端判定链过长,也会增大握手包体积。Nginx 1.24+ 可这样配置,其中 ssl_trusted_certificate 只放中间证书,用于 OCSP stapling 的签发者校验;若塞入空文件或根证书,常见报错是 nginx: [emerg] cannot load certificate ... PEM_read_bio_X509_AUX() failed。

server {
    listen 443 ssl http2; # Nginx 1.24.x 写法;1.25.1+ 可改 http2 on;
    server_name example.com *.example.com;

    ssl_certificate /etc/nginx/ssl/fullchain.pem;
    ssl_certificate_key /etc/nginx/ssl/example.com.key;

    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers off;      # Nginx 默认 off;TLS 1.3 下由客户端选序
    ssl_session_cache shared:SSL:10m;   # 默认 off
    ssl_session_timeout 1d;             # 默认 5m

    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/nginx/ssl/chain.pem;

    # 预发先用 300 秒观察,再拉长到 31536000
    add_header Strict-Transport-Security "max-age=300; includeSubDomains" always;
}

HSTS 的 includeSubDomains 会覆盖所有子域,包括还没签证书的测试域;一旦某个子域只提供 HTTP,浏览器会直接拒绝访问。据 Mozilla SSL Configuration Generator,现代配置应关闭 ssl_prefer_server_ciphers,并只保留 TLS 1.2/1.3;HSTS 先设 max-age=300 观察一周,再逐级拉长,确认所有子域都有 HTTPS 后再考虑 preload。

选型对比:通配符、多域名、单域名与免费证书怎么选

同一个主域下已经有十几个子域,明年还准备再加,那到底该买 ssl.com 通配符证书、多域名 UCC,还是直接上 Let’s Encrypt?先看一张对照表,再讲三条判断规则。

产品 验证级别 覆盖范围 签发时长 参考价(2025 结账页常见区间)
Wildcard SSL OV *.example.com;裸域 example.com 需勾选 SAN 1–3 个工作日 约 149–199 美元/年
Multi-Domain UCC OV 3–5 个独立 FQDN,可跨主域 1–3 个工作日 约 200–400 美元/年
Basic SSL DV 单个 FQDN 分钟级 约 40–60 美元/年
Let’s Encrypt DV 通配符必须走 dns-01 验证 分钟级 0 美元(90 天有效期)

规则一:数一级子域的数量和分布。一级子域少于 5 个、且分散在多个主域时,多域名 UCC 更省,因为一张证书就能同时覆盖 shop.example.com 与 api.example.net。反过来,一级子域超过 10 个且都挂在同一主域下,通配符的边际成本趋近于零——新增子域不需要重新签发、不需要重新过 OV 审核。注意“一级”这个词:*.example.com 覆盖 a.example.com,但不覆盖 a.b.example.com。

规则二:证书详情里是否需要出现组织名。B2B 门户、支付回调、邮件网关、API 开放平台这类场景,用户会在浏览器证书面板或对接文档里核对公司名,此时选 OV 通配符;纯内部测试、静态资源 CDN 用 Let’s Encrypt 通配符即可,代价是 90 天有效期和速率限制——据 Let’s Encrypt 官方文档,每注册域每周限发 50 张证书,自动化脚本写错循环就会撞上 urn:ietf:params:acme:error:rateLimited。

规则三:多级子域只能显式列名。SSL.com 与 CA/B Forum 基线要求一致,不允许把 * 放在中间标签,a.*.example.com 这类申请会直接被拒绝;确实要覆盖二级子域,就单独签 *.b.example.com(通配符仍位于最左标签),或者改用 SAN 逐条列明。这条限制同样适用于 ssl.com 通配符证书的 ACME 下单流程,客户端会收到 rejectedIdentifier 类错误。

RSA 2048 还是 ECC P-256?ECC 叶子证书体积约 1.0 KB 对 0.4 KB,TLS 1.2 握手字节数约 4.5 KB 对 3.2 KB,弱网和移动端收益明显;但 Android 7.0(API 24)以下与部分 Java 8 早期版本对 ECC 证书链兼容性差,典型报错是 CertPathValidatorException: Trust anchor for certification path not found。要覆盖老设备,可准备双证书(443 用 RSA、8443 用 ECC),或统一 RSA 2048。上生产前用 OpenSSL 自查一遍:

# 1) 对比叶子证书体积(DER 编码,直接反映握手包大小)
openssl x509 -in rsa-leaf.pem -outform DER | wc -c   # RSA 2048 典型 ~1000 字节
openssl x509 -in ecc-leaf.pem -outform DER | wc -c   # ECC P-256 典型 ~400 字节

# 2) 确认签名算法、公钥算法与曲线,判断老客户端能否验证
openssl x509 -in ecc-leaf.pem -noout -text 
  | grep -E "Signature Algorithm|Public Key Algorithm|NIST CURVE"

# 3) 用 TLS 1.2 + RSA 套件做握手冒烟测试,-brief 只打印协议与套件
openssl s_client -connect example.com:443 -servername example.com 
  -tls1_2 -cipher 'ECDHE-RSA-AES128-GCM-SHA256' -brief </dev/null

第 3 条命令适用于 OpenSSL 1.1.1 及以上(-brief 在 1.1.0 起可用),Ubuntu 20.04、Debian 11 及以上默认版本均可直接运行。若输出停在 CONNECTED 而没有 Protocol version 行,说明服务端没有协商出该套件,多半是证书类型与套件不匹配(ECDHE-RSA 套件必须配 RSA 证书)。

常见报错与排查:从 curl 到 nginx -t 的真实输出

证书签发日志显示成功,为什么 curl 访问仍报 curl: (60) SSL certificate problem: unable to get local issuer certificate?

这个错误不是”证书无效”,而是服务端只下发了叶子证书、没有拼上中间证书。浏览器会通过 AIA 扩展自动补链,所以肉眼看着正常;curl、Java、Go 等客户端只认服务端实际下发的链,缺中间证书就直接判失败。一条命令验证下发了几张证书:

# 统计服务端实际下发的证书张数:正确应为 2(叶子 + 中间),返回 1 说明 nginx 只配了 cert.pem
openssl s_client -connect api.example.com:443 -showcerts /dev/null 
  | grep -c "BEGIN CERTIFICATE"

修复只需把 ssl_certificate 指向 fullchain.pem(acme.sh 的 --fullchain-file 产物),而不是 cert.pem。据 Let’s Encrypt 文档,其链为 叶子→ISRG Root X1 中间→根,必须完整下发;ssl.com 通配符证书同理,ACME 目录下发的 fullchain.cer 已含中间证书。

浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID,curl 报 no alternative certificate subject name matches target host name 'a.b.example.com',是什么原因?

你访问的是二级子域。*.example.com 按 RFC 6125 只匹配最左一个标签,a.b.example.com 不在覆盖范围内。先确认 SAN 到底签了什么:

openssl x509 -in fullchain.pem -noout -ext subjectAltName
# 典型输出:DNS:*.example.com, DNS:example.com

若业务确实需要 a.b.example.com,只能在申请时显式加 -d a.b.example.com(acme.sh 与 certbot 都支持混签通配符 + 具体域名),不能指望通配符向下穿透两层。

acme.sh 报 urn:ietf:params:acme:error:rejectedIdentifier ... DNS problem: NXDOMAIN looking for _acme-challenge.example.com 怎么办?

这是 DNS-01 校验查不到 TXT,不是证书配置问题。先分辨是”没写”还是”写错了位置”:

dig +short TXT _acme-challenge.example.com @8.8.8.8
dig +short CNAME _acme-challenge.example.com @8.8.8.8
# 输出为空 → TXT 未写入;有 CNAME 但目标 zone 无对应 TXT → 委派地址写错
dig +short TXT _acme-challenge.example.com @ns1.your-dns-provider.com   # 绕过缓存查权威

常见坑:CNAME 委派到了 _acme-challenge.verify.example.net,但 TXT 记录名写成了 _acme-challenge.example.com,应写成目标名本身。acme.sh 默认等待 120 秒(--dnssleep 可调),TTL 较长时可用 --dnssleep 300 拉长等待。

报 urn:ietf:params:acme:error:externalAccountRequired 是漏了什么?

RFC 8555 §7.3.4 定义的外部账户绑定(EAB)。SSL.com 的 ACME 端点强制 EAB,需先在控制台 ACME 页面生成 kid 与 hmacKey:

# acme.sh 3.x:通过环境变量传 EAB,通配符走 dns_cf 等 DNS API 模式
export SSLCOM_EAB_KID="kid_xxxxxxxx"
export SSLCOM_EAB_HMAC_KEY="xxxxxxxxxxxxxxxxxxxx"   # 原样使用,禁止再做一次 base64
acme.sh --issue --dns dns_cf -d example.com -d '*.example.com' 
  --server https://acme.ssl.com/sslcom-dv-rsa            # 以控制台显示的 Directory URL 为准

# certbot 2.x+:同样两个参数,注意 --server 必须显式指定
certbot certonly --dns-cloudflare -d example.com -d '*.example.com' 
  --server https://acme.ssl.com/sslcom-dv-rsa 
  --eab-kid "$SSLCOM_EAB_KID" --eab-hmac-key "$SSLCOM_EAB_HMAC_KEY"

hmacKey 二次 base64 后会报 unauthorized 或 malformed,这是最高频的踩坑点。

nginx -t 报 PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line) 怎么修?

file fullchain.pem      # 期望 "PEM certificate";若为 "data" 则是 DER 或空文件
openssl x509 -inform DER -in cert.der -out cert.pem     # DER → PEM 转换

报 SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:X509_check_private_key:key values mismatch),如何确认证书与私钥配对?

# RSA 证书
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5   # 两个 md5 必须一致

# ECC 证书(ssl.com 通配符证书的 ECC 版本用这条)
openssl x509 -in fullchain.pem -noout -pubkey | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5

ssl_stapling ignored, issuer certificate not found 是少了哪一行?

ssl_certificate         /etc/nginx/ssl/fullchain.pem;   # 叶子 + 中间
ssl_certificate_key     /etc/nginx/ssl/example.com.key;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem;        # 仅中间证书,供 OCSP 校验
ssl_stapling on;
ssl_stapling_verify on;
resolver 8.8.8.8 valid=300s;

# 验证
nginx -t && nginx -s reload
openssl s_client -connect api.example.com:443 -status /dev/null 
  | grep -i "OCSP Response Status"     # 期望 successful

注意:据 Let’s Encrypt 官方公告,其 OCSP 响应器已于 2025 年 5 月 7 日关闭,LE 证书上该指令只会得到 no response sent,应改用 CRL;ssl.com 通配符证书仍提供 OCSP,上述配置有效。

报错原文(可搜索) 根因 一条命令定位
curl: (60) unable to get local issuer certificate 未下发中间证书 openssl s_client -showcerts | grep -c 应为 2
ERR_CERT_COMMON_NAME_INVALID 访问了通配符覆盖不到的二级子域 openssl x509 -noout -ext subjectAltName
rejectedIdentifier ... NXDOMAIN TXT 未生效或 CNAME 委派错 zone dig +short TXT _acme-challenge.example.com @8.8.8.8
externalAccountRequired 请求未携带 EAB 凭据 检查 --eab-kid/--eab-hmac-key
PEM_read_bio_X509_AUX() failed 文件是 DER 或空文件 file fullchain.pem
key values mismatch 证书与私钥不配对 -modulus | openssl md5 比对
ssl_stapling ignored ssl_trusted_certificate 缺失或误放叶子 openssl s_client -status | grep OCSP

怎么确认真的生效?6 项验证清单

部署完 Nginx 并 reload 之后,“看起来能打开”和“真的生效”是两回事。下面 6 项检查建议每次续期后都跑一遍,前 3 项在服务器本地做,后 3 项从外部视角复核。每项都给出明确通过标准,任一项不通过就说明链、名称或吊销状态有问题。

① 看 SAN 与有效期。通配符证书最容易出错的是漏掉裸域,据 RFC 6125,*.example.com 不覆盖 example.com,必须两条都在 SAN 里。OpenSSL 官方文档中 x509 -ext 可精确打印扩展项:

# -servername 必须显式指定,否则 SNI 站点会返回默认证书
openssl s_client -connect api.example.com:443 -servername api.example.com /dev/null 
  | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 通过标准:输出含 DNS:*.example.com 与 DNS:example.com,notAfter 与 ssl.com 订单页一致

② 验链完整性。浏览器能容忍的“缺中间证书”在 curl、Java、Android 上会直接失败,因为客户端只信任系统根库。-untrusted 就是用来模拟这一点的:

# chain.pem 为中间证书,fullchain.pem 为 叶证书+中间证书
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt 
  -untrusted chain.pem fullchain.pem
# 期望输出:fullchain.pem: OK
# 若报 error 20 at 0 depth lookup: unable to get local issuer certificate,说明 Nginx 只配了 ssl_certificate 叶证书

③ 多子域实测。不要只测一个域名,通配符证书常因某个子域仍指向旧服务器而漏网:

for h in www api m static; do
  curl -sS -o /dev/null -w "%{http_code} %{ssl_verify_result}n" https://$h.example.com
done
# 通过标准:第二列全部为 0;非 0 表示链不完整或名称不匹配
ssl_verify_result 含义 常见成因
0 验证通过 —
10 证书已过期 自动续期未执行(cron/timer 未生效)
20 无法获取本地签发者 Nginx 未配置 ssl_certificate 为 fullchain
62 主机名不匹配 子域不在 SAN 内,或仍在使用旧证书

④ TLS 版本与套件。先确认握手落在 TLS 1.3,再全量扫描确认没有残留 TLS 1.0/1.1(据 RFC 8996,这两版已被正式弃用;Mozilla SSL Configuration Generator 的 intermediate 配置默认即禁用):

openssl s_client -connect api.example.com:443 -tls1_3 &1 | grep "Protocol|Cipher"
# 期望:Protocol: TLSv1.3 / Cipher: TLS_AES_256_GCM_SHA384

nmap --script ssl-enum-ciphers -p 443 api.example.com
# 通过标准:输出中不出现 TLSv1.0、TLSv1.1 段

⑤ OCSP 与吊销状态。证书被吊销后浏览器未必立刻拒连,必须主动查询。先取 OCSP responder 地址,再发起查询(据 RFC 6960):

openssl x509 -in fullchain.pem -noout -ocsp_uri          # 取出 responder URL
openssl ocsp -issuer chain.pem -cert fullchain.pem 
  -url <上一步输出的地址> -resp_text
# 通过标准:Response verify OK + Cert Status: good
# 若返回 unauthorized 或超时,检查 80 端口是否对 OCSP 抓取放行

⑥ 外部视角复核。本地全绿不代表公网可达,用 SSL Labs API 与 CT 日志交叉验证:

curl "https://api.ssllabs.com/api/v3/analyze?host=api.example.com&all=done&publish=off" 
  | jq -r '.endpoints[0].grade'          # 期望 A 或 A+;首次调用可能返回 "In progress"

curl -s "https://crt.sh/?q=%25.example.com&output=json" 
  | jq -r '.[0:5][] | "(.entry_timestamp) (.name_value)"'
# 通过标准:最新一条为本次签发的 notBefore 时间,通常 5–30 分钟内进入 CT 日志

这 6 项里,第 ② 项和第 ③ 项是 ACME + DNS-01 场景下的高频故障点:DNS-01 只证明域名控制权,不保证你把中间证书装对了。如果你的 ssl.com 通配符证书是由 acme.sh 或 certbot 签发,建议把第 ① ③ ⑤ 三条写成续期后的 --reloadcmd 钩子脚本,让每次自动续期都自带验收,而不是等到用户报错才发现链断了。

延伸:SSL.com 与 GlobalSign、DigiCert 的通配符差异与迁移注意

Q:SSL.com、DigiCert、GlobalSign 的通配符证书,能不能复用同一套 ACME 脚本直接切换?

不能。三家都提供 ACME 端点,但准入方式、前置条件和根信任链完全不同。SSL.com 的 ACME 账户强制使用 EAB(External Account Binding,外部账户绑定,RFC 8555 §7.3.4),你必须先在控制台生成 EAB Key ID 和 HMAC Key;DigiCert 的 ACME 目录要求域名事先完成 DCV(Domain Control Validation,域名控制权验证)并加入账户白名单,否则 `newOrder` 会直接返回 `urn:ietf:params:acme:error:unauthorized`;GlobalSign 的 ACME 则绑定在 Atlas 平台上,需要先有 Atlas 账户与 API 凭证。迁移前务必先在预发域(例如 `staging.example.com` 或内部测试域名)把 EAB 参数跑通,不要直接在生产 DNS 上试错。

维度 SSL.com DigiCert GlobalSign
ACME 目录 URL 控制台 ACME 页面给出(DV RSA / DV ECC 两个) https://acme.digicert.com/v2/DV90 Atlas 平台目录(EMEA / USC 分域)
EAB 要求 强制,缺失即报 externalAccountRequired 不需要 需要,绑定 Atlas 凭证
前置条件 账户注册 + 域名控制权 先完成 DCV 并加白名单 Atlas 合同 + 域验证
根证书 SSL.com TLS RSA Root CA 2022 / ECC Root CA 2022 DigiCert Global Root G2 / G3 GlobalSign Root R3 / R6
通配符参考价(年) 149–199 USD 约 599 USD 500–900 USD

价格仅作区间参考:SSL.com 通配符约 149–199 美元/年,3 年期常见 400–500 美元;Sectigo 约 100–200 美元/年。实际成交价受渠道与促销影响,以结账页为准。

Q:EAB 参数具体怎么填?以 certbot 为例(需 ≥ 1.30,`–eab-kid` 自 1.20 起可用):

# EAB 凭据来自 CA 控制台,切勿写进版本库;用环境变量或 600 权限文件注入
export EAB_KID="你的-EAB-Key-ID"
export EAB_HMAC_KEY="base64编码的HMAC密钥"

certbot certonly 
  --manual --preferred-challenges dns 
  --server https://acme.ssl.com/sslcom-dv-rsa   # 以控制台给出的 directory URL 为准
  --eab-kid "$EAB_KID" --eab-hmac-key "$EAB_HMAC_KEY" 
  --cert-name wildcard-example 
  -d example.com -d '*.example.com' 
  --dry-run                                  # 先在预发域跑 --dry-run,失败不要动生产

Q:根信任差异真的会影响线上流量吗?会。据 SSL.com 官方仓库说明,其自 2022 年起签发链路锚定在自有根 SSL.com TLS RSA Root CA 2022 与 SSL.com TLS ECC Root CA 2022,而非早期依赖的 Sectigo/USERTrust 交叉签名。2017 年前出厂的 Android 4.x、部分 Java 8 早期更新版本(`cacerts` 未含新根)、老式打印机与 IoT 固件可能不在信任列表。迁移前用 Qualys SSL Labs 的客户端模拟矩阵(Android 4.4、Java 7、Windows 7 / OpenSSL 1.0.2)跑一遍,本地也可直接验链:

# 用目标客户端同款根库验证,而非用你的浏览器
openssl s_client -connect canary.example.com:443 -servername canary.example.com 
  -CAfile /etc/ssl/certs/ca-certificates.crt -verify_return_error &1 
  | grep -E "Verify return code|verify error"
# 期望:Verify return code: 0 (ok);若为 20/21/19 说明根或中间链缺失

Q:切换过程怎么做到可回滚?推荐新旧证书并行:Nginx 按 SNI 用两个 `server` 块分流,先只让 canary 子域走新证书。

# /etc/nginx/conf.d/canary.conf —— 新证书灰度块,验证通过后再替换主块
server {
    listen 443 ssl;
    http2 on;
    server_name canary.example.com;
    ssl_certificate         /etc/nginx/ssl/sslcom/fullchain.pem;
    ssl_certificate_key     /etc/nginx/ssl/sslcom/privkey.pem;
    ssl_trusted_certificate /etc/nginx/ssl/sslcom/chain.pem;  # OCSP stapling 依赖
    ssl_stapling on;
    ssl_stapling_verify on;
    resolver 1.1.1.1 valid=300s;                              # 默认不继承,必须显式声明
    add_header Strict-Transport-Security "max-age=31536000" always;
    location / { proxy_pass http://127.0.0.1:8080; }
}
# nginx -t && nginx -s reload

接着把 `_acme-challenge.example.com` 的 CNAME 从旧 CA 的委派 zone 切到新 CA 的委派目标,观察 7 天 CT 日志(RFC 6962 日志可查新证书是否已入日志)与 OCSP 响应,再下线旧证书。吊销后 OCSP 状态变为 `revoked`,且客户端与中间缓存不会立刻刷新——不要在同一天做流量灰度,至少留 24–48 小时。

# 吊销后确认 OCSP 状态(不要凭感觉)
openssl x509 -in old.crt -noout -ocsp_uri          # 取 OCSP responder URL
openssl ocsp -issuer chain.pem -cert old.crt 
  -url "$(openssl x509 -in old.crt -noout -ocsp_uri)" -resp_text 
  | grep -E "Cert Status|Revocation Time"          # 期望:revoked

Q:续期脚本的运维基线是什么?据 Let’s Encrypt 文档建议,续期检查每天 1–2 次即可,并应随机化触发分钟,避免整点集中打 CA 接口触发速率限制。certbot 的 systemd timer 默认已带随机延迟;自建脚本时把「续期 → reload → 验证」三步串成一个脚本,退出码非 0 就告警:

#!/usr/bin/env bash
# /usr/local/bin/cert-renew.sh —— 三步闭环,任一步失败即非 0 退出
set -euo pipefail
DOMAIN="example.com"
certbot renew --quiet --deploy-hook "systemctl reload nginx"   # 仅实际续期成功才 reload
echo | openssl s_client -connect ${DOMAIN}:443 -servername ${DOMAIN} 2>/dev/null 
  | openssl x509 -noout -checkend 604800                        # 剩余不足 7 天即失败
# crontab -e:随机 0–600 秒抖动,避免整点风暴
17 2 * * * sleep $((RANDOM%600)); /usr/local/bin/cert-renew.sh >> /var/log/cert-renew.log 2>&1

这套「先预发跑通 EAB、再测根信任、最后并行灰度」的顺序,同样适用于后续把 ssl.com 通配符证书扩展到多域名、多集群的场景,也是把 ACME 自动化纳入 CI 与监控体系的前提。

不能自动覆盖。*.example.com 与 example.com 是两条不同的标识符,下单时要在 SAN 列表里手工添加 example.com,或用 ACME 命令同时带 -d example.com -d '*.example.com',否则访问裸域会报证书名称不匹配。

不能。RFC 6125 规定 * 只匹配一个标签,*.example.com 只到 api.example.com 这一层;要覆盖 a.b.example.com,需要单独签 *.b.example.com,或把这些 FQDN 逐条列进 SAN。

据 RFC 8555 §7.1.3,通配符必须使用 dns-01 挑战,HTTP-01 会在订单创建阶段被拒。改成在 _acme-challenge.example.com 写 TXT 记录,或做 CNAME 委派后再提交即可。

说明请求没带 EAB 凭据。登录 SSL.com 控制台生成 ACME 的 kid 与 hmacKey,acme.sh 加 –eab-kid/–eab-hmac-key,certbot 加同名参数,hmacKey 按原样传入,不要二次 base64 编码。

需要展示组织名、走采购与合规审计的,选 SSL.com OV 通配符(1–3 个工作日、约 149–199 美元/年);纯技术场景、能接受 90 天有效期与每注册域每周 50 张速率限制的,用 Let's Encrypt 免费通配符成本更低。

大概率是 Nginx 没 reload,worker 进程仍持有旧证书。执行 nginx -t && nginx -s reload,再用 openssl s_client -connect host:443 -servername host /dev/null | openssl x509 -noout -dates 确认 notBefore 已更新;走 CDN 的还要刷新边缘节点的证书。

立即在 SSL.com 控制台吊销并重签,新私钥只下发到必要节点;同时查 crt.sh 的 CT 日志确认没有异常证书,再逐个节点检查私钥文件权限是否为 600、是否被写进镜像或 Git 仓库。


本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

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