宝塔面板(BT)安装配置 SSL 证书全流程:Let’s Encrypt 与商业 DV/OV/EV 实操
1. 问题背景与根因:宝塔站点为什么必须上 TLS
宝塔面板(BT)常把 Nginx/Apache、PHP、MySQL 和网站目录集中管理,很多站长把“购买 SSL 证书”理解成在后台点一下。实际故障通常不在证书本身,而在域名验证、证书链、443 监听和强制跳转。浏览器对 HTTP 页面标记“不安全”,微信小程序、支付回调、iOS ATS 和开放 API 普遍要求 HTTPS;没有 TLS 的站点会被现代浏览器降权提示,甚至无法被小程序合法请求。根因有三类:一是域名未解析到当前服务器或 CDN 仍走代理,导致 HTTP-01 验证失败;二是只上传了域名证书,漏掉中间证书,移动端报“证书不受信任”;三是 Nginx/Apache 未监听 443 或 80 端口被占用,配置 reload 失败。
还要修正原文中的过时说法:公共可信 TLS 证书单次签发最长有效期自 2020-09-01 起为 398 天,不是随便“默认一年”;Let’s Encrypt 免费证书固定 90 天,应开启自动续签;商业 DV/OV/EV 虽按年售卖,单次签发同样受 398 天限制,到期要重新签发并部署。EV 证书在 Chrome 77 之后已不再于地址栏显示公司名称,EV 仍代表扩展组织验证,但不能再承诺“地址栏显示公司名”。常见证书按验证级别分为 DV、OV、EV,按覆盖范围分为单域名、多域名 SAN、通配符。下面以 example.com 为例,给出宝塔面板从检查到验证的完整流程。
openssl version -ancurl -I http://example.com
如果 curl 返回 200 且没有跳转,说明 80 端口仍提供明文页面;如果返回 301 到 https,则已有跳转。先记录当前状态,再决定是申请免费证书还是上传商业证书。
2. 前置检查与域名验证准备
申请前先确认 DNS、端口和 CDN。HTTP-01 验证要求外网能访问 http://example.com/.well-known/acme-challenge/ 下的随机文件,因此 80 端口必须放行;DNS-01 验证则要求能添加 TXT 记录,通配符证书必须走 DNS-01。检查 A/AAAA 记录是否指向当前服务器公网 IP,若使用 CDN,先暂停代理或确保回源到宝塔服务器,否则 Let’s Encrypt 会拿到 CDN 节点返回的 404/403。
dig +short A example.comndig +short AAAA example.comnss -lntp | grep -E ':80|:443'nfirewall-cmd --permanent --add-service=http && firewall-cmd --permanent --add-service=https && firewall-cmd --reloadnufw allow 80/tcp && ufw allow 443/tcpncurl -I http://example.com/.well-known/acme-challenge/test.txt
云服务器还要在安全组放行 TCP 80/443;宝塔面板“安全”页同样要放行。若 80 被占用,用 ss 输出中的 PID 定位:`ss -lntp | grep ‘:80’`,再 `ps -fp PID`。不要在验证期间启用全站 301 到 HTTPS 的规则拦截 .well-known 路径;宝塔默认会为 ACME 放行,但自定义伪静态、防盗链、WAF 可能误拦。国内服务器还需确认域名备案和接入商白名单,否则 80 可能被拦截。准备完成后,再进入面板申请,能减少大半“验证失败”。
3. 宝塔面板申请 Let’s Encrypt 免费证书
登录宝塔面板,进入“网站” → 目标站点“设置” → “SSL” → “Let’s Encrypt”,勾选 example.com 和 www.example.com,验证方式选“文件验证”,点击申请。面板会调用 ACME 客户端写入 /www/server/panel/vhost/cert/example.com/,成功后可一键“强制 HTTPS”。Let’s Encrypt 有效期 90 天,宝塔会创建自动续签任务;不要手动把 90 天改成一年,公共证书没有这种操作。通配符 *.example.com 必须用 DNS-01,在面板选择 DNS 接口或手动添加 TXT 记录,不能只用文件验证。
ls -l /www/server/panel/vhost/cert/example.com/nopenssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem -noout -subject -issuer -dates -ext subjectAltNamennginx -t && nginx -s reloadntail -n 100 /www/server/panel/logs/panel.log
申请成功的关键是 fullchain.pem 与 privkey.pem 同时存在。fullchain.pem 应包含站点证书和中间证书,privkey.pem 是私钥,权限通常 600。若面板提示“验证失败,请检查域名是否解析到当前服务器”,先回到第 2 节检查 DNS 和 80 端口。若使用 CDN,先关闭代理或配置 /.well-known 直连源站。自动续签要验证:在 SSL 页面确认“自动续签”开启,并检查计划任务和日志;也可用 `crontab -l | grep -i acme` 与 `acme.sh –list` 查看。证书到期前 30 天应观察续签是否成功,避免 90 天到期后全站报错。
4. 上传商业 DV/OV/EV 证书并合并证书链
商业证书签发后通常给两个文件:域名证书(如 example.com.crt)和中间证书(intermediate.crt 或 ca-bundle.crt),私钥在服务器或 CSR 阶段生成。宝塔“SSL”页选择“其他证书”,把 fullchain.pem 内容粘贴到证书 PEM,把 privkey.pem 粘贴到私钥。若只上传域名证书,桌面浏览器可能正常,但 Android、Java、curl 会报“unable to get local issuer certificate”,所以必须合并链。OV/EV 需要企业资料审核,DV 只验证域名控制权;EV 在 Chrome 77+ 不再显示公司名,但审核更严格,金融、电商可按合规要求选择。
cat example.com.crt intermediate.crt > fullchain.pemnopenssl x509 -in fullchain.pem -noout -subject -issuer -dates -ext subjectAltNamenopenssl pkey -in privkey.pem -check -nooutnopenssl x509 -noout -modulus -in fullchain.pem | openssl md5nopenssl rsa -noout -modulus -in privkey.pem | openssl md5
两条 md5 输出必须一致,否则证书与私钥不匹配,Nginx 会报 key values mismatch。ECC 证书用 `openssl pkey -pubout` 对比公钥。商业证书按年售卖,但单次签发最长 398 天,到期不是自动展期,需要重新签发并替换 fullchain.pem/privkey.pem;建议提前 30 天续期。上传后先在宝塔保存,再执行 `nginx -t` 或 `apachectl configtest`,确认语法通过后再 reload。不要把私钥贴到工单、聊天记录或公开仓库;宝塔证书目录应限制权限。
5. Nginx、Apache、Tomcat 配置示例与强制 HTTPS
宝塔的站点 vhost 一般在 /www/server/panel/vhost/nginx/example.com.conf。核心是 80 端口 301 到 HTTPS,443 端口加载 fullchain.pem 和 privkey.pem,并只启用 TLS 1.2/1.3。修改后必须 `nginx -t && nginx -s reload`。HSTS 要等所有子域都 HTTPS 后再加,避免回滚困难。
server {n listen 80;n server_name example.com www.example.com;n return 301 https://$host$request_uri;n}nserver {n listen 443 ssl http2;n server_name example.com www.example.com;n ssl_certificate /www/server/panel/vhost/cert/example.com/fullchain.pem;n ssl_certificate_key /www/server/panel/vhost/cert/example.com/privkey.pem;n ssl_protocols TLSv1.2 TLSv1.3;n ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384';n ssl_prefer_server_ciphers off;n ssl_session_cache shared:SSL:10m;n add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;n root /www/wwwroot/example.com;n index index.php index.html;n location / { try_files $uri $uri/ /index.php?$query_string; }n}
Apache 在 /www/server/panel/vhost/apache/example.com.conf,启用 ssl 和 headers 模块后写入:
<VirtualHost *:80>n ServerName example.comn Redirect permanent / https://example.com/n</VirtualHost>n<VirtualHost *:443>n ServerName example.comn SSLEngine onn SSLCertificateFile /www/server/panel/vhost/cert/example.com/fullchain.pemn SSLCertificateKeyFile /www/server/panel/vhost/cert/example.com/privkey.pemn SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1n Header always set Strict-Transport-Security 'max-age=31536000'n</VirtualHost>
Tomcat 直连 443 时先把 PEM 转 PKCS12:`openssl pkcs12 -export -in fullchain.pem -inkey privkey.pem -out example.p12 -name tomcat -passout pass:ChangeMe123`,再在 server.xml 的 Connector 设置 keystoreFile、keystoreType=’PKCS12’、keystorePass、SSLEnabled=’true’。宝塔更常见的是 Nginx 终止 TLS 后反代 Tomcat,此时只需改 Nginx,不要重复在 Tomcat 配证书。
6. 证书类型、有效期与选型对比表
选证书先看覆盖范围和验证级别,不要只看价格。单域名只保护一个 FQDN;多域名 SAN 可在一张证书里放多个域名;通配符 *.example.com 只覆盖一级子域,不覆盖 example.com,也不覆盖 a.b.example.com。DV 适合博客、API、测试站;OV 适合企业门户;EV 适合有合规要求的金融/电商,但现代浏览器不再展示公司名。Let’s Encrypt 是 DV,90 天,自动续签最省心;商业证书按年售卖,单次签发最长 398 天。
| 类型 | 验证内容 | 典型签发 | 浏览器展示 | 有效期与续期 | 适用场景 |
|---|---|---|---|---|---|
| DV 单域名 | 域名控制权 | 几分钟 | 锁图标 | 90-397 天,到期重签 | 个人站、API |
| DV 多域名 SAN | 多个域名控制权 | 几分钟到数小时 | 锁图标 | 最长 398 天 | 多子站、多品牌 |
| DV 通配符 | DNS-01 验证 | 几分钟到数小时 | 锁图标 | 最长 398 天 | *.example.com 一级子域 |
| OV | 域名+组织资料 | 1-5 工作日 | 锁图标 | 最长 398 天 | 企业官网、门户 |
| EV | 扩展组织验证 | 5-10 工作日 | Chrome 77+ 不显示公司名 | 最长 398 天 | 金融、电商合规 |
| Let’s Encrypt | DV,HTTP-01/DNS-01 | 几分钟 | 锁图标 | 90 天,自动续签 | 预算有限的通用站点 |
如果站点是 www.example.com 和 example.com 同时访问,申请时两个都要加入 SAN;通配符证书要额外加根域。商业证书续期是重新签发,不是面板里改日期;Let’s Encrypt 到期前自动续签,但仍要监控失败日志。选择 OV/EV 时确认 CA 是否被主流浏览器和移动端信任,别只看低价。
7. 常见错误排查:真实报错与修复命令
报错 1:Challenge is invalid! (returned: invalid) (type: http-01)。这是 Let’s Encrypt 无法访问 80 端口验证文件。执行 `dig +short A example.com`、`curl -I http://example.com/.well-known/acme-challenge/test.txt`,检查 CDN 代理、安全组、宝塔防火墙、伪静态和 WAF。修复后重申请,不要连续狂点触发速率限制。
报错 2:nginx: [emerg] cannot load certificate … PEM_read_bio_X509_AUX() failed (SSL: error:0480006C:PEM routines::no start line)。fullchain.pem 为空、路径错或不是 PEM。执行 `head -n 2 /www/server/panel/vhost/cert/example.com/fullchain.pem`,应看到 BEGIN CERTIFICATE;再 `openssl x509 -in fullchain.pem -noout -text`。若文件只有私钥或复制了 HTML,重新上传正确 PEM。
报错 3:curl: (60) SSL certificate problem: unable to get local issuer certificate。缺中间证书。用 `cat example.com.crt intermediate.crt > fullchain.pem` 合并,确认顺序是站点证书在前、中间证书在后,然后 reload。可用 `openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep ‘Verify return code’` 验证,期望 0 (ok)。
报错 4:NET::ERR_CERT_COMMON_NAME_INVALID。访问的域名不在证书 SAN。执行 `openssl x509 -in fullchain.pem -noout -ext subjectAltName`,把缺失域名重新签发进 SAN,或改用通配符/多域名证书。不要用 IP 访问 HTTPS 站点。
报错 5:SSL_ERROR_RX_RECORD_TOO_LONG。443 端口跑的不是 TLS,常见于 Nginx 漏写 `listen 443 ssl` 或反代到 HTTP。用 `ss -lntp | grep ‘:443’` 和 `curl -vk https://example.com` 定位,补 ssl 参数并 reload。
报错 6:NET::ERR_CERT_DATE_INVALID。证书过期或服务器时间错误。`date -u` 校时,`openssl x509 -in fullchain.pem -noout -dates` 看 notAfter;商业证书提前 30 天重签,Let’s Encrypt 检查自动续签任务。
报错 7:AH00526: Syntax error … SSLCertificateFile: file does not exist。Apache 路径错或未启用 ssl 模块。`apachectl configtest` 查看行号,确认路径与 Nginx 证书目录一致,再 `systemctl reload httpd`。
8. 效果验证与自动续期监控
配置完成后不要只看浏览器锁图标,要同时验证跳转、证书链、协议版本和 HSTS。先测 80 到 443 的 301,再测 443 返回 200;用 openssl 检查证书主题、签发者、有效期、SAN 和链验证结果。`Verify return code` 必须为 0 (ok),否则移动端或 Java 客户端仍会失败。最后用 SSL Labs 或浏览器开发者工具 Security 面板复核。
curl -I http://example.comncurl -I https://example.comncurl -sI https://example.com | grep -i strict-transport-securitynopenssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem -noout -subject -issuer -dates -ext subjectAltNamenopenssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep 'Verify return code'nopenssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>/dev/null | grep 'Protocol'nopenssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null 2>/dev/null | grep 'Protocol'ncurl -I --resolve example.com:443:1.2.3.4 https://example.com
预期结果:http 返回 301 Location: https://example.com/;https 返回 200;HSTS 头存在;Verify return code 为 0 (ok);TLS 1.2 和 1.3 均能握手。若只允许 TLS 1.3,老客户端可能失败,生产环境建议保留 TLS 1.2。自动续期检查:宝塔 SSL 页确认自动续签开启,`crontab -l | grep -i acme` 查看任务,`acme.sh –list` 查看到期时间,定期检查面板日志和证书 notAfter。HSTS 先短 max-age 测试,再逐步加长;不要一开始 includeSubDomains 覆盖未上 HTTPS 的子域。
常见问题
宝塔 Let’s Encrypt 为什么只有 90 天,能改成一年吗?
不能。Let’s Encrypt 固定 90 天,设计上依赖自动续签;公共可信证书单次签发最长也只有 398 天。宝塔开启自动续签即可,不要手动改有效期。
通配符证书能覆盖 example.com 和 a.b.example.com 吗?
*.example.com 只覆盖一级子域,如 www.example.com、api.example.com,不覆盖根域 example.com,也不覆盖 a.b.example.com。根域要单独加入 SAN,多级子域要另签或使用多域名证书。
商业证书一年到期如何续期?
商业证书不是自动展期,到期前 30 天重新签发,得到新的 fullchain.pem 和 privkey.pem 后在宝塔替换并 reload。OV/EV 可能重新审核组织资料。
强制 HTTPS 后 80 端口还需要开放吗?
需要。HTTP-01 验证、旧链接 301 跳转都依赖 80;即使启用 HSTS,也应保留 80 做跳转。若只用 DNS-01 且全站不再需要 HTTP,可评估关闭,但要注意兼容性。
EV 证书还会在浏览器地址栏显示公司名吗?
不会。Chrome 77 起已移除 EV 公司名展示,Firefox/Safari 也弱化。EV 仍有扩展组织验证价值,但不能按旧文章承诺地址栏显示公司名。
fullchain.pem 和 privkey.pem 分别是什么?
fullchain.pem 是站点证书加中间证书,privkey.pem 是私钥。只配站点证书会缺链,报 unable to get local issuer certificate;私钥泄露要立即吊销重签。