跳到主要内容

Let’s Encrypt 签发失败 Failed authorization / Timeout during connect:根因排查与完整修复指南

问题背景:HTTP-01 验证失败的根因定位

Let’s Encrypt 签发证书时,CA 会从境外多个验证节点主动回连你的域名。ACME 协议规定,HTTP-01 挑战要求 CA 能访问 http://你的域名/.well-known/acme-challenge/<token> 并读到一段指定的 key authorization 文本。只要这个请求在 CA 侧超时或被拒绝,签发就会中止,日志里出现典型报错:

Failed authorization procedure. example.com (http-01):
urn:ietf:params:acme:error:connection :: The server could not connect to
the client to verify the domain :: Fetching
http://example.com/.well-known/acme-challenge/9Xy...: Timeout during
connect (likely firewall problem)

根因可以归为五类,按出现频率排序:

  • 80 端口未在公网放行:云厂商安全组、firewalld/iptables、Docker 端口映射、运营商封禁 80(国内未备案域名常见)。
  • 强制 HTTP→HTTPS 跳转:server 级别的 return 301 会在 location 匹配前执行,验证文件请求被 301 到 https,若 443 上用的是自签或过期证书,链条直接断裂。
  • AAAA 记录指向不可达 IPv6:CA 优先走 IPv6,服务器只监听 IPv4 时表现为超时,最容易被误判成“防火墙问题”。
  • CDN / WAF 回源拦截:Cloudflare 橙云代理、“Always Use HTTPS”、宝塔或安全狗拦截 /.well-known/ 路径。
  • 境外访问受限:国内服务器对境外 IP 做了地域封禁,或 DNS 只在部分线路解析生效。

先看日志再动手,能省一半时间:tail -50 /var/log/letsencrypt/letsencrypt.log;acme.sh 用 --debug 2 复现。同时打开 letsdebug.net 输入域名做在线诊断,它会明确告诉你卡在 TCP 连接、HTTP 状态码还是 DNS 解析,比盲猜快得多。

第一步:确认 80 端口从公网真实可达

不要只看 systemctl status nginx,要做端到端验证。以下命令在服务器上执行:

ss -lntp | grep ':80'      # 必须看到 0.0.0.0:80 或 *:80,只有 127.0.0.1:80 就是问题
mkdir -p /var/www/html/.well-known/acme-challenge
echo 'acme-test-ok' > /var/www/html/.well-known/acme-challenge/test
curl -s http://127.0.0.1/.well-known/acme-challenge/test
curl -s -4 http://example.com/.well-known/acme-challenge/test
curl -s -6 http://example.com/.well-known/acme-challenge/test   # 有 AAAA 记录时必须测

本机 curl 通不代表 CA 能通,还要从外部视角验证。用手机 4G 热点访问同一 URL,或用 curl --resolve example.com:80:服务器IP http://example.com/.well-known/acme-challenge/test 绕过 CDN 直连源站。返回 404 说明端口通了但 webroot 路径不对;返回超时说明是网络层被拦。

放行防火墙(CentOS/Ubuntu 通用):

firewall-cmd --permanent --add-service=http && firewall-cmd --reload
ufw allow 80/tcp
iptables -I INPUT -p tcp --dport 80 -j ACCEPT
iptables-save > /etc/sysconfig/iptables

云服务器必须在控制台安全组或网络 ACL 里额外放行 80 入方向,这是最常见的一处遗漏——很多人在系统内开了防火墙,却忘了安全组。Docker 部署的站点注意 docker run -p 80:80 是否绑定到 0.0.0.0,只绑 127.0.0.1 时外部永远连不上。

如果确认域名配了 AAAA 但服务器没有可用 IPv6,最快办法是到 DNS 服务商删除该 AAAA 记录,或在 Nginx 中加 listen [::]:80; 让 IPv6 也监听。验证方式:dig +short AAAA example.com 返回为空即已排除该因素。

第二步:正确处理 HTTP→HTTPS 跳转与 Nginx 配置

很多站点为了 SEO 做了全站 301,导致验证文件请求被重定向。certbot 的 nginx 插件会自动注入例外 location,但用 --webroot 或手工配置时,必须自己保证 /.well-known/acme-challenge/ 在 80 端口直接返回 200。关键点:不要在 server 块顶层写 return 301,它会在 location 匹配之前执行,任何 location 例外都无效。

server {
    listen 80;
    listen [::]:80;
    server_name example.com www.example.com;

    # 验证路径优先匹配,且不跳转
    location ^~ /.well-known/acme-challenge/ {
        root /var/www/html;
        default_type text/plain;
        try_files $uri =404;
    }

    location / {
        return 301 https://$host$request_uri;
    }
}

改完执行 nginx -t && nginx -s reload,再本地验证:

curl -i http://example.com/.well-known/acme-challenge/test
# 期望 HTTP/1.1 200 OK 与 acme-test-ok,出现 301 就是配置没生效

Apache 等价配置:

<VirtualHost *:80>
    ServerName example.com
    DocumentRoot /var/www/html
    RewriteEngine On
    RewriteCond %{REQUEST_URI} !^/.well-known/acme-challenge/
    RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L]
