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

免费SSL证书怎么配置?Let’s Encrypt、云厂商DV与Cloudflare三方案实操与验收

免费SSL证书怎么配置 — 免费SSL证书怎么配置?Let's Encrypt、云厂商DV与Cloudflare三方案实操与验收
核心结论

免费SSL证书怎么配置:在 Ubuntu 22.04 + Nginx 1.24 上执行 `sudo certbot --nginx -d example.com -d www.example.com --redirect`,约 2 分钟可签发 90 天 Let's Encrypt 证书并写入 443 配置;关键是 `ssl_certificate` 必须指向 `fullchain.pem` 而不是 `cert.pem`。 证书链不完整是免费证书“配了但浏览器报不安全”的首要原因:`openssl s_client -showcerts` 应看到至少 2 张证书,Nginx 的 `ssl_certificate` 使用 `/etc/letsencrypt/live/example.com/fullchain.pem`。 泛域名免费证书只能走 DNS-01:acme.sh 3.0.7 执行 `--issue --dns dns_ali -d example.com -d '*.example.com'`,Let's Encrypt 对同一注册域名每周限 50 张证书(据 Let's Encrypt 文档)。 配置后验收三项:`nginx -t` 返回 successful、`curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result}' https://example.com` 返回 `200 0`、`openssl s_client -status` 出现 `OCSP Response Status: successful`。

免费SSL证书怎么配置前,先弄清为什么“装上了”仍会报不安全?

很多人第一次配置免费证书时,都会遇到“浏览器地址栏已经显示小锁,但某些客户端或接口仍然报不安全”的情况。原因通常不在于证书没装上,而在于链不完整、校验路径不通或 TLS 参数没有显式配置。先弄清这三件事,再谈免费 SSL 证书怎么配置,能省掉大量返工。

三类免费证书到底差在哪?

来源 有效期 / 信任根 部署位置 典型限制
Let’s Encrypt(ACME) 90 天,链到 ISRG Root X1(RSA)/ X2(ECDSA) 你自己的 Nginx / Apache / 源站 仅 DV,需 80 或 DNS-01 验证;必须配置自动续期
云厂商免费 DV 常见 3 个月,单账号约 20 张/年(以各厂商控制台额度为准) 可下载后装到自建服务器,或绑定其 LB/CDN 额度与续期策略随厂商调整,跨云迁移需重新签发
Cloudflare Universal SSL 边缘证书,由 CF 自动管理 CF 边缘节点;源站可另配 15 年有效期的 Origin CA 证书 只覆盖 CF 代理的流量;源站与边缘之间默认是 Flexible 明文,需改成 Full (strict)

为什么 Nginx 装了证书还报 “unable to get local issuer certificate”?

据 RFC 5280,客户端必须能沿着“站点证书 → 中间证书 → 根证书”构建完整路径。浏览器会自动补链,所以看起来正常;但 Java 客户端、旧版 Android 和部分 API 网关不会补链,就会直接失败。诊断方法是看服务器实际发出了几张证书:

# -showcerts 会打印服务器发送的整条链;正常应有 2 段(站点证书 + 中间证书)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null 
  | grep -E '^ *[0-9]+ s:|i:'

# 正常输出示例(节选)
#  0 s:CN = example.com
#    i:C = US, O = Let's Encrypt, CN = R11
#  1 s:C = US, O = Let's Encrypt, CN = R11
#    i:C = US, O = Internet Security Research Group, CN = ISRG Root X1
# 若只有第 0 段,说明只发了 cert.pem,中间证书缺失

修复很简单:certbot 在 /etc/letsencrypt/live/<域名>/ 下同时生成 cert.pem(仅站点证书)和 fullchain.pem(站点 + 中间证书),Nginx 必须指向后者。这是 Let’s Encrypt 官方文档明确强调的一点。

server {
    listen 443 ssl;
    http2 on;                                  # Nginx 1.25.1+ 写法;旧版用 listen 443 ssl http2;
    server_name example.com;

    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;  # 关键:不要用 cert.pem
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;    # 权限应为 600
    ssl_protocols       TLSv1.2 TLSv1.3;       # 默认值随版本变化,显式声明更稳
    ssl_session_cache   shared:SSL:10m;
    ssl_stapling        on;                    # OCSP Stapling,需 ssl_trusted_certificate 或 fullchain
    ssl_stapling_verify on;
    add_header Strict-Transport-Security "max-age=31536000" always;  # HSTS,确认全站 HTTPS 后再开
}

其余 TLS 参数可直接套用 Mozilla SSL Configuration Generator 的 intermediate 基线,只需把证书路径替换为 fullchain.pem。

HTTP-01 验证为什么总是超时?

ACME 协议(RFC 8555)的 HTTP-01 要求 CA 能从公网访问 http://你的域名/.well-known/acme-challenge/<token> 并拿到 200。被 CDN 代理、安全组未放行 80 端口、或站点把 HTTP 301 到 HTTPS 而跳转链断裂,都会让 certbot 报 Timeout during connect (likely firewall problem)。签发前先自测:

# 应返回 200 或 404(404 说明端口通、只是 token 未生成),超时则说明链路被拦
curl -I --max-time 10 http://example.com/.well-known/acme-challenge/test
# 验证 DNS 是否已生效,A/AAAA 记录须指向本机公网 IP
dig +short example.com A

时间偏差也会让证书“失效”

服务器时钟偏差超过约 5 分钟,就会出现 certificate is not yet valid 或 OCSP 校验失败——免费证书有效期短,续期后更依赖准确时间。检查 timedatectl,System clock synchronized 与 NTP service 应为 yes/active,否则先 timedatectl set-ntp true。

最后提醒:免费 DV 只证明域名控制权,不核验企业身份。若合同要求 OV/EV,或需要国密 SM2 算法,Let’s Encrypt 无法满足,得转向 CFCA、TrustAsia 等 CA 的付费证书——这也是后面选型时最容易踩的坑。

免费SSL证书怎么配置的完整步骤:Ubuntu 22.04 + Nginx 1.24 + certbot 2.9

这一节把「免费 SSL 证书怎么配置」拆成可复制的六步链路:DNS 与端口就绪 → 装 certbot → dry-run 验证 → 正式签发 → 校验 Nginx 实际生效配置 → 续期钩子。全程以 Ubuntu 22.04 + Nginx 1.24 + certbot 2.9 为基准,命令可直接粘贴执行。

步骤一:先确认 DNS 与 80/443 端口真的通

Let’s Encrypt 的 HTTP-01 校验由 CA 从公网回连你的 80 端口,DNS 没生效或安全组没放行时,签发 100% 失败。先自查:

# 两条 A 记录都应返回服务器公网 IP,若为空说明解析未生效
dig +short example.com
dig +short www.example.com

# 确认 Nginx 已在监听 80/443(没有输出说明服务未起或监听在别的端口)
ss -lntp | grep -E ':80|:443'

# 本机自测 80 端口可达性,模拟 CA 的访问路径
curl -I http://example.com/.well-known/acme-challenge/test

据 Let’s Encrypt 官方文档,HTTP-01 校验只走 80 端口且不跟随跨域重定向;若你的站点已有强制 HTTPS 规则,需确保 /.well-known/acme-challenge/ 路径在 80 上可直接返回 200。

步骤二:装 certbot 与 nginx 插件,并核对版本

sudo apt update
sudo apt install -y certbot python3-certbot-nginx
certbot --version   # 目标:certbot 2.9.0

注意一个高频坑:Ubuntu 22.04(jammy)官方源里的 certbot 只有 1.21.0,版本对不上时不要硬撑,按下表换渠道。certbot 2.0 起默认密钥类型从 RSA 2048 改为 ECDSA P-256,握手更快、证书更小,这是升级的主要收益。

安装渠道 典型版本 说明
apt(Ubuntu 22.04 jammy) 1.21.0 默认 RSA 2048;无 snap 的离线环境可用
apt(Ubuntu 24.04 noble) 2.9.0 开箱即用,无需额外操作
snap install --classic certbot 2.9 / 2.10 / 最新 官方推荐,自动滚动更新;需 ln -s /snap/bin/certbot /usr/bin/certbot
ppa:certbot/certbot 最新稳定版 不想引入 snap 的 apt 用户替代方案

步骤三:先 dry-run,别拿正式环境试错

# --dry-run 走的是 staging 环境,不消耗正式配额
sudo certbot --nginx -d example.com -d www.example.com --dry-run

看到 The dry run was successful. 再进入下一步。失败时优先排查 80 端口与 DNS,不要连续重试正式签发:Let’s Encrypt 对「每个账户每主机名每小时 5 次校验失败」和「同一证书集每 168 小时 5 张」都有限流,报错形如:

Error creating new order :: too many failed authorizations recently: see https://letsencrypt.org/docs/rate-limits/

步骤四:正式签发并开启 301 跳转

sudo certbot --nginx -d example.com -d www.example.com 
  --agree-tos -m ops@example.com --redirect --no-eff-email
# --redirect 由 nginx 插件自动写入 301,把 http 永久跳到 https
# --no-eff-email 表示不订阅 EFF 邮件列表

证书落地在 /etc/letsencrypt/live/example.com/:fullchain.pem(叶证书 + 中间证书)与 privkey.pem(权限 600,仅 root 可读),两者都是指向 ../../archive/ 的软链,续期后自动更新指向。Nginx 配置里务必用 fullchain.pem 而非 cert.pem——缺中间证书会让部分 Android 与 Java 客户端报 unable to get local issuer certificate。

步骤五:验收 Nginx 真正加载的配置

sudo nginx -T 2>/dev/null | grep -A4 'server_name example.com'

输出中应同时出现 listen 443 ssl;、ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;、ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;。随后用 OpenSSL 直接验证链与有效期(据 OpenSSL 文档,-servername 用于 SNI):

openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | openssl x509 -noout -subject -issuer -dates
# 期望 issuer 含 R10/R11(Let's Encrypt 中间证书),有效期约 90 天

步骤六:配置续期后自动 reload

# 编辑 /etc/letsencrypt/renewal/example.com.conf,在 [renewalparams] 段追加一行
# renew_hook = systemctl reload nginx

# 验证定时器存在(certbot.timer 默认每日运行两次,带随机延迟)
systemctl list-timers | grep certbot
sudo certbot renew --dry-run   # 演练续期全流程,含 renew_hook

Let’s Encrypt 证书有效期 90 天,certbot 默认在剩余 30 天时续期。若用 snap 安装,定时器由 snap 自带,需 snap set certbot renew-hook=... 或依赖插件自动 reload;用 apt 安装则确认 certbot.timer 为 enabled。密码学参数(TLS 1.2/1.3、密码套件顺序)可对照 Mozilla SSL Configuration Generator 的 intermediate 配置补齐,与本节签发的 ECDSA 证书配合即可拿到 A 级评分。

免费SSL证书怎么配置的 3 组命令示例:certbot、acme.sh 泛域名、Cloudflare 源站

三种方式并不互斥,选型先看一个表:

方案 验证方式 泛域名 续期机制 典型坑
certbot + nginx 插件 HTTP-01 不支持 systemd timer 自动 renew 需 80 端口公网可达
acme.sh + DNS-01 DNS TXT 记录 支持 *.example.com cron 自动续期 + reloadcmd DNS API 密钥泄露风险
Cloudflare Origin CA 无需 ACME 可签泛域名 有效期 15 年,无需续期 仅 Cloudflare 回源可信

1)certbot 单/多域名最省事。据 Let’s Encrypt 官方文档,certbot 2.9 起 --nginx 插件会直接改写站点配置:写入 ssl_certificate / ssl_certificate_key,并在 80 端口的 server 块插入 301 跳转。所以别先手写 HTTPS 块,否则会出现重复配置导致 nginx -t 报 "duplicate listen options for 0.0.0.0:443"。

