跳到主要内容
ssl证书按装

宝塔面板 CentOS 部署 SSL 证书全流程:申请、Nginx 配置、强制 HTTPS 与报错排查

宝塔面板 CentOS 部署 SSL 证书全流程:申请、Nginx 配置、强制 HTTPS 与报错排查 — 宝塔面板 CentOS 部署 SSL 证书全流程:申请、Nginx 配置、强制 HTTPS 与报错排查

问题背景与根因:宝塔“已部署 SSL”为何仍然提示不安全

在宝塔面板里点一下“申请”或粘贴证书,面板显示“已部署”,并不等于 HTTPS 真正就绪。实际运维中最常见的现象是:地址栏仍是灰色地球或红色警告,微信小程序调用接口直接返回 request:fail ssl hand shake error,公众号网页授权回调被拒,支付平台异步通知提示“证书校验失败”。根因基本落在下面六类。

  • 证书链不完整。只上传了域名证书(leaf),没拼中间证书(intermediate)。桌面 Chrome 会自行补链,所以“我这能打开”;但 Android 微信 WebView、Java 客户端、部分 iOS 不会,直接报 unable to get local issuer certificate。宝塔自动签发的 Let’s Encrypt 会生成 fullchain.pem,手工上传商业证书时最容易踩这个坑。
  • 证书与私钥不匹配。CSR 在一台机器生成、私钥拷贝错、或面板里粘了旧 key,Nginx 启动即失败。
  • 域名覆盖不全。证书 SAN 只有 example.com,访问 www.example.com 报 NET::ERR_CERT_COMMON_NAME_INVALID。
  • 证书过期。Let’s Encrypt 有效期 90 天;商业 DV/OV/EV 单张证书最长 398 天(CA/B 论坛规则,2020 年 9 月起 Chrome、Safari 强制),所谓“买五年”只是 CA 分多次重签,部署文件仍需按期替换。
  • 验证通道被堵。HTTP-01 校验要求外网 80 端口可达,CDN 代理、安全组、firewalld 任一环节拦截都会失败。
  • 协议版本过低。微信小程序要求 TLS 1.2 及以上;CentOS 7 自带 OpenSSL 1.0.2,老版本 Nginx 无法启用 TLS 1.3,合规扫描会直接扣分。

另外必须提醒:CentOS 7 已于 2024-06-30 停止维护(EOL),宝塔新版对其支持在收缩,新部署建议 Rocky Linux 9 / AlmaLinux 9 / Ubuntu 22.04。本文命令在两个体系下通用,差异处会标注。

环境准备:系统版本、时间同步与 80/443 端口放行

先确认基础环境,CentOS 7 与 8/9 的包管理命令不同(yum 与 dnf),但宝塔安装脚本会自动识别。

cat /etc/centos-release
uname -r
getenforce
timedatectl status

系统时间必须准确,偏差超过几分钟,证书会被浏览器判定为“尚未生效”或“已过期”,报 NET::ERR_CERT_DATE_INVALID。用 chrony 校时:

timedatectl set-timezone Asia/Shanghai
timedatectl set-ntp true
chronyc sources -v

放行端口(firewalld 环境):

firewall-cmd --permanent --add-service=http
firewall-cmd --permanent --add-service=https
firewall-cmd --permanent --add-port=8888/tcp
firewall-cmd --reload
firewall-cmd --list-all

云服务器还必须在控制台安全组放行 80、443 与面板端口 8888(或你自定义的端口)。检查端口占用:

ss -lntp | grep -E ':80|:443|:8888'

若 80/443 被系统自带 httpd、nginx 占用,先停掉再装宝塔,否则面板装完站点起不来:

systemctl stop httpd nginx
systemctl disable httpd nginx

SELinux 为 enforcing 时宝塔部分操作会失败,可临时设为 permissive:

setenforce 0
sed -i 's/^SELINUX=enforcing/SELINUX=permissive/' /etc/selinux/config

最后确认解析已生效,两条 A 记录都必须指向本机公网 IP:

dig +short example.com A
dig +short www.example.com A

国内服务器域名需完成备案,未备案的 80/443 会被运营商拦截,Let’s Encrypt 校验必然超时,这一点排查时极易被忽略。

安装宝塔面板与 LNMP 环境(CentOS 可直接执行)

使用宝塔官方 LTS 安装脚本(脚本校验参数会更新,以 bt.cn 官网最新命令为准):

url=https://download.bt.cn/install/install_lts.sh;if [ -f /usr/bin/curl ];then curl -sSO $url;else wget -O install_lts.sh $url;fi;bash install_lts.sh ed8484bec

安装完成后终端会输出面板地址、用户名与密码,忘记时执行 bt 后选 14 可再次查看。首次登录需绑定宝塔账号并同意用户协议。

接着装运行环境:面板左侧“软件商店”→ 运行环境,选择 Nginx 1.24(或 1.26)、MySQL 5.7/8.0、PHP 8.1,编译安装约 10-30 分钟。Nginx 1.24 由宝塔使用较新的 OpenSSL 编译,默认支持 TLS 1.3,这是老系统上开 TLS 1.3 的关键。

