在 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 社區支持。