# certbot ≥ 2.9,Ubuntu/Debian 用 apt install certbot python3-certbot-nginx
sudo certbot --nginx -d example.com -d www.example.com 
  --redirect 
  --deploy-hook 'systemctl reload nginx'
# --redirect 写入 301;--deploy-hook 每次续期成功后执行,比依赖 cron 更可靠
# 干跑测试续期:sudo certbot renew --dry-run

2)泛域名只能走 DNS-01。acme.sh 3.0.7 用 DNS 别名模式,凭据通过环境变量传入,避免写进命令行历史:

# acme.sh 3.0.7;阿里云 DNS,其余厂商换成 dns_cf / dns_dp 等
export Ali_Key='LTAI...'
export Ali_Secret='...'
~/.acme.sh/acme.sh --issue --dns dns_ali 
  -d example.com -d '*.example.com' --keylength ec-256
# 安装并落地到 Nginx 可读路径,续期后自动 reload
~/.acme.sh/acme.sh --install-cert -d example.com --ecc 
  --key-file       /etc/nginx/ssl/example.com.key 
  --fullchain-file /etc/nginx/ssl/example.com.fullchain.pem 
  --reloadcmd      'systemctl reload nginx'

3)Nginx 手动片段(TLS 1.2/1.3 + OCSP Stapling)。ssl_prefer_server_ciphers off 是 Mozilla SSL Configuration Generator 的现代推荐值,让客户端(通常 AES 有硬件加速)决定套件顺序:

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_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305';
ssl_prefer_server_ciphers off;
ssl_session_cache   shared:SSL:10m;   # 默认 none
ssl_session_timeout 1d;               # 默认 5m
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;

