跳到主要内容
安装配置教程

SSL 证书安装教程免费版:certbot 4.0 与 acme.sh 3.1 走通 HTTP-01/DNS-01 全流程

ssl证书 安装教程免费版 — SSL 证书安装教程免费版:certbot 4.0 与 acme.sh 3.1 走通 HTTP-01/DNS-01 全流程
核心结论

免费版 SSL 证书安装的本质,是用 ACME 客户端(certbot 4.0 或 acme.sh 3.1.0)向 Let's Encrypt 申请 90 天 DV 证书,通过 HTTP-01(80 端口)或 DNS-01(TXT 记录)完成域名验证,再把 fullchain.pem 与 privkey.pem 写进 Web 服务器并配好自动续期,全程 0 元,单域名从发起到签发通常 30–90 秒。 通配符 *.example.com 只能走 DNS-01,certbot 命令为 certbot certonly --dns-cloudflare --dns-cloudflare-credentials /root/.secrets/cf.ini -d example.com -d '*.example.com',Cloudflare TXT 传播一般 5–30 秒,DNSPod 默认 TTL 600 秒需把 --dns-cloudflare-propagation-seconds 调大。 certbot 4.0 的续期由 certbot.timer 驱动,默认每天两次并带随机延迟,离场前必须跑 certbot renew --dry-run;acme.sh 则靠 crontab 里的 0 3 * * * 任务,默认剩余 60 天续期,--install-cert 不带 --reloadcmd 会导致续期成功但线上仍是旧证书。 Let's Encrypt 的速率限制是每注册域名 50 张/周、重复证书 5 张/周、验证失败 5 次/账户/主机名/小时,调试阶段一律加 --staging,否则 1 小时就能把自己锁死。 验收用 openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null,输出 Verify return code: 0 (ok) 且 notAfter 约为 90 天后才算真正生效;返回 21 (unable to verify the first certificate) 说明只配了 cert.pem 没配 fullchain.pem。

为什么免费版 SSL 证书安装大多卡在域名验证,而不是卡在安装

多数人把免费证书失败归因于“装”,实际上绝大多数卡在“签”。免费证书没有人工审核环节,CA 只验证域名控制权(DCV);按 RFC 8555 定义的 ACME 协议,DCV 通过三类挑战之一完成——选错挑战、或让挑战路径在公网不可达,失败就发生在签发阶段,而运维手上只剩一份“没有证书可装”的结果,排查方向从一开始就偏了。

挑战类型 CA 侧验证动作 依赖条件 最常见的失败现象
http-01 GET http://域名/.well-known/acme-challenge/<token> 80/TCP 从公网可达 404、301 跳 HTTPS、连接超时
dns-01 查询 _acme-challenge.域名 的 TXT 记录 记录已全局生效 TXT 未传播、CNAME 链未跟随;泛域名只能用这一种
tls-alpn-01 443 握手并协商 ALPN acme-tls/1 443/TCP 直通到 ACME 客户端 CDN/反代终止 TLS 后未透传 ALPN

http-01 踩坑最多:安全组拦 80、CDN 未回源放行、Nginx 的 try_files 把 /.well-known 重写到 index.html,都会让 CA 拿到 404 或 301。此时 certbot 报的通常是 Timeout during connect (likely firewall problem) 或 Invalid response from http://…: 404——它说的是“取不到文件”,不是“装不上证书”。

# 1) 从服务器外部探测:404 = 请求已到达 Nginx;000/超时 = 被安全组或 CDN 拦截
curl -sS -o /dev/null -w '%{http_code}n' http://example.com/.well-known/acme-challenge/test

# 2) 让 /.well-known 不被 try_files 重写(放在 server{} 内,位置优先于 try_files)
location ^~ /.well-known/acme-challenge/ {
    root /var/www/letsencrypt;        # 与 certbot --webroot -w /var/www/letsencrypt 保持一致
    default_type text/plain;
    try_files $uri =404;
}

# 3) 真正属于“安装”的一步:必须加载 fullchain.pem(叶子+中间证书),而不是 cert.pem
ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

只配 cert.pem 会在部分客户端触发 UNABLE_TO_VERIFY_LEAF_SIGNATURE 或 PHP cURL error 60——缺的是中间证书,不是服务器没装。

第二个高频误解是续期时点。据 Let’s Encrypt 文档,证书有效期固定 90 天,官方建议剩余 30 天时续期;certbot 4.0 起默认按 ARI(ACME Renewal Information,2025 年成为 RFC 9773)向 CA 询问建议窗口,实际续期可能早于第 60 天。所以“证书还剩 29 天为什么没续”不构成故障证据。

