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|先画域名矩阵,再决定买几张证书
通配符只匹配一层标签,这是 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|账号与组织验证(OV/EV 卡在哪)
在 ssl.com 注册后提交加盖公章的营业执照扫描件、组织英文名、注册地址,以及能在 114 或黄页查到的组织电话,等待电话回拨核实。据 SSL.com 官方文档,OV 证书通常 1–3 个工作日、EV 为 3–5 个工作日;材料不全会挂起并邮件通知,此时证书状态停留在 Order Submitted,不会自动重试——务必盯邮箱。个人/无营业执照场景应改选 DV 通配符,不要硬走 OV。
-
步骤 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|配置 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|提交订单并下载证书包
控制台 Orders → Wildcard SSL,核对 SAN 列表是否含裸域,签发后下载
.crt(叶子证书)、.ca-bundle(中间链)与.p7b。文件命名带日期与批次,例如example.com-2025Q4.crt,方便灰度与回滚。 -
步骤 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|上线自检与回滚
# 看实际下发的链、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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。