跳到主要内容
HTTPS小程序证书

宝塔面板 + 阿里云/腾讯云网站搬家:SSL 证书部署、Nginx HTTPS 配置与 8 类真实报错排查实战

宝塔面板 + 阿里云/腾讯云网站搬家:SSL 证书部署、Nginx HTTPS 配置与 8 类真实报错排查实战 — 宝塔面板 + 阿里云/腾讯云网站搬家:SSL 证书部署、Nginx HTTPS 配置与 8 类真实报错排查实战

一、问题背景:网站搬家后 HTTPS 为什么必然出问题

网站从一台服务器搬到阿里云 ECS 或腾讯云 CVM,用宝塔面板重建 LNMP 环境后,最常见的现象是:http:// 能打开,https:// 直接报「您的连接不是私密连接」;或者电脑上正常、微信内置浏览器打不开、Java 接口调用报 PKIX 错误。根因基本集中在下面六类:

  • 域名与证书不匹配:证书签发时就绑定了具体域名。搬家后如果顺手把 example.com 换成 www.example.com,或新增了子域名,旧证书必然报 NET::ERR_CERT_COMMON_NAME_INVALID。
  • 私钥丢失或与证书不配套:只拷了 .pem 没拷 .key,或用新生成的 CSR 覆盖了旧私钥,Nginx 启动会直接抛 key values mismatch。
  • 证书链不完整:只部署了域名证书(leaf),没拼中间证书(intermediate)。Chrome 有 AIA 自动补链能力能修复,但旧版 Android、微信、Java、curl 会直接失败。
  • 云安全组没放行 443:阿里云 ECS 安全组、腾讯云 CVM 防火墙默认只开 22/3389,面板里点开了 HTTPS 但外网连不上,表现为 Connection timed out。
  • Nginx 没重载或端口被占:改完配置只点了保存没执行 reload;或系统自带 httpd、Docker 容器先占了 443。
  • 续签链路断了:Let’s Encrypt 证书只有 90 天有效期,靠 HTTP-01 文件验证续签。旧机停用、DNS 已切到新机器,但 .well-known/acme-challenge/ 被伪静态规则拦截,续签就会静默失败。

另外要纠正一个流传很广的过时说法:「SSL 证书可以签很多年」。按 CA/Browser Forum 基线要求,自 2020 年 9 月 1 日起,公开信任的 TLS 证书最长有效期 398 天;Let’s Encrypt 免费证书固定 90 天。并且从 2026 年 3 月 15 日起最长有效期将缩短至 200 天,2027 年 3 月降到 100 天,2029 年 3 月降到 47 天。所以「一次性部署、几年不用管」已彻底不可行,自动化续签是必选项。

二、前置准备:数据盘、宝塔面板、安全组与 DNS 校验

动手前先把地基打牢,否则后面每一步都会踩坑。

1)数据盘挂载到 /www(宝塔默认站点目录是 /www/wwwroot,先挂载再装面板,重装面板不丢数据):

# 查看未挂载磁盘
lsblk
fdisk -l | grep -E '^Disk /dev/(vdb|sdb)'

# 分区 + 格式化(以 /dev/vdb 为例,已有数据请勿操作)
parted -s /dev/vdb mklabel gpt
parted -s /dev/vdb mkpart primary ext4 0% 100%
mkfs.ext4 /dev/vdb1

# 挂载并写入 fstab(用 UUID 更稳,避免设备名漂移)
mkdir -p /www
mount /dev/vdb1 /www
echo "UUID=$(blkid -s UUID -o value /dev/vdb1) /www ext4 defaults 0 0" >> /etc/fstab
df -hT /www

2)安装宝塔面板(CentOS / Alibaba Cloud Linux / Ubuntu / Debian 通用):

curl -sSO https://download.bt.cn/install/install_panel.sh && bash install_panel.sh ed8484bec
# 装完记录面板地址、用户名、密码
bt default

3)放行端口:阿里云「安全组 → 入方向」、腾讯云「防火墙」需放行 22、80、443、8888(面板)。系统层防火墙同步放行:

firewall-cmd --permanent --add-service={http,https} && firewall-cmd --reload
# Ubuntu / Debian
ufw allow 80,443/tcp

4)确认 DNS 已指向新机器(这一步不确认,后面所有验证都是假的):

dig +short A example.com
dig +short A www.example.com
curl -s https://ipinfo.io/ip   # 与本机公网 IP 对比

5)检查端口占用与系统时间:

ss -lntp | grep -E ':(80|443)b'
timedatectl status      # 时间偏差会直接导致 NET::ERR_CERT_DATE_INVALID
chronyc tracking

三、证书获取:面板一键申请、acme.sh 脚本与商业证书上传

