跳到主要内容
ssl证书按装

宝塔 Linux 面板建站全流程:多版本 PHP 环境、MySQL 迁移与 SSL 证书部署实战

宝塔 Linux 面板建站全流程:多版本 PHP 环境、MySQL 迁移与 SSL 证书部署实战 — 宝塔 Linux 面板建站全流程:多版本 PHP 环境、MySQL 迁移与 SSL 证书部署实战

问题背景与根因:宝塔环境为什么总在 SSL、PHP、数据库上翻车

宝塔 Linux 面板只是把 LNMP/LAMP 的编译与配置脚本化,它不会替你解决网络、服务、证书这三层问题。实际运维中绝大多数「宝塔装完不能用」都集中在以下根因:

  • 网络层:面板端口(默认 8888)只在 firewalld/ufw 放行,云厂商安全组没放行,浏览器报 ERR_CONNECTION_TIMED_OUT;FTP 被动模式端口 39000-40000 未放行,能登录但列不出目录(425 Failed to establish connection)。
  • 服务层:PHP-FPM 未启动,或 Nginx 的 fastcgi_pass 指向 unix:/tmp/php-cgi-82.sock 而实际 socket 名是 php-cgi-74.sock,直接 502;MySQL 8 默认 caching_sha2_password,老程序驱动不支持,报 1045 / 2002。
  • 证书层:只部署了域名证书、漏装中间证书,部分安卓机报 NET::ERR_CERT_AUTHORITY_INVALID;有效期规则不清——公有 CA 签发的单张证书最长 398 天,Let’s Encrypt 固定 90 天,忘续签就是 NET::ERR_CERT_DATE_INVALID。
  • 迁移层:搬家只搬了 /www/wwwroot,没搬数据库、伪静态、SSL 证书和 PHP 版本,结果首页 404、内页 500;或用 root 解压导致属主错乱,Nginx 报 403。

环境基线建议:CentOS 7+ / Ubuntu 20.04+ / Debian 11+ 纯净系统,x86_64 架构,内存 ≥ 2 GB(1 GB 只能跑极速安装且易 OOM),磁盘 ≥ 40 GB。安装前先执行 cat /etc/os-release && free -m && uname -m 确认。下面按「安装 → PHP/Nginx → 数据库 → SSL → 搬家 → 排错验证」给出可直接复制的命令。

第一步:宝塔面板安装、端口放行与 FTP 配置(命令可直接执行)

官方安装脚本(root 执行、纯净系统;已装过 Apache/Nginx/PHP 的机器请先卸载):

url=https://download.bt.cn/install/install_panel.sh
curl -sSO $url && bash install_panel.sh ed8484bec
# 安装完成后查看面板地址、用户名、密码
bt default

修改面板端口(建议改成 5 位随机数,不要用 8888):

echo 28888 > /www/server/panel/data/port.pl
bt restart
ss -lntp | grep 28888

防火墙与云厂商安全组必须同时放行,只放行其中一个是最常见的坑:

# CentOS / RHEL
firewall-cmd --permanent --add-port=28888/tcp
firewall-cmd --permanent --add-port=80/tcp
firewall-cmd --permanent --add-port=443/tcp
firewall-cmd --permanent --add-port=21/tcp
firewall-cmd --permanent --add-port=39000-40000/tcp
firewall-cmd --reload
# Ubuntu / Debian
ufw allow 28888/tcp && ufw allow 80,443/tcp && ufw allow 21/tcp && ufw reload

FTP 采用 Pure-FTPd,宝塔软件商店装完 FTP 组件后:

/etc/init.d/pure-ftpd start
netstat -lntp | grep :21
# 被动端口范围见 /www/server/pure-ftpd/etc/pure-ftpd.conf 的 PassivePortRange

安全加固:开启面板 SSL、绑定面板授权域名或 IP 白名单、关闭 888(phpMyAdmin)公网访问、MySQL 3306 绝不对外开放,改用 SSH 隧道 ssh -L 3306:127.0.0.1:3306 root@服务器IP。忘记面板密码可执行 cd /www/server/panel && python3 tools.py panel 新密码。生产环境优先用 SFTP(22 端口)替代 FTP,省掉被动端口放行与明文传输风险。

第二步:多版本 PHP 与 Nginx 环境搭建、调优配置示例

面板 → 软件商店安装 PHP 7.4 / 8.1 / 8.2(老 CMS 留在 7.4,新框架上 8.2),Nginx 选 1.24 以上。命令行确认:

ls /www/server/php/
/www/server/php/82/bin/php -v
/www/server/php/82/bin/php -m | grep -E 'opcache|fileinfo|redis|pdo_mysql'
nginx -V 2>&1 | tr ' ' 'n' | grep -E 'http_ssl_module|http_v2_module'

站点配置示例(宝塔生成在 /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;
    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 on;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;

    client_max_body_size 100m;
    access_log /www/wwwlogs/example.com.log;
    error_log  /www/wwwlogs/example.com.error.log;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
    location ~ .php$ {
        fastcgi_pass unix:/tmp/php-cgi-82.sock;
        fastcgi_index index.php;
        include fastcgi.conf;
        fastcgi_read_timeout 300;
    }
    location ~ /.(?!well-known) { deny all; }
}

PHP-FPM 进程池 /www/server/php/82/etc/php-fpm.d/www.conf:pm.max_children 按「可用内存 MB ÷ 单进程常驻 50 MB」估算,2 GB 机器取 30 左右;pm.max_requests = 500 防内存泄漏;request_terminate_timeout = 300。

php.ini 关键项:memory_limit = 256M、upload_max_filesize = 100M、post_max_size = 100M、max_execution_time = 300、date.timezone = Asia/Shanghai,并开启 opcache.enable=1、opcache.memory_consumption=128、opcache.max_accelerated_files=10000。改完执行 nginx -t && nginx -s reload,PHP 用 /etc/init.d/php-fpm-82 reload 平滑生效。

第三步:MySQL 数据库导入导出与网站对接

宝塔 MySQL 二进制在 /www/server/mysql/bin/。InnoDB 大库用 --single-transaction 免锁表,MySQL 8 加 --set-gtid-purged=OFF 避免 GTID 报错:

/www/server/mysql/bin/mysqldump -uroot -p'密码' 
  --single-transaction --quick --routines --triggers --events 
  --default-character-set=utf8mb4 --set-gtid-purged=OFF 
  example_db > /root/example_db_$(date +%F).sql
gzip -9 /root/example_db_*.sql

# 导入(先建库)
/www/server/mysql/bin/mysql -uroot -p'密码' -e 'CREATE DATABASE IF NOT EXISTS example_db DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci;'
/www/server/mysql/bin/mysql -uroot -p'密码' --default-character-set=utf8mb4 example_db < /root/example_db_20250101.sql

给站点单独建账号,禁止程序直接用 root:

CREATE USER 'app'@'127.0.0.1' IDENTIFIED BY '强随机密码';
GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,INDEX,ALTER ON example_db.* TO 'app'@'127.0.0.1';
FLUSH PRIVILEGES;
SELECT table_schema, ROUND(SUM(data_length+index_length)/1024/1024,2) AS mb
FROM information_schema.tables GROUP BY table_schema ORDER BY mb DESC;

程序侧改 wp-config.php / .env / config/database.php:DB_HOST=127.0.0.1(不要写 localhost,PHP 会走 socket 并可能报 [2002] No such file or directory)、DB_NAME=example_db、charset=utf8mb4。

备份用面板 → 计划任务 → 备份数据库(保留最近 7 份),或写 crontab:0 3 * * * /www/server/mysql/bin/mysqldump -uroot -p密码 --single-transaction --default-character-set=utf8mb4 example_db | gzip > /www/backup/db_$(date +%F).sql.gz。注意 crontab 中的 % 必须转义成 %,否则任务不执行。

第四步:SSL 证书申请、CSR 生成与 HTTPS 部署

向商业 CA 申请需要 CSR,且必须带 SAN,否则 www 子域不生效:

openssl req -new -newkey rsa:2048 -sha256 -nodes 
  -keyout example.com.key -out example.com.csr 
  -subj '/C=CN/ST=Beijing/L=Beijing/O=Example Tech/CN=example.com' 
  -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'

免费证书用 acme.sh(支持 DNS API 与自动续签):

curl https://get.acme.sh | sh -s email=admin@example.com
source ~/.bashrc
~/.acme.sh/acme.sh --set-default-ca --server letsencrypt
~/.acme.sh/acme.sh --issue -d example.com -d www.example.com 
  -w /www/wwwroot/example.com --keylength ec-256
~/.acme.sh/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 -t && nginx -s reload'

有效期必须记住两条硬规则:公有 CA(DV/OV/EV)单张证书有效期上限 398 天;Let’s Encrypt 固定 90 天,acme.sh 默认在到期前 30 天自动续签,但要确认 crontab 中存在 ~/.acme.sh/acme.sh --cron 且 --reloadcmd 真正执行。HTTPS 段统一使用 ssl_protocols TLSv1.2 TLSv1.3,禁用 TLSv1.0/1.1 与 RC4/3DES。HSTS 先设 max-age=300 验证,确认全站 HTTPS 后再改 31536000,因为它会被浏览器缓存且不可回退。

