chenlb 的知识库

主题

在 Windows 中用 wsl 使用 Linux ​

WSL (Windows Subsystem for Linux) 介绍请看官网

环境：

  • windows 11 专业版 22H2
  • wsl 2

在 wsl 安装 Debian ​

开启 wsl 功能：

  • 适应于 Linux 的 Windows 子系统
  • Windows 虚拟机监控程序平台

pre-set-wsl

否则会出现如下报错：

console
Installing, this may take a few minutes...
WslRegisterDistribution failed with error: 0x8007019e
Error: 0x8007019e ??????? Linux ? Windows ????

Press any key to continue...

下载安装 Debian ​

Microsoft store 下载和安装 Debian 或 Ubuntu。（说明：推荐用 Microsoft store 安装。用 wsl 命令安装有可能报错。）

download-debian-on-win-store

下载后启动，如果出现如下错误

console
Installing, this may take a few minutes...
WslRegisterDistribution failed with error: 0x800701bc
Error: 0x800701bc WSL 2 ?????????????????? https://aka.ms/wsl2kernel

Press any key to continue...

就更新 最新版的 wsl。

bash
# PowerShell 运行。
# 更新到 wsl 2
wsl --update

启动：在程序列表双击 Debian 或 Ubuntu。安装并要求输入用户名和密码

console
Installing, this may take a few minutes...
Please create a default UNIX user account. The username does not need to match your Windows username.
For more information visit: https://aka.ms/wslusers
Enter new UNIX username: chenlb
New password:
Retype new password:
passwd: password updated successfully
Installation successful!
User account already exists, skipping creation
chenlb@chenlb-ai:~$
console
Installing, this may take a few minutes...
Please create a default UNIX user account. The username does not need to match your Windows username.
For more information visit: https://aka.ms/wslusers
Enter new UNIX username: chenlb
New password:
Retype new password:
passwd: password updated successfully
Installation successful!
To run a command as administrator (user "root"), use "sudo <command>".
See "man sudo_root" for details.

Welcome to Ubuntu 22.04.5 LTS (GNU/Linux 5.15.167.4-microsoft-standard-WSL2 x86_64)

 * Documentation:  https://help.ubuntu.com
 * Management:     https://landscape.canonical.com
 * Support:        https://ubuntu.com/pro

 System information as of Tue Mar 11 20:39:41 CST 2025

  System load:  0.07                Processes:             31
  Usage of /:   0.1% of 1006.85GB   Users logged in:       0
  Memory usage: 1%                  IPv4 address for eth0: 172.30.208.210
  Swap usage:   0%


This message is shown once a day. To disable it please create the
/home/chenlb/.hushlogin file.
chenlb@chenlb-ai:~$

说明

启方式有： 1、程序里找到操作系统双击 2、命令行 wsl 直接启动，或 wsl -d Debian (如果之前安装过其它 Linux 的话)

如果报错：无法解析服务器的名称或地址
console
PS C:\Users\Administrator> wsl -l -o
无法从“https://raw.githubusercontent.com/microsoft/WSL/master/distributions/DistributionInfo.json”中提取列表分发。无法解析服务器的名称或地址
错误代码: Wsl/WININET_E_NAME_NOT_RESOLVED

或用命令行安装 Linux 子系统，报错。

console
PS C:\Users\Administrator> wsl --install -d Debian
适用于 Linux 的 Windows 子系统已安装。

无法解析服务器的名称或地址

有两种方式解决： 1、改 hosts

bash
# 改域名映射ip，可比在 ip138.com 进行域名到ip的查询, 写在 hosts 如：
185.199.111.133 raw.githubusercontent.com

2、使用科学上网。

查看系统版本信息 ​

console
$ cat /etc/os-release
PRETTY_NAME="Debian GNU/Linux 12 (bookworm)"
NAME="Debian GNU/Linux"
VERSION_ID="12"
VERSION="12 (bookworm)"
VERSION_CODENAME=bookworm
ID=debian
HOME_URL="https://www.debian.org/"
SUPPORT_URL="https://www.debian.org/support"
BUG_REPORT_URL="https://bugs.debian.org/"

网络访问 ​

场景1： wsl 里的 linux 启动了服务，如：8000 端口。windows 可以使用 http://localhost:8000 访问。但使用 windows 宿主机的 ip:8000无法访问。

需要查看 wsl 的 linux 在 windows 宿主机 ip。使用 wsl 的 linux 的 ip。

console
PS C:\Users\Administrator> wsl -d Debian hostname -I
172.30.208.210

场景2：在 wsl 的 linux 访问 windows 宿主机的服务。要使用 windows 宿主机 ip。

console
$ ip route show | grep -i default | awk '{ print $3}'
172.30.208.1

场景3：局域网的其它机器访问 wsl 的 linux。需要做网络转发

bash
# netsh interface portproxy add v4tov4 listenport=<yourPortToForward> listenaddress=0.0.0.0 connectport=<yourPortToConnectToInWSL> connectaddress=(wsl hostname -I)
# <yourPortToForward> - windows 宿主机监听的端口号
# <yourPortToConnectToInWSL> - wsl linux 服务的端口号
# connectaddress - wsl linux 的 ip 地址

# 上面 ip 地址的示例
# 改一个从外面 LAN 机器访问到 windows 宿主机的端口号 8080
netsh interface portproxy add v4tov4 listenport=8080 listenaddress=0.0.0.0 connectport=8000 connectaddress=172.30.208.210

# 查看 nat 端口映射
netsh interface portproxy show all

# 删除
# netsh interface portproxy delete v4tov4 listenport=8080 listenaddress=0.0.0.0

结果为

console
PS C:\Users\Administrator> netsh interface portproxy show all

侦听 ipv4:                 连接到 ipv4:

地址            端口        地址            端口
--------------- ----------  --------------- ----------
0.0.0.0         8080        172.30.208.210  8000

windows 本机或其它 lan 的机器就可以访问 windows lan ip:8080 访问了。如 http://192.168.0.2:8080

参考：https://learn.microsoft.com/zh-cn/windows/wsl/networking

常见问题 ​

解决Debian WSL报错ping: socket: Operation not permitted ​

参考：https://debug.fanzheng.org/post/Debian-WSL-ping-socket-Operation-not-permitted.html

bash
sudo setcap 'cap_net_raw+ep' /bin/ping