宝塔环境有三条路径,选一条走通即可。

路径 A:面板一键申请。网站 → 站点 → 设置 → SSL → Let’s Encrypt → 勾选域名 → 文件验证 → 申请。成功后证书落在固定目录:

/www/server/panel/vhost/cert/example.com/fullchain.pem   # 域名证书 + 中间证书
/www/server/panel/vhost/cert/example.com/privkey.pem     # 私钥
/www/server/panel/vhost/cert/example.com/chain.pem       # 中间证书

注意:通配符 *.example.com 只能用 DNS 验证,文件验证无法签发。

路径 B:acme.sh(推荐,可脚本化、可迁移):

curl https://get.acme.sh | sh -s email=admin@example.com
source ~/.bashrc

# 方式 1:HTTP-01 文件验证(80 端口必须可达,且不能整站 301)
~/.acme.sh/acme.sh --issue -d example.com -d www.example.com -w /www/wwwroot/example.com

# 方式 2:DNS-01 阿里云(支持通配符)
export Ali_Key="LTAI5t******"
export Ali_Secret="******"
~/.acme.sh/acme.sh --issue --dns dns_ali -d example.com -d '*.example.com'

# 方式 3:DNS-01 腾讯云 DNSPod
export DP_Id="123456"
export DP_Key="******"
~/.acme.sh/acme.sh --issue --dns dns_dp -d example.com -d '*.example.com'

签发成功后安装到宝塔目录并绑定 reloadcmd,这一步决定能不能自动续签:

~/.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      "nginx -t && nginx -s reload"

路径 C:商业证书上传。云厂商一般给一个含域名证书与中间证书的 .pem 加一个 .key,直接粘贴到面板 SSL → 其他证书。若拿到的是分离文件,拼接顺序必须是「域名证书 → 中间证书」,顺序反了同样报链错误:

cat server.crt intermediate.crt > fullchain.pem

有效期提示:Let’s Encrypt 90 天自动续签;商业 DV 证书现在最长也只签 398 天,别被「3 年期套餐」误导——CA 只会签发 398 天,剩下的只是账单周期。

四、Nginx HTTPS 配置示例与强制跳转

宝塔站点的配置文件在 /www/server/panel/vhost/nginx/example.com.conf。关键点:务必在面板「设置 → 配置文件」里改,直接编辑文件后一旦在面板点 SSL 开关就会被重写覆盖。

server {
    listen 80;
    server_name example.com www.example.com;

    # 必须放行 ACME 验证,否则续签报 Invalid response
    location ^~ /.well-known/acme-challenge/ {
        root /www/wwwroot/example.com;
        default_type "text/plain";
        try_files $uri =404;
    }
    location / {
        return 301 https://$host$request_uri;
    }
}

server {
    listen 443 ssl;
    http2 on;                    # nginx < 1.25.1 请写成 listen 443 ssl http2;
    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_trusted_certificate /www/server/panel/vhost/cert/example.com/chain.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;

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

    root /www/wwwroot/example.com;
    index index.php index.html;

    location ~ .php$ {
        fastcgi_pass unix:/tmp/php-cgi-74.sock;
        fastcgi_index index.php;
        include fastcgi.conf;
    }
}

检查并重载:

nginx -t && nginx -s reload
# 宝塔封装的写法
/etc/init.d/nginx reload

三个容易忽略的细节:

  • ssl_stapling 依赖 ssl_trusted_certificate,缺这行 OCSP 装订不生效,握手会多一次外网请求,首屏变慢。
  • HSTS 一旦下发,浏览器在 max-age 内拒绝走 http。调试阶段先用 max-age=300,稳定后再调到 31536000。
  • 开强制 HTTPS 后页面样式错乱,多半是数据库里还存着 http:// 绝对地址(混合内容)。WordPress 执行 wp search-replace 'http://example.com' 'https://example.com' --all-tables --precise;Discuz、帝国 CMS 需改 config 表里的站点 URL。

五、网站搬家场景下的证书迁移与一致性校验

正确顺序是:备份 → 传文件 → 导入数据库 → 恢复证书 → 改 DNS → 验证。最容易漏的是证书目录。

1)旧服务器打包:

tar -zcvf /www/backup/cert_$(date +%F).tar.gz  /www/server/panel/vhost/cert/
tar -zcvf /www/backup/nginx_$(date +%F).tar.gz /www/server/panel/vhost/nginx/
tar -zcvf /www/backup/site_$(date +%F).tar.gz  /www/wwwroot/example.com

mysqldump -uroot -p'密码' --single-transaction --routines --triggers 
  --default-character-set=utf8mb4 dbname > /www/backup/dbname.sql