HSTS 按 RFC 6797 建议先短后长,确认无混合内容再拉长,preload 不可逆:

# 灰度:300 秒,验证混合内容
add_header Strict-Transport-Security 'max-age=300; includeSubDomains' always;
# 稳定后(preload 需所有子域均支持 HTTPS)
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;

4)Cloudflare 源站证书。SSL/TLS 模式必须设 Full (strict),否则回源明文或自签会被降级。在控制台 SSL → Origin Server 创建 Origin CA 证书(可选 7 天至 15 年),把证书和私钥写入 Nginx 的 ssl_certificate / ssl_certificate_key。注意浏览器看到的是 Cloudflare 边缘证书,用 openssl s_client -connect example.com:443 -servername example.com 只能验到边缘,源站证书要用 --resolve 直连源 IP 验证。

5)Apache 2.4.52 等价配置:

SSLCertificateFile    /etc/letsencrypt/live/example.com/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLUseStapling on
SSLStaplingCache "shmcb:logs/stapling-cache(150000)"

免费SSL证书怎么配置选型:Let's Encrypt、云厂商免费 DV、Cloudflare 对比

问“免费SSL证书怎么配置”之前,先决定用哪条链路。三种免费方案(Let’s Encrypt、云厂商 DV、Cloudflare)覆盖的其实是三种不同的信任边界,选错会导致后期要么手工续期到手软,要么源站证书链报错。判断只需三个问题:是否需要 *.example.com 泛域名、源站是否只允许 Cloudflare 回源、以及你是否拥有服务器上的 cron/systemd 权限。下表按 Let’s Encrypt 官方文档、Cloudflare 开发者文档与阿里云/腾讯云证书服务页的公开信息整理。

方案 有效期 信任链 泛域名 自动化 适用场景 成本
Let’s Encrypt + certbot 90 天 ISRG Root X1/X2 支持(DNS-01) certbot.timer 个人站、API、测试环境 0 元
云厂商免费 DV 常见 3 个月 CFCA/GeoTrust 等 通常不支持 控制台下载,需手工替换 已备案企业站 0 元,额度约 20 张/年
Cloudflare Universal SSL 自动管理 Cloudflare 边缘 免费版仅边缘 自动 已接入 CF 的站点 0 元
Cloudflare Origin CA 15 年 Cloudflare 私有根 支持 手工/API CF 回源加密 0 元
付费 DV/OV 1 年 Sectigo/DigiCert 等 支持 控制台/API 电商、支付、合同要求 约 50–300 元/年/单域

