原文链接： https://blog.llweb.top/posts/linux/wsl-basic
安装
Microsoft Store 装安装
安装后首次启动会让你设置用户名，密码。更换默认用户为 root: https://superuser.com/questions/1566022/how-to-set-default-user-for-manually-installed-wsl-distro
.wslconfig 文件参考：https://learn.microsoft.com/zh-cn/windows/wsl/wsl-config#wslconfig
wsl cli 参考：https://learn.microsoft.com/zh-cn/windows/wsl/basic-commands
卸载
wsl --unregister Ubuntu- 利用
Bulk Crap Uninstaller卸载干净
更换 Ubuntu apt-get 源
方法： https://mirrors.tuna.tsinghua.edu.cn/help/ubuntu/
源： http://mirrors.aliyun.com/ubuntu/
在 Ubuntu 24.04 之前，Ubuntu 的软件源配置文件使用传统的 One-Line-Style，路径为
/etc/apt/sources.list；从 Ubuntu 24.04 开始，Ubuntu 的软件源配置文件变更为 DEB822 格式，路径为/etc/apt/sources.list.d/ubuntu.sources。
安装 docker
https://docs.docker.com/engine/install/ubuntu/#install-using-the-repository
docker 镜像
https://github.com/DaoCloud/public-image-mirror
https://status.daocloud.io/status/docker
sudo tee /etc/docker/daemon.json <<EOF{"registry-mirrors": ["https://docker.m.daocloud.io"]
}
EOFsudo systemctl daemon-reload
sudo systemctl restart docker
镜像也慢，不如代理
proxy
使用代理： https://docs.docker.com/engine/daemon/proxy/
但wsl的网络模式影响，nat 不能访问主机代理，换成 mirrored
代理设置参考：https://george.betterde.com/technology/20240608.html
/etc/docker/daemon.json
{"proxies": {"no-proxy": "*.local,localhost,127.0.0.0/8","http-proxy": "http://IP_OR_DOMAIN:6152","https-proxy": "https://IP_OR_DOMAIN:6152",}
}
~/.docker/config.json
{"proxies": {"default": {"httpProxy": "http://127.0.0.1:7890","httpsProxy": "http://127.0.0.1:7890","noProxy": "*.local,localhost,127.0.0.0/8"}}
}
在 WSL 中访问 Windows 文件有几种便捷的方法
- 通过
/mnt目录访问
- Windows 的磁盘会自动挂载在
/mnt目录下 - 比如 C 盘路径为
/mnt/c，D 盘为/mnt/d - 示例:
cd /mnt/c/Users/YourName/Documents
- 通过符号链接创建快捷方式
# 在 home 目录下创建到 Windows Documents 文件夹的链接
ln -s /mnt/c/Users/YourName/Documents ~/Documents
# 快速访问
cd ~/windows_desktop
配置 /etc/wsl.conf 来自定义挂载点
需要注意的几点：
- WSL 访问 Windows 文件时性能会比直接在 Linux 文件系统中操作稍慢
- 建议将开发项目文件放在 WSL 文件系统中以获得更好的性能
性能差异的原因：
- 当你通过
/mnt/c访问 Windows 文件时，WSL 需要在Windows 和 Linux 文件系统之间进行转换，这会带来额外的开销 - 在 Linux 文件系统中直接操作文件时，不需要这种转换，所以性能好
若需频繁操作，建议将文件复制到 WSL 原生目录
# 在 Windows 文件系统中运行 npm install
cd /mnt/c/projects/my-node-app
npm install # 较慢# 在 Linux 文件系统中运行 npm install
cd ~/projects/my-node-app
npm install # 更快
# 打开当前目录对应的 Windows 文件夹
explorer.exe .
# 将 Windows 路径转为 WSL 路径
wslpath "C:\Users\你的用户名\Downloads"
# 输出：/mnt/c/Users/你的用户名/Downloads# 将 WSL 路径转为 Windows 路径
wslpath -w ~/documents
# 输出：\\wsl.localhost\Ubuntu\home\用户名\documents备份 WSL
https://stackoverflow.com/questions/38779801/move-wsl-bash-on-windows-root-filesystem-to-another-hard-drive/51767786#51767786
troubleshooting
常见问题解答：https://learn.microsoft.com/en-us/windows/wsl/faq
wsl: 检测到 localhost 代理配置，但未镜像到 WSL。NAT 模式下的 WSL 不支持 localhost 代理。
https://github.com/microsoft/WSL/issues/10753#issuecomment-1814839310
https://github.com/microsoft/WSL/releases/tag/2.0.0
找不到被占用的端口
- hyper-v 占用
- wsl
- wsa 杀进程
netsh interface ipv4 reset
netsh interface ipv6 reset
netsh winsock reset netsh int ipv4 add excludedportrange protocol=tcp startport=3000 numberofports=100Disable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V-AllEnable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V-All
https://stackoverflow.com/questions/58216537/what-is-administered-port-exclusions-in-windows-10
