跳到主要内容
ssl证书按装

宝塔面板 PHP 环境搭建与 SSL 证书部署实战:证书申请、Nginx 配置、网站搬家迁移与故障排查

宝塔面板 PHP 环境搭建与 SSL 证书部署实战:证书申请、Nginx 配置、网站搬家迁移与故障排查 — 宝塔面板 PHP 环境搭建与 SSL 证书部署实战:证书申请、Nginx 配置、网站搬家迁移与故障排查

一、为什么宝塔面板“开了 SSL”仍然报错:根因拆解

很多用户在宝塔 Linux 面板里点开“网站 → SSL → Let’s Encrypt → 申请”,看到“证书已部署”就以为万事大吉,结果浏览器依旧弹出 NET::ERR_CERT_AUTHORITY_INVALID。问题几乎都集中在四个层面。

1)证书链不完整。服务端只发送了站点证书(example.com.pem),没有附带中间证书。桌面版 Chrome 因为有缓存可能不报错,但 Android、微信内置浏览器、Java 客户端、curl 会直接判定不可信。正确做法是部署 fullchain.pem(站点证书 + 中间证书),而不是单证书文件。

2)协议与加密套件配置过时。TLS 1.0/1.1 已于 2021 年被 RFC 8996 正式废弃,Chrome 98+、iOS 15+ 不再协商。若 Nginx 里仍写着 ssl_protocols TLSv1 TLSv1.1 TLSv1.2;,老客户端握手失败就会报 ERR_SSL_PROTOCOL_ERROR;反之若只开 TLS 1.3,部分老旧安卓机也会连不上。

3)有效期认知过时。自 2020 年 9 月 1 日起,CA/B 论坛规定公开信任的 TLS 证书最长有效期为 398 天;Let’s Encrypt 免费证书固定 90 天。任何“一次部署管三年”的教程都已失效,自动续期是必选项而非可选项。

4)应用层混合内容。证书本身没问题,但页面里硬编码了 http:// 的图片、JS、CSS,浏览器按 HTTPS 加载时会被拦截,控制台出现 Mixed Content,地址栏小锁消失或变成灰色。

下面从环境搭建到证书签发、配置、迁移、排错,给出一套可以直接复制执行的完整流程,适用于宝塔 8.x/9.x + Nginx 或 Apache + 多版本 PHP 的常见架构。

二、环境准备与证书申请:可直接执行的命令

推荐系统:CentOS 7.9+/Ubuntu 20.04+/Debian 11+,内存 2G 以上。先装面板、放行端口,再装 LNMP 环境。

# 1. 安装宝塔面板(官方脚本,结束会输出面板地址、账号、密码)
curl -sSO https://download.bt.cn/install/install_panel.sh && bash install_panel.sh ed8484bec

# 2. 忘记面板入口时,用 bt 命令查看默认信息
bt 14

# 3. 放行端口(firewalld 示例;云服务器还需在安全组放行 80/443/8888)
firewall-cmd --permanent --add-port=80/tcp --add-port=443/tcp --add-port=8888/tcp
firewall-cmd --reload

面板登录后安装 Nginx 1.24+、MySQL 5.7/8.0、PHP 7.4/8.1/8.2(可多版本共存)。随后用 acme.sh 申请 Let’s Encrypt 证书,比面板内置申请更可控,支持通配符和自定义续期钩子。

# 安装 acme.sh 并注册账号(以 root 执行)
curl https://get.acme.sh | sh -s email=admin@example.com
source ~/.bashrc

# 方式 A:Webroot 文件验证(站点已能通过 80 端口访问)
acme.sh --issue -d example.com -d www.example.com --webroot /www/wwwroot/example.com --keylength ec-256

# 方式 B:DNS 验证申请通配符(以阿里云 DNS 为例,无需 80 端口)
export Ali_Key='LTAI5tXXXXXX'
export Ali_Secret='XXXXXXXX'
acme.sh --issue --dns dns_ali -d example.com -d '*.example.com' --keylength ec-256

