跳到主要内容
宝塔面板

宝塔面板部署 SSL 证书完整教程:Let’s Encrypt 自动续期与商业证书手动部署

一、问题背景与根因:为什么证书装好了浏览器还是报错

在宝塔面板里申请 SSL 证书只要点几下,但运维现场最高频的三类故障并不是申请不到证书,而是:证书装上了浏览器仍提示不安全、证书到期忘了续导致站点整站打不开、开启强制 HTTPS 后陷入重定向死循环。这三类问题各有明确的根因。

根因一:证书链不完整。CA 签发的是证书链,服务器证书加中间证书才构成完整信任链。很多人只把 domain.crt 粘进面板,桌面 Chrome 因为有 AIA 自动补链能正常显示,但 Android 老版本、Java 客户端、curl 会直接报 unable to get local issuer certificate。正确做法是把域名证书与中间证书按顺序拼接成 fullchain 再部署。

根因二:有效期规则变了。自 2020 年 9 月 1 日起,CA/B 论坛要求所有公开信任的 TLS 证书最长有效期不得超过 398 天;Let’s Encrypt 免费证书有效期是 90 天,且官方已明确将逐步缩短至 45 天。宝塔的自动续签并非每 60 天跑一次,而是在证书剩余约 30 天(即生命周期第 60 天左右)触发。如果 80 端口被 CDN、WAF 或安全组拦住,续签会静默失败,直到证书过期才被发现。

根因三:CDN 回源协议与源站跳转冲突。源站开启强制 HTTPS 后会写入 301 跳转,若 CDN 仍以 HTTP 回源 80 端口,CDN 每次拿到 301 又用 HTTP 重新请求,形成 ERR_TOO_MANY_REDIRECTS 循环。

先用三条命令定位现状,后续操作才有针对性:

curl -sSI http://example.com | head -5
curl -sSI https://example.com | head -5
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates

第一条看 80 是否 301 到 https;第二条看 443 是否正常握手;第三条打印证书主体、颁发者与起止时间。若 issuer 显示的是你的域名而不是 CA 名称,说明链不完整;若 notAfter 只剩几天,说明自动续签早已失效。

二、准备工作:解析、端口放行与面板环境自检

正式申请前必须完成四项检查,任何一项缺失都会让 ACME 验证失败。

  • 域名解析:A 记录指向服务器公网 IP。若域名同时存在 AAAA 记录而服务器没有 IPv6,Let’s Encrypt 会优先走 IPv6 导致验证超时,务必先删除 AAAA。
  • 端口放行:HTTP-01 文件验证必须放行 80,站点访问必须放行 443。云服务器还需在控制台安全组同步放行,这一步漏了会直接报验证超时。
  • 端口占用:确认 80/443 由 Nginx 或 Apache 监听,无重复进程。
  • 时间同步:ACME 对时间敏感,偏差超过 5 分钟直接报 JWS verification error。
firewall-cmd --permanent --add-service=http --add-service=https
firewall-cmd --reload
ss -lntp | grep -E ':80|:443'
timedatectl set-ntp true
timedatectl status | grep -i synchronized

时间输出 System clock synchronized: yes 才可继续。接着做面板与 Nginx 自检:

/www/server/nginx/sbin/nginx -v
/www/server/nginx/sbin/nginx -t
cat /www/server/panel/data/port.pl
ls -l /www/server/panel/vhost/cert/
curl -sI https://acme-v02.api.letsencrypt.org/directory | head -1

bt 是宝塔命令行菜单(bt 1 停止面板、bt restart 重启面板、bt 14 查看面板信息),cat /www/server/panel/data/port.pl 查看面板端口。证书统一存放在 /www/server/panel/vhost/cert/域名/ 下,包含 fullchain.pem 与 privkey.pem。最后一条命令应返回 HTTP/2 200,返回 000 说明服务器 DNS 或出网被限制,面板申请必然失败。

三、方式一:面板一键申请 Let’s Encrypt(推荐)

路径:网站 → 站点 → 设置 → SSL → Let’s Encrypt。勾选主域名与 www 子域(同一张证书的 SAN 列表,不勾选 www 会报 NET::ERR_CERT_COMMON_NAME_INVALID),选择验证方式后点击申请。

文件验证(HTTP-01)要求 80 端口可从公网访问。申请前先手动造一个测试文件,确认路径可达:

mkdir -p /www/wwwroot/example.com/.well-known/acme-challenge
echo ok > /www/wwwroot/example.com/.well-known/acme-challenge/test
curl -I http://example.com/.well-known/acme-challenge/test

必须返回 HTTP/1.1 200 OK。若返回 301/404,多半是伪静态规则把 .well-known 重写了,需在站点伪静态最前面加一条放行:

location ^~ /.well-known/acme-challenge/ {
    root /www/wwwroot/example.com;
    default_type text/plain;
}

DNS 验证(DNS-01)适合 80 端口被封、站点走 CDN 或需要通配符的场景。面板会给出 TXT 记录值,手工添加后用 dig 确认生效:

dig +short TXT _acme-challenge.example.com

申请成功后证书自动落盘到 /www/server/panel/vhost/cert/example.com/,并在站点配置中写入 ssl_certificate 与 ssl_certificate_key。随后回到 SSL 页打开强制 HTTPS,并确认自动续签开关处于开启状态。宝塔的续签由面板后台任务驱动,可在计划任务列表中查看对应 SSL 续签任务,执行日志在 /www/server/panel/logs/ 下,用 tail -f 观察即可确认是否真的在跑。

如果面板申请反复失败,可用 acme.sh 兜底,并把证书直接写进面板目录,面板会识别为已有证书:

curl https://get.acme.sh | sh -s email=admin@example.com
~/.acme.sh/acme.sh --set-default-ca --server letsencrypt
~/.acme.sh/acme.sh --issue -d example.com -d www.example.com -w /www/wwwroot/example.com
~/.acme.sh/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 "/etc/init.d/nginx reload"

四、方式二:手动部署商业证书(CSR 生成与拼接)

商业证书需要自行生成 CSR 并提交给 CA。RSA 2048 位足够,注意把 SAN 一次性写全,事后补域名只能重新签发:

openssl req -new -newkey rsa:2048 -nodes 
  -keyout example.com.key -out example.com.csr 
  -subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"

CA 签发后通常给你三个文件:域名证书、中间证书(ca_bundle.crt 或 chain.crt)、私钥。部署前必须拼接并做三项校验:

cat domain.crt ca_bundle.crt > fullchain.pem
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5

第一项输出 fullchain.pem: OK 说明链完整;后两条 MD5 必须完全一致,否则就是证书与私钥不匹配,Nginx 会报 key values mismatch。

然后进入面板:网站 → 设置 → SSL → 其他证书,证书内容(PEM) 粘贴 fullchain.pem 全文(顺序为服务器证书在前、中间证书在后),私钥 粘贴 example.com.key 全文,保存并开启强制 HTTPS。注意商业证书最长有效期 398 天且不会自动续期,必须在到期前 30 天重新签发替换,建议同步登记到监控脚本。

Apache 环境的对应指令是 SSLCertificateFile 指向 fullchain.pem、SSLCertificateKeyFile 指向 privkey.pem;Apache 2.4.8 及以上不再需要 SSLCertificateChainFile,因为中间证书已包含在 fullchain 中。

五、配置示例:站点 SSL 与安全加固参数

宝塔站点的 SSL 配置写在 /www/server/panel/vhost/nginx/example.com.conf,由面板自动生成。手工修改后不要再在面板点保存,否则会被覆盖。一个可直接使用的加固版本如下:

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    server_name example.com www.example.com;
    root /www/wwwroot/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;

    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /www/server/panel/vhost/cert/example.com/fullchain.pem;

    add_header Strict-Transport-Security "max-age=31536000" always;
}

几个参数值得说明:TLSv1.2 TLSv1.3 去掉 TLS 1.0/1.1 才能通过 PCI 与 SSL Labs 的合规检查;OCSP Stapling 依赖 ssl_trusted_certificate 指向含中间证书的 fullchain,否则 stapling 不生效;HSTS 首次上线建议先用 max-age=300 试运行,确认全站 HTTPS 无混合内容后再调到 31536000,避免回滚困难。改完必须做语法检查再重载:

/www/server/nginx/sbin/nginx -t
/etc/init.d/nginx reload

输出 syntax is ok 与 test is successful 才算通过。若站点前面还有 CDN,需在 CDN 控制台同步上传证书,并确认回源协议为 HTTPS、回源端口 443,否则强制跳转会引发循环。

六、自动续期机制与三种方案对比

理解续期时间轴很关键:Let’s Encrypt 证书有效期 90 天,宝塔在剩余约 30 天时触发续签,成功后自动 reload Nginx,整个过程无中断。因此判断续签是否正常,只需看 notAfter 是否始终保持在 60 天以上;如果某天发现只剩 20 天,说明续签任务已连续失败多次。常见失败原因是 80 端口被 CDN 拦截、伪静态拦截 .well-known、域名解析变更后未同步。

对比项 面板申请 Let’s Encrypt 商业 DV/OV 证书 acme.sh 手动签发
有效期 90 天 最长 398 天 90 天
费用 免费 付费,按年计 免费
验证方式 文件 / DNS DNS / 文件 / 邮件 HTTP-01 / DNS-01
自动续期 面板后台任务,默认开启 无,需人工替换 cron 每日检查并续签
通配符 需 DNS 验证 付费支持 需 DNS-01
适用场景 个人站、中小业务 企业站、需保修与 OV 主体信息 无面板、多机部署、容器环境

选择建议:能开 80 端口的常规站点直接用面板 Let’s Encrypt,运维成本最低;走 CDN 或需要通配符的,统一改用 DNS 验证并在面板填写服务商 API;有多台服务器或需要把证书同步到负载均衡的,用 acme.sh 加 --install-cert 的 reloadcmd 统一分发更可控。无论哪种方式,都必须配一个到期告警兜底,不能把可用性完全押在自动续期上。

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

