一、 安装前的准备 (Prerequisites)
在开始安装之前,请确保满足以下条件:
一台“干净”的 Linux 服务器: 宝塔面板建议安装在未安装其他 Web 服务器环境(如 Nginx, Apache, PHP, MySQL 等)的纯净操作系统上。
支持的操作系统: CentOS 7.1+, Ubuntu 16.04+, Debian 9.0+, Fedora 30+ (建议使用 CentOS 7/8 或 Ubuntu 20.04/22.04 LTS)。请参考宝塔官网获取最新的完整支持列表。
硬件要求: 至少 512MB 内存(推荐 768MB 或更高),1GB 可用硬盘空间(推荐 2GB+ 用于面板和环境)。
Root 或 Sudo 权限: 您需要有服务器的 root 用户权限,或者一个可以执行 sudo 命令的用户。
网络连接: 服务器需要能够访问互联网以下载安装脚本和软件包。
SSH 客户端: 您需要使用 SSH 客户端(如 PuTTY, Xshell, Termius 或系统自带的 ssh 命令)连接到您的服务器。
二、 获取并执行官方安装脚本
强烈建议始终从宝塔官方网站 (www.bt.cn) 获取最新的安装命令,以确保安全和兼容性。安装脚本会根据您的操作系统自动选择。
以下是截至本文撰写时(2025年初)常见的安装命令格式示例,但请务必以官网显示的为准!
通过 SSH 连接到您的服务器。
根据您的操作系统,在宝塔官网找到对应的安装命令并执行。
CentOS:
Bash
# 请前往 www.bt.cn 获取最新的 CentOS 安装命令
# 通常格式类似如下 (xxxxx 代表官网提供的验证码或特定参数):
yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0
Ubuntu/Deepin:
Bash
# 请前往 www.bt.cn 获取最新的 Ubuntu/Deepin 安装命令
# 通常格式类似如下 (xxxxx 代表官网提供的验证码或特定参数):
wget -O install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh
Debian:
Bash
# 请前往 www.bt.cn 获取最新的 Debian 安装命令
# 通常格式类似如下 (xxxxx 代表官网提供的验证码或特定参数):
wget -O install.sh http://download.bt.cn/install/install-debian_6.0.sh && bash install.sh x
Fedora:
Bash
# 请前往 www.bt.cn 获取最新的 Fedora 安装命令
# 通常格式类似如下 (xxxxx 代表官网提供的验证码或特定参数):
wget -O install.sh http://download.bt.cn/install/install_6.0.sh && bash install.sh xxxxx
再次强调: 上述命令仅为示例格式,URL 和脚本名 (install_6.0.sh 等) 以及结尾的参数 (xxxxx) 会变化,请务必从官网复制最新命令!
3.执行脚本并等待安装完成:
整个过程根据您的服务器性能和网络状况,可能需要几分钟到十几分钟不等。请耐心等待。
脚本会自动检测系统、下载必要的依赖包并安装宝塔面板。
过程中会询问您是否确认安装路径(通常是 /www),按 y 并回车即可。
4.记录登录信息:
==================================================================
Bt-Panel(宝塔面板) installation completed successfully!
==================================================================
Bt-Panel-URL: http://YOUR_SERVER_IP:8888/xxxx (外网面板地址)
Bt-Panel-URL: http://YOUR_INTERNAL_IP:8888/xxxx (内网面板地址)
username: admin_xxxxx (用户名)
password: xxxxxxxxxx (密码)
Warning:
If you cannot access the panel,
release the following port (8888|888|80|443|20|21)in the security group.
==================================================================
记下 外网面板地址 (Bt-Panel-URL)、username 和 password。
三、 首次登录与环境配置
访问面板:
在您的电脑浏览器中打开刚才记录的 外网面板地址 (例如 http://123.45.67.89:8888/xxxx)。
如果服务器有防火墙或使用了云服务商的安全组,请确保面板端口(默认为 8888,或您安装时指定的端口)是开放的。
首次访问可能会遇到浏览器提示“不安全”,因为面板默认使用自签名证书。选择“高级” -> “继续前往”即可。
登录:
一键安装推荐套件 (LNMP/LAMP):
首次登录后,通常会弹出一个窗口,推荐您一键安装常用的 Web 服务器套件。
LNMP: Linux + Nginx + MySQL + PHP (推荐,Nginx 性能通常更好)
LAMP: Linux + Apache + MySQL + PHP
根据您的需求选择一个套件。同时,您可以选择需要安装的 MySQL、PHP 版本等。
安装方式: 通常有“极速安装”和“编译安装”。
选择“极速安装”并点击“一键安装”。面板会在后台开始下载和安装您选择的环境。这个过程可能需要较长时间(几分钟到几十分钟),您可以在面板左上角的消息盒子查看进度。
四、 重要的安全设置
安装完成后,请立即进行以下安全加固操作:
修改面板端口:
修改面板用户和密码:
在“面板设置”中,找到“面板用户”和“面板密码”。
将默认的用户名(如 admin_xxxxx)修改为您自定义的用户名。
设置一个极其复杂的面板登录密码,包含大小写字母、数字和特殊符号。
设置面板 SSL (推荐):
定期更新:
服务器防火墙:
五、 常见问题与解决方法
无法访问面板地址:
检查宝塔服务状态: SSH 登录服务器,执行 bt status 查看面板服务是否运行,如果停止则执行 bt start 启动。
检查防火墙: 确认服务器防火墙(firewalld, ufw 等)已放行面板端口(修改后的新端口)。
检查云服务器安全组: 如果使用阿里云、腾讯云等,登录云控制台检查安全组规则,确保面板端口已对您的 IP 或 0.0.0.0/0 开放。
检查 IP 地址和端口: 确认输入的 IP 地址和端口号无误。
检查网络: 尝试 ping 服务器 IP 是否可达。
忘记面板密码:
SSH 登录服务器。
执行命令 sudo bt 5,然后按照提示输入新的密码即可重置。
(如果忘记用户名,可以尝试执行 sudo bt 6 修改用户名)。
较旧版本可能是 bt default 显示信息或 bt 14 重置密码,请尝试或查阅官方文档。
一键安装环境 (LNMP/LAMP) 失败:
检查资源: 服务器内存、硬盘空间是否不足?
检查网络: 服务器网络连接是否正常?DNS 是否能正常解析?
查看日志: 在面板左侧“首页”或特定软件的安装界面通常有日志输出,或者查看 /www/server/panel/logs 目录下的日志文件。
尝试单独安装: 在面板的“软件商店” -> “运行环境”中,尝试单独安装失败的组件(如 Nginx, MySQL, PHP)。
检查系统兼容性: 确认您的操作系统版本是否在官方支持列表内。
添加网站后无法访问:
DNS 解析: 确认域名已正确解析到服务器 IP 地址。可以使用 ping your_domain.com 测试。
宝塔网站配置: 检查宝塔面板 -> 网站 -> 对应站点的配置是否正确(域名绑定、网站目录、伪静态规则等)。
Web 服务状态: 检查 Nginx/Apache 服务是否正常运行。
文件权限: 检查网站目录和文件的权限设置是否正确。
查看网站日志: 在宝塔面板 -> 网站 -> 对应站点 -> 日志,或直接查看 /www/wwwlogs/ 目录下的访问日志和错误日志。
面板更新失败:
检查网络: 服务器网络连接是否通畅?DNS 是否正常?
检查磁盘空间: /www 分区或根分区空间是否足够?
尝试修复面板: SSH 登录服务器,执行 bt repair 命令,根据提示尝试修复。或者执行 curl http://download.bt.cn/install/update_panel.sh|bash 尝试手动更新。