第三个是信任链。据 Let’s Encrypt 官方公告,2024-06-06 起默认签发链使用 ISRG Root X1 自签根,2025-06-05 完全停止 IdenTrust 交叉签名;Android 7.1.1 以下不信任 ISRG Root X1,这才是“新证书在旧手机上提示不安全”的常见根因,与安装动作无关。

还要认清产品定位:免费版只发 DV 证书,证书主体不含公司名称,地址栏不显示组织信息,需要 OV/EV 主体信息只能换商业证书。最后是额度:Let’s Encrypt 限制为每注册域名 50 张/周、完全相同的域名集合 5 张/周、验证失败 5 次/账户/主机名/小时,按这个额度反复重装三次以上就可能撞到重复证书限额——所以先修好 DCV,再谈重装。

七步实操:从零到 443 端口跑通一张免费证书

很多人搜“ssl证书 安装教程免费版”时拿到的是零散命令,粘完却卡在验证失败或续期不生效。下面这条七步路径在 certbot 4.0 与 acme.sh 3.1.0 上实测可走通 HTTP-01 与 DNS-01,每一步都给出可复制的完整命令与期望输出。

第 1 步:先查 DNS 与时钟,别急着装客户端。证书签发失败有相当比例不是客户端的问题,而是前置条件没满足。据 Let’s Encrypt 官方文档,HTTP-01 校验时验证节点会优先使用 AAAA 记录,所以“域名有 IPv6 但服务器没监听 80 端口”是最隐蔽的失败原因。

# 1) A 记录必须指向本机公网 IP
dig +short example.com @1.1.1.1        # 期望输出:203.0.113.10

# 2) 若返回非空且本机未监听 IPv6,HTTP-01 必然超时失败
dig +short AAAA example.com            # 期望:空输出

# 3) 三层防火墙都要放行,任何一层没开都会失败
firewall-cmd --list-ports              # 期望含 80/tcp 443/tcp
ufw status verbose                     # 期望含 80,443 ALLOW
# 云厂商安全组须在控制台单独放行,与上面两层互不覆盖

# 4) ACME 的 JWS 请求带时间戳,偏移过大直接判过期
chronyc tracking | grep 'System time'  # 期望:0.0000xx seconds fast/slow

第 2 步:按环境选客户端。仓库里的 python3-certbot 在 Debian/Ubuntu 上常停留在 2.x,要拿 4.0 请走 snap 或 pipx;acme.sh 3.x 默认 CA 已改为 ZeroSSL,签发前需显式切回 Let’s Encrypt。

维度 certbot 4.0 acme.sh 3.1.0
运行时依赖 Python 3.9+,snap/pipx 分发 纯 Shell,无 Python 依赖
安装方式 snap install --classic certbot curl https://get.acme.sh | sh
默认密钥 ECDSA P-256(2.0 起) 由 --keylength ec-256 指定
续期调度 systemd certbot.timer 安装时写入用户 cron
适用场景 有 root + systemd 的标准 VPS 容器、无 root、老系统
# 标准 VPS
snap install --classic certbot && ln -s /snap/bin/certbot /usr/bin/certbot

# 无 root / 容器内
curl https://get.acme.sh | sh -s email=ops@example.com
~/.acme.sh/acme.sh --set-default-ca --server letsencrypt  # 3.x 默认 ZeroSSL,务必切回

第 3 步:80 端口可用时走 HTTP-01。Nginx 已在跑就交给插件自动改配置,不想被改就用 webroot,证书固定落在 /etc/letsencrypt/live/example.com/。

certbot --nginx -d example.com -d www.example.com 
  --key-type ecdsa --elliptic-curve secp256r1 
  --deploy-hook "systemctl reload nginx"

# 或者只签发、不动 Nginx 配置
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com
ls -l /etc/letsencrypt/live/example.com/   # fullchain.pem / privkey.pem / chain.pem

第 4 步:80 端口被封或要通配符,切 DNS-01。通配符 *.example.com 只能通过 DNS-01 签发,这是 RFC 8555 的硬性约束。Cloudflare Token 只授予 Zone:DNS:Edit 权限,文件权限收到 600。

mkdir -p /root/.secrets && chmod 700 /root/.secrets
printf 'dns_cloudflare_api_token = %sn' "$CF_TOKEN" > /root/.secrets/cf.ini
chmod 600 /root/.secrets/cf.ini

apt install -y python3-certbot-dns-cloudflare
certbot certonly --dns-cloudflare 
  --dns-cloudflare-credentials /root/.secrets/cf.ini 
  -d example.com -d '*.example.com' 
  --dns-cloudflare-propagation-seconds 30   # 默认 10s,TXT 生效慢时调大

