SSL证书申请流程卡在哪?从生成 CSR 到通过域名验证的 6 步实操与报错排查(2026 版)
SSL 证书申请流程本质只有三步:本地生成私钥与 CSR(RSA 2048 位或 ECDSA P-256)→ CA 完成域名或组织验证(DCV)→ 签发并下载 fullchain;DV 证书通常 1-10 分钟签发,OV 需 1-3 个工作日。 域名验证只有四条路:HTTP-01(需 80 端口可访问 /.well-known/acme-challenge/)、DNS-01(TXT 记录 _acme-challenge,唯一支持通配符)、TLS-ALPN-01(443 端口独占)、邮件验证(WHOIS 邮箱),选错方式是最常见的卡点。 据 CA/Browser Forum SC-081 决议,公信证书最长有效期自 2026-03-15 起降为 200 天,域名验证复用期同步从 398 天缩短到 200 天,续期频率需按此重排。 Let's Encrypt 单张证书最多 100 个 SAN,同一注册域名每周限 50 张,失败验证每小时每主机名 5 次,触限报 too many failed authorizations recently。 验收用 openssl s_client -connect example.com:443 -servername example.com -showcerts 检查链,再用 crt.sh 查 CT 日志确认签发记录已公开。
SSL 证书申请流程到底在验证什么?5 个卡点的根本原因
很多人把 SSL 证书申请流程想象成”提交资料等审核”,但据 RFC 8555(ACME 协议)的定义,CA 在签发 DV 证书时只做两件事:校验 CSR 里的签名,证明你确实持有对应私钥;再通过 DCV(Domain Control Validation)证明你控制这个域名。这两步之外没有第三步,所谓”审核”在 DV 场景基本是毫秒级自动化完成的。所以卡住你的从来不是”人工审核慢”,而是下面 5 个具体环节。
卡点一:CSR 本身就不合法。CSR 是自签名结构,CA 第一件事是用其中的公钥验证签名。如果私钥与 CSR 不匹配、用了 SHA-1 签名,或者 SAN 列表写错,请求在到达 DCV 之前就被拒。生成后务必本地自检:
# 生成 2048 位 RSA 私钥 + CSR,SAN 必须显式列出裸域和 www
openssl req -new -newkey rsa:2048 -sha256 -nodes
-keyout example.com.key -out example.com.csr
-subj "/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
# 1) 验证 CSR 自签名是否有效(输出 "verify OK" 才算合格)
openssl req -in example.com.csr -noout -verify
# 2) 确认 CSR 与私钥是同一对(两行 SHA256 必须完全一致)
openssl req -in example.com.csr -noout -modulus | openssl sha256
openssl rsa -in example.com.key -noout -modulus | openssl sha256
适用版本:OpenSSL 1.1.1 及以上支持 -addext;1.1.1 之前需写临时配置文件。-sha256 是当前默认摘要,若显式指定 -sha1 会被主流 CA 直接拒绝。
卡点二:CAA 记录直接否决。按 RFC 8659,CA 在签发前必须查询域名的 CAA 记录;只要存在 issue 或 issuewild 标签且未包含该 CA 的标识,签发立即中止。这是最容易被忽略的”历史遗留配置”——比如几年前给某个 CDN 加的 CAA 没清理。先自查:
# 逐级向上查询,注意 CAA 会沿域名树继承(a.b.example.com 无记录时查 b.example.com)
dig +short CAA example.com
# 正常返回示例:0 issue "letsencrypt.org"
# 若返回 0 issue "sectigo.com" 而你在申请 Let's Encrypt 证书,就会失败
真实报错:
CAA record for example.com prevents issuance (urn:ietf:params:acme:error:caa)。这条错误与域名解析、服务器配置无关,改 Nginx 一百遍也没用。
卡点三:业务架构让 HTTP-01 静默超时。HTTP-01 要求 CA 从公网访问 http://example.com/.well-known/acme-challenge/<token> 拿到指定内容。套了 CDN 后回源路径被改写、安全组只放行 443、或者 AAAA 记录指向一台已下线的机器(CA 优先走 IPv6),都会导致超时,而报错往往只写”连接超时”。用 curl 从外网视角复现:
# 强制走 IPv6,验证 AAAA 记录是否指向活着的机器
curl -6 -v http://example.com/.well-known/acme-challenge/test-token
# 看是否被 CDN/负载均衡 301 到 https 或返回 404
curl -I http://example.com/.well-known/acme-challenge/test-token
卡点四:通配符只能走 DNS-01,且不覆盖裸域。*.example.com 无法用 HTTP-01 验证,必须用 DNS-01 写入 _acme-challenge.example.com 的 TXT 记录。更关键的是,按 RFC 6125 的通配符匹配规则,*.example.com 既不覆盖 example.com,也不覆盖 a.b.example.com。申请时若不同时把裸域列入 SAN,主站上线后浏览器仍报 NET::ERR_CERT_COMMON_NAME_INVALID。
# 确认 TXT 已生效且只有一条(多条残留会导致验证随机失败)
dig +short TXT _acme-challenge.example.com
| 验证方式 | 端口/位置 | 支持通配符 | 典型失败原因 | DCV 结果复用 |
|---|---|---|---|---|
| HTTP-01 | TCP 80,路径 /.well-known/acme-challenge/ | 否 | CDN 改写、只放行 443、AAAA 指向下线机器 | 398 天(2026-03-15 起 200 天) |
| DNS-01 | TXT 记录 _acme-challenge.<domain> | 是 | TXT 未传播、多条残留、CNAME 链断裂 | 同上 |
| TLS-ALPN-01 | TCP 443,ALPN 协议 acme-tls/1 | 否 | 前置代理不支持 ALPN、SNI 分流错误 | 同上 |
卡点五:时间线正在压缩你的容错空间。据 CA/Browser Forum 基线要求 BR 3.2.2.4,同一域名的 DCV 结果可复用 398 天;但 SC-081 决议把它在 2026-03-15 缩短为 200 天,同时证书最长有效期从 398 天依次降到 200 天(2026-03-15)、100 天(2027-03-15)、47 天(2028-03-15)。Let’s Encrypt 目前固定 90 天,商业 CA 普遍 12 个月。这意味着换 CA、换验证方式或域名过户时都必须重新走一遍 DCV,而 47 天有效期下手工申请已经完全不可行——这正是 ACME 客户端(certbot、acme.sh、lego)必须纳入 CI/CD 的根本原因,而不是”图省事”。
申请前要定哪 6 个参数?密钥、SAN、验证方式与有效期新规
“CSR 都生成了,为什么验证总是过不去?”——大多数失败不是命令写错,而是参数在申请前就没定清楚。下面 6 个参数建议在建单前一次性确认,后面每一步排查都要回看它们。
1)密钥算法:RSA 2048 还是 ECDSA P-256?OpenSSL 3.x 的 genpkey 默认即 2048 位(可用 -pkeyopt rsa_keygen_bits:2048 显式指定,取值范围 512–16384,生产环境不要低于 2048)。据 Mozilla Server Side TLS 指南,RSA 3072 位握手开销约增 30%,而 ECDSA P-256 握手更省 CPU、证书体积更小;Nginx 1.11.0+ 与 OpenSSL 1.0.2+ 均支持双证书并行。代价是 Android 4.x 及更早设备不兼容 ECDSA,纯老移动端用户场景建议仍以 RSA 为主,或按 SNI 同时部署两张证书。
# RSA 2048(兼容性优先),OpenSSL 3.x 可用
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out privkey.pem
# ECDSA P-256(性能优先),需 OpenSSL 1.0.2+
openssl genpkey -algorithm EC -pkeyopt ec_paramgen_curve:P-256 -out privkey-ec.pem
# 生成 CSR 时必须带 SAN,否则现代浏览器直接报 NET::ERR_CERT_COMMON_NAME_INVALID
openssl req -new -key privkey.pem -out example.csr
-subj "/C=CN/O=Example Ltd/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com,DNS:api.example.com"
openssl req -in example.csr -noout -text | grep -A2 "Subject Alternative Name" # 核对清单
2)SAN 清单要一次写全。据 CA/Browser Forum 基线要求,CN 已被废弃为兼容字段,校验只看 subjectAltName;example.com、www.example.com、api.example.com 必须全部进 SAN,CN 只填主域名。Let’s Encrypt 单证书 SAN 上限为 100 个(据 Let’s Encrypt 官方速率限制文档);商业 CA 通配符证书通常不限子域数量,但限主域个数,常见 1/3/5 个主域档位——买错档位后加主域只能重新签发。
3)验证方式按网络形态选。有公网且 80 端口可达用 HTTP-01;套 CDN、80 端口被封或需要通配符(*.example.com)只能用 DNS-01;纯内网域名公网 CA 一律无法签发,只能走内部 CA(如 step-ca)或商业 CA 的内网验证产品。
| 参数 | 选项 | 关键默认值/上限 | 适用与代价 |
|---|---|---|---|
| 密钥算法 | RSA 2048 / RSA 3072 / ECDSA P-256 | OpenSSL 3.x 默认 2048 | RSA 兼容性最好;3072 握手约增 30%;ECDSA 快但老 Android 不支持 |
| SAN 数量 | 多域名 / 通配符 | Let’s Encrypt 单证书 100 个 | 商业通配符限 1/3/5 个主域 |
| 验证方式 | HTTP-01 / DNS-01 / 内网验证 | HTTP-01 需 80 端口 | 通配符必须 DNS-01 |
| 证书类型 | DV / OV | OV 需组织核验 | OV 材料不一致报 organization name does not match the official registry |
| 有效期 | 90 天 / 200 天 / 12 个月 | 2026-03-15 后商业 CA 最长 200 天 | Let’s Encrypt 90 天,建议到期前 30 天自动续 |
| 根信任链 | ISRG Root X1 / 商业根 | Android 7 之前不信任自签 ISRG Root X1 | 需交叉签名链;IoT 设备单独评估根证书版本 |
4)证书类型与材料。DV 只需证明域名管理权;OV 需营业执照扫描件、组织英文名与电话回访,组织名必须与工商登记完全一致(含括号全半角),不一致时 CA 直接返回 organization name does not match the official registry,这是 OV 申请最常见的卡点。
5)有效期与续期窗口。Let’s Encrypt 为 90 天,建议到期前 30 天自动续;商业 CA 目前 12 个月,但据 CA/Browser Forum 通过的 SC-081 决议,2026-03-15 起单张证书最长 200 天。采购周期必须按新上限重算,否则会出现“刚买完就要换”的预算错配——这也是把 SSL证书申请流程 从一次性采购改成自动化运维的直接原因。
6)CA 与根信任链。先确认目标 CA 的根证书在客户端信任库中:Android 7 之前不信任 ISRG Root X1 自签根,需依赖交叉签名链;内网 IoT 设备需单独评估根证书版本,必要时保留一张商业 CA 证书做兜底。把上述 6 项写进申请工单模板,后续 6 步实操中的报错基本都能在这里找到根因。
完整实操:从生成 CSR 到拿到证书的 6 个步骤
这一节按真实操作顺序拆成 6 步,每步都给出可直接复制的命令和判定标准。先说结论:私钥只在你的服务器上生成,CA 与代理商只应拿到 CSR 或域名控制权——这是整个 SSL 证书申请流程里最不能妥协的一条,因为一旦私钥外泄,证书签发得再规范也等于零。
步骤 1 · 本地生成私钥与 CSR
# RSA 2048:兼容性最好,仍需支持老旧 Android 4.x / Java 8 的站点选它
# -nodes 表示私钥不加密(便于服务自动加载);-addext 需 OpenSSL 1.1.1+
openssl req -new -newkey rsa:2048 -sha256 -nodes
-keyout example.com.key -out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Ltd/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
# ECDSA P-256:密钥更小、握手更快,Mozilla 服务器端 TLS 配置指南将其列为推荐曲线
openssl req -new -newkey ec -pkeyopt ec_paramgen_curve:prime256v1
-sha256 -nodes -keyout example.com.key -out example.com.csr
-subj "/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
chmod 600 example.com.key # 私钥仅属主可读,务必在生成后立刻执行
chmod 644 example.com.csr
OpenSSL 3.x 的默认摘要已是 SHA-256,但显式写 -sha256 可避免在 1.1.1 环境中拿到 sha1WithRSAEncryption 而被 CA 拒收。
步骤 2 · 自检 CSR,别把错误带到 CA 那边
openssl req -in example.com.csr -noout -text
# 关键输出示例:
# Signature Algorithm: sha256WithRSAEncryption
# Public-Key: (2048 bit)
# X509v3 Subject Alternative Name:
# DNS:example.com, DNS:www.example.com
# 顺手确认 CSR 与私钥配对:两条命令的哈希必须一致
openssl req -in example.com.csr -noout -pubkey | openssl sha256
openssl pkey -in example.com.key -pubout | openssl sha256
据 Let’s Encrypt 文档,现代客户端只看 SAN 不看 CN;漏写 www 或漏写通配符覆盖的二级域名,是“证书签下来却提示不匹配”的首要原因。这一步能挡掉大约一半的返工。
步骤 3 · 先查 CAA,再提交订单
# RFC 8659 定义的 CAA 记录:为空,或包含 0 issue "letsencrypt.org" 才可继续
dig +short CAA example.com @8.8.8.8
# ACME 通道(acme.sh 3.x / certbot 2.x 均遵循 RFC 8555)
acme.sh --issue -d example.com -d www.example.com --webroot /var/www/html
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com --dry-run
# 商业 CA:控制台下单后,把整段 CSR 粘贴进去
# -----BEGIN CERTIFICATE REQUEST----- ... -----END CERTIFICATE REQUEST-----
若 CAA 里残留 0 issue "sectigo.com" 而你向 Let’s Encrypt 下单,会直接收到 CAA record for example.com prevents issuance。先用 --dry-run 打 staging 环境,避免触发正式环境的速率限制(Let’s Encrypt 为每注册域名每周 50 张)。
步骤 4 · 配置 DCV 并等待校验
| 维度 | HTTP-01 | DNS-01 |
|---|---|---|
| 能否签通配符 | 不能 | 能,唯一方式 |
| 前置条件 | 80 端口公网可达,路径 /.well-known/acme-challenge/ 返回 200 |
能写 _acme-challenge.example.com 的 TXT |
| 建议 TTL | 不涉及 | 60 秒 |
| 典型出证时间 | 1–10 分钟(DV) | 1–10 分钟(DV) |
| 高频报错 | Invalid response ... 301(HTTP 被强制跳转 HTTPS) |
NXDOMAIN / TXT 未刷新 |
# HTTP-01:确认 token 文件可被匿名访问
curl -I http://example.com/.well-known/acme-challenge/test-token
# DNS-01:换公共解析器确认记录已生效,再触发校验
dig +short TXT _acme-challenge.example.com @1.1.1.1
OV/EV 证书还要走组织信息核验甚至电话回访,通常 1–3 个工作日;DV 证书在 DNS 生效后基本是分钟级。
步骤 5 · 下载并校验证书链
# 三个文件:domain.crt(叶证书)、chain.crt(中间证书)、fullchain.crt(两者拼接)
openssl verify -untrusted chain.crt domain.crt
# 期望输出:domain.crt: OK
grep -c "BEGIN CERTIFICATE" fullchain.crt # 期望 >= 2,只有 1 说明中间证书缺失
缺失中间证书时,桌面 Chrome 往往正常(会走 AIA 补链),但部分 Android 版本与 Java 客户端会抛 PKIX path building failed: unable to find valid certification path。这类问题在签发环节不报错,只在终端用户那里爆发,所以必须在校验环节堵住。
步骤 6 · 归档登记并设定续期提醒
openssl x509 -noout -fingerprint -sha256 -in domain.crt
# SHA1 Fingerprint=... 之外,新版 OpenSSL 输出形如:
# sha256 Fingerprint=3A:1F:...:9C
openssl x509 -noout -dates -subject -issuer -in domain.crt
# notBefore=... notAfter=... subject=CN = example.com issuer=C = US, O = Let's Encrypt, CN = R11
把 CSR、SHA-256 指纹、Not After、验证方式(HTTP-01/DNS-01)、CA 名称写入 CMDB。提醒阈值按 CA 区分:Let’s Encrypt 建议到期前 30 天续期(其官方推荐在剩余 1/3 生命周期时续),商业 CA 因人工审核环节建议留 45 天。另需注意 CA/Browser Forum 的 SC-081 已确定分阶段缩短证书最长有效期(2026 年 3 月起 200 天,2029 年起 47 天),把有效期当成可配置项而非常量写死在监控脚本里,能省掉一次全站告警。
命令与配置示例:OpenSSL 3.x、certbot 3.x、acme.sh 3.0.9 可直接复制
为什么要把版本号写进命令里?因为 SSL 证书申请流程里最常卡住的往往不是域名验证本身,而是工具的“默认值”。-addext 是 OpenSSL 1.1.1 才加入的选项;据 OpenSSL 官方 man req 文档,1.0.2 及更早版本遇到它时会直接报 req: Unknown option or ciphersuite -addext。而 acme.sh 3.0.9 的默认 CA 已不是 Let’s Encrypt(默认 ZeroSSL),不显式加 --server 就会签出一张来源不符合预期的证书。
OpenSSL 3.0 / 3.2 生成 RSA 私钥 + 带 SAN 的 CSR:-nodes 意为私钥不加密(no DES),便于无人值守续签;-sha256 在 3.x 已是默认摘要,写出来只为兼容 1.1.1 脚本。
# 适用 OpenSSL 1.1.1 / 3.0 / 3.2;RSA 2048 是 CA/B Forum 基线要求
openssl req -new -newkey rsa:2048 -sha256 -nodes
-keyout example.com.key -out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Tech/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
# 自检:现代浏览器只看 SAN,CN 已不再作为身份依据
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
1.0.2 环境需改用配置文件:在 openssl.cnf 中定义 [req_ext] subjectAltName = @alt_names,并在 [req] 里加 req_extensions = req_ext,否则签出的证书只含 CN、Chrome 会报 NET::ERR_CERT_COMMON_NAME_INVALID。
ECDSA P-256 版本:证书体积约为 RSA 2048 的三分之一,握手更快。
openssl ecparam -genkey -name prime256v1 -out example.com.ec.key
openssl req -new -sha256 -key example.com.ec.key -out example.com.ec.csr
-subj "/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
# 期望输出 "Public-Key: (256 bit)"
openssl req -in example.com.ec.csr -noout -text | grep "Public-Key"
acme.sh 3.0.9 两条主流路径(其 --keylength 长期默认 2048,要 ECDSA 必须显式写 ec-256):
# HTTP-01:-w 必须是 80 端口实际对外服务的文档根
acme.sh --issue -d example.com -d www.example.com -w /var/www/html
--keylength ec-256 --server letsencrypt
# DNS-01 通配符:先在阿里云 RAM 授予 AliyunDNSFullAccess
export Ali_Key="LTAI5t******"
export Ali_Secret="******"
acme.sh --issue --dns dns_ali -d example.com -d "*.example.com" --keylength 2048
certbot 3.x 的 webroot 方式:据 Certbot 变更日志,2.0 起默认密钥类型已改为 ECDSA/secp256r1,这里显式写出以防旧脚本回退。
# --staging 走 Let's Encrypt 测试环境;调试通过后仅删掉该参数重跑
certbot certonly --webroot -w /var/www/html
-d example.com -d www.example.com
--key-type ecdsa --elliptic-curve secp256r1
--preferred-challenges http --staging
加 --staging 的原因是限速:据 Let’s Encrypt 文档,同一注册域名的 Duplicate Certificate 上限为每周 5 张,Failed Validation 为每账号每主机名每小时 5 次,反复调试极易撞线。
域名验证前后必做的查询三连:
# 1. CAA 是否放行 Let's Encrypt;无返回表示未配置(默认允许)
dig +short CAA example.com @8.8.8.8 # 期望 0 issue "letsencrypt.org"
# 2. DNS-01 的 TXT 是否已传播;可能返回多条,全部都会被校验
dig +short TXT _acme-challenge.example.com @1.1.1.1
# 3. 证书链自校验
openssl verify -untrusted chain.crt domain.crt # 期望 domain.crt: OK
TXT 未生效时 acme.sh 会打印 _acme-challenge.example.com:Verify error:DNS problem: NXDOMAIN,本质是权威 NS 尚未刷新,而非凭证错误,等 TTL 过后重试即可。
| 方式 | 适用版本 | 密钥默认值 | 验证方式 | 典型卡点 |
|---|---|---|---|---|
| OpenSSL 手工 CSR | 1.1.1 / 3.0 / 3.2 | 由 -newkey 指定,无默认 |
CA 侧另行验证 | 漏写 SAN,CN 被浏览器忽略 |
| acme.sh | 3.0.9 | 2048(RSA) | HTTP-01 / DNS-01 | 默认 CA 非 LE,缺 --server |
| certbot | 3.x | ecdsa / secp256r1 | http / dns / tls-alpn-01 | webroot 路径与真实文档根不符 |
申请通道与域名验证方式怎么选?两张对比表
走到这一步,你已经拿到了 CSR,接下来的问题变成:把 CSR 交给谁签、用哪种方式证明域名归你所有。这两个选择决定了签发时长、能否签通配符、以及未来 90 天还是 365 天要重复一次运维动作。SSL证书申请流程里最容易”卡住”的环节,恰恰不是 CSR 生成,而是通道与验证方式错配——比如给 K8s Ingress 后面的服务选 HTTP-01,却忘了源站 80 端口并未对公网开放。
先看通道。下表价格为 2025 年公开报价区间,实际以 CA 官网为准。
| 申请通道 | 验证方式 | 签发时长 | 有效期 | 价格区间 |
|---|---|---|---|---|
| ACME(Let’s Encrypt / ZeroSSL) | HTTP-01、DNS-01、TLS-ALPN-01 | 1–5 分钟 | 90 天 | 0 元 |
| 云厂商免费 DV | DNS TXT、文件验证 | 5–30 分钟 | 12 个月(新规后 ≤200 天) | 0 元,单账号限 20 张/年 |
| 商业 CA DV | HTTP、DNS、邮件 | 10 分钟–2 小时 | 12 个月 | ¥0–300/年(单域名) |
| 商业 CA OV | 文件/DNS + 组织核验 | 1–3 个工作日 | 12 个月 | ¥800–3000/年 |
| 商业 CA EV | 组织核验 + 扩展核验 | 3–7 个工作日 | 12 个月 | ¥2000–8000/年 |
再看验证方式。据 Let’s Encrypt 文档《Challenge Types》,ACME 协议(RFC 8555)定义的三种挑战各有硬性网络前提:
| 验证方式 | 端口要求 | 支持通配符 | 自动化难度 | 典型失败原因 |
|---|---|---|---|---|
| HTTP-01 | 80(可 301 跳 443,最终须 200) | 否 | 低 | 404、CDN 回源改写、WAF 拦截 |
| DNS-01 | 无 | 是 | 中(需 DNS API) | TXT 未传播、CNAME 冲突、TTL 过长 |
| TLS-ALPN-01 | 443 独占 | 否 | 中 | Nginx 占用 443、SNI 分流 |
| 邮件验证 | 无 | 否 | 高(人工) | WHOIS 邮箱不可达、隐私保护屏蔽 |
选型结论一:HTTP-01 是成本最低的默认解。只要业务允许 80 端口入站且不需要通配符,一条 crontab 加 acme.sh --cron 即可全自动,不必申请 DNS API 权限,凭据泄露风险面更小。以 acme.sh v3.x 为例(默认 CA 为 ZeroSSL,建议显式切换):
# 1) 切换默认 CA 为 Let's Encrypt(acme.sh 默认是 ZeroSSL)
acme.sh --set-default-ca --server letsencrypt
# 2) webroot 模式签发:验证文件写入 /.well-known/acme-challenge/
acme.sh --issue -d example.com -d www.example.com
-w /var/www/html
--keylength ec-256 # 默认 2048 位 RSA;ec-256 证书更小
# 3) 安装证书并重载 Nginx(--reloadcmd 会在每次续期后执行)
acme.sh --install-cert -d example.com --ecc
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.pem
--reloadcmd "systemctl reload nginx"
# 4) 加入 crontab:acme.sh 在剩余 30 天时自动续期(Let's Encrypt 有效期 90 天)
0 3 * * * "/root/.acme.sh"/acme.sh --cron --home "/root/.acme.sh" > /dev/null
失败时最典型的一条报错是 Detail: Fetching http://example.com/.well-known/acme-challenge/xxx: Timeout during connect (likely firewall problem)——它几乎总是安全组或 CDN 回源规则的问题,而不是文件没写对。
选型结论二:多子域、K8s Ingress、CDN 后置源站这三类场景,DNS-01 更稳,因为它不依赖任何入站端口。代价是要为 DNS 服务商申请最小权限 API 子账号,只授予对应 zone 的 TXT 编辑权限:
# 以阿里云 DNS 为例(acme.sh 需 dns_ali 插件,v3.x 内置)
export Ali_Key="LTAI5t******" # 子账号 AK,仅授权该 zone 的解析记录写权限
export Ali_Secret="******"
acme.sh --issue --dns dns_ali
-d example.com -d '*.example.com'
--dnssleep 120 # 默认 120 秒;TTL=600 的解析商建议调到 180 以上
选型结论三:需要 OV/EV 品牌背书的,要预留人工核验时间。据 CA/Browser Forum Ballot SC-081,公开信任证书的最长有效期自 2026-03-15 起缩至 200 天、2027-03-15 起 100 天,因此即便是 12 个月的商业证书,也建议把续期纳入同一套自动化流程。OV/EV 需提前准备营业执照、组织英文名与可接听的固话——电话回访未接通常会直接拖慢 1 个工作日以上,这是 SSL证书申请流程在 OV/EV 通道上最常见的”隐形卡点”。
申请失败怎么排查?6 组真实报错与对应命令
Q1:报错 Detail: Invalid response from http://example.com/.well-known/acme-challenge/xxx: 404,怎么查?
按 RFC 8555(ACME 协议)规定,验证器会以 GET 请求该路径并期望拿到纯文本令牌;返回 404 意味着请求没落到你放的令牌文件上——要么 webroot 指错目录,要么被 rewrite/try_files 规则截走。
# 1. 手动放测试文件,验证「磁盘路径 → URL」的映射是否正确
mkdir -p /var/www/html/.well-known/acme-challenge
echo ok > /var/www/html/.well-known/acme-challenge/test
curl -I http://example.com/.well-known/acme-challenge/test # 期望 200,Content-Type: text/plain
# 2. Nginx 中该 location 必须排在所有伪静态/rewrite 之前;^~ 前缀匹配优先于正则 location
location ^~ /.well-known/acme-challenge/ {
root /var/www/html;
default_type text/plain;
try_files $uri =404; # 别让它落到 index.php 的 rewrite 上
}
# 3. 用同一 webroot 预演签发
certbot certonly --webroot -w /var/www/html -d example.com --dry-run
Q2:报错 DNS problem: NXDOMAIN looking up A for example.com?
dig +short A example.com @8.8.8.8 # 两个公共 DNS 交叉验证,排除本地缓存干扰
dig +short A example.com @1.1.1.1
dig +short AAAA example.com @8.8.8.8 # 有返回但主机无 IPv6 → 必须先删这条 AAAA
dig example.com +trace | tail -20 # 判断是权威未下发还是 TTL 缓存未过期
关键坑:Let’s Encrypt 验证器按 RFC 6724 做地址排序,IPv6 优先,AAAA 记录不可达时直接 connect timeout,不会回退 IPv4。所以「A 记录明明对」却报 NXDOMAIN/timeout,先删掉错误 AAAA 再重试。
Q3:报错 CAA record for example.com prevents issuance?
dig +short CAA example.com
# 若返回:0 issue "digicert.com"
# 需要追加(不是替换):0 issue "letsencrypt.org"
# 若返回:0 issue ";" 表示禁止任何 CA 签发,必须删除该条
依据 RFC 8659,多条 CAA 是并集关系,任一 issue 命中即可签发,因此不需要删原记录。
Q4:报错 Timeout during connect (likely firewall problem)?
# 从外网机器(不是本机)执行,本机 curl 通不算数
curl -v --connect-timeout 10 http://example.com/.well-known/acme-challenge/test
sudo ss -lntp | grep -E ':80|:443' # 本机是否真在监听
sudo ufw status verbose # 主机防火墙
# 云安全组入方向需放行 0.0.0.0/0 的 80/443(验证节点 IP 不固定,无法白名单)
# 前置 WAF/CDN 时确认未拦截 UA: "Mozilla/5.0 (compatible; Let's Encrypt validation server; +https://www.letsencrypt.org/docs/faq/)"
Q5:两类限速报错怎么区分?
| 报错原文 | 限速维度 | 阈值 | 处置 |
|---|---|---|---|
| too many failed authorizations recently | 每账户 / 每主机名 / 每小时失败验证 | 5 次 | 等 1 小时,期间改用 –dry-run |
| too many certificates (5) already issued for this exact set of domains in the last 168 hours | Duplicate Certificate(同一组域名) | 5 张 / 168 小时 | 等 7 天;调试期加 –staging 或 –dry-run |
据 Let’s Encrypt 官方 Rate Limits 文档,这两项为固定阈值且不可申请提额,--dry-run 走 staging 环境,不消耗生产配额。
Q6:Problem binding to port 80: Could not bind to IPv4 or IPv6 与 OV 名称报错?
sudo ss -lntp | grep ':80' # 通常是 nginx/apache 已占用
# 方案 A:改用 webroot,全程不碰端口
certbot certonly --webroot -w /var/www/html -d example.com
# 方案 B:临时让出 80
sudo systemctl stop nginx && certbot certonly --standalone -d example.com && sudo systemctl start nginx
OV/EV 场景若报 organization name does not match the official registry,需与营业执照登记全称逐字一致(含括号全半角、空格);CA/Browser Forum Baseline Requirements 要求组织信息与官方登记库匹配,CA 不会替你猜测简称。首次正式签发前建议始终先跑一遍 --dry-run。
怎么确认申请下来的证书是对的?5 项验收方法
证书签发成功不等于装对了。验收必须站在客户端视角做,而不是看服务商后台的”已签发”状态——下面 5 项依次覆盖身份、链路、协议、状态与可观测性,任何一项失败都会在特定客户端上变成真实故障。
1)主体与有效期:确认 CN、notBefore/notAfter 和 SAN 与申请单一致
# -servername 必填,否则 SNI 缺失会拿到默认虚拟主机的证书
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null
| openssl x509 -noout -subject -dates -ext subjectAltName
# 期望输出(示例):
# subject=CN = example.com
# notBefore=Mar 1 00:00:00 2026 GMT
# notAfter=May 30 23:59:59 2026 GMT
# X509v3 Subject Alternative Name:
# DNS:example.com, DNS:www.example.com
重点核对 SAN 是否含全部业务域名(现代浏览器只看 SAN,不看 CN,见 RFC 6125)。有效期方面,据 Let’s Encrypt 2025 年公告,除 90 天证书外已提供 6 天期 short-lived profile,2026 年越来越多站点在用,所以别再默认”一定是 90 天”。
2)证书链完整性:链上必须 ≥2 张证书
# 用系统根库验证服务器证书 + 中间证书(-untrusted 传中间证书)
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.crt domain.crt
# 期望:domain.crt: OK
# 数一数握手实际下发了多少张证书
openssl s_client -connect example.com:443 -showcerts /dev/null | grep -c "BEGIN CERTIFICATE"
# 返回 1 说明中间证书没配,Java 与 Android 7 以下会报:
# unable to find valid certification path to requested target / PKIX path building failed
注意 openssl s_client 默认不校验证书链,看到 “Verify return code: 0” 不代表链完整,必须配合 -verify_return_error 或上面的 openssl verify。Nginx 的 ssl_certificate 需把「服务器证书 + 中间证书」按顺序拼进同一文件。
3)协议与套件:TLS 1.2/1.3 可用,TLS 1.0/1.1 已关
openssl s_client -connect example.com:443 -tls1_2 &1 | grep -E "Protocol|Cipher"
openssl s_client -connect example.com:443 -tls1_3 &1 | grep -E "Protocol|Cipher"
openssl s_client -connect example.com:443 -tls1_1 &1 | head -2
# 期望第三条出现 handshake failure / no protocols available
TLS 1.0/1.1 已被 RFC 8996 正式弃用,OpenSSL 3.x 与主流发行版 crypto-policy 默认禁用。评分用 Qualys SSL Labs 官方 API(有速率限制,首次返回 IN_PROGRESS,需轮询):
curl -s "https://api.ssllabs.com/api/v3/analyze?host=example.com&publish=off&all=done"
| jq '.endpoints[] | {ipAddress, grade, statusDetails}'
# 目标 grade 为 A 及以上;出现 B/C 通常是开了 TLS 1.0/1.1 或缺 HSTS
4)OCSP Stapling:必须返回 successful
openssl s_client -connect example.com:443 -status /dev/null | grep -A1 "OCSP Response Status"
# 通过:OCSP Response Status: successful (0x0)
# 失败:OCSP response: no response sent
未装订时检查 Nginx 三件套:ssl_stapling on;、ssl_stapling_verify on;、ssl_trusted_certificate(需含中间证书),以及最常被漏掉的 resolver 8.8.8.8 valid=300s;——没有 resolver,Nginx 根本不会去取 OCSP 响应(机制见 RFC 6960)。
5)CT 日志与到期监控
# 确认证书已进 CT 日志(RFC 6962),Chrome 对未记录证书会告警
curl -s "https://crt.sh/?q=example.com&output=json" | jq -r '.[0] | "(.name_value) (.not_after)"'
# Prometheus 告警:blackbox_exporter 的 probe_ssl_earliest_cert_expiry 是秒级时间戳
# blackbox.yml -> modules..prober: http(v0.13+ 起提供该指标)
- alert: SSLCertExpiringSoon
expr: probe_ssl_earliest_cert_expiry - time() < 21 * 86400
for: 1h
labels: { severity: warning }
| 验收项 | 通过判据 | 失败典型信号 |
|---|---|---|
| 主体/有效期 | SAN 齐全,日期与申请一致 | SNI 缺失取到默认站证书 |
| 链完整性 | openssl verify 返回 OK,≥2 张 | PKIX path building failed |
| 协议 | TLS 1.2/1.3 通,1.0/1.1 拒 | SSL Labs 评分 B 及以下 |
| OCSP Stapling | Response Status: successful | no response sent |
| CT 与监控 | crt.sh 有记录,剩余 <21 天告警 | 证书静默过期 |
通配符、多域名、内网域名:申请边界与 4 个容易踩的坑
通配符证书到底覆盖哪些名字?为什么申请了 *.example.com,访问 example.com 仍报证书不匹配?
按 RFC 6125 与 CA/Browser Forum 基线要求,通配符只能替换标签最左侧的一级标签。*.example.com 匹配 a.example.com,不匹配 example.com 本身(标签数为 0),也不匹配 a.b.example.com(跨了两级)。因此实操中几乎总是把两条 SAN 放进同一张证书,一次覆盖主站与全部一级子域:
# acme.sh v3.x(LE 走 DNS-01,通配符强制要求 DNS-01,HTTP-01 会直接被拒)
acme.sh --issue --dns dns_cf
-d example.com -d "*.example.com" # 两条 SAN 写在同一张证书里
--keylength ec-256 # 默认 2048 位 RSA;EC 证书体积更小
# 签发后核对 SAN 是否两条都在(OpenSSL 1.1.1 / 3.x 通用)
openssl x509 -in /path/fullchain.pem -noout -text
| grep -A1 "Subject Alternative Name"
# 期望输出:DNS:example.com, DNS:*.example.com
# 验证覆盖边界:以下两条能过,a.b.example.com 必然失败
openssl verify -CAfile chain.pem -verify_hostname example.com cert.pem
openssl verify -CAfile chain.pem -verify_hostname a.example.com cert.pem
openssl verify -CAfile chain.pem -verify_hostname a.b.example.com cert.pem
# 报错样例:error 62 at 0 depth lookup: hostname mismatch
一张证书能同时放 *.a.com 和 *.b.com 吗?
能,但取决于 CA 产品形态。据 Let’s Encrypt 官方速率限制文档,单张证书 SAN 上限为 100 个名字(硬限制),且通配符与普通域名一样计入;同一注册域每周 50 张、重复证书每周 5 张。商业 CA 则按”主域数”卖,例如 3 主域通配产品可把 3 个 *.domain 放进同一张证书。注意 *.a.com 永远不能覆盖 *.b.com——通配符不能跨越注册域边界。
| 方案 | 典型签发方 | 一张证书可覆盖 | 域名验证 | 主要约束 |
|---|---|---|---|---|
| 单主域通配符 | Let’s Encrypt、ZeroSSL | example.com + *.example.com |
仅 DNS-01 | 不跨主域,不含二级子域 |
| 多域名通配符 | DigiCert、GlobalSign 等商业 CA | *.a.com、*.b.com 同证书 |
DNS-01 / 文件 / 邮件 DCV | 按主域数计费,需人工审核 |
| 内网私有 CA | step-ca、Vault PKI、Windows AD CS | *.corp.internal 等任意内部名 |
无需公网 DCV | 根证书必须经 GPO/MDM 下发 |
并发给多个子域申请时,为什么总报 “Incorrect TXT record found”?
因为所有子域的验证记录名都是同一个 _acme-challenge.example.com,多条 TXT 共存时 CA 可能读到上一条的值。真实报错形如 urn:ietf:params:acme:error:unauthorized :: Incorrect TXT record "xxxx" found at _acme-challenge.example.com。两种解法:
# 方案 A:CNAME 委派。把 _acme-challenge.example.com CNAME 到独立子域,
# 各子域用 --challenge-alias 指向各自的验证域,TXT 名不再冲突
acme.sh --issue --dns dns_cf -d "*.example.com" -d example.com
--challenge-alias verify.example.net # 该域需同样托管在支持的 DNS API 上
# Let's Encrypt 会跟随 _acme-challenge 的 CNAME(见 LE 官方文档 CNAME 支持说明)
# 方案 B:串行签发 + 手动确认。每条 TXT 写入后先 dig,确认全网可见再触发验证
dig +short TXT _acme-challenge.example.com @8.8.8.8
# 返回期望的字符串后再执行下一步,避免 CA 侧缓存读到旧值
acme.sh --issue --dns dns_cf -d "*.example.com" --dnssleep 120 # 秒;不指定时 acme.sh 轮询,通常 20 秒左右
.local / .internal 这类内网域名能申请公网证书吗?
不能。公网 CA 必须完成 DCV,内网名无公网权威解析,Let’s Encrypt 会直接返回 urn:ietf:params:acme:error:dns :: DNS problem: NXDOMAIN looking up A for host.internal。注意 .local 已被 RFC 6762 保留给 mDNS,.internal 也于 2024 年被 ICANN 正式划为私有用途,本就不该出现在公网 DNS。正确做法是内部 CA 签发:
# step-ca v0.25+:以内部根签发一张内网通配符证书
step ca certificate "*.corp.internal" corp.pem corp.key
--ca-url https://ca.corp.internal --root /etc/step/certs/root_ca.crt
--san "*.corp.internal" --san "corp.internal" --not-after 720h
# 根证书通过 GPO(计算机配置→策略→Windows 设置→受信任的根证书颁发机构)
# 或 MDM 配置描述文件下发,否则终端一律报 unable to get local issuer certificate
子域签发突然被拒,是 CAA 拦的吗?
很可能是。据 RFC 8659,CAA 查询采用 tree-climbing:先查 sub.example.com,无记录则上溯到 example.com、.com。所以在父域写死一条 issue "letsencrypt.org" 会同时约束全部子域;若某些子域要用商业 CA,必须在父域把所有 CA 都列进 issue,否则 Boulder 返回 urn:ietf:params:acme:error:caa :: CAA record for sub.example.com prevents issuance。
# 逐级排查 CAA(注意:+short 为空表示该级无记录,会继续上溯)
dig +short CAA example.com
dig +short CAA sub.example.com
# 允许 LE 与某商业 CA 并存的父域记录写法(iodef 用于接收违规告警)
example.com. 300 IN CAA 0 issue "letsencrypt.org"
example.com. 300 IN CAA 0 issue "digicert.com"
example.com. 300 IN CAA 0 iodef "mailto:security@example.com"
签发前的自检顺序建议固定为:SAN 清单是否含裸域 → CAA 是否放行目标 CA →
_acme-challenge是否 CNAME 委派 → 域名是否具备公网权威解析。这四步能拦掉本节提到的绝大多数失败场景。
DV 证书只需域名管理权(能改 DNS 或放验证文件),不需要任何证件;OV 需要营业执照扫描件、组织英文名与可接听的固话,CA 会做电话回访;EV 在 OV 基础上增加第三方核验,部分 CA 还要求律师函或邓白氏编码。个人站长申请 DV 即可,10 分钟内可完成。
不一定。HTTP-01 需要 80 端口可被公网访问,TLS-ALPN-01 需要 443 端口独占,而 DNS-01 完全不需要任何入站端口,只要求能添加 TXT 记录。服务器只放行 443、或套了 CDN 回源受限的场景,直接选 DNS-01 更省事。
Let's Encrypt 走 ACME 协议(RFC 8555),账户注册、下单、DCV、下载全程可脚本化,90 天有效期必须自动续期;商业 CA 需要控制台下单、粘贴 CSR、等待人工核验,OV/EV 还要提交组织材料,但有效期 12 个月、带组织身份信息与商业支持。流程复杂度差别主要在人工核验环节,而非技术难度。
这是 Let's Encrypt 的失败验证限速:每小时每账户每主机名最多 5 次失败。触发后等待 1 小时自动解除,期间不要反复重试。建议先用 –dry-run 或 –staging 在本地验证配置,确认 curl 能 200 返回验证文件后再正式提交。
Let's Encrypt 单证书 SAN 上限 100 个,且同一注册域名每周限签 50 张;商业 CA 按产品档位限制,单域名证书 1 个、多域名证书常见 5/10/50 个档位、通配符证书通常限 1 个主域但子域不限。超过上限就拆成多张证书,按业务域分组管理。
九成是中间证书没装。用 openssl s_client -connect example.com:443 -showcerts 看输出证书数量,只有 1 张就是缺链,把 fullchain.crt(站点证书 + 中间证书)配到 ssl_certificate 即可。少数情况是客户端信任库过旧,或用了自签根未下发。
Let's Encrypt 有效期 90 天,建议到期前 30 天自动续期,acme.sh –cron 与 certbot renew 默认就是这个窗口。商业 CA 目前 12 个月,但按 CA/Browser Forum SC-081 决议,2026-03-15 起最长 200 天、2027-03-15 起 100 天,续期提醒阈值要跟着改。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。