# 安装证书到宝塔目录,并设置续期后自动重载 Nginx
acme.sh --install-cert -d example.com --ecc --key-file /www/server/panel/vhost/cert/example.com/privkey.pem --fullchain-file /www/server/panel/vhost/cert/example.com/fullchain.pem --reloadcmd 'nginx -s reload'

若购买的是商业证书,需要先生成 CSR 提交给 CA:

openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/C=CN/ST=Guangdong/L=Shenzhen/O=Example/CN=example.com'
# 校验证书与私钥是否匹配(两个输出必须完全一致)
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5

三、Nginx 与 Apache 的 SSL 配置示例

Nginx 的标准写法如下,注意 ssl_certificate 必须指向 fullchain,OCSP 装订依赖 chain.pem。Nginx 1.25.1 之后推荐用独立的 http2 on; 指令,旧版本写在 listen 行上。

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;
    root /www/wwwroot/example.com;
    index index.php index.html;

    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-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;
    resolver 223.5.5.5 119.29.29.29 valid=300s;

    add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
    add_header X-Content-Type-Options nosniff always;

    location ^~ /.well-known/acme-challenge/ { root /www/wwwroot/example.com; }
    location ~ .php$ { fastcgi_pass unix:/tmp/php-cgi-82.sock; include fastcgi.conf; }
}

Apache 的等价配置(宝塔默认站点路径为 /www/server/panel/vhost/apache/):

<VirtualHost *:443>
    ServerName example.com
    DocumentRoot /www/wwwroot/example.com
    SSLEngine on
    SSLCertificateFile    /www/server/panel/vhost/cert/example.com/fullchain.pem
    SSLCertificateKeyFile /www/server/panel/vhost/cert/example.com/privkey.pem
    SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
    SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256
    SSLHonorCipherOrder off
    SSLUseStapling on
    Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>
SSLStaplingCache shmcb:/www/server/apache/logs/stapling_cache(128000)

注意:宝塔面板每次在“网站 → 设置 → 配置文件”里保存,都会用模板重写 vhost 文件,手工添加的 SSL 参数会被覆盖。稳妥做法是把自定义参数写入 /www/server/panel/vhost/nginx/example.com.ssl.conf,再用 include 引入,或者改完配置后不要在面板界面点保存。

四、方案对比:证书类型、验证方式与服务器选型

选型先看预算和信任需求,再看运维能力。下表为当前(证书最长有效期 398 天规则下)的实际情况。

证书类型 有效期上限 验证方式 信任表现 适用场景
Let’s Encrypt DV 90 天,自动续期 HTTP-01 / DNS-01 与付费 DV 同级 博客、API、内部系统、绝大多数站点
付费 DV 域名型 398 天 DNS / 文件验证 浏览器小锁,无企业信息 需要更长周期、少维护的中小站
OV 企业型 398 天 企业资质核验 1-3 工作日 证书含企业名称 电商、政企官网、招投标
EV 增强型 398 天 严格核验 主流浏览器已弱化企业名展示 金融、支付(合规要求场景)
验证方式 需 80 端口 支持通配符 典型场景
HTTP-01 是 否 单域名、源站可直接访问
DNS-01 否 是 泛域名、CDN 后源站、内网服务器
TLS-ALPN-01 否(需 443) 否 80 端口被占用或被运营商封锁
项目 Nginx Apache
证书指令 ssl_certificate / ssl_certificate_key SSLCertificateFile / SSLCertificateKeyFile
协议控制 ssl_protocols SSLProtocol
套件控制 ssl_ciphers SSLCipherSuite
OCSP 装订 ssl_stapling on SSLUseStapling on + SSLStaplingCache
HTTP/2 http2 on(1.25.1+) Protocols h2 http/1.1
配置检测 nginx -t apachectl configtest