# acme.sh 等价写法
export CF_Token="xxx"
~/.acme.sh/acme.sh --issue --dns dns_cf -d example.com -d '*.example.com'

第 5 步:确认私钥权限。privkey.pem 默认 600 root:root,fullchain.pem 为 644。别为了让 Nginx worker 读私钥去 chmod 644——master 进程以 root 启动时会自行读取;容器场景用只读卷挂载 /etc/letsencrypt 即可。这条与 OpenSSL 文档对私钥文件权限的建议一致。

第 6 步:必须挂 deploy hook。续期成功后不重载 Nginx,线上仍是旧证书,这是“续期了但没生效”的第一大原因。

# certbot:写入 /etc/letsencrypt/cli.ini 后对所有证书生效
echo 'deploy-hook = systemctl reload nginx' >> /etc/letsencrypt/cli.ini

# acme.sh:安装证书时绑定 reloadcmd
~/.acme.sh/acme.sh --install-cert -d example.com 
  --key-file /etc/nginx/ssl/example.com.key 
  --fullchain-file /etc/nginx/ssl/example.com.fullchain.pem 
  --reloadcmd "systemctl reload nginx"

第 7 步:验收后再离场。不要以“签发成功”为终点,要验证自动续期链路本身能跑通。

systemctl enable --now certbot.timer
systemctl list-timers certbot.timer
certbot renew --dry-run      # 全绿(Congratulations, all simulated renewals succeeded)才算通过

# acme.sh
~/.acme.sh/acme.sh --cron --force && tail -n 20 ~/.acme.sh/acme.sh.log

若第 1 步时钟偏移超标,certbot 会返回 urn:ietf:params:acme:error:malformed 并提示 JWS has expired,此时先修 NTP 再重试,别反复重签消耗速率限制——据 Let’s Encrypt 文档,同一注册域名每周失败验证上限为 5 次。按上面七步走完,这份 ssl证书 安装教程免费版 的流程即可稳定复现,后续可扩展到 OCSP 装订、HSTS 预加载与证书透明度日志监控等主题。

可直接抄的配置与命令:certbot 4.0、acme.sh 3.1.0、Caddy 2.8.4

问:Nginx 1.24 / 1.26 上最少要写哪几行才能把证书挂上去?

据 Mozilla SSL Configuration Generator 的 intermediate 档位,TLS 1.2/1.3 的套件顺序交给 OpenSSL 3.0 默认值即可,不必手写 cipher list——手写反而会在 OpenSSL 升级后失效。真正必须显式声明的只有四项:

# /etc/nginx/conf.d/example.com.conf —— Nginx 1.24 与 1.26 通用
server {
    listen 443 ssl;
    # Nginx 1.24 写 "listen 443 ssl http2;";1.25.1+ 改为独立的 "http2 on;"
    server_name example.com;

    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

    ssl_protocols             TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers off;   # 让客户端选套件,TLS1.3 本就如此
    ssl_session_cache         shared:MozSSL:10m;
    ssl_session_tickets       off;
}

这份 ssl证书 安装教程免费版 的配置之所以不写 ssl_ciphers,是因为 Nginx 未设置时使用 OpenSSL 的 DEFAULT,已包含 Mozilla intermediate 推荐的 AEAD 套件;只有需要兼容老旧客户端时才降到 old 档位。

问:certbot 4.0 哪些参数值得记,默认值是多少?

# Ubuntu 24.04 / certbot 4.0,webroot 方式首次签发
certbot certonly --webroot -w /var/www/html -d example.com 
  --key-type ecdsa --elliptic-curve secp256r1   # P-256 证书体积约为 RSA 2048 的 1/4
  --staging                                     # 调试期必加,避开 Let's Encrypt 正式速率限制
  --deploy-hook "systemctl reload nginx"         # 仅在证书真正更新时触发
  • --key-type 默认 rsa;切到 ecdsa 后 --rsa-key-size(默认 2048)完全失效,别再同时传。
  • --elliptic-curve 默认 secp256r1,可选 secp384r1。
  • --must-staple 不建议新项目开启:据 Let’s Encrypt 2025 年公告,OCSP 响应服务正逐步关停,OCSP Stapling 的收益已明显下降。

问:acme.sh 3.1.0 怎么把证书直接落到 Nginx 目录?

acme.sh --issue -d example.com -w /var/www/html --keylength ec-256
acme.sh --install-cert -d example.com --ecc 
  --key-file       /etc/nginx/ssl/example.com.key 
  --fullchain-file /etc/nginx/ssl/example.com.crt 
  --reloadcmd      "systemctl reload nginx"

