Auto-sync: 2026-04-28 16:03

wiki/sources/wsl2-启动与网络配置指南.md

@@ -6,37 +6,49 @@ date: 2026-04-17
 ---
 
 ## Source File
-- [[raw/Home Office/WSL2 启动与网络配置指南.md]]
+- [[Home Office/WSL2 启动与网络配置指南.md]]
 
 ## Summary（用中文描述）
-- 核心主题：WSL2（Windows Subsystem for Linux 2）的安装启动与网络配置实操指南
-- 问题域：Windows 环境下 Linux 开发环境搭建，重点解决 WSL2 网络隔离导致的 GitHub/海外资源访问障碍
-- 方法/机制：① `wsl --install` 快速安装；② `.wslconfig` 启用镜像网络模式（mirrored mode）实现 WSL2 与 Windows 共享网络堆栈；③ 终端代理环境变量手动配置；④ ghproxy.com 反向代理绕过网络限制
-- 结论/价值：提供从零安装到生产可用的完整 WSL2 配置路径，镜像网络模式是最稳妥的解决方案，避免 NAT 模式下的 localhost 代理失效问题
+- 核心主题：WSL2（Windows Subsystem for Linux 2）日常使用操作与网络配置
+- 问题域：WSL2 网络隔离导致 Windows 代理无法被 Linux 内部访问的痛点
+- 方法/机制：
+  - 首次安装：`wsl --install` 一键安装
+  - 状态检查：`wsl -l -v` 查看版本
+  - 版本转换：`wsl --set-version <分发版> 2`
+  - 镜像网络模式：`.wslconfig` 配置 `networkingMode=mirrored` + `dnsTunneling=true`
+  - 手动代理：获取宿主机 IP 后设置 `http_proxy/https_proxy` 环境变量
+  - GitHub 加速：通过 `ghproxy.com` 反向代理下载
+- 结论/价值：提供完整的 WSL2 从安装到生产可用的端到端操作指南
 
 ## Key Claims（用中文描述）
-- WSL2 默认使用 NAT 模式，导致 Windows 宿主机 localhost 代理无法被 WSL2 内部正确访问，这是 GitHub/海外资源连接失败的根本原因
-- 在 `.wslconfig` 中设置 `networkingMode=mirrored` + `dnsTunneling=true` + `autoProxy=true` 可使 WSL2 与 Windows 共享网络堆栈，是解决网络问题的推荐方案
-- 使用 `ghproxy.com` 反向代理可绕过 GitHub 访问限制，适用于 uv 安装器、Hermes Agent 等工具的下载场景
+- WSL2 默认 NAT 模式导致 Windows localhost 代理无法被 WSL2 内部访问
+- `.wslconfig` 中 `networkingMode=mirrored` 使 WSL2 与 Windows 共享网络堆栈，彻底解决代理镜像问题
+- `ghproxy.com` 反向代理可将 GitHub 下载请求重定向至国内可访问节点
 
 ## Key Quotes
-> "WSL2 默认使用 NAT 模式，常会出现'localhost 代理无法镜像'或无法访问海外资源的情况。" — 背景说明
-> "在 PowerShell 执行 `wsl --shutdown` 后重启 WSL。" — 镜像模式生效操作
+> "WSL2 默认使用 NAT 模式，常会出现 localhost 代理无法镜像或无法访问海外资源的情况" — 问题背景说明
+> "这是最稳妥的方案，使 WSL2 与 Windows 共享网络堆栈" — 镜像模式推荐理由
+> "始终先执行 `cd ~` 进入 Linux 原生家目录后再进行环境配置" — 文件权限最佳实践
 
 ## 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 替换为代理地址以绕过网络限制
+- [[WSL2]]：Windows Subsystem for Linux 2，Windows 10/11 内置 Linux 虚拟机环境
+- [[镜像网络模式（Mirrored Networking）]]：WSL2 网络配置选项，使 WSL2 与 Windows 共享网络堆栈而非 NAT
+- [[NAT 模式]]：WSL2 默认网络模式，WSL2 有独立 IP 与 Windows 隔离
+- [[ghproxy]]：ghproxy.com，GitHub 反向代理加速服务
 
 ## Key Entities
-- [[Ubuntu]]：WSL2 默认安装的 Linux 分发版
-- [[Windows]]：宿主操作系统，WSL2 运行其上
-- [[PowerShell]]：Windows 命令行环境，用于执行 wsl 管理命令
+- [[WSL2]]：本文档主题，Windows 内置 Linux 子系统第二版
+- [[uv]]：Python 包管理/安装工具，本文通过镜像地址安装
+- [[Hermes Agent]]：本文通过 ghproxy 镜像安装的 AI Agent 产品
 
 ## Connections
-- [[Ubuntu Server]] ← related_to ← [[WSL2]]（WSL2 是 Ubuntu 在 Windows 上的轻量运行方式）
-- [[ubuntu-server科学上网]] ← related_to ← [[WSL2 网络配置]]（均涉及 Linux 环境代理配置）
+- [[Install WSL]] ← depends_on ← [[WSL2 启动与网络配置指南]]（安装指南为前置，配置指南为后续）
+- [[WSL2 启动与网络配置指南]] ← extends ← [[Ubuntu Server科学上网]]（均为 Linux 环境网络配置）
+- [[WSL2 启动与网络配置指南]] ← uses ← [[ghproxy]]（ghproxy 是解决 GitHub 下载的核心工具）
 
 ## Contradictions
-- （无已知冲突）
+- 与 [[Install WSL]] 视角差异：
+  - 冲突点：Install WSL 聚焦安装过程，本文聚焦日常使用与网络配置
+  - 当前观点：本文将网络配置作为 WSL2 日常使用的重要组成部分
+  - 对方观点：Install WSL 将安装与配置视为独立阶段
+  - 说明：两者互补，无本质冲突，安装指南完成后需参考本文完成网络配置