# **Windows 11 + WSL2 + Ubuntu 22.04 + 宝塔面板 完整安装教程** - Winmax Music 

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 内核更新

  1. 下载地址:https://aka.ms/wsl2kernel
  2. 运行下载的 .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

  1. 从开始菜单启动 "Ubuntu 22.04"
  2. 设置用户名和密码(建议使用小写字母)

    • 用户名:自定(如 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:安装过程中的选择

安装过程中:

  1. 输入 y 确认安装
  2. 等待安装完成(约5-10分钟)
  3. 保存显示的登录信息

    • 外网面板地址
    • 内网面板地址
    • 用户名
    • 密码
    • 安全入口路径

步骤 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
}

🔗 第五部分:访问宝塔面板

访问地址选项

  1. 直接 IPhttps://[WSL_IP]:29652/安全入口

    • 例:https://192.168.61.174:29652/96584140
  2. localhosthttps://localhost:29652/安全入口

    • 需要先设置端口转发
  3. 自定义域名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 可以访问面板
  • [ ] 保存了所有登录信息
  • [ ] 防火墙已放行端口
  • [ ] 重要数据已备份

📞 遇到问题?

  1. 查看日志/www/server/panel/logs/
  2. 重启服务bt restart
  3. 重置面板bt repair
  4. 重新安装:运行安装脚本

保存此教程,下次重装时按步骤操作即可快速恢复环境!

标签: none



没事发点牢骚,评论几句?!Nothing to complain about, comment a few words.