--install-cert 写入的路径与 reload 命令会被记住,之后每次 cron 续期都会自动复制并重载。--days 默认 60(最小 1),比 certbot 的 30 天更保守。

对比项 certbot 4.0 acme.sh 3.1.0 Caddy 2.8.4
调度载体 certbot.timer crontab 0 3 * * * 进程内自动续期
查看下次触发 systemctl list-timers | grep certbot crontab -l 无定时任务
续期阈值 剩余 30 天 剩余 60 天(--days) 剩余 1/3 有效期
证书落盘 /etc/letsencrypt/live/ 由 --key-file 指定 /var/lib/caddy/.local/share/caddy/certificates

问:容器里跑 certbot、根文件系统只读怎么办?

docker run --rm 
  -v /etc/letsencrypt:/etc/letsencrypt 
  -v /var/lib/letsencrypt:/var/lib/letsencrypt 
  -v /var/log/letsencrypt:/var/log/letsencrypt 
  -v /var/www/html:/var/www/html 
  certbot/certbot certonly --webroot -w /var/www/html -d example.com

只读根文件系统时,把 --config-dir、--work-dir、--logs-dir 三个参数全部指向可写卷;只挂 /etc/letsencrypt 会在写 /var/log/letsencrypt/letsencrypt.log 阶段失败,报 OSError: [Errno 30] Read-only file system。同理,部分容器镜像禁用了 cron,acme.sh 的 crontab 不会生效,需要包一层 systemd timer 或交给宿主机的 cron 调用。

问:有没有完全不用配置文件的写法?

# Caddyfile —— Caddy 2.8.4 自动完成 ACME 下单、HTTP-01 验证与续期
example.com {
    reverse_proxy 127.0.0.1:8080
}

据 Caddy 官方文档,域名写在站点块首行即触发自动 HTTPS,默认走 HTTP-01、失败回退 TLS-ALPN-01(RFC 8737)。代价是可观测性弱于 certbot:排查失败只能看 journalctl -u caddy,而 certbot 会留下完整的 ACME 交互日志。上面这份 ssl证书 安装教程免费版 的三种路径按需取用:已有 Nginx 就选 certbot 或 acme.sh,新项目直接反代则 Caddy 最省事。

选型对比:三种验证方式、三款客户端、三家免费 CA

决定装哪个客户端之前,先回答三个问题:域名能不能在 80 端口被公网访问?要不要通配符证书?这台机器装不装得上 Python?三个答案基本就把验证方式、客户端和 CA 定死了。下表可直接当决策表用。

表 1:三种 ACME 验证方式(依据 RFC 8555 与 RFC 8737)

验证方式 端口要求 通配符 典型失败原因与真实报错 适用场景
http-01 80 端口对公网可达,不能有 301 到 https 之外的跳转 不支持 防火墙未放行或 CDN 未回源:Timeout during connect (likely firewall problem);回源路径 /.well-known/acme-challenge/ 被拦截则返回 404 单机 Nginx/Apache、无通配符需求
dns-01 无端口要求,只需能写入 _acme-challenge 的 TXT 记录 支持 TXT 未传播完成:Incorrect TXT record found at _acme-challenge.example.com。Cloudflare 通常 5–30 秒生效,DNSPod 免费版默认 TTL 600 秒,需预留 10 分钟 通配符证书、内网机器、80 端口被封
tls-alpn-01 443 端口,验证端必须支持 ALPN 协议 acme-tls/1 不支持 SNI 分流把未知 SNI 丢给默认站点,或前置代理吞掉 ALPN:Cannot negotiate ALPN protocol "acme-tls/1" 80 被封但 443 直通、且无通配符需求

表 2:三款主流客户端

客户端 实现与依赖 续期驱动 默认 CA 最适合
certbot 4.0 Python,官方维护(EFF),可用 --nginx/--apache 自动改配置 systemd timer(certbot.timer,每日两次随机延迟) Let’s Encrypt 标准 VPS + 单机 Nginx/Apache,需要自动改 vhost
acme.sh 3.1.0 纯 Shell,零依赖,支持 100+ DNS API cron(安装时写入 0 0 * * *) ZeroSSL,需 --set-default-ca --server letsencrypt 切换 宝塔、群晖、OpenWrt、Alpine 容器等装不上 Python 的环境
Caddy 2.8.4 Go 单二进制,内置 ACME,零配置 进程内自动续期(到期前约 1/3 有效期触发) Let’s Encrypt 新项目、反向代理层,不想管证书生命周期

表 3:三家免费 CA

