宝塔面板要求纯净系统环境,推荐CentOS 7.9/8.5、Ubuntu 20.04+、Debian 10+,需开放8888、80、443端口,用LTS安装脚本,首次访问忽略HTTPS证书警告,登录后勿盲目一键部署LNMP。

确认服务器是否满足安装前提
宝塔面板不是所有 Linux 服务器都能直接装,最常踩的坑就是“装一半失败”或“装完打不开面板”,根本原因往往是环境不干净。它明确要求是全新、纯净的系统——没装过 Apache/Nginx/MySQL/PHP/Python 环境,没改过防火墙规则,没手动编译过关键组件。
常见错误现象:sh install.sh 执行后卡在 Checking system... 或报错 port 8888 is occupied,大概率是已有服务占用了端口,或之前装过其他面板残留了进程和配置。
- 推荐系统:CentOS 7.1+(实测 CentOS 7.9 / 8.5 最稳)、Ubuntu 20.04+、Debian 10+
- 必须开放的端口:
8888(面板默认)、80(HTTP)、443(HTTPS),阿里云/腾讯云等平台还需在安全组里手动放行 - 不要用 Docker 容器或 OpenVZ 虚拟化低权限环境,部分轻量应用服务器(如腾讯云轻量)需确认是否支持
systemd
执行安装命令时选对脚本和参数
官网提供的安装命令不止一种,不同脚本对应不同稳定性和功能集,乱用容易导致后续升级异常或插件不兼容。目前生产环境建议优先用 LTS(长期支持)版,而不是最新版 install_6.0.sh。
常见错误现象:执行 wget -O install.sh http://download.bt.cn/install/install.sh 后提示 command not found: wget,说明系统没预装基础工具;或安装完成后访问 https://ip:8888 显示连接被拒绝,其实是脚本没正确检测到系统版本,用了不匹配的安装逻辑。
- CentOS 系统推荐命令:
curl -sSO https://download.bt.cn/install/install_lts.sh && bash install_lts.sh - Ubuntu/Debian 推荐命令:
wget -O install.sh https://download.bt.cn/install/install-ubuntu_lts.sh && sudo bash install.sh - 执行中遇到
Do you want to install Bt-Panel to the /www directory now?(y/n),必须输y回车,否则安装会中断 - 别复制网页上带中文空格或全角符号的命令,容易静默失败
安装成功后第一件事不是点“一键部署”,而是配好访问入口
安装脚本跑完会输出一串类似 https://123.56.78.90:8888/abc123de 的地址,很多人直接复制进浏览器,结果看到“您的连接不是私密连接”就懵了——这不是错误,是 HTTPS 自签名证书的正常提示。
常见错误现象:点击“继续前往”后仍无法登录,或输入账号密码后反复跳回登录页,大概率是浏览器缓存了旧面板会话,或服务器时间偏差超过 5 分钟导致 JWT 认证失败。
- 首次访问务必点【高级】→【继续访问(不安全)】,Chrome/Firefox 都有这个选项
- 用户名默认是
admin,密码是安装过程中生成的随机字符串,不是 root 密码,也别试图用bt default查(该命令仅在面板已运行时有效) - 如果页面空白或加载超时,先检查服务器是否真开了
8888端口:ss -tlnp | grep :8888,再查宝塔服务状态:systemctl status bt
别急着装 LNMP,先关掉不必要的默认行为
首次登录后,面板会自动弹窗推荐安装 LNMP 套件。但很多用户没意识到:这一步会强制安装 Nginx 1.22+、MySQL 8.0、PHP 8.0,并停用系统原有服务——如果你只是想用宝塔做文件管理或计划任务,完全没必要。
性能影响很实际:MySQL 8.0 默认启用 innodb_buffer_pool_size 占用 1.2G 内存,512MB 小内存服务器直接 OOM;PHP 8.0 不兼容某些老 CMS 插件,比如 Typecho 的部分主题会报 Deprecated: Function get_magic_quotes_gpc()。
- 如只需面板管理功能,点右上角【关闭】弹窗,不点“一键安装”
- 如确定要 Web 环境,先在【软件商店】里手动选择版本:PHP 建议选
7.4(兼容性最好),MySQL 选5.7(比 8.0 更省资源) - 安装前记得在【安全】→【防火墙】里加一条放行规则:
8888(面板)、80(网站)、443(SSL),否则装完也访问不了
真正麻烦的不是安装那两分钟,而是装完发现面板打不开、网站跑不起来、数据库连不上——这些问题九成出在安装前没核对系统状态,或安装后没调通网络链路。把 8888 端口、systemctl status bt、浏览器证书警告这三件事理清楚,后面基本不会卡住。