添加站点:网站 → 添加站点,域名一行一个填 example.com 与 www.example.com,FTP 可不建,数据库按需创建,PHP 版本选已安装的。建站后验证:

curl -I http://example.com

返回 HTTP/1.1 200 OK 说明站点可用;返回 403 多为 index 文件缺失或目录属主不对,修正为 www:www、目录 755、文件 644。此时先不要开“强制 HTTPS”,否则证书还没配好会直接 502 或重定向死循环。

安全建议:面板端口不要用默认 8888,改成随机高位端口;面板设置里可开启“面板 SSL”,但请注意面板证书与站点证书是两套完全独立的东西,不要互相粘贴。

申请证书:Let’s Encrypt 免费证书、DNS 通配符与商业证书 CSR

方式一:Let’s Encrypt 文件验证(最常用)。网站 → 站点 → 设置 → SSL → Let’s Encrypt,勾选 example.com 与 www.example.com,验证方式选“文件验证”,点申请。宝塔会在网站根目录写入 /.well-known/acme-challenge/ 校验文件,Let’s Encrypt 从公网 80 端口回访。成功后面板自动写入证书并重载 Nginx,有效期 90 天,到期前 30 天自动续签。

方式二:DNS 验证申请通配符。同一页面选“DNS 验证”,先配置 DNS 接口(阿里云 AccessKey、腾讯云 SecretId/Key、Cloudflare API Token),域名填 *.example.com。通配符只覆盖一级子域,a.b.example.com 需单独申请。API 密钥请用子账号并只授予 DNS 解析权限。

方式三:商业证书。在服务器上生成 CSR 与私钥(OpenSSL 1.1.1 以上才支持 -addext):

openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Tech Co.,Ltd/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'

提交前务必检查 SAN 是否写入,漏了 www 是最常见的返工原因:

openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'

CA 签发后一般给两个文件:域名证书(crt/cer)与中间证书(ca-bundle/ca.crt)。必须拼接成完整链再部署:

cat example.com.crt ca-bundle.crt > fullchain.pem

有效期提醒:Let’s Encrypt 90 天且不支持延长;商业证书单张最长 398 天。任何“一次部署管三年”的说法都不成立,务必记录到期日或开启自动续签。

部署证书:面板粘贴与 Nginx 手工配置示例

面板部署:站点 → 设置 → SSL → 其他证书,把 fullchain.pem 全文粘到“证书(PEM 格式)”——注意里面应有两段 -----BEGIN CERTIFICATE-----,域名证书在前、中间证书在后;私钥粘到“私钥(PEM 格式)”,保存。宝塔实际写入路径为:

/www/server/panel/vhost/cert/example.com/fullchain.pem
/www/server/panel/vhost/cert/example.com/privkey.pem

手工配置:在站点 → 配置文件(对应 /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 on;
    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:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
    ssl_prefer_server_ciphers off;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;
    ssl_session_tickets off;
    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /www/server/panel/vhost/cert/example.com/chain.pem;
    add_header Strict-Transport-Security 'max-age=31536000' always;
    root /www/wwwroot/example.com;
    index index.php index.html;
}

两个细节:Nginx 1.25.1 之前用 listen 443 ssl http2;,1.25.1 之后 http2 单独写,否则告警 nginx: [warn] the 'listen ... http2' directive is deprecated;HSTS 建议先用 max-age=300 观察一周,确认无混合内容(页面里还有 http 图片、http 接口)后再调大,不要一上来就加 includeSubDomains 和 preload。

校验并平滑重载,reload 不会断开现有连接:

nginx -t && nginx -s reload

证书类型与部署方式对比

选型先看验证方式与有效期,不要被“绿色地址栏”之类的过时说法误导——主流浏览器早已取消 EV 的绿色企业名展示。

证书类型 验证方式 单张有效期 浏览器展示 适用场景
Let’s Encrypt DV HTTP-01 / DNS-01 90 天 锁标识 个人站、博客、测试环境、小程序后端
商业 DV 域名控制权 最长 398 天 锁标识 中小业务,需要发票与 SLA
DV 通配符 DNS-01 TXT 90 天 / 398 天 锁标识 多子域、SaaS、动态二级域名
OV 企业资质核验 最长 398 天 锁标识,详情可见企业名 政企、金融、招投标
EV 严格企业核验 最长 398 天 不再显示绿色地址栏 合规明确指定 EV 的场景
部署方式 自动续签 支持通配符 注意点
面板 Let’s Encrypt 文件验证 是,到期前 30 天 否 要求 80 端口公网可达,CDN 需回源放行
面板 DNS 验证(API) 是 是 需保存云 DNS 密钥,建议子账号最小权限
手工上传商业证书 否,需人工替换 取决于证书 必须拼中间证书,登记到期日
CDN / 云 WAF 边缘证书 由云厂商托管 是 回源协议须设为 HTTPS 或协议跟随

实践建议:源站用 Let’s Encrypt + DNS 验证拿通配符,CDN 侧用云厂商托管证书,两层都加密,避免“用户到 CDN 是 HTTPS、CDN 回源是 HTTP”的半截加密。

