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

宝塔面板 LNMP 实战:PHP 站点、FTP、SSL 证书与数据库一次配通

宝塔面板 LNMP 实战:PHP 站点、FTP、SSL 证书与数据库一次配通 — 宝塔面板 LNMP 实战:PHP 站点、FTP、SSL 证书与数据库一次配通

为什么“装完宝塔”离“网站能用”还差五步

原文把需求写成“安装宝塔 + 装 FTP + 配 PHP + 上 SSL + 建数据库”,这在工单里只是一句话,在服务器上却涉及五层独立依赖。绝大多数“装完打不开”的问题,都出在下面几个根因上。

  • 网络层:云安全组和系统防火墙是两套规则。只放行 80/443,而 FTP 被动模式端口段 39000-40000 没有放行时,表现就是能登录、列目录卡死,客户端报 425 Failed to establish connection。
  • 权限层:Nginx 的 worker 用户 www 与 PHP-FPM socket 的属主不一致,日志里会出现 connect() to unix:/tmp/php-cgi-81.sock failed (13: Permission denied);SELinux 处于 enforcing 时还会额外拦截 Nginx 读取 /www/wwwroot。
  • 协议层:FTP 主动模式(PORT)在 NAT 或云主机后面必然失败,必须切换到被动模式(PASV),并把公网 IP 写入 ForcePassiveIP。
  • 证书层:只部署站点证书、不部署中间证书,浏览器可能“能打开”,但 curl、Java 客户端和部分 Android 会报 unable to get local issuer certificate。有效期方面要记住两条:公网 TLS 证书单张最长 398 天(CA/B 论坛规定),Let’s Encrypt 免费证书固定 90 天,需在到期前 30 天完成续期。
  • 数据层:MySQL 的 3306 端口直接对公网开放,几天内就会收到爆破流量;宝塔面板 8888 端口在公网直接暴露也是同样问题。

下文按“初始化 → LNMP/PHP → FTP → SSL → 数据库 → 排错 → 验证”的顺序,给出可以直接复制执行的命令,环境以 CentOS 7/8、Ubuntu 22.04 + 宝塔 9.x 为例。

服务器初始化与宝塔面板安装

前置条件:全新系统、root 权限、域名 A 记录已指向服务器公网 IP(用 dig +short example.com 确认生效)。

# 1. 确认系统版本并校准时间
cat /etc/os-release
timedatectl set-timezone Asia/Shanghai
chronyc makestep 2>/dev/null || ntpdate -u ntp.aliyun.com

# 2. 关闭 SELinux(宝塔与 enforcing 冲突较多,生产可先用 permissive 观察)
setenforce 0
sed -i 's/^SELINUX=enforcing/SELINUX=permissive/' /etc/selinux/config

# 3. 安装宝塔面板 LTS 版(脚本以官网最新为准)
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 default 查看,直接输入 bt 可进入菜单修改密码(5)、修改面板端口、重启面板。随后放行端口:

# firewalld
firewall-cmd --permanent --add-port=80/tcp --add-port=443/tcp 
  --add-port=21/tcp --add-port=39000-40000/tcp --add-port=8888/tcp
firewall-cmd --reload

# ufw(Ubuntu)
ufw allow 80/tcp; ufw allow 443/tcp; ufw allow 21/tcp
ufw allow 39000:40000/tcp; ufw allow 8888/tcp

云厂商的安全组必须在控制台单独放行同样的端口,这一步漏了,系统防火墙配得再对也没用。安全加固建议:面板端口改成 5 位非默认端口,开启面板 SSL,并在“面板设置 → 授权 IP”里只允许自己的出口 IP;3306 一律不放行公网,需要远程时走 SSH 隧道。

LNMP 与 PHP 站点配置

在软件商店选 Nginx 1.24 + MySQL 8.0 + PHP 8.1,建议编译安装(性能和扩展可控),PHP 扩展勾选 opcache、redis、fileinfo、mysqli、pdo_mysql、gd、intl、zip。PHP-FPM 进程数按内存估算:pm.max_children ≈ 可用内存(MB) / 单进程平均占用(40-60MB),2C4G 机器建议如下:

# /www/server/php/81/etc/php-fpm.d/www.conf
pm = dynamic
pm.max_children = 50
pm.start_servers = 10
pm.min_spare_servers = 5
pm.max_spare_servers = 20
pm.max_requests = 500
request_terminate_timeout = 100

改完执行 /etc/init.d/php-fpm-81 reload。宝塔默认让 PHP-FPM 监听 unix:/tmp/php-cgi-81.sock,先确认属主是否为 www:

ls -l /tmp/php-cgi-81.sock
# 期望输出:srw-rw---- 1 www www ... /tmp/php-cgi-81.sock

Nginx 站点配置(/www/server/panel/vhost/nginx/example.com.conf):

server {
    listen 80;
    server_name example.com www.example.com;
    root /www/wwwroot/example.com;
    index index.php index.html;
    access_log /www/wwwlogs/example.com.log;
    location / { try_files $uri $uri/ /index.php?$args; }
    location ~ .php$ {
        fastcgi_pass unix:/tmp/php-cgi-81.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
    location ~ /.(user.ini|htaccess) { deny all; }
}

保存后执行 nginx -t && nginx -s reload。数据库可在面板“数据库”页创建,也可用命令行建库建号:

CREATE DATABASE `wpdb` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'wpuser'@'localhost' IDENTIFIED BY 'Str0ng!Passw0rd';
GRANT ALL PRIVILEGES ON `wpdb`.* TO 'wpuser'@'localhost';
FLUSH PRIVILEGES;
-- 老程序(PHP 7 以下驱动)不认 caching_sha2_password 时:
ALTER USER 'wpuser'@'localhost' IDENTIFIED WITH mysql_native_password BY 'Str0ng!Passw0rd';

FTP(Pure-Ftpd)配置与被动端口放行

在面板“FTP”页添加账号,根目录指向 /www/wwwroot/example.com,记下用户名和密码。真正决定能不能连上的是配置文件里的几行:

# /www/server/pure-ftpd/etc/pure-ftpd.conf
ChrootEveryone      yes
MaxClientsNumber    50
PassivePortRange    39000 40000
ForcePassiveIP      203.0.113.10   # 换成你的公网 IP,NAT 下必填
PureDB              /www/server/pure-ftpd/etc/pureftpd.pdb

改完重启并验证监听与被动模式:

/etc/init.d/pure-ftpd restart
ss -lntp | grep -E ':(21|39000)b'
curl --ftp-pasv -u ftpuser:password ftp://203.0.113.10/ -l

如果服务器返回 227 进入被动模式,但数据连接一直超时,基本就是 39000-40000 没有放行,或者 ForcePassiveIP 写成了内网地址(如 172.17.x.x)。另外要明确一点:FTP 全程明文,账号密码可被中间人抓包,生产环境优先用 SFTP(走 22 端口,WinSCP/FileZilla 选 SFTP 协议),FTP 只留给老系统对接或临时传包。若合规要求必须用 FTPS,Pure-Ftpd 需额外配置证书,客户端选择 explicit TLS(端口 21)而不是 implicit TLS(990)。

SSL 证书申请与部署

两种方式。方式 A 用面板一键:网站 → SSL → Let’s Encrypt,要求 80 端口可访问且域名解析正确,面板会自动写入续期计划任务。方式 B 用 acme.sh 命令行,适合通配符和 DNS 验证场景:

curl https://get.acme.sh | sh -s email=you@example.com
source ~/.bashrc
# 指定 Let's Encrypt(新版 acme.sh 默认 CA 是 ZeroSSL)
~/.acme.sh/acme.sh --set-default-ca --server letsencrypt
# 文件验证,80 端口必须放行
~/.acme.sh/acme.sh --issue -d example.com -d www.example.com -w /www/wwwroot/example.com
# 部署到宝塔证书目录并自动 reload
~/.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 -s reload'

站点 443 端口配置片段:

listen 443 ssl http2;
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;
ssl_prefer_server_ciphers on;
ssl_session_cache shared:SSL:10m;
add_header Strict-Transport-Security 'max-age=31536000' always;

三个硬知识点:① 必须使用 fullchain(站点证书 + 中间证书),只配站点证书会让 curl、Java 报证书链不完整;② 有效期:公网证书单张最长 398 天,Let’s Encrypt 固定 90 天,acme.sh 默认在到期前 60 天自动续期,宝塔的续期任务每天检查一次;③ 80 端口加 return 301 https://$host$request_uri; 做强制跳转,HSTS 的 max-age 先设短一点观察,确认全站资源都是 HTTPS 后再调大。

方案对比:安装方式与证书类型

同一套需求有不同实现路径,选错会直接影响后期维护成本。下面两张表是实际选型时最常对照的维度。

维度 宝塔编译安装 宝塔极速安装 手动 LNMP 一键包
安装耗时 40-90 分钟 5-15 分钟 20-40 分钟
性能 可按 CPU 指令集优化 通用预编译包 取决于脚本参数
扩展与升级 面板可视化,可控 受限于预编译 全手动
故障定位 日志路径固定,易查 同左 需自行约定目录
适用场景 生产站,需 opcache/redis 调优 测试、临时环境 追求最小化、不要面板
证书类型 有效期上限 验证方式 覆盖范围 典型用途
DV 单域名 398 天 文件 / DNS 1 个域名 个人站、API 网关
DV 通配符 398 天 DNS *.example.com 多子域业务
OV / EV 398 天 企业资质审核 组织信息展示 电商、金融
Let’s Encrypt 90 天 文件 / DNS 单域或通配符 免费、可全自动续期

结论:能自动化就上 Let’s Encrypt + acme.sh,不要为了省事买 1 年期证书然后忘记续费——证书到期前一天才想起来续,是线上事故的高频来源。

常见错误排查(含真实报错)

  • 502 Bad Gateway,Nginx 错误日志为 connect() to unix:/tmp/php-cgi-81.sock failed (13: Permission denied) while connecting to upstream:socket 属主或权限不对,或 PHP-FPM 没起来。执行 ls -l /tmp/php-cgi-81.sock、/etc/init.d/php-fpm-81 restart,确认 nginx.conf 的 user www; 与 php-fpm 的 user = www 一致;SELinux 未关时先 setenforce 0 复测。
  • nginx: [emerg] cannot load certificate "/www/server/panel/vhost/cert/example.com/fullchain.pem": No such file or directory:证书未部署或路径拼错,重新执行 acme.sh 的 --install-cert,再用 ls -l 核对文件名(宝塔目录里是 fullchain.pem,不是 cert.pem)。
  • curl: (60) SSL certificate problem: unable to get local issuer certificate:缺中间证书。用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 看返回的证书是否 2 张以上,改配 fullchain 即可。
  • acme.sh 报 Verify error:Invalid response from http://example.com/.well-known/acme-challenge/xxxx: 404:80 端口被 301 规则拦截、-w 指向的根目录不对,或域名走了 CDN。临时注释跳转规则,确认根目录,或改用 DNS 验证 --dns dns_ali。
  • Pure-FTPd 报 530 Login authentication failed:密码错误或 pureftpd.pdb 未刷新,面板改密后必须重启 FTP 服务;报 425 Failed to establish connection:被动端口段未放行,或 ForcePassiveIP 写成了内网地址。
  • MySQL 报 ERROR 1045 (28000): Access denied for user 'wpuser'@'localhost' (using password: YES):密码错、host 不匹配(localhost 走 socket,127.0.0.1 走 TCP),或认证插件不兼容。先 SELECT user,host,plugin FROM mysql.user; 定位,再按需 ALTER USER ... IDENTIFIED WITH mysql_native_password BY ...。
  • bind() to 0.0.0.0:443 failed (98: Address already in use):有 Apache 或旧 Nginx 重复监听,ss -lntp | grep :443 找到 PID 后停掉冲突服务。

效果验证清单

配置完成不等于交付完成,下面 7 条命令逐条通过再交付:

# 1. 端口与进程
ss -lntp | grep -E ':(80|443|21|3306)b'
# 2. 配置语法
nginx -t
# 3. 跳转与状态码
curl -sI http://example.com | head -3     # 期望 301
curl -sI https://example.com | head -3    # 期望 200
# 4. 证书链与有效期
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates
# 5. 剩余天数检测(少于 30 天该续期了)
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -checkend 2592000 && echo 'OK: 30 天内不会过期'
# 6. PHP 与数据库连通
curl -s https://example.com/info.php | grep -i 'php version'
mysql -uwpuser -p -h127.0.0.1 wpdb -e 'select 1;'
# 7. FTP 被动模式
curl --ftp-pasv -u ftpuser:pass ftp://203.0.113.10/ -l

最后用浏览器开发者工具的 Security 面板确认证书有效,或把域名交给 SSL Labs 测一遍拿 A 级以上;面板“网站 → 监控”里看 502、499 是否归零。全部通过后,把 root 密码、面板入口、FTP 账号收进密码管理器或堡垒机,不要留在聊天记录和工单截图里——很多被入侵的服务器,入口就是这些“临时发一下”的凭据。

常见问题

宝塔面板必须用 root 吗?能不能只给普通用户?

安装和大部分运维操作需要 root,因为要写 /www、改系统服务、监听 80/443。生产环境不建议直接长期用 root 登录 SSH:建议创建普通用户 + sudo,SSH 改为密钥登录并禁用密码认证,面板本身开启二次验证和授权 IP。如果必须把服务器交给外部人员,优先开临时账号并在操作完成后回收,而不是长期共享 root 密码。

Let’s Encrypt 只有 90 天,能不能申请 1 年的免费证书?

不能。公共信任的 TLS 证书有效期上限是 398 天(CA/B 论坛规定,2020 年 9 月起生效),Let’s Encrypt 更严格,固定 90 天。正确的做法不是找“长期限”,而是把续期自动化:acme.sh 安装时会写入 cron,默认到期前 60 天自动续;宝塔的续期任务每天检查一次。只要 80 或 DNS 验证通道长期可用,续期就是无感的。

服务器上已经有 Apache,还能装宝塔的 Nginx 吗?

可以装,但不能同时监听 80/443。二选一:要么停掉 Apache(systemctl stop httpd && systemctl disable httpd)改用 Nginx,要么在宝塔里只装 Nginx 不启动,由 Apache 反代到 Nginx 的非标准端口。混跑最常见的结果就是 bind() to 0.0.0.0:443 failed (98: Address already in use),重启后站点全挂。

FTP 和 SFTP 到底该用哪个?

优先 SFTP。它走 22 端口、复用 SSH 加密通道,不需要额外放行 39000-40000,也不存在明文密码问题。FTP 只在两种情况下保留:老系统只支持 FTP 协议对接,或临时迁移需要给非技术同事一个图形化入口。即便如此,也应限制账号目录(ChrootEveryone yes)、限制 IP 来源,用完即删。

面板 8888 端口天天被扫描,怎么处理?

三步:改端口(面板设置里改成一个 5 位随机端口)、开面板 SSL、设置授权 IP 白名单,只允许公司出口 IP 访问。再加一层:安全组里对面板端口只放行固定源 IP,公网全放行等于把管理后台挂在互联网上。若需要多地访问,用 SSH 隧道 ssh -L 8888:127.0.0.1:8888 user@server 本地转发更安全。

换服务器时证书和站点怎么迁移?

面板自带“迁移”工具可整站打包,但证书私钥、数据库、计划任务要单独核对。手工方式:旧机打包 /www/wwwroot 与数据库 mysqldump -uroot -p --single-transaction wpdb > wpdb.sql;新机建站后导入;证书重新在 new 机执行 acme.sh --issue 更干净(域名解析切到新 IP 后验证才能通过)。切记不要在 DNS 还没切换完成时就去签证书,否则文件验证必然 404。

内容审核

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