证书链必须完整:fullchain.pem = 站点证书 + 中间证书。缺中间证书时桌面 Chrome 正常,部分安卓与微信内置浏览器会报 NET::ERR_CERT_AUTHORITY_INVALID。验证命令:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null。

第五步:网站搬家(数据迁移)完整流程

前置:新机装同版本面板与同版本 PHP/MySQL;老站 DNS TTL 提前 24 小时调到 300 秒,缩短切换窗口。

# 1. 老机打包站点(排除缓存与日志)
cd /www/wwwroot
tar -czf /root/site_$(date +%F).tar.gz --exclude='*/runtime/cache/*' --exclude='*/logs/*' example.com

# 2. 导出数据库(用上一步的 mysqldump 命令)
# 3. 传输到新机
rsync -avzP -e 'ssh -p 22' /root/site_20250101.tar.gz root@新IP:/root/
rsync -avzP -e 'ssh -p 22' /root/example_db_20250101.sql.gz root@新IP:/root/
# 4. 新机还原
tar -xzf /root/site_20250101.tar.gz -C /www/wwwroot/
chown -R www:www /www/wwwroot/example.com
find /www/wwwroot/example.com -type d -exec chmod 755 {} ;
find /www/wwwroot/example.com -type f -exec chmod 644 {} ;
gunzip -c /root/example_db_20250101.sql.gz | /www/server/mysql/bin/mysql -uroot -p'密码' --default-character-set=utf8mb4 example_db

面板 → 网站 → 添加站点,域名、根目录、PHP 版本、伪静态规则(WordPress / ThinkPHP 等)必须与老站一致;SSL 证书重新签发,或整目录复制 /www/server/panel/vhost/cert/。修改程序配置里的数据库地址与密码,清空 runtime/、cache/、storage/framework/views/ 下的旧缓存。

切换前用 --resolve 验证新机,不动 DNS 也能测:

curl -I --resolve example.com:443:新IP https://example.com
curl -s --resolve example.com:443:新IP https://example.com | head -n 20

确认无误后切 DNS,观察 24-48 小时(dig +short example.com 核对解析),老机保留 7 天再下架。站点多且两端面板版本一致时可用「宝塔一键迁移」插件(需两端开启 API 并放行面板端口);单库超过 2 GB 建议坚持 tar + mysqldump + rsync 分步迁移,中途失败可断点重来。

方案对比:环境搭建方式、证书类型与迁移方式

选型直接决定后续维护成本,下面三张表按实际运维经验整理(耗时以 2 核 4 G 云服务器为基准)。

环境搭建方式 耗时 可控性 适用场景
宝塔极速安装 3-5 分钟 中,扩展受仓库限制 中小站点快速上线、测试环境
宝塔编译安装 30-60 分钟 高,可自定义编译参数 需要 redis / fileinfo / imagemagick 等扩展
手动 LNMP 源码编译 2-4 小时 最高,配置全部落盘可审计 生产环境标准化、合规审计
Docker 容器化 10 分钟 高,环境可版本化 多环境隔离、CI/CD 流水线
证书类型 有效期上限 验证方式 适用场景
Let’s Encrypt(DV 免费) 90 天 域名 / DNS 校验 个人站、测试环境、内部系统
商业 DV 398 天 域名校验 中小企业官网
OV 398 天 企业实名审核 电商、对外 API 服务
EV 398 天 严格主体审核 金融、支付(地址栏已不显示公司名)
迁移方式 停机时间 风险点 适用场景
面板一键迁移 5-20 分钟 两端面板/环境版本需一致,大库易超时 同版本面板、站点数量多
tar + mysqldump + rsync 可控,切 DNS 约 10 分钟 需人工核对伪静态与目录权限 通用方案,大库首选
云厂商整机镜像/快照 分钟级 内网 IP、授权绑定需重配 同账号同区域同规格

结论:日 PV 一万以下用宝塔编译安装 + Let’s Encrypt 自动续签 + rsync 迁移即可;对外支付类业务优先 OV 证书(398 天)并单独配置到期监控,避免 90 天短周期证书在高并发业务中因续签失败造成全站不可访问。

常见错误排查与效果验证