2)证书三件套一致性校验(搬家后最常见的错误就是拷错文件):

cd /www/server/panel/vhost/cert/example.com

# 证书与私钥的模数必须完全一致
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in privkey.pem   | openssl md5
# 若为 ECC 证书,改用:
openssl ec -noout -text -in privkey.pem 2>/dev/null | head -3

# 查看证书绑定的域名与到期时间
openssl x509 -noout -subject -issuer -dates -in fullchain.pem

# 校验证书链是否完整
openssl verify -CAfile chain.pem fullchain.pem
# 期望输出:fullchain.pem: OK

3)线上链完整性实测:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null 
  | grep -c 'BEGIN CERTIFICATE'
# 返回 2 或 3 表示含中间证书;返回 1 说明只部署了叶子证书,必须换 fullchain.pem

4)迁移 acme.sh 续签环境:旧机用 acme.sh 签发的,把 ~/.acme.sh 整个目录一起迁过来,然后重新执行一次 --install-cert(绝对路径与 reloadcmd 会变),最后强制续签一次验证链路:

~/.acme.sh/acme.sh --list
~/.acme.sh/acme.sh --renew -d example.com --force

提醒一个常见误解:证书本身与服务器 IP 无关,只与域名绑定。所以「换 IP 要重签证书」是错的;但「换域名、加 www、加子域必须重签」是对的。

六、方案对比:证书获取方式与环境搭建方式

两个维度的选择直接决定后续维护成本。

表 1:证书获取方式对比

方式 有效期 通配符 续签 适用场景 主要坑点
宝塔面板一键 Let’s Encrypt 90 天 仅 DNS 验证支持 面板计划任务自动 单站点、新手 80 端口不通或伪静态拦截即失败
acme.sh + DNS API 90 天 支持 *.example.com cron 自动 + reloadcmd 多站点、泛域名、内网机 需妥善保管云 API 密钥
云厂商免费 DV 90–398 天 部分支持 控制台手动续 已在用阿里云/腾讯云 到期易忘,难自动化
商业 OV/EV 最长 398 天 支持 手动重新签发 金融、政企、需主体信息 需企业实名与人工审核

表 2:环境搭建方式对比

方案 上手成本 稳定性 SSL 配置方式 适合谁
宝塔面板 低,10 分钟建站 中,面板自身有攻击面 图形化,自动生成 Nginx 配置 新手、中小站点、快速搬家
WDCP 低 中,社区维护较弱 图形化 老用户、历史遗留项目
手动编译 LNMP 高,需熟悉编译参数 高,无额外面板进程 手写 server 块 + acme.sh 高并发、对安全性能有要求

结论:日均 PV 十万以下、没有专职运维,宝塔 + acme.sh 的组合性价比最高;一旦站点成为核心业务,建议把面板 8888 端口限制为固定 IP 白名单,或直接转手动编译。

七、常见错误排查:真实报错对照表

以下都是搬家场景高频出现的真实报错,按「报错原文 → 根因 → 处置」对照即可。

1. NET::ERR_CERT_COMMON_NAME_INVALID / SSL_ERROR_BAD_CERT_DOMAIN
根因:证书 SAN 里没有当前访问的域名,最常见是只签了 example.com,用户访问的是 www.example.com。
处置:openssl x509 -noout -text -in fullchain.pem | grep -A1 "Subject Alternative Name" 确认 SAN 列表,缺什么用 acme.sh 加 -d 重签。

2. [emerg] SSL_CTX_use_PrivateKey_file("/www/server/panel/vhost/cert/example.com/privkey.pem") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
根因:证书与私钥不配套。
处置:用第五节的 modulus 比对命令定位,重新签发或从备份恢复成对的 pem/key。

3. curl: (60) SSL certificate problem: unable to get local issuer certificate
根因:证书链不完整,只部署了叶子证书。
处置:ssl_certificate 指向 fullchain.pem 而不是 cert.pem。

4. curl: (7) Failed to connect to example.com port 443: Connection timed out
根因:云安全组或系统防火墙未放行 443。
处置:先 ss -lntp | grep :443 确认本机在监听;本机正常而外网不通,一定是安全组。

5. nginx: [emerg] bind() to 0.0.0.0:443 failed (98: Address already in use)
根因:httpd、docker-proxy 或另一个 Nginx 实例占用 443。
处置:ss -lntp | grep :443 找到 PID,systemctl stop httpd 或修改容器端口映射。

6. NET::ERR_CERT_DATE_INVALID
根因:证书过期,或搬家后系统时间未同步 NTP。
处置:timedatectl set-ntp true && chronyc makestep,再 openssl x509 -noout -dates -in fullchain.pem 核对有效期。