</VirtualHost>

用了 CDN 的话,先把域名切回“仅 DNS”(Cloudflare 灰云),并关闭 Always Use HTTPS 与 Automatic HTTPS Rewrites,签发完成后再打开代理。若源站只允许 CDN 回源 IP 访问,必须临时放行全部,否则 CA 的验证节点会被挡在门外——这类场景其实更适合直接改用 DNS-01,避免每次续期都要改一次安全策略。

第三步:用 certbot 与 acme.sh 完整签发(命令可直接执行)

先装工具并做 dry-run,staging 环境不计入失败限流:

apt install -y certbot python3-certbot-nginx   # Debian/Ubuntu
dnf install -y certbot python3-certbot-nginx   # RHEL 系
certbot certonly --webroot -w /var/www/html 
  -d example.com -d www.example.com 
  --agree-tos -m admin@example.com --no-eff-email --dry-run

dry-run 通过后去掉 --dry-run 正式签发。80 端口被其他程序占用时可临时用 standalone:

systemctl stop nginx
certbot certonly --standalone -d example.com --agree-tos -m admin@example.com
systemctl start nginx

acme.sh 版本(无 Python 依赖,国内服务器更常用):

curl https://get.acme.sh | sh -s email=admin@example.com
source ~/.bashrc
~/.acme.sh/acme.sh --set-default-ca --server letsencrypt
~/.acme.sh/acme.sh --issue -d example.com -d www.example.com 
  -w /var/www/html --debug 2

--debug 2 会把完整的 ACME 请求与响应打到终端,比翻日志快;不加参数的 --debug 只有一级信息。签发成功后安装证书并配置续期后重载:

~/.acme.sh/acme.sh --install-cert -d example.com 
  --key-file /etc/nginx/ssl/example.com.key 
  --fullchain-file /etc/nginx/ssl/example.com.pem 
  --reloadcmd 'systemctl reload nginx'

注意 Let’s Encrypt 证书有效期固定为 90 天,公开信任证书的最长有效期上限为 398 天,因此任何“一年期免费证书”的说法都不成立。certbot 会安装 certbot.timer(每天两次)在到期前 30 天自动续期,acme.sh 会写入 crontab,用 crontab -l | grep acme 确认。手工续期不可持续,务必把自动续期纳入验收范围。

第四步:80 端口不可用时改用 DNS-01 验证

当服务器在 NAT 后、80 端口被运营商封禁、或需要通配符证书(*.example.com)时,HTTP-01 无法完成,必须走 DNS-01:CA 要求你在 _acme-challenge.example.com 添加一条指定值的 TXT 记录。通配符证书只能通过 DNS-01 申请,这是 ACME 协议的限制,没有绕过办法。

acme.sh 内置 100 多家 DNS 服务商 API,自动化程度最高。以 Cloudflare 为例,先建一个只对目标 zone 有 DNS:Edit 权限的 API Token:

export CF_Token='你的Token'
export CF_Account_ID='你的AccountID'
~/.acme.sh/acme.sh --issue --dns dns_cf 
  -d example.com -d '*.example.com' --debug 2

DNSPod(腾讯云)示例:

export DP_Id='123456'
export DP_Key='abcdef...'
~/.acme.sh/acme.sh --issue --dns dns_dp -d example.com -d '*.example.com'

凭据会被 acme.sh 保存到 ~/.acme.sh/account.conf,续期时自动复用,不必重新 export。手工验证(certbot)则需人工添加记录:

certbot certonly --manual --preferred-challenges dns -d example.com
dig +short TXT _acme-challenge.example.com   # 确认 TXT 已生效再回车

常见坑:一是 DNS 传播延迟,权威 DNS 未更新就提交会报 Incorrect TXT record,建议等 30–120 秒并用 dig @8.8.8.8 TXT _acme-challenge.example.com 复核;二是同一域名存在多条 TXT 时 CA 会全部读取,旧记录没删会校验失败;三是通配符 *.example.com 与 example.com 需分别写两个 -d,前者不覆盖后者。

三种 ACME 验证方式对比与选型

对比项 HTTP-01 DNS-01 TLS-ALPN-01
依赖端口 80/TCP 必须公网可达 无需任何入站端口 443/TCP
支持通配符 否 是(唯一支持) 否
是否需要 DNS API 不需要 自动续期场景需要 不需要
内网 / NAT 服务器 不可用 可用 不可用
CDN 开启代理 常被拦截 不受影响 常被拦截
证书覆盖范围 仅当前域名 域名加泛域名 仅当前域名
自动化难度 低 中(首次配置 API) 中

选型建议:单域名加 80 端口干净的公网服务器,用 HTTP-01 最省事;国内服务器、云 WAF 之后、NAT 环境、需要泛域名,直接上 DNS-01,一次配置长期免维护。TLS-ALPN-01 适合 80 被封但 443 可用的场景,certbot 用 --preferred-challenges tls-alpn-01,注意它要求 443 由验证程序独占,Nginx 需短暂停掉。