1. Nginx 启动失败:nginx: [emerg] cannot load certificate "/www/server/panel/vhost/cert/example.com/fullchain.pem": BIO_new_file() failed (SSL: error:02001002:system library:fopen:No such file or directory)。原因是证书文件不存在或路径写错,用 ls -l /www/server/panel/vhost/cert/example.com/ 核对实际文件名,注意面板生成的是 fullchain.pem 而非 fullchain.crt。

2. 客户端报链不完整:curl: (60) SSL certificate problem: unable to get local issuer certificate。fullchain 中缺少中间证书,按第四节重新拼接后重载。

3. 域名不匹配:浏览器 NET::ERR_CERT_COMMON_NAME_INVALID。证书 SAN 里没有当前访问的域名,重新申请时把 www 或子域一并勾选。

4. 重定向循环:ERR_TOO_MANY_REDIRECTS。CDN 回源协议为 HTTP 而源站 301 到 HTTPS,把 CDN 回源改为 HTTPS(端口 443),或临时关闭源站强制 HTTPS 验证后再定位。

5. ACME 验证失败:Error: urn:ietf:params:acme:error:unauthorized ... Invalid response from http://example.com/.well-known/acme-challenge/xxx: 404。文件验证路径不可达,检查伪静态规则、80 端口与站点根目录是否一致。

6. 触发速率限制:too many certificates (5) already issued for this exact set of domains in the last 168 hours。同一组域名每周限 5 张,调试阶段改用 staging 环境:--server https://acme-staging-v02.api.letsencrypt.org/directory。

7. 私钥不匹配:SSL_CTX_use_PrivateKey ... key values mismatch。用第四节的两条 modulus MD5 命令比对,不一致就重新签发或找回原私钥。

8. 时间不同步:面板日志出现 JWS verification error,执行 timedatectl set-ntp true 校时后重试。

八、效果验证:五条命令确认部署成功

部署完成后不要只看浏览器绿锁,用命令行做客观验证:

curl -sSI http://example.com | grep -i location
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates
echo | openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null | grep -c "BEGIN CERTIFICATE"
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -text | grep -A1 "Subject Alternative Name"
curl -sSI https://example.com | head -3

判读标准:第一条应返回 location: https://example.com/,证明 301 生效;第二条 issuer 必须是真实 CA 名称(如 Let’s Encrypt 的 R10/R11),notAfter 应大于当前时间 60 天;第三条输出必须 大于等于 2,等于 1 就是链不完整;第四条 SAN 中要能看到 www 等全部域名;第五条返回 HTTP/2 200 说明 TLS 握手与 HTTP/2 均正常。

再补一个到期监控脚本,挂到 crontab 每日执行,避免续签静默失败:

#!/bin/bash
END=$(echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -enddate | cut -d= -f2)
LEFT=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
if [ $LEFT -lt 15 ]; then echo "SSL 证书剩余 $LEFT 天" | mail -s "SSL 告警" ops@example.com; fi

最后用 SSL Labs 或 MySSL 做一次外部评分,重点看是否拿到 A 及以上、是否支持 TLS 1.3、有无 HSTS 与 OCSP Stapling 生效。评分中出现“证书链不完整”或“不支持前向保密”,回到第五节调整配置即可。

常见问题

Let’s Encrypt 证书有效期 90 天,宝塔在到期前约 30 天(生命周期第 60 天左右)触发续签,成功后自动 reload Nginx。前提是面板自动续签开关开启、80 端口可公网访问或改用 DNS 验证,否则会静默失败。

根因是 CDN 用 HTTP 回源 80 端口,而源站 301 跳转到 HTTPS,形成死循环。将 CDN 回源协议改为 HTTPS(回源端口 443)即可,或先在源站关闭强制 HTTPS,等 CDN 配置同步后再开启并清缓存。

自 2020 年 9 月 1 日起,CA/B 论坛规定公开信任的 TLS 证书最长有效期 398 天。Let’s Encrypt 免费证书为 90 天,并计划缩短至 45 天。因此无论免费还是付费证书,都必须开启自动续期或设置到期告警。

说明只部署了服务器证书,缺少中间证书。用 cat domain.crt ca_bundle.crt > fullchain.pem 按顺序拼接,在面板「其他证书」中粘贴完整链内容,再执行 nginx -t 与 reload 重载,最后用 openssl verify 校验返回 OK。

必须使用 DNS 验证(DNS-01),文件验证不支持通配符。可在宝塔面板选择 DNS 验证并填写服务商 API,或用 acme.sh 执行 –issue -d example.com -d ‘*.example.com’ –dns dns_cf,签发后通过 –install-cert 部署。

商业证书没有自动续期能力,需在到期前 30 天重新签发并替换证书文件。替换后执行 /www/server/nginx/sbin/nginx -t 检查语法,再 /etc/init.d/nginx reload 重载,并同步更新 CDN 侧证书。

内容审核

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