结论:普通站点直接用 Let’s Encrypt + acme.sh 自动续期,成本为零、安全等级与付费 DV 相同;只有需要证书内展示企业名称或合同合规要求时,才升级到 OV/EV。

五、网站搬家迁移:SSL 证书的正确迁移姿势

搬家最容易翻车的不是数据库,而是证书路径和私钥权限。推荐流程:先在源站打包与导出,再在新机恢复,最后处理证书与 DNS。

# 1. 源服务器打包站点(排除日志与缓存,减小体积)
tar -zcf site.tar.gz -C /www/wwwroot example.com --exclude='*.log' --exclude='runtime/cache'

# 2. 导出数据库(含存储过程与触发器,避免锁表)
mysqldump -uroot -p --single-transaction --routines --triggers --default-character-set=utf8mb4 example_db > example_db.sql

# 3. 新服务器导入并修正属主
mysql -uroot -p example_db < example_db.sql
chown -R www:www /www/wwwroot/example.com
chmod 600 /www/server/panel/vhost/cert/example.com/privkey.pem

# 4. 证书与 vhost 一并同步(也可在新机重新签发)
rsync -avz /www/server/panel/vhost/cert/example.com/ root@新服务器IP:/www/server/panel/vhost/cert/example.com/
rsync -avz /www/server/panel/vhost/nginx/example.com.conf root@新服务器IP:/www/server/panel/vhost/nginx/

三点关键提醒:其一,acme.sh 的账号目录在 ~/.acme.sh,若整体迁移该目录,新机可直接用 acme.sh --cron 续期,否则需在新机重新执行 --issue;其二,迁移前 24 小时把域名 DNS 的 TTL 调低到 300 秒,切换后能快速回滚;其三,PHP 站点要同步修改 wp-config.php 或 .env 里的数据库地址、账号密码与站点 URL,WordPress 还需执行 UPDATE wp_options SET option_value='https://example.com' WHERE option_name IN ('siteurl','home');,否则后台会跳回旧域名导致证书域名不匹配。

若使用宝塔自带的“一键迁移”插件,它会同步站点、数据库、FTP 与 SSL,但迁移后仍需手动核对证书绝对路径是否变化,并重新执行 nginx -t && nginx -s reload。

六、常见错误排查:真实报错与修复

以下报错在宝塔环境中出现频率最高,按“现象 → 原因 → 修复”对照处理即可。

报错信息 根因 修复要点
nginx: [emerg] cannot load certificate … PEM_read_bio_X509_AUX() failed 证书文件为空、内容被 HTML 转义、含 CRLF 或只粘贴了部分 head -1 检查是否为 BEGIN CERTIFICATE;dos2unix 转换
NET::ERR_CERT_AUTHORITY_INVALID / curl: (60) 未发送中间证书 ssl_certificate 指向 fullchain.pem
SSL_ERROR_RX_RECORD_TOO_LONG 用 https 访问了 http 端口,或 443 被纯 HTTP 服务占用 ss -lntp 检查 443 监听进程
ERR_SSL_PROTOCOL_ERROR 协议不匹配或安全组未放行 443 补 TLSv1.2;检查防火墙与安全组
Cloudflare 521 / 525 521 源站拒绝连接;525 源站证书无效 SSL 模式改 Full,源站部署有效证书
面板申请提示“域名验证失败” 80 未放行、伪静态拦截 .well-known、CDN 未回源 加 location ^~ /.well-known/ 放行规则

逐个给出手工验证命令:

# 证书文件本身是否可解析、是否过期
openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem -noout -subject -issuer -dates

# 服务端实际下发了几个证书(应为 2 个及以上,只有 1 个说明缺中间证书)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'

# 443 端口被谁占用
ss -lntp | grep -E ':(80|443)'

# 定位页面里的混合内容
grep -rn 'http://' /www/wwwroot/example.com --include=*.html --include=*.php | head -20