续期策略也要跟着选型走。HTTP-01 的失败通常是“环境变了”(安全组改动、CDN 重新开代理),所以续期失败告警比首次签发更重要;DNS-01 的失败通常集中在 API Token 过期或权限被收窄,建议给 Token 设到期提醒。无论哪种方式,都应在监控里对 443 端口证书剩余天数做告警,阈值设 21 天,早于自动续期窗口暴露问题。

常见报错与逐条排查

把日志里的 detail 字段抓出来,报错信息本身就指明了方向:

grep -E 'error|detail|Timeout|Invalid response' /var/log/letsencrypt/letsencrypt.log | tail -30
报错片段 根因 处理
Timeout during connect (likely firewall problem) 80 端口不可达 查安全组、iptables、AAAA 记录
Connection refused 服务未监听 80 ss -lntp | grep :80
Invalid response … 404 webroot 路径不匹配 确认 -w 与 Nginx root 一致
Invalid response … 301/302 跳转未放行验证路径 调整 location 优先级,去掉 server 级 return
DNS problem: NXDOMAIN A/AAAA 未解析或解析线路不全 dig +short A example.com
too many failed authorizations recently 触发失败限流 停手 1 小时,改用 –dry-run
Incorrect TXT record found DNS 未传播或存在旧记录 删旧 TXT,等 TTL 后重试

几个高频细节:301 报错往往伴随 Fetching https://...: Error getting validation data,说明请求被跳到 https 而 443 用的是自签证书,先修跳转再签;限流报错的窗口通常是每账号每域名每小时 5 次失败验证,正式环境反复失败会锁死一小时,务必全程用 --dry-run 调试;NXDOMAIN 要检查是否刚改 NS 还没生效,dig @8.8.8.8 example.com 与本地解析器结果可能不同。

如果日志里什么都没写,加详细模式:certbot 用 certbot certonly ... -v --debug-challenges(会暂停等你检查 challenge 文件),acme.sh 用 --debug 2。同时用 letsdebug.net 交叉验证,它能区分“TCP 连不上”和“HTTP 返回码不对”这两类完全不同的故障,避免在错误方向上浪费时间。

效果验证:证书、链路与自动续期

签发成功后先看证书本身,确认签发者、有效期与 SAN 列表:

certbot certificates
openssl x509 -in /etc/letsencrypt/live/example.com/cert.pem -noout 
  -subject -issuer -dates -ext subjectAltName
~/.acme.sh/acme.sh --list

再验证线上链路是否真的加载了新证书(服务器上的文件对不代表浏览器看到的对,中间可能还有 CDN):

echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -issuer -dates
curl -sSI https://example.com | head -1
curl -sS https://example.com/.well-known/acme-challenge/test -o /dev/null -w '%{http_code}n'

期望输出 issuer=C = US, O = Let's Encrypt, CN = R11(中间证书名称随批次变化),notAfter 距今约 90 天。若仍显示旧证书或自签证书,检查 Nginx 的 ssl_certificate 是否指向 fullchain.pem——只配 cert.pem 会导致部分客户端链不完整,报 unable to get local issuer certificate。

最后验证自动续期,这一步经常被跳过:

systemctl list-timers | grep certbot
certbot renew --dry-run
crontab -l | grep acme
~/.acme.sh/acme.sh --renew -d example.com --force

把 certbot renew --dry-run 的退出码接入监控(0 为正常),并对 443 端口证书剩余天数设置 21 天告警。做到这两点,才算真正解决了“签发失败”——因为 90 天后的续期失败,本质上是同一个问题在更糟的时间点复发,而那时线上业务已经在报证书过期了。

常见问题

本机 curl 走 127.0.0.1,绕过了安全组和 NAT。CA 从境外节点发起连接,需检查云安全组入方向是否放行 80、是否有地域封禁,以及域名是否配了不可达的 AAAA 记录导致优先走 IPv6 超时。可用 letsdebug.net 或手机热点从外部验证。

可以。CA 会跟随 301,但要求跳转后的 https 页面能返回验证内容且证书链可信,实践中很容易失败。更稳的做法是在 80 端口为 /.well-known/acme-challenge/ 单独配置 location 直接返回文件,并且不要用 server 级 return 301,避免在 location 匹配前就跳走。

ACME 规范规定泛域名只能通过 DNS-01 校验,因为 HTTP-01 无法证明你对所有子域名的控制权。申请时 *.example.com 与 example.com 要分别用 -d 指定,前者不包含后者。还需保证 _acme-challenge 的 TXT 记录已传播,否则报 Incorrect TXT record。

这是失败验证限流,通常每账号每域名每小时允许 5 次失败。立即停止正式签发,等待约 1 小时后重试,期间一律用 –dry-run(走 staging 环境,不计入限流)调试配置。反复失败会延长锁定时间,务必先定位根因再正式提交。

Let’s Encrypt 证书有效期固定 90 天,公开信任证书最长不超过 398 天。certbot 通过 certbot.timer 每天两次检查,到期前 30 天自动续期;acme.sh 安装时写入 crontab。不建议手动续期,但必须定期执行 certbot renew –dry-run 验证续期链路仍可用。