在 WSL (Windows Subsystem for Linux) 下的 Ubuntu 中安装宝塔面板的步骤如下:
1. 确保 WSL 环境正常
-
已安装 WSL 2 并启用 Ubuntu 发行版(推荐 Ubuntu 20.04/22.04)。
-
在 PowerShell 中检查 WSL 版本:
wsl --list --verbose
如果为 WSL 1,建议升级到 WSL 2:
wsl --set-version Ubuntu 2
2. 更新 Ubuntu 系统
在 Ubuntu 终端中执行:
sudo apt update && sudo apt upgrade -y
3. 安装必要依赖
宝塔需要的基础工具:
sudo apt install -y wget curl git vim
4. 安装宝塔面板
-
官方安装命令(默认安装):
wget -O install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh
安装完成后会显示面板地址、用户名和密码(务必保存)。
-
备用命令(若官方脚本失效):
curl -sSO http://download.bt.cn/install/install_panel.sh && sudo bash install_panel.sh
5. 解决常见问题
问题1:WSL 不支持 systemd
宝塔依赖 systemd 管理服务,但 WSL 默认不启用。需手动解决:
-
方法1:使用
genie
或subsystemctl
模拟 systemd(推荐):# 安装 genie sudo apt install -y systemd-genie genie -s
然后在新的终端窗口启动宝塔:
bt start
-
方法2:手动启动关键服务(如 Nginx/MySQL):
sudo service nginx start sudo service mysql start
问题2:宝塔端口无法访问
WSL 默认隔离网络,需在 Windows 中做端口转发(以 8888 为例):
# 在 PowerShell 中执行
wsl --shutdown
wsl -d Ubuntu -u root -- bash -c "bt stop && bt start"
netsh interface portproxy add v4tov4 listenport=8888 connectaddress=(wsl的IP) connectport=8888
查看 WSL IP:
hostname -I
6. 访问宝塔面板
-
在 Windows 浏览器中输入:
http://127.0.0.1:8888/安全入口
或使用 WSL 内 IP:
http://<WSL_IP>:8888
注意事项
-
性能问题:WSL 不适合生产环境,仅推荐用于本地开发测试。
-
数据持久化:WSL 卸载后数据会丢失,建议定期备份(
bt backup
)。 -
兼容性:部分宝塔功能(如防火墙)可能无法在 WSL 中正常工作。
卸载宝塔
wget http://download.bt.cn/install/bt-uninstall.sh && sudo bash bt-uninstall.sh
如有其他问题,建议参考 宝塔官方文档 或 WSL 社区支持。