一、检查系统环境兼容性
- 必须使用64位Linux系统(CentOS/Ubuntu/Debian等)
- Python版本需≥2.7或3.6,可通过
python -V
命令验证 - 根分区剩余空间建议≥5GB,使用
df -h
查看磁盘容量
二、排查网络连接问题
安装失败常见于网络环境异常,建议按序执行:
- 使用
ping download.bt.cn
测试下载服务器连通性 - 更换国内镜像源:
curl -sSO http://download.bt.cn/install/install_panel.sh && bash install_panel.sh
- 检查DNS解析是否正常,临时改用阿里云DNS 223.5.5.5
三、处理端口与防火墙配置
天翼云主机需同时配置系统防火墙和云平台安全组:
- 开放8888端口:
firewall-cmd --add-port=8888/tcp --permanent
- 检查端口占用情况:
netstat -tulnp | grep 8888
- 在天翼云控制台安全组规则中添加TCP:8888入站规则
四、验证依赖项安装状态
出现模块安装失败时,可手动修复环境:
mv /www/server/panel/pyenv /root/
curl -sSO http://download.bt.cn/install/install_panel.sh && bash install_panel.sh
btpip install psutil gevent
执行后通过ps aux | grep bt
检查服务进程状态
通过分阶段排查系统环境、网络配置、端口规则和依赖安装,可解决天翼云主机上90%的宝塔面板安装失败问题。建议安装完成后立即执行面板升级命令bt default
获取最新安全补丁。