问:域名已接入 Cloudflare,源站证书怎么配才不会 526?
Cloudflare 报 Error 526 Invalid SSL certificate 表示边缘能连上源站 443,但源站证书无法被校验(自签、过期或 CN/SAN 不匹配)。正确做法是 SSL/TLS 模式选 Full (strict),源站使用 Origin CA。Origin CA 私钥必须与 CSR 同时生成,密钥算法需与 request_type 一致(origin-rsa 对应 2048 位 RSA,origin-ecc 对应 P-256):

# 1) 源站生成私钥与 CSR(CN 与 SAN 都要写,泛域名放 SAN)
openssl req -new -newkey rsa:2048 -nodes -keyout /etc/nginx/ssl/origin.key 
  -out /tmp/origin.csr -subj "/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:*.example.com"

# 2) 调 Cloudflare API 签发,requested_validity=5475 即 15 年(Origin CA 上限)
curl -sX POST "https://api.cloudflare.com/client/v4/certificates" 
  -H "X-Auth-Email: ops@example.com" -H "X-Auth-Key: $CF_GLOBAL_KEY" 
  -H "Content-Type: application/json" 
  --data "$(jq -n --rawfile csr /tmp/origin.csr 
    '{hostnames:["example.com","*.example.com"],requested_validity:5475,request_type:"origin-rsa",csr:$csr}')" 
  | jq -r '.result.certificate' > /etc/nginx/ssl/origin.pem

# 3) Nginx 只信任 CF 回源(IP 段见 cloudflare.com/ips-v4,此处示例两段)
#    ssl_certificate /etc/nginx/ssl/origin.pem;  ssl_certificate_key /etc/nginx/ssl/origin.key;
#    allow 173.245.48.0/20; allow 103.21.244.0/22; deny all;

问:要泛域名、又没有云厂商 API,怎么走 0 元路径?
用 Let’s Encrypt DNS-01 + acme.sh。注意 acme.sh 自 3.0.0 起默认 CA 已改为 ZeroSSL,要显式加 --server letsencrypt。DNS API Token 只授予 Zone:DNS:Edit 且限定单域名,并把 ~/.acme.sh(含账户密钥与续期配置)纳入备份:

# 安装(默认写入 crontab 自动续期,证书 90 天,30 天时触发续签)
curl https://get.acme.sh | sh -s email=ops@example.com

# 签发泛域名;--keylength ec-256 生成 ECDSA 证书,兼容性见 Mozilla SSL 配置生成器
export CF_Token="仅Zone.DNS编辑权限的Token"
~/.acme.sh/acme.sh --issue --dns dns_cf -d example.com -d '*.example.com' 
  --server letsencrypt --keylength ec-256

# 安装并重载 Nginx,续期后自动执行 reloadcmd
~/.acme.sh/acme.sh --install-cert -d example.com --ecc 
  --key-file /etc/nginx/ssl/example.com.key 
  --fullchain-file /etc/nginx/ssl/example.com.fullchain.pem 
  --reloadcmd "systemctl reload nginx"

问:云厂商免费 DV 有什么隐藏成本?
它不会自动续到服务器。免费证书有效期常见 3 个月、每账号约 20 张/年额度,到期需在控制台重新签发并手工替换证书文件,适合没有 cron 权限的备案站临时使用。小程序/公众号强制 HTTPS 且域名已备案时,Let’s Encrypt 同样可用;但金融、支付类合同常要求 OV/EV 或证书保险,免费 DV 不满足,采购前务必确认证书类型条款。

问:为什么批量签发总被限流?据 Let’s Encrypt 官方 Rate Limits 文档(RFC 8555 定义的 ACME 协议之上):同一注册域名每周 50 张、完全相同的域名集合每周 5 张、新订单每 3 小时 300 个、每小时每个账户每主机名验证失败 5 次。超限返回 urn:ietf:params:acme:error:rateLimited 与 too many certificates (5) already issued for this exact set of domains in the last 168h0m0s。规避方式:先 certbot certonly --dry-run 或 acme.sh --issue --staging 演练,失败后不要连续重试,等待窗口重置。这就是“免费SSL证书怎么配置”里最容易被忽略的一步——先算配额,再谈命令。

免费SSL证书怎么配置时最常见的 6 个报错与处理

报错信息通常只有一行,但根因往往在别处。下面 6 个是配置免费 SSL 证书时出现频率最高的问题,每个都给出“一条定位命令 + 一条修复动作”。环境以 certbot 2.9.0(2024 年,Python 3.9+)、Nginx 1.24、OpenSSL 3.0 为例。

报错 1:nginx: [emerg] cannot load certificate "/etc/nginx/ssl/fullchain.pem": BIO_new_file() failed

这表示文件不存在、路径写错,或者 nginx worker 进程(Debian 下默认 www-data,RHEL 下默认 nginx)没有读权限。先确认证书到底签没签出来:

# live/ 下全是软链接,指向 ../../archive/,软链接本身不占空间
sudo ls -l /etc/letsencrypt/live/example.com/
# 列出 Certbot 记录的路径、到期时间与是否可续期
sudo certbot certificates
# 期望输出:
#   Certificate Name: example.com
#     Certificate Path: /etc/letsencrypt/live/example.com/fullchain.pem
#     Expiry Date: 2025-09-01 12:00:00+00:00 (VALID: 89 days)
# 目录存在但 Nginx 报错 → 多半是权限:Certbot 2.x 建 archive/ 时默认 700
sudo chmod 755 /etc/letsencrypt/{live,archive}