特别说明 SSL_ERROR_RX_RECORD_TOO_LONG:它几乎总是“用 https 去连一个只会说 HTTP 的端口”。执行 curl -I http://example.com:443,如果返回 400 或直接断开,说明该端口跑的是 HTTP 服务,检查是否开了多个 Nginx、是否 CDN 回源协议填成了 HTTP、是否宝塔里同时装了 Apache 和 Nginx 抢占 443。

七、效果验证:三条命令完成 HTTPS 验收

配置改完不要只看浏览器,按下面顺序做机器验收,结果可复现、可交付。

# 1. 语法与证书有效期
nginx -t && nginx -s reload
openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem -noout -subject -dates

# 2. 模拟真实握手,确认协议版本与套件
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | grep -E 'Protocol|Cipher'
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>/dev/null | openssl x509 -noout -subject -dates

# 3. 跳转、HSTS 与证书校验结果(verify=0 表示链校验通过)
curl -sI http://example.com | head -3
curl -sI https://example.com | grep -iE 'HTTP/|strict-transport|location'
curl -s -o /dev/null -w '%{http_code} verify=%{ssl_verify_result}' https://example.com

期望结果:80 端口返回 301 且 Location 指向 https;443 返回 200;响应头包含 Strict-Transport-Security;verify=0;握手显示 TLSv1.3 或 TLSv1.2。

再做两项长期保障:一是调用 SSL Labs 接口看评级,A 及以上为合格,出现 B 通常是支持了 TLS 1.0/1.1 或用了 RC4/3DES;二是演练自动续期,执行 acme.sh --cron --home ~/.acme.sh --force,观察是否成功续签并自动 reload,避免 90 天后证书突然过期导致全站告警。

# SSL Labs 评级查询(结果需等待 1-3 分钟)
curl 'https://api.ssllabs.com/api/v3/analyze?host=example.com&publish=off&all=done' | grep -o 'grade[^,]*'

# 查看 acme.sh 的续期计划与下次续期时间
acme.sh --list
crontab -l | grep acme

常见问题

有效期固定 90 天。acme.sh 安装后会写入 crontab,每天检查一次,剩余不足 30 天时自动续签并执行 –reloadcmd 重载 Nginx;宝塔面板内置申请同样带自动续签任务。建议用 acme.sh –list 查看下次续期时间,并手动 –force 演练一次,确认续期链路可用。

CA/B 论坛规定,2020 年 9 月 1 日起签发的公开信任 TLS 证书有效期上限为 398 天(含续签宽限)。所谓“买三年证书”实际是三年内分多次签发,每次仍是 398 天以内。到期前 30 天必须完成续签,否则浏览器会直接提示证书已过期。

先在新服务器执行 ss -lntp | grep 443 确认 Nginx 已监听;再 nginx -t 看证书路径是否存在;然后 openssl s_client -connect 域名:443 看是否返回证书。最常见原因是证书文件没同步、privkey.pem 权限不对(应为 600、属主 root),或云安全组未放行 443。

通配符证书只能用 DNS-01 验证,不支持 HTTP 文件验证。配置好 DNS 服务商 API 密钥后执行 acme.sh –issue –dns dns_ali -d example.com -d ‘*.example.com’。注意 *.example.com 不包含 example.com 本身,两个参数都要写,否则主域名仍会报证书不匹配。

这是混合内容(Mixed Content)问题:HTTPS 页面里引用了 http:// 的图片、JS、CSS。用 grep -rn ‘http://’ /www/wwwroot/example.com –include=*.html 定位后改成 // 或 https://,并在 Nginx 增加响应头 Content-Security-Policy: upgrade-insecure-requests 做兜底。

面板在“网站 → 设置 → 配置文件”保存时会用模板重写 /www/server/panel/vhost/nginx/*.conf,手写参数随之丢失。稳妥做法是把自定义 SSL 参数单独写成 example.com.ssl.conf,在主配置里用 include 引入,改完后避免在面板界面再次点保存。

内容审核

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