常见错误排查:真实报错与修复命令

1)nginx: [emerg] SSL_CTX_use_PrivateKey_file(…) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
证书与私钥不是一对。分别取模比对,两个 MD5 必须一致:

openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in privkey.pem | openssl md5

2)curl: (60) SSL certificate problem: unable to get local issuer certificate(微信/安卓同源问题)
缺中间证书。检查服务端是否只返回一张证书:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null | grep -c 'BEGIN CERTIFICATE'

结果应为 2 或更多;只有 1 说明没拼链,按前文 cat crt ca-bundle > fullchain.pem 重新拼接并 reload。

3)Let’s Encrypt 申请失败:Detail: Fetching http://example.com/.well-known/acme-challenge/xxx: Timeout during connect (likely firewall problem)
80 端口不可达。依次排查安全组、firewalld、CDN 是否开启代理(橙云)、是否强制跳转 HTTPS 把校验请求 301 走了。临时关闭 CDN 或改用 DNS 验证最快。

4)浏览器报 NET::ERR_CERT_DATE_INVALID
证书过期或服务器时间偏差。核对:

date -R
openssl x509 -noout -dates -in fullchain.pem

5)NET::ERR_CERT_COMMON_NAME_INVALID
SAN 不含当前域名:

openssl x509 -noout -ext subjectAltName -in fullchain.pem

6)nginx: [warn] ‘ssl_stapling’ ignored, issuer certificate not found
缺少 chain.pem,OCSP 装订失效。补 ssl_trusted_certificate 指向中间证书文件即可,不影响访问但影响握手性能。

7)ERR_SSL_VERSION_OR_CIPHER_MISMATCH / SSL_ERROR_NO_CYPHER_OVERLAP
协议或套件不匹配。确认 ssl_protocols 含 TLSv1.2;仅开 TLSv1.3 会让老安卓、老爬虫直接握手失败。

8)面板 8888 端口提示证书错误
把站点证书配到了面板上。面板 SSL 在“面板设置 → 面板 SSL”单独配置,与站点无关。

效果验证:curl、openssl 与 SSL Labs 检测

先看 HTTP 是否正确 301 到 HTTPS:

curl -I http://example.com

期望返回 301 且 Location: https://example.com/。再看 HTTPS 响应与证书信息:

curl -I https://example.com
curl -vI https://example.com 2>&1 | grep -E 'SSL connection|subject|issuer|expire'

用 openssl 直接读服务端证书链,确认主体、签发者与有效期:

echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates

验证协议版本,小程序与支付通道通常要求 TLS 1.2 以上:

openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null | grep 'Protocol'
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null | grep -E 'alert|error'

第二条应握手失败,说明旧协议已关闭。再检查证书链完整性与 OCSP:

openssl s_client -connect example.com:443 -servername example.com -status </dev/null | grep -E 'OCSP|Verify return code'

Verify return code: 0 (ok) 才算链完整。

浏览器侧:开发者工具 → Security 面板看证书是否“有效且受信任”;线上可用 SSL Labs(ssllabs.com/ssltest)打分,配置得当可拿到 A 或 A+,若出现“Chain issues: Incomplete”就是中间证书问题。

最后做一次续签演练,别等过期才发现自动续签早就坏了:在站点 SSL 页面手动点“续签”,观察是否成功并自动 reload;同时确认面板计划任务中的 SSL 续签任务处于启用状态,续签日志无报错。

常见问题

Let’s Encrypt 证书固定 90 天,官方不提供一年期。宝塔会在到期前 30 天自动续签并重载 Nginx。商业证书单张最长 398 天(CA/B 规则),多年期产品本质是 CA 分次重签,部署文件仍要按期替换。

九成是证书链不完整或 TLS 版本过低。用 openssl s_client -showcerts 确认返回 2 张以上证书,缺中间证书就拼接 fullchain;再确认 Nginx 配置了 ssl_protocols TLSv1.2 TLSv1.3,且域名已完成备案。

可以。用多域名 SAN 证书或通配符证书,各 server 块的 ssl_certificate 指向同一 fullchain.pem 与 privkey.pem,Nginx 按 SNI 匹配。但不同主域建议分开签发,便于独立续签、吊销和迁移。

常见于 CDN 回源仍是 HTTP,或 CDN 与源站同时配置了 301。把 CDN 回源协议改为 HTTPS 或协议跟随,检查 Nginx 中只有一处 return 301,并确认 443 端口在安全组和 firewalld 均已放行。

先把新证书与私钥上传到新路径,执行 nginx -t 校验通过后 nginx -s reload,reload 是平滑的不会断开连接。也可直接覆盖 fullchain.pem 与 privkey.pem 再 reload,覆盖前备份旧文件便于回滚。

内网测试可用,但微信小程序、公众号网页授权、支付回调强制要求受信任 CA 签发的证书,自签名会直接握手失败。内网生产环境可自建私有 CA 并给所有客户端安装根证书,公网业务必须用 DV 及以上证书。

内容审核

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