宝塔面板部署 Let’s Encrypt SSL 证书:自动申请、手动安装与排错实战
问题背景与根因:为什么宝塔部署 Let’s Encrypt 会失败
Let’s Encrypt 是免费 DV 证书,通过 ACME v2 协议签发,单张证书有效期 90 天,支持 HTTP-01、DNS-01 和 TLS-ALPN-01 验证。宝塔面板把申请、续签和 Nginx 配置封装成图形操作,但失败通常不是“证书坏了”,而是验证链路或证书链有问题。
常见根因包括:域名 A/AAAA 记录未指向源站;CDN 开启代理后 HTTP-01 请求被 CDN 接管,源站收不到 /.well-known/acme-challenge/;安全组或 firewalld 未放行 80/443;Nginx 默认站点、伪静态、安全规则拦截点目录;面板版本旧或 ACME 账户注册失败;同一域名短时间重复申请触发 Let’s Encrypt 速率限制。Let’s Encrypt 当前限制包括每注册域名 50 张证书/周、重复证书 5 张/周、验证失败 5 次/账户/主机名/小时。
另一个高频问题是证书链不完整。浏览器可能正常,但 Java、小程序、老版本 curl 报 unable to get local issuer certificate。Nginx 的 ssl_certificate 必须指向 fullchain(叶子证书+中间证书),不能只放叶子证书。公开信任 TLS 证书目前最长有效期 398 天(CA/B Forum 规定,2020-09-01 起),Let’s Encrypt 为 90 天;行业计划 2026-03-15 起降至 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天,因此自动续期和续期后 reload 必须可靠。
排查先做三件事:getent ahosts example.com 确认解析;ss -lntp | grep ':80' 和 ss -lntp | grep ':443' 确认监听;curl -I http://example.com/.well-known/acme-challenge/test.txt 看返回 404 还是 403。404 多为路径或 root 不对,403 多为 Nginx 规则拦截,连接超时则是防火墙或 CDN 回源问题。
前置检查与证书文件准备
先确认 DNS 与端口。执行 dig +short example.com A、dig +short www.example.com A,返回的 IP 必须是源站公网 IP;使用 CDN 时要么关闭代理申请,要么改用 DNS-01。防火墙检查:firewall-cmd --list-ports、ufw status,云服务器还要检查安全组入方向 80/443。宝塔建议使用 8.x/9.x,Nginx 配置目录通常在 /www/server/panel/vhost/nginx/,证书目录在 /www/server/panel/vhost/cert/example.com/。
自动申请不需要手工准备文件;手动安装需要 fullchain.pem 和 privkey.pem。用 acme.sh 签发可执行:curl https://get.acme.sh | sh -s email=admin@example.com,然后 acme.sh --issue -d example.com -d www.example.com --webroot /www/wwwroot/example.com。安装到宝塔路径:acme.sh --install-cert -d example.com --key-file /www/server/panel/vhost/cert/example.com/privkey.pem --fullchain-file /www/server/panel/vhost/cert/example.com/fullchain.pem --reloadcmd 'nginx -s reload'。用 certbot 则执行 certbot certonly --webroot -w /www/wwwroot/example.com -d example.com -d www.example.com,文件在 /etc/letsencrypt/live/example.com/。
拿到文件后必须校验:openssl x509 -in fullchain.pem -noout -subject -issuer -dates 看域名和有效期;openssl rsa -in privkey.pem -check -noout 检查私钥;openssl x509 -noout -modulus -in fullchain.pem | openssl md5 与 openssl rsa -noout -modulus -in privkey.pem | openssl md5 的输出必须一致。私钥权限设为 chmod 600 privkey.pem,属主为 root。fullchain 顺序应为“叶子证书在前、中间证书在后”,不要把根证书拼进去。
方式一:宝塔面板自动申请 Let’s Encrypt(推荐)
登录宝塔面板,进入“网站 → 站点 → 设置 → SSL → Let’s Encrypt”,勾选需要签发的域名(如 example.com、www.example.com),选择“文件验证”或“DNS 验证”。文件验证要求 80 端口可从公网访问,DNS 验证适合 CDN 或 80 被封场景,需要在面板配置阿里云、腾讯云、DNSPod 等 API。点击申请后,面板会调用 ACME 客户端写入验证文件并签发证书,成功后开启“自动续签”和“强制 HTTPS”。
文件验证失败时,先在服务器上创建测试文件:mkdir -p /www/wwwroot/example.com/.well-known/acme-challenge,写入 echo ok > /www/wwwroot/example.com/.well-known/acme-challenge/test.txt,再执行 curl -I http://example.com/.well-known/acme-challenge/test.txt。返回 200 才能申请;返回 403 检查 Nginx 是否拦截点目录,可在站点配置加入 location ^~ /.well-known/acme-challenge/ { allow all; };返回 404 检查 root 是否指向站点目录;超时检查 CDN 回源和安全组。
自动续签依赖面板计划任务。进入“计划任务”确认存在 Let’s Encrypt 续签任务,命令行可用 crontab -l | grep -i acme 或 crontab -l | grep -i lets 查看。证书文件生成后可用 ls -l /www/server/panel/vhost/cert/example.com/ 确认 fullchain.pem 与 privkey.pem 的更新时间。开启“强制 HTTPS”后,如果站点套了 CDN,必须把 CDN 回源协议改为 HTTPS,否则 CDN 强制 HTTPS、回源 HTTP、源站再 301 到 HTTPS,会形成重定向循环。
申请时若提示 rate limit exceeded,不要反复重试。Let’s Encrypt 对同一注册域名有每周 50 张证书、重复证书每周 5 张、验证失败每小时 5 次的限制。先修复 403/404,再等待限制窗口结束;测试阶段可用 staging 环境,避免消耗生产配额。
方式二:手动上传或粘贴证书(fullchain + key)
进入“网站 → 站点 → 设置 → SSL → 其他证书”,左侧粘贴 privkey.pem 私钥内容,右侧粘贴 fullchain.pem 完整证书链内容,保存后开启“强制 HTTPS”。注意右侧不是只粘贴叶子证书,而是包含中间证书的 fullchain。保存后宝塔会写入 Nginx 配置并 reload;若保存报错,先检查粘贴内容是否包含“—–BEGIN CERTIFICATE—–”和“—–END CERTIFICATE—–”边界。
也可以直接把文件放到 /www/server/panel/vhost/cert/example.com/,在站点 Nginx 配置中引用:ssl_certificate /www/server/panel/vhost/cert/example.com/fullchain.pem; 和 ssl_certificate_key /www/server/panel/vhost/cert/example.com/privkey.pem;。修改后执行 nginx -t,通过后 systemctl reload nginx。不要用 restart 替代 reload 作为日常操作,reload 更平滑。
手动证书最常见的问题是链不完整和私钥不匹配。链检查:openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem,输出 OK 表示系统信任链可验证。私钥匹配:分别计算证书和私钥模数 MD5,值必须一致。若使用商业证书,注意证书最长有效期目前为 398 天,到期前要更新;Let’s Encrypt 为 90 天,手动上传后没有自动续期,必须自己建立续期提醒或改用 acme.sh 的 install-cert 钩子。
如果站点使用 CDN,上传证书后还要在 CDN 控制台部署证书,并确认回源协议为 HTTPS、回源端口 443、回源 Host 正确。只更新源站证书而 CDN 仍用旧证书,浏览器看到的仍是旧证书。
配置示例:Nginx 80 跳转与 443 证书配置
下面是一个可直接套用的站点配置片段,域名替换为 example.com。80 端口只做跳转,443 端口加载 fullchain 和私钥,启用 TLS 1.2/1.3:
server {
listen 80;
server_name example.com www.example.com;
location ^~ /.well-known/acme-challenge/ { allow all; }
return 301 https://$host$request_uri;
}
server {
listen 443 ssl http2;
server_name example.com www.example.com;
ssl_certificate /www/server/panel/vhost/cert/example.com/fullchain.pem;
ssl_certificate_key /www/server/panel/vhost/cert/example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384';
ssl_prefer_server_ciphers on;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 10m;
add_header Strict-Transport-Security 'max-age=300' always;
root /www/wwwroot/example.com;
index index.php index.html;
}
HSTS 不要一上来就设一年。先设 max-age=300 验证站点所有子域都支持 HTTPS,再逐步提高到 31536000。若站点有 HTTP 资源或子域未上证书,HSTS 会导致用户无法访问。配置写好后执行 nginx -t,出现 syntax is ok 和 test is successful 再 reload。
CDN 场景重点检查回源:CDN 回源协议选 HTTPS,回源端口 443,回源 Host 与证书域名一致。若 CDN 侧也开启“强制 HTTPS”,源站 80 跳转 443 是正常链路;但 CDN 回源 HTTP 而源站强制 HTTPS,就会出现 ERR_TOO_MANY_REDIRECTS。用 curl -I -L http://example.com 观察每一跳的 Location,能快速定位循环点。
自动续期与 reload 钩子
Let’s Encrypt 证书 90 天有效,建议剩余 30 天续期。宝塔自动申请的在面板计划任务中续签;acme.sh 默认由 cron 每天检查,可用 crontab -l 查看 /root/.acme.sh/acme.sh --cron 任务,用 acme.sh --list 查看下次续期时间。certbot 用 systemctl list-timers | grep certbot 查看定时器,用 certbot certificates 查看到期时间。
续期后不生效,九成是没 reload 或配置指向旧文件。acme.sh 安装证书时必须带 reload 钩子:acme.sh --install-cert -d example.com --key-file /www/server/panel/vhost/cert/example.com/privkey.pem --fullchain-file /www/server/panel/vhost/cert/example.com/fullchain.pem --reloadcmd 'nginx -s reload'。certbot 可用 certbot renew --deploy-hook 'nginx -s reload',并先执行 certbot renew --dry-run 演练。宝塔面板自动续签后通常会自行 reload,但多节点、容器或多 CDN 场景要逐台确认。
验证续期是否真正生效:openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -dates,对比 notAfter 是否更新;acme.sh --list 或 certbot certificates 看本地文件到期日;ls -l /www/server/panel/vhost/cert/example.com/ 看文件时间。若本地已更新但线上仍旧,检查 Nginx 配置 include 的是否为同一路径、CDN 是否缓存证书、负载均衡后端是否同步。
部署方式与证书有效期对比
宝塔自动申请适合单机、80 端口可达、希望图形化续期的站点;手动粘贴适合已有商业证书或从其他 CA 迁移;acme.sh 适合需要 DNS API、批量域名和自定义 reload 的运维场景;certbot 适合习惯官方客户端的环境。选择时重点看验证方式、续期可靠性和 CDN 兼容性。
| 方式 | 申请入口 | 验证方式 | 续期 | 适合场景 |
|---|---|---|---|---|
| 宝塔自动 | SSL → Let’s Encrypt | 文件/DNS | 面板计划任务 | 单机宝塔站点 |
| 手动粘贴 | SSL → 其他证书 | 不涉及 | 人工更新 | 商业证书、迁移 |
| acme.sh | 命令行 | HTTP/DNS | cron + reloadcmd | 批量、CDN、自动化 |
| certbot | 命令行 | HTTP/DNS | systemd timer | 官方客户端环境 |
有效期方面,Let’s Encrypt 为 90 天;公开信任 TLS 证书目前最长 398 天。按 CA/B Forum 已公布的时间表,2026-03-15 起单张证书最长 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天。证书越短,越不能依赖人工更换,必须把续期和 reload 做成可验证的自动流程。
常见错误排查(含真实报错)
- nginx: [emerg] cannot load certificate … PEM_read_bio_X509_AUX() failed:路径错误、文件为空或粘贴了 HTML。执行
ls -l fullchain.pem、file fullchain.pem、openssl x509 -in fullchain.pem -noout -subject定位,修正 ssl_certificate 路径。 - curl: (60) SSL certificate problem: unable to get local issuer certificate:证书链不完整。Nginx 改用 fullchain.pem,执行
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null查看是否返回中间证书。 - SSL_ERROR_RX_RECORD_TOO_LONG:用 HTTPS 访问了 HTTP 端口,或 CDN 回源协议配错。检查
curl -I http://example.com:443和 CDN 回源端口,确保 443 由 Nginx ssl 监听。 - 403 或 404 during ACME challenge:Nginx 拦截
/.well-known/或 root 不对。加入location ^~ /.well-known/acme-challenge/ { allow all; },确认测试文件可通过公网访问。 - ERR_TOO_MANY_REDIRECTS:CDN 强制 HTTPS、回源 HTTP、源站又 301 到 HTTPS。把 CDN 回源协议改为 HTTPS,或暂时关闭源站强制跳转排查。
- nginx: [emerg] SSL_CTX_use_PrivateKey … key values mismatch:证书与私钥不匹配。用模数 MD5 比对,不一致就重新签发或找回对应私钥。
排查时按“DNS → 端口 → 验证文件 → 证书链 → reload”的顺序,不要一上来重装面板。每条报错都对应明确层级,先看 nginx -t 和 curl -I 的输出,再改配置。
效果验证:从浏览器到命令行的完整检查
浏览器无痕模式访问 https://example.com,点击小锁查看证书域名、签发者、有效期;若显示“证书无效”,先看是过期、域名不匹配还是链不完整。命令行验证证书信息:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName。subjectAltName 必须包含实际访问域名。
验证跳转与链信任:curl -I http://example.com 应返回 301 且 Location 为 https;curl -I https://example.com 应返回 200 或业务状态码;openssl s_client -connect example.com:443 -servername example.com -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null 输出 Verify return code: 0 表示系统信任链通过。再用 SSL Labs 或 openssl s_client 检查协议版本,确认未启用 TLS 1.0/1.1。
宝塔“监控”页可看 HTTPS 请求占比,Nginx 日志可执行 grep ' 443 ' /www/wwwlogs/example.com.log | tail 观察流量。最后做一次续期演练:certbot 用 certbot renew --dry-run,acme.sh 用 acme.sh --list 确认下次任务时间;检查 reload 钩子是否存在。只有“本地文件更新、Nginx 已 reload、线上证书日期更新”三者一致,才算部署完成。
常见问题
先确认 80 端口和 CDN 回源可达,检查 Nginx 是否拦截 .well-known 目录;在站点配置加入 location ^~ /.well-known/acme-challenge/ { allow all; },并确保 root 指向站点目录。用 curl -I 访问测试文件返回 200 后再申请。
Let’s Encrypt 证书有效期为 90 天,建议剩余 30 天续期,依靠宝塔自动续签或 acme.sh、certbot 计划任务。公开信任 TLS 证书目前最长 398 天,2026-03-15 起 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天。
通常是证书链不完整。Nginx 的 ssl_certificate 要指向 fullchain.pem,包含叶子证书和中间证书,不能只放叶子证书。用 openssl s_client -showcerts 检查返回链,并确认中间证书顺序正确。
检查 Nginx 是否 reload、配置是否指向旧路径、CDN 是否缓存旧证书、多节点是否同步。执行 nginx -t 后 systemctl reload nginx,并确认 acme.sh 的 –reloadcmd 或 certbot 的 –deploy-hook 已生效。
比对模数:openssl x509 -noout -modulus -in fullchain.pem | openssl md5 与 openssl rsa -noout -modulus -in privkey.pem | openssl md5,两个值必须一致;不一致就重新签发或找回对应私钥,不要反复重启 Nginx。