宝塔 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 天短周期证书在高并发业务中因续签失败造成全站不可访问。
常见错误排查与效果验证
真实报错与处理
- 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。 - 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 '密码'; - SQLSTATE[HY000] [2002] No such file or directory:程序连
localhost走了 socket,改成127.0.0.1。 - 413 Request Entity Too Large:Nginx
client_max_body_size 100m;与 PHP 的post_max_size、upload_max_filesize三处都要改。 - NET::ERR_CERT_DATE_INVALID:证书过期,
openssl x509 -noout -enddate -in fullchain.pem看到期日,重新续签。 - SSL_ERROR_RX_RECORD_TOO_LONG / ERR_SSL_PROTOCOL_ERROR:用 https 访问了 80 端口,或 443 段缺
ssl_certificate指令。 - nginx: [emerg] unknown directive ‘ssl_certificate’:Nginx 未编译 SSL 模块,
nginx -V | grep -o with-http_ssl_module结果为空则需重装 Nginx。 - 403 Forbidden:属主或权限错误,
namei -l /www/wwwroot/example.com/index.php逐级核对,属主必须是www:www,目录 755、文件 644。 - 425 Failed to establish connection(FTP):被动端口 39000-40000 未在防火墙与安全组放行。
- 面板 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。