宝塔面板必须在纯净系统安装，已有nginx/apache/mysql等环境会导致端口冲突或服务失败；需确认系统纯净、网络可达、端口8888未占用，并按centos/ubuntu/debian选择对应官方安装命令，安装后须在云平台安全组放行8888端口并忽略https证书警告。
宝塔面板不能在已有 Web 环境（如已装 Nginx、Apache、PHP、MySQL）的系统上正常安装，强行安装会导致端口冲突、服务启动失败或面板无法登录——这是最常被忽略的前提，不是“能连上 SSH 就能装”，而是“必须是干净系统”。
确认系统是否满足安装前提
安装前必须验证三点：系统是否为纯净、网络是否可达、端口是否可用。缺一不可。
- 执行
ps aux | grep -E 'nginx|apache|httpd|mysql|mysqld|php-fpm'，若输出非空进程，说明已有环境，不要继续安装 - 检查系统版本是否在推荐范围内：
cat /etc/os-release，优先选CentOS 7.x或Ubuntu 20.04；Debian 11+和CentOS 8/9存在兼容性问题，部分功能（如防火墙模块、SSL 申请）可能异常 - 确认 8888 端口未被占用：
ss -tuln | grep ':8888'，若返回结果，需先终止占用进程或修改面板默认端口（安装后可在/www/server/panel/data/port.pl中改）
根据系统选择正确安装命令
不同发行版用错脚本会导致 wget 失败、curl 超时或 bash 权限错误，官网已明确区分节点，不能混用。
-
CentOS 7.x：运行yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.sh -
Ubuntu 20.04/22.04：运行wget -O install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh（必须加sudo，否则权限不足） -
Debian 10/11：运行wget -O install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh && bash install.sh（不加 sudo，Debian 默认允许 root 执行） - 所有命令执行后都会提示
Do you want to install Bt-Panel to the /www directory now?(y/n)，输入y回车，**不要输 yes 或 Y**，只认小写 y
安装完成后无法访问面板的常见原因
看到终端输出面板地址 ≠ 能直接打开网页，多数卡在这一步，本质是网络策略没配好。
- 阿里云/腾讯云等厂商默认关闭所有非标准端口，
8888（面板）、888（FTP）、443（HTTPS）必须手动在安全组中放行，仅开放22和80不够 - 浏览器访问时出现
NET::ERR_CERT_AUTHORITY_INVALID，是因为面板自签证书，需点击“高级 → 继续前往”（Chrome）或“接受风险并继续”（Firefox），不是证书配置错误 - 面板地址形如
https://123.123.123.123:8888/abcd1234，其中末尾的随机字符串是临时入口路径，每次重装会变，不可硬编码到书签 - 如果页面空白或加载超时，检查服务器是否启用了 firewalld：
systemctl status firewalld，若 active，则运行firewall-cmd --permanent --add-port=8888/tcp && firewall-cmd --reload
真正麻烦的不是安装命令本身，而是安装前没清理旧环境、安装后没调安全组、以及把面板地址当成永久链接反复收藏——这三处出错率超过 70%。
