在 Alibaba Cloud Linux 3 (基于 CentOS/RHEL 8+ 体系) 上安装宝塔面板,核心痛点在于包管理器从 yum 切换到了 dnf,以及 SELinux 和防火墙策略的严格化。
直接照搬 CentOS 7 的脚本大概率会报错或导致环境异常。以下是经过验证的稳定安装步骤及避坑指南。
1. 前置准备:系统初始化
登录服务器后,建议先执行以下基础清理和优化,避免后续依赖冲突。
# 更新系统内核和基础软件(可选,但推荐)
sudo dnf update -y
# 关闭防火墙(宝塔自带防火墙,建议先关系统防火墙以免端口不通)
sudo systemctl stop firewalld
sudo systemctl disable firewalld
# 关闭 SELinux(宝塔对 SELinux 兼容性一般,建议临时或永久关闭)
setenforce 0
sed -i 's/^SELINUX=enforcing$/SELINUX=disabled/' /etc/selinux/config
# 安装必要的基础工具
sudo dnf install -y wget curl vim unzip tar gcc make openssl-devel pcre-devel zlib-devel
注意:Alibaba Cloud Linux 3 默认使用
dnf而非yum,但宝塔官方脚本通常做了兼容处理。如果脚本提示找不到yum,可以创建一个软链接:sudo ln -s /usr/bin/dnf /usr/bin/yum
2. 安装宝塔面板
目前宝塔主推的是 BT Panel 9.x 版本,对新版 Linux 支持更好。推荐使用官方提供的最新稳定版脚本。
# 下载并执行安装脚本
wget -O install.sh https://download.bt.cn/install/install_6.0.sh && sh install.sh ed8484bec
- 参数说明:
ed8484bec是特定版本的校验码,确保你安装的是最新稳定版。如果你不确定,可以直接运行sh install.sh,它会尝试检测最新版本。 - 等待时间:编译安装可能需要 5-10 分钟,期间不要中断 SSH 连接。
3. 关键配置与排错
安装完成后,终端会输出内网/网络访问地址、用户名和密码。请务必截图保存。
A. 放行安全组(阿里云特有)
这是新手最容易踩的坑。宝塔面板默认监听 8888 端口。
- 登录阿里云控制台。
- 进入 ECS 实例 -> 安全组 -> 配置规则。
- 添加入方向规则:
- 协议:TCP
- 端口范围:8888/8888
- 授权对象:0.0.0.0/0(或指定你的 IP)
B. 绑定域名(推荐)
为了安全,强烈建议在宝塔面板后台设置“面板入口”为自定义域名,而不是直接使用 IP:8888。
- 登录宝塔 Web 界面。
- 左侧菜单 -> 面板设置 -> 面板入口。
- 修改端口(建议改为非标准端口,如 8889),并绑定一个已解析到该服务器的域名。
C. 解决常见报错
问题 1:安装过程中提示 “No module named ‘lib'” 或 Python 相关错误
- 原因:Alibaba Cloud Linux 3 默认 Python 版本可能较高(3.6+),而旧版宝塔脚本依赖 Python 2 或特定库。
- 解决:确保安装了
python3-pip和python3-devel。如果仍报错,可尝试手动安装宝塔所需的依赖:sudo dnf install -y python3-pip python3-devel sudo pip3 install --upgrade pip
问题 2:网站无法访问,提示 502 Bad Gateway
-
原因:Nginx 或 PHP-FPM 未启动,或权限不足。
-
解决:
# 检查服务状态 systemctl status nginx systemctl status php-fpm-74 # 以 PHP 7.4 为例 # 重启服务 systemctl restart nginx systemctl restart php-fpm-74
问题 3:数据库连接失败
- 原因:MySQL 未正确初始化或密码错误。
- 解决:在宝塔面板中重置 MySQL 密码,并确认远程连接权限是否开启(如需外部工具连接)。
4. 优化建议(针对 Alibaba Cloud Linux 3)
- 启用 Swap:云服务器内存较小(如 2G 以下)时,务必在宝塔面板“安全”页面开启 Swap,防止 OOM(内存溢出)。
- 使用 Nginx + OpenResty:Alibaba Cloud Linux 3 对高性能 Web 服务器支持良好,建议使用宝塔内置的 OpenResty 替代标准 Nginx,性能更优。
- 定期备份:利用宝塔的“计划任务”功能,将网站文件和数据库自动备份到阿里云 OSS 或本地磁盘。
- 禁用不必要的模块:在宝塔面板“软件商店”中,只安装你需要的组件(如仅装 PHP 7.4 + MySQL 5.7),减少攻击面。
5. 总结
在 Alibaba Cloud Linux 3 上安装宝塔的核心流程是:
- 关闭 SELinux 和 firewalld。
- 创建
yum软链接指向dnf。 - 执行官方最新安装脚本。
- 重点:在阿里云控制台放行 8888 端口。
遵循以上步骤,即可顺利部署宝塔面板。如遇特殊报错,可查看 /tmp/panelBoot.pl 日志获取详细信息。
云技术博客