---
title: WSL2 启动与网络配置指南
source:
author: shenwei
published:
created:
description:
tags:
---
#wsl #ubuntu #windows 
# WSL2 启动与网络配置指南

## 一、 WSL2 基础启动操作

### 1. 首次安装与启用

- **快速安装命令**（管理员模式 PowerShell）：
    
    PowerShell
    
    ```
    wsl --install
    ```
    
    _注：默认安装 Ubuntu，完成后必须重启电脑。_
    

### 2. 状态检查与版本转换

- **查看已安装分发版及状态**：
    
    PowerShell
    
    ```
    wsl -l -v
    ```
    
- **强制将分发版设置为 WSL2**：
    
    PowerShell
    
    ```
    wsl --set-version <分发版名称> 2
    ```
    
- **日常进入 Linux 终端**：
    
    PowerShell
    
    ```
    wsl -d <分发版名称>  # 启动指定版本
    wsl --shutdown      # 强制停止所有运行中的 WSL 实例
    ```
    

## 二、 网络进阶配置（解决 GitHub/海外连接问题）

由于 WSL2 默认使用 NAT 模式，常会出现“localhost 代理无法镜像”或无法访问海外资源的情况。

### 1. 启用“镜像网络模式”（推荐方案）

这是最稳妥的方案，使 WSL2 与 Windows 共享网络堆栈。

- **操作步骤**：
    
    1. 打开 Windows 用户目录（`C:\Users\<你的用户名>\`）。
        
    2. 创建或编辑 `.wslconfig` 文件。
        
    3. 写入以下配置：
        
        Ini, TOML
        
        ```
        [wsl2]
        networkingMode=mirrored
        dnsTunneling=true
        firewall=true
        autoProxy=true
        ```
        
    4. 在 PowerShell 执行 `wsl --shutdown` 后重启 WSL。
        

### 2. 手动配置终端代理

如果未开启镜像模式，需手动指向 Windows 宿主机 IP：

- **获取宿主机 IP**：`cat /etc/resolv.conf | grep nameserver`
    
- **设置临时变量**（假设端口为 7890）：
    
    Bash
    
    ```
    export https_proxy="http://<宿主机IP>:7890"
    export http_proxy="http://<宿主机IP>:7890"
    ```
    

### 3. 使用国内镜像加速（针对 Hermes/uv 安装）

若 GitHub 访问受限，可使用代理地址：

- **手动安装 uv**：
    
    Bash
    
    ```
    curl -LsSf https://mirror.ghproxy.com/https://github.com/astral-sh/uv/releases/latest/download/uv-installer.sh | sh
    ```
    
- **使用镜像安装 Hermes Agent**：
    
    Bash
    
    ```
    curl -fsSL https://mirror.ghproxy.com/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    ```
    

## 三、 常见故障排查

- **错误码 Wsl/Service/WSL_E_VM_MODE_INVALID_STATE**：
    
    - 通常由于虚拟化未开启或服务死锁。
        
    - **解决**：检查 BIOS 中的 `Virtualization Technology` 是否为 `Enabled`；在 Windows 功能中勾选“虚拟机平台”。
        
- **文件权限问题**：
    
    - 避免在 `/mnt/c/`（Windows 挂载目录）下执行复杂的 Linux 脚本安装。
        
    - **建议**：始终先执行 `cd ~` 进入 Linux 原生家目录后再进行环境配置。
        

---

_记录日期：2026-04-17_