CA 有效期 通配符 速率限制 商业 SLA
Let’s Encrypt 90 天 支持(走 dns-01) 50 张/注册域名/周,同一组域名重复签发 5 张/周,失败验证 5 次/账户/主机名/小时 无
Buypass Go SSL 180 天 支持 比 LE 宽松,续期频率约为 LE 的一半 无
ZeroSSL 免费档 90 天 支持 免费账户对同时持有的证书数量与并发订单有限制(以官网为准) 无

动手前先花 30 秒摸清环境,比装完再排障便宜得多:

# 1) 确认 80 端口是否真的对公网可达(http-01 的前提,返回 404 也算通)
curl -sS -o /dev/null -w '%{http_code}n' http://example.com/.well-known/acme-challenge/test

# 2) 核对客户端版本,确保与本文一致
certbot --version   # 期望 certbot 4.0.0
acme.sh --version   # 期望 https://github.com/acmesh-official/acme.sh  v3.1.0
caddy version       # 期望 v2.8.4

# 3) 探测验证端是否放行 acme-tls/1(tls-alpn-01 的前提)
openssl s_client -connect example.com:443 -alpn acme-tls/1 /dev/null | grep -i 'ALPN protocol'

# 4) dns-01 轮询 TXT 传播,避免盲目 sleep
TOKEN=你的TXT值
until dig +short TXT _acme-challenge.example.com @1.1.1.1 | grep -q "$TOKEN"; do sleep 5; done

选型建议。单机 Nginx + systemd 选 certbot,它顺手把 vhost 改好;面板、嵌入式、容器选 acme.sh,因为 Alpine 镜像里装 Python 往往比证书本身更折腾;K8s Ingress 走 cert-manager(本文不展开);完全不想管生命周期就上 Caddy 或云负载均衡的托管证书。这三款客户端都能完成同一份 SSL 证书安装教程免费版流程,差别只在依赖和驱动方式,所以”ssl证书 安装教程免费版”里最常被忽略的一步恰恰是先确认自己属于哪一类环境。

成本维度。三家 CA 的证书费用都是 0 元,隐性成本全在运维时间:按每月一次续期排障、每次 10 分钟估算,一年约 2 小时人工。把 --deploy-hook(certbot)与 --reloadcmd(acme.sh)配置到位,并坚持每次改配置后跑 certbot renew --dry-run 或 acme.sh --cron --force,这项成本可以压到接近 0。据 Let’s Encrypt 官方文档,续期失败最常见的两个原因是 80 端口被防火墙关闭、以及 CDN 未回源放行验证路径——这也正是表 1 里 http-01 一行要放在最前面的原因。

签发失败先别急着重跑:Let’s Encrypt 的失败验证限额是每账户、每主机名、每小时 5 次,盲目重试只会把自己锁在门外一小时。下面按真实报错原文逐条拆解,每条给出定位命令和修法。

1)Detail: Invalid response from http://example.com/.well-known/acme-challenge/xxx: 404

挑战文件写到了磁盘,但 Nginx 没从那个目录读。两种成因:--webroot -w 指的目录与 server 块里的 root 不一致;或 SPA 的 try_files $uri /index.html 把 /.well-known/ 也兜底成首页。修法是把下面这段放在 server 块最前面,^~ 保证匹配后不再参与正则 location 竞争:

server {
    listen 80;
    server_name example.com;

    # 必须置于所有 location 之前;^~ 让正则 location 不再参与匹配
    location ^~ /.well-known/acme-challenge/ {
        root /var/www/html;      # 与 certbot -w 的路径逐字符一致
        default_type text/plain;
        try_files $uri =404;     # 阻断 SPA 的 index.html 兜底
    }
    location / { try_files $uri /index.html; }
}
# 验证:nginx -t && nginx -s reload
# certbot certonly --webroot -w /var/www/html -d example.com --dry-run

2)Problem binding to port 80: Could not bind to IPv4 or IPv6

--standalone 会自起一个临时 80 服务,端口被占即失败。先定位占用者:ss -ltnp | grep ':80b'。必须用 standalone 时先 systemctl stop nginx,签完再启;但生产站点会中断数十秒。更稳的做法是 --webroot 或 certbot 的 --nginx 插件(自动改配置并 reload),acme.sh 对应 --nginx 模式,全程无需停服务。

3)DNS problem: NXDOMAIN looking up A for example.com

NXDOMAIN 是权威 DNS 明确回答”记录不存在”,不是超时。逐级确认:

dig +trace example.com A       # 从根开始看在哪一级断掉
dig +short AAAA example.com    # 高频坑:只配了 AAAA 而主机未监听 IPv6