注意别把 ssl_certificate 指向 /etc/nginx/ssl/ 这种手工目录——用 --nginx 或 --webroot 签发的证书只存在于 /etc/letsencrypt/live/<域名>/,手工复制会让 90 天自动续期失效。

报错 2:SSL_CTX_use_PrivateKey: key values mismatch

证书和私钥不是一对(常见于从云厂商控制台分别下载了两份文件,或续期后私钥被覆盖)。用模数指纹比对,两个 md5 必须完全一致:

# RSA 证书
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in privkey.pem  | openssl md5
# ECDSA 证书(-modulus 不适用,改比公钥)
openssl x509 -noout -pubkey -in fullchain.pem | openssl md5
openssl pkey -pubout        -in privkey.pem  | openssl md5

不一致时不要手动拼接,直接 sudo certbot renew --force-renewal 重新生成一对,让 Certbot 保证 cert/key 同源。

报错 3:curl: (60) SSL certificate problem: unable to get local issuer certificate

服务端只发了叶子证书、没发中间证书(Let’s Encrypt 的中间证书是 R3/E5 这类)。把 Nginx 的 ssl_certificate 从 cert.pem 改为 fullchain.pem,然后验证链路:

# 服务端应返回 ≥2 个 BEGIN CERTIFICATE(叶子 + 中间)
openssl s_client -connect example.com:443 -servername example.com -showcerts 
  | grep -c "BEGIN CERTIFICATE"

四个文件的用途别混:

文件 内容 用在哪
cert.pem 仅叶子证书 不直接用于 Nginx
chain.pem 仅中间证书 OCSP stapling(ssl_trusted_certificate)
fullchain.pem 叶子 + 中间 ssl_certificate(唯一正确值)
privkey.pem 私钥 ssl_certificate_key

报错 4:浏览器 NET::ERR_CERT_COMMON_NAME_INVALID

域名不在证书覆盖范围内。注意 Let’s Encrypt 自 2018 年 3 月起签发的证书 Subject 中已不含 CN 字段,浏览器这句提示是历史文案,实际判定依据是 SAN:

openssl x509 -noout -ext subjectAltName -in fullchain.pem
# 期望:X509v3 Subject Alternative Name:
#         DNS:example.com, DNS:www.example.com
# 少了 www 就带上两个 -d 重签(同一个证书覆盖,不占额外额度)
sudo certbot --nginx -d example.com -d www.example.com

报错 5:Challenge failed for domain example.com + Timeout during connect (likely firewall problem)

HTTP-01 验证要求公网 80 端口可达,且路径 /.well-known/acme-challenge/ 不被拦截。先自己探一次:

curl -I http://example.com/.well-known/acme-challenge/test
# 超时 = 安全组未放行 80 / Cloudflare 橙云代理 / 强制 HTTPS 跳转未放行该路径
# 绕不过 CDN 时改用 DNS-01(不需要 80 端口)
sudo certbot certonly --manual --preferred-challenges dns -d example.com

用 Cloudflare 代理时,签发期间先切到“仅 DNS”(灰云),或用 --dns-cloudflare 插件自动化。

报错 6:too many certificates already issued for exact set of domains

撞上了 Let’s Encrypt 的重复证书限流:据 Let’s Encrypt Rate Limits 文档,同一组精确域名每周最多签发 5 张重复证书,每注册域名 50 张/周,验证失败上限 5 次/小时/账户/主机名,滑动窗口按 168 小时计算。正式签发前务必先演练:

# --dry-run 走 staging 环境,不计入生产额度
sudo certbot renew --dry-run
sudo certbot certificates   # 查重,避免重复申请同一域名

已经超限只能等窗口滑出(约 168 小时),或先用 test.example.com 这类新子域验证配置。验收标准一句话:openssl s_client 返回 Verify return code: 0 (ok) 且证书链 ≥2 张,才算真正配好。

免费SSL证书怎么配置后如何验证生效?6 条命令与判定标准

证书文件放到磁盘上、Nginx 配置里写了 ssl_certificate,都只代表”配置写完了”,不代表”浏览器信任了”。下面 6 条命令按配置层 → 协议层 → 信任链 → 运维层的顺序执行,每条都给出期望输出和失败时的含义,把域名 example.com 替换成你自己的域名即可直接复制。这也是判断”免费SSL证书怎么配置才算真正生效”最省时间的路径。

1. 配置语法与进程状态(Nginx 1.18+ 通用)

# 先校验语法,避免 reload 失败导致旧配置继续跑
sudo nginx -t
# 期望两行:nginx: configuration file /etc/nginx/nginx.conf test is successful
#           nginx: the configuration file ... syntax is ok
sudo systemctl reload nginx
sudo systemctl status nginx --no-pager
# 期望:Active: active (running)
# 若为 failed / activating,先看日志再改配置
sudo journalctl -u nginx -n 50 --no-pager

2. 用一条 curl 同时看状态码、链验证结果与耗时

curl -sS -o /dev/null 
  -w '%{http_code} %{ssl_verify_result} %{time_total}n' 
  https://example.com
# 期望输出:200 0 0.123
# ssl_verify_result=0 表示整条证书链验证通过;非 0(如 20 = unable to get local issuer certificate)说明中间证书缺失

3. 看叶子证书的签发者与有效期(-ext 需 OpenSSL 1.1.1+)

openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 期望:subject=CN = example.com
#       issuer=C = US, O = Let's Encrypt, CN = R11   (也可能是 R10/R3,随签发批次变化)
#       notAfter 距当前不超过 90 天 —— Let's Encrypt 文档明确其证书有效期为 90 天,靠自动续期而非长有效期

4. 链完整性计数

openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | grep -c 'BEGIN CERTIFICATE'
# 期望 ≥ 2(叶子证书 + 至少一张中间证书)

结果为 1 说明服务端只发了叶子证书。桌面浏览器常靠 AIA 自动补链而”看起来正常”,但 Java、部分 Android 与 curl 会直接报 unable to get local issuer certificate。修复方式是把 fullchain.pem(而非 cert.pem)配进 ssl_certificate。

5. OCSP Stapling(Nginx 中 ssl_stapling 默认 off,需显式开启并配置 resolver)

echo | openssl s_client -connect example.com:443 -servername example.com -status 2>/dev/null 
  | grep -A2 'OCSP Response Status'
# 期望:OCSP Response Status: successful (0x0)
# 刚 reload 后可能短暂显示 "OCSP response: no response sent",等 1-2 分钟再测

6. 跳转、HSTS 与旧协议禁用

curl -I http://example.com      # 期望 301,且 Location: https://example.com/
curl -I https://example.com     # 期望 200,且含 Strict-Transport-Security: max-age=31536000
openssl s_client -connect example.com:443 -tls1_1 </dev/null
# 期望握手失败(no protocols available / handshake failure),证明 TLS 1.0/1.1 已关闭

HSTS 由 RFC 6797 定义,max-age 单位是秒,一旦下发到浏览器就无法用服务端配置撤回,建议先用 max-age=300 试跑再拉满一年。协议版本与套件可参照 Mozilla SSL Configuration Generator 的 “intermediate” 档位。

检查项 期望结果 失败时的高频原因
nginx -t syntax is ok + test is successful 证书路径拼错、缺 ssl_certificate_key
%{ssl_verify_result} 0 只配了 cert.pem,未配 fullchain
证书计数 ≥ 2 中间证书未下发,Java 客户端报错
OCSP Status successful 未配 resolver 或 80 端口被墙
HTTP 跳转 301 → https 漏写 return 301 或 server_name 不匹配

全部通过后,再回到”免费SSL证书怎么配置”的运维闭环:Let’s Encrypt 证书 90 天到期,务必用 certbot renew --dry-run 验证续期钩子(--deploy-hook "systemctl reload nginx")可用,否则第 91 天会静默过期;云厂商 DV 证书通常 1 年有效期且不自动续期,需自行设置到期提醒;Cloudflare 边缘证书则要额外确认”SSL/TLS 加密模式”为 Full (strict),否则回源段仍是明文或自签名。

免费SSL证书怎么配置后的自动化:90 天证书如何不手工续?

证书装好了,为什么第 89 天还是过期了?因为”签发”和”续期”是两件事。Let’s Encrypt 的 DV 证书有效期固定 90 天(据 Let’s Encrypt 官方文档《Challenge Types》与《Renewal》页面),到期不会自动宽限;ACME 协议(RFC 8555)也不存在”服务端推新证书”的机制,续期完全依赖客户端定时发起新订单。所以免费 SSL 证书怎么配置只是第一步,真正决定线上是否中断的是续期链路。

certbot 装完就有定时器吗?有。Debian/Ubuntu 的 apt install certbot 与官方 snap 包都会安装 certbot.timer,默认每日触发两次(约每 12 小时),并用 RandomizedDelaySec 打散到随机分钟,避免全球客户端在同一秒冲击 ACME 端点。先确认它在跑:

# 查看定时器:NEXT 是下次触发时间,LAST 是上次触发时间
systemctl list-timers certbot.timer
# NEXT                         LEFT       LAST                         PASSED  UNIT
# Mon 2025-06-02 03:17:44 UTC  9h left    Sun 2025-06-01 15:42:10 UTC  2h ago  certbot.timer

# 查看 timer 定义,确认 OnCalendar 与随机延迟(certbot 2.x 默认每天两次)
systemctl cat certbot.timer

# 查看当前证书到期时间与 renewal 配置路径
sudo certbot certificates

timer 和 /etc/cron.d/certbot 会不会打架?会。部分发行版(如早期 Debian 包、部分 EPEL 版本)同时投递了 cron 文件,两套调度叠加会重复发起订单,触发 Let’s Encrypt 的 duplicate certificate 限流(同一域名集每周 5 张)。保留一个即可,检查与清理:

# 若两者都存在,注释掉 cron 版本,只保留 systemd timer
ls -l /etc/cron.d/certbot 2>/dev/null
sudo sed -i 's|^0 * * * *|#&|' /etc/cron.d/certbot   # 注释掉原行
sudo systemctl restart certbot.timer
续期机制 默认频率 检查命令 典型坑
systemd certbot.timer 每日 2 次 + 随机延迟 systemctl list-timers certbot.timer 与 cron.d 并存导致重复续期
/etc/cron.d/certbot 每日 2 次(0 点和 12 点) cat /etc/cron.d/certbot 容器/精简镜像里 cron 守护进程未启动,任务从不执行
acme.sh 内置 cron 每 60 天一次(--cron) crontab -l | grep acme.sh 换用户后 crontab 不在同一账号下

怎么在上线当天就验证续期能成功?用 --dry-run 走一遍完整的 ACME 流程(含挑战校验),但不写入新证书、不消耗正式限额:

sudo certbot renew --dry-run
# 成功输出(certbot 2.x):
# Congratulations, all simulated renewals succeeded:
#   /etc/letsencrypt/live/example.com/fullchain.pem (success)

# 失败示例(standalone 模式 80 端口被 Nginx 占用):
# Attempting to renew cert (example.com) from /etc/letsencrypt/renewal/example.com.conf
# produced an unexpected error: Problem binding to port 80: Could not bind to IPv4 or IPv6.. Skipping.

建议上线当天跑一次,之后每月巡检跑一次——不要等到第 89 天才发现 80 端口被防火墙挡住。

为什么续期成功了浏览器还显示旧日期?因为证书文件已落盘,但 Nginx/Apache 仍在内存里持有旧证书。必须挂 deploy hook 触发 reload。注意 --deploy-hook 只在真正续期成功时执行,而 --post-hook 每次运行都执行,两者语义不同:

# 方式一:命令行追加(会被写入 renewal 配置持久化)
sudo certbot renew --deploy-hook 'systemctl reload nginx' --dry-run

# 方式二:直接编辑 /etc/letsencrypt/renewal/example.com.conf
[renewalparams]
authenticator = webroot
webroot_path = /var/www/html,
renew_hook = systemctl reload nginx

用 acme.sh 的人怎么装定时任务?acme.sh 3.0.7 起提供一条命令写入 crontab,默认每 60 天续期(证书 90 天有效期,留 30 天缓冲):

~/.acme.sh/acme.sh --install-cronjob
crontab -l | grep acme.sh
# 0 0 * * * "/home/user/.acme.sh"/acme.sh --cron --home "/home/user/.acme.sh" > /dev/null

怎么监控”还剩几天”?用 openssl x509 -checkend 做黑盒探测,不依赖本地文件:

# checkend 2592000 = 30 天(秒);退出码 0 表示未到期,1 表示 30 天内到期
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -checkend 2592000
# 输出 Certificate will not expire  → 健康
# 输出 Certificate will expire      → 触发告警

规模化环境可接入 Prometheus 的 ssl_certificate_expiry_seconds(blackbox_exporter)或 Zabbix 内置键值 web.certificate.get[example.com,443],把阈值设在 21 天。

迁移服务器后为什么续期失败?续期依赖三件事同时成立:DNS 仍指向本机、80/443 放行、ACME 账号目录存在。把 /etc/letsencrypt(含 account/ 与 renewal/)或 ~/.acme.sh 一并纳入备份并复制到新机,可保留签发历史与账号绑定,但 DNS 与防火墙仍需人工确认,否则会报 DNS problem: NXDOMAIN looking up A for example.com 一类错误。

上线当天的检查清单:

  1. systemctl list-timers certbot.timer 能看到 NEXT;
  2. certbot renew --dry-run 输出 all simulated renewals succeeded;
  3. renewal conf 里存在 renew_hook;
  4. openssl s_client ... -checkend 2592000 返回 not expire;
  5. 备份任务覆盖 /etc/letsencrypt。

免费SSL证书怎么配置的边界:哪些场景不建议只用免费 DV?

很多团队在问“免费SSL证书怎么配置”时,默认把“能配通、浏览器不报警”当成验收标准。但 DV(Domain Validation)只证明你控制了这个域名,证书主题里不会出现企业名称。用一条命令就能验证这个差异:

# 查看站点证书的主题、签发者与有效期;适用于 OpenSSL 1.1.1 / 3.x
openssl s_client -connect example.com:443 -servername example.com /dev/null 
  | openssl x509 -noout -subject -issuer -dates

# 免费 DV 的典型输出:subject 只有 CN,没有 O(组织)字段
# subject=CN = example.com
# issuer=C = US, O = Let's Encrypt, CN = R11
# notBefore=Mar  1 00:00:00 2025 GMT
# notAfter=May 30 00:00:00 2025 GMT

# OV/EV 的输出会多出组织信息
# subject=C = CN, ST = Shanghai, L = Shanghai, O = 某某科技有限公司, CN = example.com

这个 O = 字段就是合同、金融、政企投标场景的硬门槛:据 CA/Browser Forum Baseline Requirements,OV 需核验企业注册信息,DV 不做任何组织核验。浏览器 UI 早已不展示 EV 绿条,但招标文件、支付通道入网、银行对接仍会要求 OV 及以上,免费证书在这里无法替代。

维度 免费 DV(Let’s Encrypt / 云厂商) 付费 OV 付费 EV
验证内容 仅域名控制权(HTTP-01 / DNS-01) 域名 + 企业工商信息 域名 + 企业 + 电话回访等增强核验
证书主题 仅 CN,无 O 含 O = 公司名 含 O,部分 CA 附注册号
有效期 LE 90 天;云厂商免费 DV 常见 3 个月 通常 1 年(受 398 天上限约束) 通常 1 年
保修赔付 无 常见 10 万–150 万美元(以 CA 条款为准) 通常更高
典型场景 博客、官网、测试环境、API 网关 企业门户、SaaS 商用、招投标 金融、支付收单

续期频率是被低估的运维成本。90 天有效期意味着每域名每年约 4 次续期,云厂商 3 个月免费证书同样如此;没有自动化、也没有监控的团队,漏续就是全站中断。至少要做两件事:dry-run 验证续期链路,以及到期告警。certbot 2.x 安装后自带 systemd timer(每日两次),acme.sh 从 3.0.0 起默认 CA 已从 Let’s Encrypt 改为 ZeroSSL,默认剩余 30 天时续期:

# certbot:模拟续期,不真正签发,用于验证 DNS/80 端口与 hook 是否可用
sudo certbot renew --dry-run

# acme.sh:查看已管证书与下次续期时间;--days 默认 30,可改为 45 提前续
acme.sh --list
acme.sh --renew -d example.com --days 45 --force

# 到期监控(可放进 cron,<14 天返回非零触发告警)
end=$(openssl s_client -connect example.com:443 -servername example.com /dev/null 
  | openssl x509 -noout -enddate | cut -d= -f2)
days=$(( ( $(date -d "$end" +%s) - $(date +%s) ) / 86400 ))
[ "$days" -lt 14 ] && echo "WARN: example.com 证书仅剩 ${days} 天" && exit 1

IP 证书与客户端证书是另一条硬边界。截至 2024 年,Let’s Encrypt 的 ACME 服务只对 DNS 标识符签发,对内网 IP 直接拒绝,报错形如 Cannot issue for "10.0.0.1": The ACME server can not issue a certificate for an IP address。内网 IP 场景应自建私有 CA(如 step-ca、openssl ca)或购买付费 IP 证书。双向 TLS 的客户端证书同理,需要单独签发并在服务端配置 ssl_client_certificate + ssl_verify_client on(Nginx 默认 off)。

合规差异往往一票否决。等保测评与商用密码应用安全性评估(密评)在部分行业要求 SM2 国密证书、国密 TLS 套件,Let’s Encrypt 是国际公共根,不满足国密要求。此时应选 CFCA、TrustAsia 等具备国密资质的 CA,并注意 Chrome/Firefox 并不原生支持 SM2 证书链,通常需要国密网关做“SM2 + RSA 双证书”自适应下发。

限流会让批量签发当场卡住。据 Let’s Encrypt 官方 Rate Limits 文档:同一注册域名每周 50 张证书、同一精确域名集合 168 小时内 5 张、单证书最多 100 个 SAN、泛域名必须走 DNS-01(不支持 HTTP-01)。批量上线前先规划域名清单,否则会撞到:

# 典型限流报错(certbot 输出)
# Error creating new order :: too many certificates (5) already issued for this exact set
# of domains in the last 168h0m0s: example.com,www.example.com, retry after 2025-03-05 09:12:33 UTC
# 处理方式:换用未超限的域名集合,或等待窗口重置;不要反复重试

所以判断标准很清晰:纯展示站、内部 API、个人项目,免费 DV 完全够用;一旦涉及合同签署方要求 O 字段、需要赔付条款兜底、需要 IP 或客户端证书、需要国密合规、域名数量超过 100 个 SAN 或需要高频批量签发,就应在免费SSL证书怎么配置的方案之外补一张 OV/EV,或至少把免费证书定位为“边缘/测试层”,生产主域走付费链路。把这张判断清单写进上线检查表,比事后解释“为什么证书里没有公司名”便宜得多。

先查证书链是否完整:`openssl s_client -showcerts` 应看到至少 2 张证书,Nginx 的 `ssl_certificate` 必须指向 `fullchain.pem`。若链完整仍报警,检查页面是否加载 `http://` 图片/脚本,HSTS 下混合内容仍会触发警告;再核对域名是否包含 `www` 的 SAN。

可以,微信要求 HTTPS、已备案域名与合法证书链,免费 DV 满足 TLS 要求;但微信支付商户号、行业资质另需企业主体,不由证书类型决定。配置时确保 `fullchain.pem` 完整、TLS 1.2 以上,并用 `curl -sS -o /dev/null -w '%{ssl_verify_result}'` 验证返回 0。

泛域名只能用 DNS-01:acme.sh 3.0.7 执行 `–issue –dns dns_ali -d example.com -d '*.example.com'`,在 DNS 服务商创建 `_acme-challenge` TXT 记录;HTTP-01 不能签泛域名。Let's Encrypt 泛域名证书有效期同为 90 天,续期仍需 DNS API 权限。

TLS 配置基本一致,都是 `ssl_certificate` + `ssl_certificate_key`,差异在证书链文件、有效期、泛域名支持与保修。付费 DV 常见 1 年,减少续期次数;免费 Let's Encrypt 90 天,必须配合 `certbot.timer` 或 acme.sh cron 自动续期。

这是证书与私钥不配对:分别计算模数 `openssl x509 -noout -modulus -in fullchain.pem | openssl md5` 与 `openssl rsa -noout -modulus -in privkey.pem | openssl md5`,两个值必须一致;ECDSA 证书用 `openssl ec -noout -text` 对比公钥。不一致时重新签发或找回对应私钥,不要混用不同批次的文件。

Let's Encrypt 证书最长 90 天,不能改;想减少操作可选云厂商免费 DV(常见 3 个月)或付费 DV/OV(1 年)。更稳妥的是保留 90 天证书 + `certbot.timer`/acme.sh cron 自动续期,并用 `openssl x509 -checkend 2592000` 加 30 天到期监控。

算边缘证书方案:免费版 Universal SSL 由 Cloudflare 自动签发,浏览器到 CF 看到的是 CF 证书;CF 到源站可用 15 年 Origin CA。源站 Nginx 要配置 Origin CA 证书,并把 CF SSL/TLS 模式设为 `Full (strict)`,否则可能出现 `526 Invalid SSL certificate` 或 `525 SSL handshake failed`。


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

内容审核

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