跳到主要内容
宝塔面板

宝塔面板部署 SSL 证书教程:Let’s Encrypt 自动续期、强制 HTTPS 与故障排查

问题背景与根因

宝塔面板部署 SSL 证书后仍提示“不安全”,通常不是面板本身的问题,而是证书文件、Web 配置、DNS/CDN、ACME 验证四层中有一层不一致。最常见根因包括:只上传了域名证书未带中间证书,导致证书链不完整;Nginx/Apache 的 ssl_certificate 指向错误路径;CDN 使用 HTTP 回源又开启源站强制 HTTPS,形成 301 循环;Let’s Encrypt 文件验证被伪静态、404 规则或 CDN 缓存拦截;服务器 80/443 安全组未放行;域名解析变更后 ACME 仍访问旧 IP。

有效期规则也要先纠正:公共信任 TLS 证书单张有效期上限为 398 天,Let’s Encrypt 证书有效期为 90 天,宝塔自动续签一般安排在剩余约 30 天时触发,也就是第 60 天左右,原文“每 60 天续期”说的是续期时间点,不是证书有效期。Let’s Encrypt 还有失败验证限制:每账号每主机名每小时 5 次失败验证,每注册域每周 50 张证书,频繁重试会触发 rate limit。先执行基础探测:curl -I http://example.com 看 80 端口是否可达,ss -lntp | grep -E ':80|:443' 看服务是否监听,再决定是修证书链还是修验证链路。

前置检查与证书有效期规则

申请前先做五项检查,能避免大部分“申请失败/续期失败”。第一,DNS 必须指向当前服务器:dig +short A example.com 与 dig +short AAAA example.com 都要核对,错误的 AAAA 会让 ACME 优先走 IPv6 并验证失败。第二,端口与防火墙:ss -lntp | grep -E ':80|:443' 应看到 Nginx/Apache;云厂商安全组和系统防火墙都要放行 80/443,HTTP-01 必须保留 80。第三,时间同步:date -u 与 timedatectl 检查系统时间,偏差过大会导致证书校验和 ACME 签名失败。第四,域名不能是 IP,且国内服务器需完成备案;CDN 域名在申请文件验证时建议先关闭代理或确保回源可达。第五,确认证书类型与有效期:Let’s Encrypt 为 90 天,付费证书也要看 notAfter,公共信任证书单张最长 398 天。可用 openssl x509 -in fullchain.pem -noout -dates 查看起止时间。若使用通配符 *.example.com,必须选 DNS 验证,因为 HTTP-01 不支持通配符。面板版本过旧也可能缺少 ACME 修复,建议先在宝塔后台升级到当前稳定版,并备份 /www/server/panel/vhost/ 后再操作。

方式一:宝塔面板自动申请 Let’s Encrypt

推荐方式:网站 → 设置 → SSL → Let’s Encrypt,勾选需要签发的域名(如 example.com、www.example.com),验证方式选“文件验证”或“DNS 验证”。文件验证要求 80 端口可访问,且 http://example.com/.well-known/acme-challenge/ 不被伪静态、重定向、CDN 缓存拦截;DNS 验证需按提示添加 TXT 记录,通配符证书必须用 DNS 验证。提交后等待 ACME 返回成功,再开启“自动续签”和“强制 HTTPS”。签发完成后检查文件:ls -l /www/server/panel/vhost/cert/example.com/,应看到 fullchain.pem 与 privkey.pem;再执行 openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem -noout -subject -issuer -dates,确认 CN/SAN 包含域名、issuer 为 Let’s Encrypt、notAfter 在 90 天内。

若申请报 urn:ietf:params:acme:error:unauthorized 或 Invalid response from http://.../.well-known/acme-challenge/...: 404,先执行 curl -I http://example.com/.well-known/acme-challenge/test 判断请求是否到达源站;返回 404 不一定异常,但若被 301 到错误域名或被 CDN 拦截就不正常。申请期间可临时关闭强制 HTTPS,避免首次无证书时 443 不可用。不要短时间反复点击申请,失败验证每小时 5 次的限制会触发。