Let’s Encrypt 优先走 IPv6,AAAA 指向未开 80 端口的机器时验证必失败;删掉无用 AAAA 通常立刻恢复。本地缓存用 dig @8.8.8.8 绕过。

4)too many failed authorizations recently

撞上 5 次/账户/主机名/小时的失败上限(据 Let’s Encrypt Rate Limits 文档),只能等满一小时。调试期一律加 --staging,正式签发再切回生产目录;注意 staging 证书不受浏览器信任。

5)Error creating new order :: too many certificates (5) already issued for this exact set of domains

这是”完全相同域名集合”每周 5 张的重复证书限额,与失败次数无关。先查历史签发记录:

curl -s "https://crt.sh/?q=example.com&output=json" 
  | jq -r '.[].not_before' | sort -r | head

确认是否有人在反复重装并停掉该任务;确需立即上线,给域名集合加一个子域(如 www.example.com)错开限额。

6)acme.sh 报 Verify error 且日志出现 _authz_url

日志在 ~/.acme.sh/acme.sh.log。典型死循环:站点把 http 全量 301 跳 https,而 https 证书尚未签发成功。必须让 80 端口的挑战路径先放行、再跳转,顺序写反 ^~ 也救不了:

location ^~ /.well-known/acme-challenge/ { root /var/www/html; }
location / { return 301 https://$host$request_uri; }

7)nginx: [emerg] cannot load certificate … PEM lib

PEM 结构损坏,多为编辑器写入 BOM 或复制时混入杂字符。先验证文件本身再查配置:

openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -subject
head -c 3 /etc/letsencrypt/live/example.com/fullchain.pem | xxd  # 正常为 2d 2d 2d(---),efbbbf 即 BOM
nginx -t

certbot 4.0 的 live/ 下全是指向 archive/ 的符号链接,直接编辑会破坏续期链路,应重新签发或从 archive 取干净副本。

需求 certbot 4.0 acme.sh 3.1 说明
测试环境签发 --staging --staging(别名 --test) 不消耗生产限额
仅演练不落盘 --dry-run(隐含 staging) 无原生对应,用 --staging --issue --force dry-run 会完整跑一遍验证
指定站点根目录 -w /var/www/html -w /var/www/html 必须与 Nginx root 一致
列出已签发证书 certbot certificates acme.sh --list 排查重复签发先跑这条

ACME 协议层面的错误码含义可对照 RFC 8555 第 6.7 节;证书链与 TLS 参数问题可交叉参考 Mozilla SSL Configuration Generator 的推荐配置。

怎么确认免费证书真的生效:五条命令与三个在线验收

证书签发成功不等于线上生效。证书装错路径、漏拼中间证书、CDN 回源仍用旧证书,这几种情况在浏览器里可能只表现为“偶尔报错”,必须用命令逐层核对。以下五条命令按“从外到内”的顺序执行,再叠加三个在线验收,即可判断免费证书是否真的生效。

1)查看证书主体与有效期(据 OpenSSL 文档,-servername 用于发送 SNI,缺少它可能拿到默认站点证书):

# 取回证书链并解析 subject / issuer / 有效期
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | openssl x509 -noout -subject -issuer -dates
# 期望:notAfter ≈ 签发日 + 90 天(Let's Encrypt 现行有效期)
# issuer 应为 C=US, O=Let's Encrypt, CN=R10 或 R11(ECDSA 证书为 E5/E6)

2)验证证书链是否完整:

openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null
# 必须出现:Verify return code: 0 (ok)
# 若出现 21 (unable to verify the first certificate),说明漏配中间证书,
# 常见原因是只部署了 cert.pem,正确做法是 fullchain.pem(证书 + 中间证书)

3)确认协议版本与套件:

openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null | grep Protocol
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null | grep Protocol
# 反向确认老协议已关闭(预期握手失败):
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null
nmap --script ssl-enum-ciphers -p 443 example.com   # 列出实际协商套件,核对是否残留 CBC 老套件
检查项 命令 通过标准 常见失败信号
证书身份 s_client + x509 -subject -issuer 域名匹配,issuer 为 Let’s Encrypt R10/R11/E5/E6 CN 为默认站点或自签证书
链完整 -verify_return_error Verify return code: 0 (ok) 21 unable to verify the first certificate
协议版本 -tls1_2 / -tls1_3 / -tls1_1 1.2、1.3 通,1.1 拒 TLS 1.1 仍可握手
套件强度 nmap ssl-enum-ciphers 仅 AEAD(GCM/CHACHA20) 残留 CBC 套件
续期链路 certbot renew –dry-run 报告 dry run succeeded reloadcmd 未触发

