2.5 KiB
2.5 KiB
title, type, tags, date
| title | type | tags | date |
|---|---|---|---|
| WSL2 启动与网络配置指南 | source | 2026-04-17 |
Source File
Summary（用中文描述）
- 核心主题：WSL2（Windows Subsystem for Linux 2）的安装启动与网络配置实操指南
- 问题域：Windows 环境下 Linux 开发环境搭建，重点解决 WSL2 网络隔离导致的 GitHub/海外资源访问障碍
- 方法/机制：①
wsl --install快速安装；②.wslconfig启用镜像网络模式（mirrored mode）实现 WSL2 与 Windows 共享网络堆栈；③ 终端代理环境变量手动配置；④ ghproxy.com 反向代理绕过网络限制 - 结论/价值：提供从零安装到生产可用的完整 WSL2 配置路径，镜像网络模式是最稳妥的解决方案，避免 NAT 模式下的 localhost 代理失效问题
Key Claims（用中文描述）
- WSL2 默认使用 NAT 模式，导致 Windows 宿主机 localhost 代理无法被 WSL2 内部正确访问，这是 GitHub/海外资源连接失败的根本原因
- 在
.wslconfig中设置networkingMode=mirrored+dnsTunneling=true+autoProxy=true可使 WSL2 与 Windows 共享网络堆栈，是解决网络问题的推荐方案 - 使用
ghproxy.com反向代理可绕过 GitHub 访问限制，适用于 uv 安装器、Hermes Agent 等工具的下载场景
Key Quotes
"WSL2 默认使用 NAT 模式，常会出现'localhost 代理无法镜像'或无法访问海外资源的情况。" — 背景说明 "在 PowerShell 执行
wsl --shutdown后重启 WSL。" — 镜像模式生效操作
Key Concepts
- WSL2：Windows Subsystem for Linux 2，Windows 10/11 内置的 Linux 虚拟机环境，默认使用 NAT 网络模式
- 镜像网络模式（Mirrored Network Mode）：WSL2 与 Windows 共享网络堆栈的配置模式，使 WSL2 能直接访问 Windows 代理
- NAT模式：WSL2 默认网络模式，WSL2 拥有独立 IP，localhost 代理不可用
- ghproxy：ghproxy.com，反向代理服务，将 GitHub 资源 URL 替换为代理地址以绕过网络限制
Key Entities
- Ubuntu：WSL2 默认安装的 Linux 分发版
- Windows：宿主操作系统，WSL2 运行其上
- PowerShell：Windows 命令行环境，用于执行 wsl 管理命令
Connections
- Ubuntu Server ← related_to ← WSL2（WSL2 是 Ubuntu 在 Windows 上的轻量运行方式）
- ubuntu-server科学上网 ← related_to ← WSL2 网络配置（均涉及 Linux 环境代理配置）
Contradictions
- （无已知冲突）