7. NET::ERR_TOO_MANY_REDIRECTS 重定向循环
根因:站点开了强制 HTTPS,同时前面挂了 CDN/SLB,回源走 http,Nginx 又 301 到 https,形成死循环。
处置:CDN 回源协议改为 HTTPS,或在 Nginx 中判断 if ($http_x_forwarded_proto = "http") { return 301 https://$host$request_uri; }

8. acme.sh 报 Verify error:Invalid response from http://example.com/.well-known/acme-challenge/xxxx: 404
根因:整站 301 到 https,或伪静态规则把 .well-known 目录重写了。
处置:按第四节加 location ^~ /.well-known/acme-challenge/ 例外块,或直接改用 DNS-01 验证。

八、效果验证:命令行四层检查与到期监控

配置完不要只看浏览器绿锁,用命令行做四层验证。

1)状态码与跳转:

curl -I http://example.com
# 期望:301,且 Location: https://example.com/
curl -I https://example.com
# 期望:200,响应头含 strict-transport-security

2)证书信息与链验证:

openssl s_client -connect example.com:443 -servername example.com -brief </dev/null
# 期望包含:Verification: OK / Protocol version: TLSv1.3

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

3)协议与加密套件扫描:

nmap --script ssl-enum-ciphers -p 443 example.com
# 确认结果中不出现 TLSv1.0 / TLSv1.1 / RC4 / 3DES
curl -vI --tlsv1.2 --tls-max 1.2 https://example.com 2>&1 | grep "SSL connection"

4)到期监控脚本(存为 /etc/cron.daily/cert-check):

#!/bin/bash
DOMAIN="example.com"
END=$(echo | openssl s_client -servername $DOMAIN -connect $DOMAIN:443 2>/dev/null 
      | openssl x509 -noout -enddate | cut -d= -f2)
DAYS=$(( ($(date -d "$END" +%s) - $(date +%s)) / 86400 ))
echo "$(date '+%F %T') $DOMAIN 剩余 $DAYS 天" >> /var/log/cert-check.log
if [ "$DAYS" -lt 15 ]; then
  curl -s "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=你的KEY" 
    -H 'Content-Type: application/json' 
    -d "{"msgtype":"text","text":{"content":"$DOMAIN 证书仅剩 $DAYS 天"}}"
fi
chmod +x /etc/cron.daily/cert-check

最后在 SSL Labs(ssllabs.com/ssltest)跑一次完整评测,目标 A 级以上;若只有 B,通常是未开 HSTS 或仍支持 TLSv1.0/1.1。搬家场景还要额外确认:CDN 是否也上传了新证书,对象存储、邮件、小程序接口等子域是否遗漏。

常见问题

证书和服务器 IP 绑定吗?换服务器要不要重新申请?

不绑定。证书只校验域名(SAN 字段),换 IP、换机房、换云厂商都无需重签,把 fullchain.pem 和 privkey.pem 拷过去即可。但换域名、新增子域、增加 www 必须重新签发。

为什么 Chrome 显示正常,微信和安卓 App 却提示证书错误?

典型证书链不完整。Chrome 会用 AIA 自动下载中间证书补链,微信内置浏览器、旧版 Android、Java 客户端不会。把 ssl_certificate 指向 fullchain.pem(域名证书 + 中间证书拼接)即可解决。

免费 Let’s Encrypt 和付费证书在加密强度上有区别吗?

没有。两者都是 DV 级别,密钥长度、加密算法、浏览器信任度完全一致。差别在于有效期(90 天 vs 最长 398 天)、是否提供 OV/EV 主体信息、是否有赔付与人工支持。只有金融、政企招标等场景才需要 OV/EV。

面板里点了「强制 HTTPS」后网站打不开或样式错乱怎么办?

分两种情况:打不开多半是 443 未放行或证书未生效,先 curl -I https://域名 确认;样式错乱是混合内容,数据库里残留 http:// 绝对地址,用 wp search-replace 或后台批量替换,再检查模板里硬编码的 http:// 资源。

证书明明在有效期内,为什么还报 ERR_CERT_DATE_INVALID?

九成是服务器系统时间错误(搬家后未同步 NTP),其次是从 CDN 节点取到了旧证书。用 timedatectl status 检查,chronyc makestep 强制同步后重启 Nginx,并刷新 CDN 缓存。

自动续签怎么确认真的生效了?

三个检查点:acme.sh --list 看 Next renew 时间;crontab -l 或 systemctl list-timers 确认定时任务存在;每季度手动跑一次 acme.sh --renew -d 域名 --force,观察 reloadcmd 是否成功执行 nginx -s reload。只签发不重载,等于没续。

内容审核

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