真实报错与处理

  1. 502 Bad Gateway,example.com.error.log 中出现 connect() to unix:/tmp/php-cgi-82.sock failed (2: No such file or directory):PHP-FPM 未启动或 socket 名不符。执行 /etc/init.d/php-fpm-82 start,再用 ls /tmp/php-cgi-*.sock 核对后改 fastcgi_pass。
  2. 1045 Access denied for user ‘app’@’localhost’ (using password: YES):主机不匹配或认证插件不兼容。查 SELECT user,host,plugin FROM mysql.user;,MySQL 8 老程序可执行 ALTER USER 'app'@'127.0.0.1' IDENTIFIED WITH mysql_native_password BY '密码';
  3. SQLSTATE[HY000] [2002] No such file or directory:程序连 localhost 走了 socket,改成 127.0.0.1。
  4. 413 Request Entity Too Large:Nginx client_max_body_size 100m; 与 PHP 的 post_max_size、upload_max_filesize 三处都要改。
  5. NET::ERR_CERT_DATE_INVALID:证书过期,openssl x509 -noout -enddate -in fullchain.pem 看到期日,重新续签。
  6. SSL_ERROR_RX_RECORD_TOO_LONG / ERR_SSL_PROTOCOL_ERROR:用 https 访问了 80 端口,或 443 段缺 ssl_certificate 指令。
  7. nginx: [emerg] unknown directive ‘ssl_certificate’:Nginx 未编译 SSL 模块,nginx -V | grep -o with-http_ssl_module 结果为空则需重装 Nginx。
  8. 403 Forbidden:属主或权限错误,namei -l /www/wwwroot/example.com/index.php 逐级核对,属主必须是 www:www,目录 755、文件 644。
  9. 425 Failed to establish connection(FTP):被动端口 39000-40000 未在防火墙与安全组放行。
  10. 面板 ERR_CONNECTION_REFUSED:bt start 启动服务,再确认端口已放行。

效果验证清单

# 端口与服务
ss -lntp | grep -E ':(80|443|21|3306|28888)b'
systemctl status nginx --no-pager
/etc/init.d/php-fpm-82 status

# HTTP 状态与各阶段耗时
curl -s -o /dev/null -w 'code=%{http_code} dns=%{time_namelookup} tls=%{time_appconnect} ttfb=%{time_starttransfer} total=%{time_total}n' https://example.com

# 证书主体、签发者、有效期
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates

# TLS 版本与套件
nmap --script ssl-enum-ciphers -p 443 example.com

# 数据库连通性
/www/server/mysql/bin/mysql -uapp -p -h127.0.0.1 -e 'SELECT 1;'

达标参考:证书剩余天数 > 30 天、TLS 握手 < 300 ms(同区域)、TTFB < 500 ms、curl 返回 200 且无混合内容告警、ssl-enum-ciphers 输出中 TLSv1.0/1.1 为 disabled。全部通过后再切 DNS 或交付客户。

常见问题

先执行 bt default 确认端口,再用 ss -lntp | grep 8888 看服务是否监听,最后检查云厂商安全组和 firewalld/ufw 是否放行该端口;面板服务停止用 bt start 启动,忘记密码用 cd /www/server/panel && python3 tools.py panel 新密码 重置。


Let’s Encrypt 只签发 90 天 DV 证书,不支持自定义有效期。398 天是 CA/B 论坛对公有 CA 单张证书的有效期上限,只有商业 DV/OV/EV 证书能签到接近该上限。免费证书必须依赖 acme.sh 或面板自动续签,建议保留 30 天余量监控。


通常是伪静态规则没同步。宝塔的伪静态配置在站点 conf 的 rewrite 段,换机后需在新站点「伪静态」里选同一套规则(如 WordPress/ThinkPHP),并确认 Nginx 中存在 try_files $uri $uri/ /index.php?$query_string;,改完执行 nginx -t && nginx -s reload。


说明 PHP-FPM 没启动或 socket 名不一致。执行 /etc/init.d/php-fpm-82 start 启动,用 ls /tmp/php-cgi-*.sock 查看实际文件名,把 Nginx 里的 fastcgi_pass 改成一致即可。多版本 PHP 切换后最容易出现这个报错。


导出和导入都必须显式加 –default-character-set=utf8mb4,并确认表结构是 utf8mb4。已经乱码的数据无法靠改字符集恢复,需要从源库重新导出导入;程序连接串也要带 charset=utf8mb4,否则写入仍是错的。


多半是主机不匹配或认证插件不兼容。用 SELECT user,host,plugin FROM mysql.user; 查看账号是 ‘app’@’localhost’ 还是 ‘app’@’127.0.0.1’,PHP 用 127.0.0.1 连接时匹配不到 localhost 账号;MySQL 8 的 caching_sha2_password 老程序不支持,可改为 mysql_native_password。

内容审核

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