跳到主要内容
ssl证书按装

宝塔面板(BT)安装配置 SSL 证书全流程:Let’s Encrypt 与商业 DV/OV/EV 实操

宝塔面板(BT)安装配置 SSL 证书全流程:Let's Encrypt 与商业 DV/OV/EV 实操 — 宝塔面板(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;私钥泄露要立即吊销重签。

内容审核

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