方式二:手动部署付费证书与 Nginx/Apache 配置示例

手动部署付费证书时,准备两个文件:fullchain.pem 必须是“域名证书 + 中间证书”的完整链,privkey.pem 是私钥。若服务商只给 .crt 和 ca.crt,可合并:cat example.com.crt intermediate.crt > fullchain.pem。然后进入 网站 → 设置 → SSL → 其他证书,把 fullchain 内容粘贴到证书框,把私钥粘贴到 KEY 框,保存后开启强制 HTTPS。粘贴时保留 -----BEGIN CERTIFICATE-----、-----END CERTIFICATE----- 头尾,不要带 BOM 或多余空格。校验证书与私钥是否匹配:openssl x509 -in fullchain.pem -noout -pubkey | openssl sha256 与 openssl pkey -in privkey.pem -pubout | openssl sha256 的输出应一致。

Nginx 站点配置示例:server { listen 80; server_name example.com www.example.com; return 301 https://$host$request_uri; },HTTPS 段使用 listen 443 ssl http2;、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;,确认 HTTPS 正常后再加 add_header Strict-Transport-Security 'max-age=31536000' always;。Apache 则在 443 VirtualHost 中使用 SSLEngine on、SSLCertificateFile 指向 fullchain、SSLCertificateKeyFile 指向私钥。改完执行 nginx -t 后 nginx -s reload,或 apachectl configtest 后重载 Apache。

自动续期机制与定时任务验证

宝塔的自动续期依赖面板 ACME 任务和系统 cron。Let’s Encrypt 证书 90 天有效,自动续签通常在剩余约 30 天时执行;开启 SSL 页面的“自动续签”后,不要删除 /www/server/panel/vhost/cert/example.com/,也不要在续期前改动验证方式。检查 cron:systemctl status cron || systemctl status crond,再执行 crontab -l 看计划任务是否存在;若 cron 未运行,续期不会触发。查看面板日志:tail -n 200 /www/server/panel/logs/panel.log | grep -Ei 'acme|letsencrypt|renew|ssl',重点看 unauthorized、timeout、404、rate limit。查看当前证书到期时间:openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem -noout -enddate。

如果临近到期仍未续签,可在 SSL 页面点击“续签”手动触发;没有按钮时重新提交一次 Let’s Encrypt 申请。使用 DNS 验证的通配符证书,续期需要 DNS API 或再次添加 TXT 记录,否则自动续期会失败。续期成功后 Nginx 需要重载才加载新证书,宝塔一般会自动处理;若未生效,执行 nginx -t 后 nginx -s reload。建议在到期前 15 天设置外部监控,避免 cron 故障导致全站证书过期。

方案对比与选型建议

选型时不要只看价格,要看有效期、验证方式、是否支持通配符和续期成本。公共信任证书单张有效期上限 398 天,Let’s Encrypt 为 90 天;付费证书即使宣传“1 年”,实际 notAfter 也不会超过 398 天,多年期证书通常需要重新签发而不是一张证书用多年。对比表如下:

方案 单张有效期 验证方式 通配符 续期 适用场景
Let’s Encrypt 文件验证 90 天 HTTP-01 不支持 宝塔自动续签 博客、普通站点、API
Let’s Encrypt DNS 验证 90 天 DNS-01 支持 需 DNS API 或手动 TXT 通配符、内网入口
付费 DV 不超过 398 天 DNS/文件 通常另购 手动或服务商 API 商业站点、需要发票
OV/EV 不超过 398 天 组织验证 通常另购 手动 企业、合规场景

个人站点优先 Let’s Encrypt;需要通配符就选 DNS-01;企业展示或合规采购可选 OV,但不要期待 EV 绿色地址栏,现代浏览器已弱化该展示。

常见错误排查(含真实报错)

常见报错按链路排查,不要一上来重装面板。

  • NET::ERR_CERT_AUTHORITY_INVALID 或 unable to get local issuer certificate:证书链不完整,ssl_certificate 必须指向 fullchain,而不是只含站点证书的 .crt。
  • ERR_TOO_MANY_REDIRECTS:CDN 用 HTTP 回源,源站又强制 HTTPS;把 CDN 回源协议改为 HTTPS,或让源站只保留一层 301,检查 curl -I http://example.com 与 curl -I https://example.com 的 Location。
  • nginx: [emerg] cannot load certificate ... BIO_new_file() failed 或 PEM_read_bio_X509_AUX() failed:路径错、权限不足或文件不是 PEM;执行 ls -l /www/server/panel/vhost/cert/example.com/ 和 nginx -t。
  • urn:ietf:params:acme:error:unauthorized 与 Invalid response from http://.../.well-known/acme-challenge/...: 404:验证文件被伪静态、CDN 或 301 拦截;用 curl -I http://example.com/.well-known/acme-challenge/test 确认回源。
  • X509_check_private_key:key values mismatch:证书和私钥不匹配,重新粘贴正确私钥,用公钥哈希比对。
  • SSL_ERROR_RX_RECORD_TOO_LONG:443 端口返回了 HTTP 明文,检查 listen 443 ssl 是否漏写 ssl,或端口被其他服务占用。
  • certificate has expired:续期失败,查看 cron 与面板 ACME 日志,手动续签后再重载 Web 服务。

效果验证与监控

验证分四层:跳转、证书、链、协议。执行 curl -I http://example.com 应返回 301 且 Location 为 https://example.com/;curl -I https://example.com 应返回 200 或业务状态码。查看证书:echo | openssl s_client -servername example.com -connect example.com:443 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName,确认 SAN 含所有域名、issuer 正确、notAfter 未过期。验证证书链:openssl s_client -connect example.com:443 -servername example.com -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null 2>/dev/null | grep 'Verify return code',应看到 Verify return code: 0 (ok);非 0 多为中间证书缺失。检查 HSTS:curl -sI https://example.com | grep -i strict-transport-security,确认只在 HTTPS 正常后启用。协议检查可用 openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 与 -tls1_3,生产站点不建议再开 TLS 1.0/1.1。最后用浏览器开发者工具看 Console 是否有 Mixed Content,并用 SSL Labs 或 testssl.sh 复测评分。

常见问题

证书有效期是 90 天;宝塔自动续签通常在剩余约 30 天时触发,也就是第 60 天左右。原文“每 60 天续期”指续期时间点,不是有效期。开启自动续签并保证 80 端口或 DNS 验证可用即可。

优先检查 CDN 回源协议。若 CDN 用 HTTP 回源、源站又 301 到 HTTPS,就会循环;把回源改为 HTTPS,或源站只保留一层跳转。再用 curl -I 分别看 80 和 443 的 Location。

只上传了域名证书,缺少中间证书。把站点证书与中间证书合并为 fullchain.pem,Nginx 的 ssl_certificate 指向 fullchain,Apache 的 SSLCertificateFile 也指向 fullchain,然后重载服务。

80 端口被安全组拦截、CDN 缓存或伪静态拦截 /.well-known/acme-challenge/、DNS 解析变更、cron 未运行。查看面板 ACME 日志中的 unauthorized、404、rate limit,修好后手动续签一次。

公共信任 TLS 证书单张有效期上限为 398 天,不能一张证书用多年。多年采购通常是服务商分年重新签发;每次签发后都要更新服务器证书文件并验证链和私钥匹配。

Let’s Encrypt 通配符必须用 DNS-01 验证,在 _acme-challenge.example.com 添加 TXT 记录,或在宝塔配置 DNS API 自动写入。HTTP-01 文件验证不支持 *.example.com。

内容审核

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