4)三个在线验收:SSLLabs 取评级与链详情(curl "https://api.ssllabs.com/api/v3/analyze?host=example.com&all=done",注意首次分析需数分钟,返回 status: "IN_PROGRESS" 时轮询);crt.sh(https://crt.sh/?q=example.com)确认证书已进 CT 日志——这是判断“证书是否真的签发成功”的旁证,据 Let’s Encrypt 文档,所有签发的证书都会提交 CT 日志;Java 客户端另需 keytool -list -cacerts | grep -i isrg 确认信任库含 ISRG Root X1,否则报 PKIX path building failed。

5)续期与业务侧验证:certbot renew --dry-run 只走 staging、不写盘;acme.sh --cron --force 会强制跑一次续期,检查 /root/.acme.sh/acme.sh.log 中是否有 renew success 与 reloadcmd 执行记录。最后绕过 DNS 直连回源,确认线上拿到的就是你刚装的那张证书:

curl -vI https://example.com --resolve example.com:443:1.2.3.4
# 在输出中核对 subject / 有效期,排除 CDN 回源仍是旧证书

免费版证书的边界:哪些场景该考虑换方案

免费证书不是”装上就完事”,先问一句:你的续期链路断得起吗?Let’s Encrypt 证书有效期固定 90 天,官方在 Challenge Types 与 Integration Guide 文档中明确建议在剩余 30 天时续期——也就是说一年至少有 4 个窗口,任何一次失败都会在 90 天内演变成全站证书过期。certbot 4.0 的默认续期阈值正是 30 天(renewal 配置里的 renew_before_expiry = 30 days),下面这三条命令应当纳入日常巡检,而不是等告警才发现:

# 1) 列出所有证书的到期时间与 renewal 配置(certbot 4.0)
certbot certificates --cert-name example.com

# 2) 确认续期定时器真的在跑:Debian/Ubuntu 为 certbot.timer,RHEL 系为 certbot-renew.timer
systemctl list-timers --all | grep -i certbot

# 3) 演练续期,不写盘、不消耗速率限制;退出码 0 才算链路通畅
certbot renew --dry-run

链路断掉时的典型报错是 Failed authorization procedure ... urn:ietf:params:acme:error:unauthorized :: The client lacks sufficient authorization,九成来自 80 端口被防火墙策略、CDN 回源或容器端口映射改动。如果你的团队已经具备成熟的 CI/CD 与监控(续期失败能在 1 小时内告警),可以评估 Let’s Encrypt 已开放的短期证书 profile:6 天有效期、按有效期约 1/3 时刻续期,certbot 4.0 通过 ACME Profiles 扩展选择:

# 不指定时 profile 为 classic(90 天);shortlived 即 6 天短期证书,需 CA 端支持 profiles
certbot certonly --webroot -w /var/www/html -d example.com 
  --preferred-profile shortlived   # 6 天证书要求每天至少调度一次续期任务

OCSP 停用后,ssl_stapling 还值得开吗?据 Let’s Encrypt 官方公告,自 2025-01-30 起新签发证书不再包含 OCSP AIA 地址,OCSP responder 于 2025-05-07 关闭,全面转向 CRL(CA/Browser Forum 亦通过 SC-063 移除 OCSP 强制要求,CRL 机制见 RFC 5280 第 5 节)。nginx 的 ssl_stapling 默认值为 off,此前为降低握手延迟而开启的站点,现在应重新测量收益:

# 观察是否仍有 stapling 响应;Let's Encrypt 证书输出 "OCSP response: no response sent" 属正常
openssl s_client -connect example.com:443 -servername example.com -status /dev/null 
  | grep -A2 "OCSP response"
# nginx 若仍指向已失效的 OCSP,错误日志会出现
# "ssl_stapling ignored, issuer certificate not found" 或 OCSP 查询超时

内网和 IP 直连为什么装不上?主流免费 CA 只为公有 DNS 域名签发,公网 IP 与纯内网主机不在其签发范围,硬套 ACME 只会得到 urn:ietf:params:acme:error:rejectedIdentifier。这类场景应改用内部 PKI,例如 Smallstep step-ca 或 cfssl,签发 1 年期内部证书:

# 初始化私有 CA 并为一台内网主机签发证书(step-ca,适合 IP SAN 与长有效期)
step ca init --name "Internal CA" --dns ca.internal --address :9000 --provisioner admin
step ca certificate "intranet.internal" internal.crt internal.key 
  --san 10.0.0.10 --not-after 8760h   # 内网可控,1 年有效期显著降低轮换成本

