# **Windows 11 + WSL2 + Ubuntu 22.04 + 宝塔面板 完整安装教程**
Windows 11 + WSL2 + Ubuntu 22.04 + 宝塔面板 完整安装教程
📋 适用场景
- Windows 11 系统重装后
- WSL 重装或重置后
- Ubuntu 22.04 LTS 重装后
- 需要快速恢复开发/运维环境
🚀 第一部分:WSL2 和 Ubuntu 安装
步骤 1:启用 WSL 功能
以管理员身份打开 PowerShell:
# 启用 WSL 功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
# 启用虚拟化功能
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
# 重启电脑(必须)
shutdown /r /t 0步骤 2:安装 WSL2 内核更新
- 下载地址:https://aka.ms/wsl2kernel
- 运行下载的
.msi文件安装
步骤 3:设置 WSL2 为默认版本
wsl --set-default-version 2步骤 4:安装 Ubuntu 22.04 LTS
# 方法 A:从 Microsoft Store 安装(推荐)
# 打开 Microsoft Store,搜索 "Ubuntu 22.04 LTS" 安装
# 方法 B:命令行安装
wsl --install -d Ubuntu-22.04步骤 5:初始化 Ubuntu
- 从开始菜单启动 "Ubuntu 22.04"
设置用户名和密码(建议使用小写字母)
- 用户名:自定(如
ubuntu) - 密码:记住这个密码,sudo 时需要
- 用户名:自定(如
⚙️ 第二部分:系统优化配置
步骤 1:切换到 root 用户(可选)
# 临时切换到 root
sudo -i
# 设置 root 密码
passwd
# 设置 WSL 默认以 root 启动(可选)
exit # 退出 Ubuntu在 Windows PowerShell:
# 查看发行版名称
wsl -l -v
# 设置默认用户为 root
ubuntu2204 config --default-user root步骤 2:更新系统
# 更新软件包列表
apt update
# 升级已安装的包
apt upgrade -y
# 安装常用工具
apt install -y curl wget git vim nano htop net-tools步骤 3:配置 SSH(可选)
# 安装 SSH 服务器
apt install -y openssh-server
# 修改配置允许 root 登录
sed -i 's/#PermitRootLogin prohibit-password/PermitRootLogin yes/' /etc/ssh/sshd_config
# 启动 SSH
service ssh start
# 设置开机自启
update-rc.d ssh defaults🛠️ 第三部分:安装宝塔面板
步骤 1:安装必要依赖
# 安装编译工具
apt install -y build-essential
apt install -y libssl-dev libncurses5-dev libsqlite3-dev libreadline-dev libtk8.6 libgdm-dev libdb4o-cil-dev libpcap-dev步骤 2:安装宝塔面板
# 下载安装脚本
wget -O install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh
# 执行安装
sudo bash install.sh步骤 3:安装过程中的选择
安装过程中:
- 输入
y确认安装 - 等待安装完成(约5-10分钟)
保存显示的登录信息:
- 外网面板地址
- 内网面板地址
- 用户名
- 密码
- 安全入口路径
步骤 4:启动宝塔服务
# 启动宝塔
/etc/init.d/bt start
# 设置开机自启
systemctl enable bt # 如果支持 systemd
# 或
update-rc.d bt defaults
# 查看面板状态
/etc/init.d/bt status
# 查看面板信息
bt default🌐 第四部分:Windows 访问配置
步骤 1:获取 WSL IP 地址
# 在 Ubuntu 中查看 IP
hostname -I
# 或
ip addr show eth0 | grep inet步骤 2:Windows hosts 文件配置
以管理员打开 PowerShell:
# 编辑 hosts 文件
notepad C:\Windows\System32\drivers\etc\hosts添加内容:
# WSL 宝塔面板
192.168.x.x panel.local
192.168.x.x wsl.bt
127.0.0.1 bt.local步骤 3:端口转发(如果需要)
# 获取 WSL IP
$wsl_ip = (wsl hostname -I).Trim()
# 设置端口转发
netsh interface portproxy add v4tov4 listenport=29652 listenaddress=127.0.0.1 connectport=29652 connectaddress=$wsl_ip
# 查看转发规则
netsh interface portproxy show all步骤 4:防火墙放行
# 允许端口通过防火墙
New-NetFirewallRule -DisplayName "WSL BT Panel" -Direction Inbound -LocalPort 29652 -Protocol TCP -Action Allow
# 如果使用其他端口,一并放行
$ports = @(8888, 888, 80, 443, 20, 21, 3306)
foreach ($port in $ports) {
New-NetFirewallRule -DisplayName "WSL Port $port" -Direction Inbound -LocalPort $port -Protocol TCP -Action Allow -ErrorAction SilentlyContinue
}🔗 第五部分:访问宝塔面板
访问地址选项
直接 IP:
https://[WSL_IP]:29652/安全入口- 例:
https://192.168.61.174:29652/96584140
- 例:
localhost:
https://localhost:29652/安全入口- 需要先设置端口转发
自定义域名:
https://panel.local:29652/安全入口- 需要配置 hosts 文件
登录信息
- 用户名:安装时显示的用户名
- 密码:安装时显示的密码
- 安全入口:安装时显示的路径(如
/96584140)
⚡ 第六部分:常见问题快速解决
问题 1:WSL 网络无法访问
# 重启 WSL
wsl --shutdown
# 等待10秒后重新启动
# 重置网络
netsh winsock reset
netsh int ip reset all
ipconfig /flushdns问题 2:宝塔面板无法启动
# 修复面板
bt repair
# 重启服务
/etc/init.d/bt restart
# 查看错误日志
tail -50 /www/server/panel/logs/error.log问题 3:端口被占用
# 查看占用端口的进程
lsof -i :29652
# 结束占用进程
kill -9 [PID]
# 修改面板端口
bt 8问题 4:忘记登录信息
# 查看面板信息
bt default
# 修改密码
bt 5
# 修改安全入口
bt 6💾 第七部分:备份与恢复
备份 WSL 系统
# 导出 Ubuntu 系统
wsl --export Ubuntu-22.04 D:\wsl-backup\ubuntu-backup.tar
# 导出宝塔数据(在 Ubuntu 中)
tar -czf /home/backup/bt-backup.tar.gz /www恢复 WSL 系统
# 导入 Ubuntu 系统
wsl --import Ubuntu-22.04 C:\WSL\Ubuntu D:\wsl-backup\ubuntu-backup.tar
# 恢复宝塔数据(在 Ubuntu 中)
tar -xzf /home/backup/bt-backup.tar.gz -C /📝 第八部分:常用命令速查
WSL 命令
# 查看已安装的发行版
wsl -l -v
# 停止所有 WSL 实例
wsl --shutdown
# 设置默认发行版
wsl --set-default Ubuntu-22.04
# 导出/导入系统
wsl --export Ubuntu-22.04 backup.tar
wsl --import NewUbuntu C:\WSL backup.tar宝塔命令
# 面板控制
bt # 宝塔命令行
bt 1 # 重启面板
bt 5 # 修改面板密码
bt 6 # 修改安全入口
bt 8 # 修改面板端口
bt default # 查看面板信息
bt stop # 停止面板
bt start # 启动面板
bt restart # 重启面板
# 服务管理
/etc/init.d/bt status
/etc/init.d/nginx restart
/etc/init.d/mysql restart系统管理
# 查看系统信息
hostname -I # 查看 IP
df -h # 查看磁盘空间
free -h # 查看内存使用
top # 查看进程
# 网络检查
netstat -tlnp # 查看端口监听
ping google.com # 测试网络
curl -I localhost:29652 # 测试本地服务🎯 一键安装脚本
保存为 install-all.sh:
#!/bin/bash
echo "=== 开始安装宝塔面板 ==="
# 更新系统
apt update && apt upgrade -y
# 安装依赖
apt install -y curl wget git build-essential
# 安装宝塔
wget -O install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh
bash install.sh
# 启动服务
/etc/init.d/bt start
# 显示信息
bt default
echo "=== 安装完成 ==="
echo "访问地址: https://$(hostname -I | awk '{print $1}'):29652"✅ 安装完成检查清单
- [ ] WSL2 正常运行
- [ ] Ubuntu 22.04 可以启动
- [ ] 宝塔面板服务运行中
- [ ] Windows 可以访问面板
- [ ] 保存了所有登录信息
- [ ] 防火墙已放行端口
- [ ] 重要数据已备份
📞 遇到问题?
- 查看日志:
/www/server/panel/logs/ - 重启服务:
bt restart - 重置面板:
bt repair - 重新安装:运行安装脚本
保存此教程,下次重装时按步骤操作即可快速恢复环境!