WSL2 + Ubuntu 22.04 全流程安装与配置指南（适配 D 盘）

3️⃣ 注销旧系统

wsl --unregister Ubuntu-22.04

4️⃣ 导入到 D 盘

wsl --import Ubuntu-22.04 D:\WSL\Ubuntu D:\WSL\ubuntu.tar --version 2

5️⃣ 删除临时文件

del D:\WSL\ubuntu.tar

验证迁移：

wsl --list --verbose

应显示：

Ubuntu-22.04 Stopped 2

🐧 五、首次进入系统与基础配置

启动：

wsl -d Ubuntu-22.04

更新系统：

sudo apt update && sudo apt upgrade -y
sudo apt install -y build-essential git curl wget vim python3.11 python3.11-venv

🧠 六、解决无法联网

⚠️ 默认 WSL 网络为 NAT 模式，不能自动继承 Windows 代理。你会遇到 curl 卡住、apt update timeout 的问题。

1️⃣ 在 Windows 的代理工具中启用 LAN

进入代理工具设置 → 开启局域网

确认配置中有：

allow-lan: true
bind-address: 0.0.0.0
mixed-port: 7897

重点是第二行：bind-address: 0.0.0.0，这一步很关键，代理工具的配置文件是 config.yaml，同时需要注意端口没错。

然后重启代理工具。

2️⃣ 在 PowerShell 验证端口监听

我们需要得到两条信息：WSL 的内网 IP 和代理工具的转发端口（第一步已经得到了）。

netstat -ano | findstr 7897

✅ 期望输出：

TCP 0.0.0.0:7897 0.0.0.0:0 LISTENING ……

3️⃣ 在 WSL 中获取主机 IP

cat /etc/resolv.conf | grep nameserver

输出示例：

nameserver 172.19.48.1

测试是否连通，在 WSL 里面执行：

nc -zv 172.19.48.1 7897

如果输出：

Connection to 172.19.48.1 7897 port [tcp/*] succeeded! 

说明端口没被挡住。如果失败，则管理员权限单开一个 PowerShell，然后输入（注意替换端口）：

这条命令会让 Windows 接受来自 WSL 的请求访问端口 7897。

之后再回到 WSL 执行：

nc -zv 172.19.48.1 7897 

应当返回 succeeded ✅。

4️⃣ 手动设置

export http_proxy="http://172.19.48.1:7897"
export https_proxy="http://172.19.48.1:7897"

验证：

curl -I https://www.google.com

返回 HTTP/2 200 即表示成功。

然后执行：

echo 'Acquire { HTTP::proxy "http://172.19.48.1:7897"; HTTPS::proxy "http://172.19.48.1:7897"; };' | \ sudo tee /etc/apt/apt.conf.d/proxy.conf 

能更新包列表就说明 apt 已走代理。

5️⃣ 永久生效（添加到 .bashrc）

编辑：

nano ~/.bashrc

添加（注意端口需要替换成自己的代理工具实际端口）：

win_ip=$(grep nameserver /etc/resolv.conf | awk '{print $2}')
export http_proxy="http://$win_ip:7897"
export https_proxy="http://$win_ip:7897"
export HTTP_PROXY=$http_proxy
export HTTPS_PROXY=$https_proxy
echo "[WSL] Proxy set to $http_proxy"

保存并执行：

source ~/.bashrc

👤 七、恢复默认登录用户（迁移后变 root 的修复）

迁移导入后 WSL 默认用 root 登录。

1️⃣ 查看用户

ls /home

例如看到：

jiahao

2️⃣ 切换回用户

su - jiahao

3️⃣ 设置默认启动用户

在 PowerShell 中：

Ubuntu-22.04.exe config --default-user jiahao

下次启动 WSL 就会自动进入你的账户。

🧰 八、测试 GPU / CUDA（可选）

确保驱动版本 ≥ 510：

nvidia-smi

输出显示显卡信息即代表 GPU 直通成功。

🧩 九、安装开发依赖（可选）

创建 Python 环境：

python3 -m venv ~/venv
source ~/venv/bin/activate
pip install -U pip

常见依赖：

pip install fastapi uvicorn faiss-cpu qdrant-client pymupdf transformers sentence-transformers

🧱 十、常见问题与解决

🧾 十一、最终结构验证

查看系统

cat /etc/os-release

确认代理

echo $http_proxy

确认 GPU

nvidia-smi

确认挂载路径（应在 D 盘）

df -h | grep /mnt/d

输出路径指向：

/mnt/d/WSL/Ubuntu/

✅ 十二、总结