通配符为什么是凭据风险点?通配符只能通过 DNS-01 验证,意味着 DNS 服务商 API Token 成为等同于”签发任意子域证书”的高价值凭据。建议在 Cloudflare 等平台创建仅含 Zone:DNS:Edit、且限定单一 Zone 的 Token,单独落盘并收紧权限:

# 凭据单独存放,目录 700、文件 600,避免被 web 目录、备份或镜像带走
install -d -m 700 /root/.secrets
install -m 600 /dev/null /root/.secrets/cf.env
printf 'export CF_Token="%s"n' 'TOKEN_VALUE' > /root/.secrets/cf.env
set -a; . /root/.secrets/cf.env; set +a
# acme.sh 3.1:自动将 Token 记入 ~/.acme.sh/account.conf,注意该文件的备份与外泄面
acme.sh --issue --dns dns_cf -d example.com -d '*.example.com' --keylength ec-256

什么情况下该换商业证书?当业务需要 OV/EV 的主体信息展示、需要发票与合同走采购流程、或需要可赔付的 SLA 时,免费 CA 天然无法满足——Let’s Encrypt 的 Service Agreement 明确不提供商业可用性承诺。下表可作为选型基线(价格为国内市场大致区间,随品牌与渠道浮动):

维度 免费 DV(Let’s Encrypt 等) 商业 DV 商业 OV/EV
最长有效期 90 天,可选 6 天 shortlived 通常 1 年 通常 1 年
主体信息核验 无 无 营业执照、电话核验
SLA 与赔付 无 有(按比例赔付) 有
吊销状态分发 仅 CRL 多数仍提供 OCSP 多数仍提供 OCSP
发票与合同 无 有 有
价格参考 0 元 100–800 元/年 800–3000 元/年

需要提醒的是,”买 1 年期证书少轮换”这个理由正在变弱:CA/Browser Forum 已通过 SC-081,证书最长有效期将在 2026-03-15 降至 200 天、2027-03-15 降至 100 天、2029-03-15 降至 47 天。换言之,无论免费还是商业证书,自动化续期与到期监控都是不可省略的基础设施,选型的真正差异在于主体信息、SLA 与采购合规,而不是”要不要做自动化”。

差在验证等级与保障条款,不在加密强度。免费版是 DV 证书,只验证域名控制权,密钥长度与 TLS 协议支持和付费 DV 完全一致;付费的 OV/EV 会核验企业主体并在证书里带上组织信息,同时附带商业 SLA 与赔付。需要地址栏显示公司名或需要合同发票时再考虑付费。

标准 VPS + systemd + Nginx 选 certbot 4.0,官方维护、systemd timer 省心、日志清晰;面板环境、Alpine 容器、OpenWrt 这类装不上 Python 的场景选 acme.sh 3.1.0,纯 Shell 零依赖。两者都支持 http-01 与 dns-01,功能上没有决定性差距,选团队更熟悉的那个。

能,改走 DNS-01。certbot 用 –dns-cloudflare 插件加 –dns-cloudflare-propagation-seconds 30,acme.sh 用 export CF_Token=xxx 后执行 acme.sh –issue –dns dns_cf -d example.com。DNS-01 还是申请通配符 *.example.com 的唯一途径,因为 http-01 无法验证未列出的子域。

这是触发了 Let's Encrypt 的验证失败限额:5 次/账户/主机名/小时。只能等满 1 小时再试,期间不要继续重试以免叠加。正确做法是先在测试环境用 certbot –staging 或 acme.sh –staging 把 404、跳转、防火墙问题全部排掉,再切回生产签发。

不需要手动。certbot 装完会启用 certbot.timer,默认每天两次带随机延迟自动检查;acme.sh 安装时写入 0 3 * * * 的 crontab,默认剩余 60 天时续期。你只需要保证 deploy hook 或 –reloadcmd 配好,并且定期看一次 certbot renew –dry-run 的结果。

先看 openssl s_client 的 Verify return code,返回 21 说明链不完整、只配了 cert.pem,改成 fullchain.pem 即可;返回 0 但仍告警,通常是页面里混入了 http:// 的资源(混合内容),或访问的是 www 子域而证书只签了裸域。老 Android 设备则要检查是否受 ISRG Root X1 信任问题影响。

因为 ACME 的 http-01 只能验证一个已解析的具体主机名,无法证明你控制整个域下的任意子域,所以 RFC 8555 规定通配符必须走 dns-01。命令上就是给 -d 参数加引号包住星号:certbot certonly –dns-cloudflare -d example.com -d '*.example.com',注意星号只覆盖一级子域,a.b.example.com 需要单独再签一张。


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

内容审核

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