WSL 安装与常用命令

# 前言

WSL（Windows Subsystem for Linux）是 Windows 上的 Linux 子系统，允许在 Windows 中直接运行 Linux 环境。对于 Hermes Agent、OpenClaw 等 AI 工具，WSL2 是推荐的运行环境。

本文将介绍 WSL 的安装、配置和常用命令。

# WSL 安装

# 前置条件

Windows 10 版本 2004+ 或 Windows 11
启用虚拟机功能

# 一键启用 WSL

# 在 PowerShell（管理员）中执行
wsl --install

1
2

该命令会：

启用 WSL 和虚拟机平台
下载并安装 Ubuntu（默认）
安装完成后需重启电脑

# 安装指定发行版到自定义位置

默认 WSL 会安装在 C 盘，占用系统盘空间。可以指定安装位置到其他盘：

# 安装 Ubuntu 24.04 到 D:\WSL\ 目录
wsl --install -d Ubuntu-24.04 --location D:\WSL\Ubuntu-24.04

1
2

提示

建议将 WSL 安装到非系统盘，避免 C 盘空间不足。

# 查看可用发行版

# 列出可安装的发行版
wsl --list --online

# 输出示例
NAME                    FRIENDLY NAME
Ubuntu                  Ubuntu
Ubuntu-22.04            Ubuntu 22.04 LTS
Ubuntu-24.04            Ubuntu 24.04 LTS
Debian                  Debian GNU/Linux
kali-linux              Kali Linux Rolling
...

1
2
3
4
5
6
7
8
9
10
11

# 安装其他发行版

# 安装 Debian
wsl --install -d Debian --location D:\WSL\Debian

# 安装 Ubuntu 22.04
wsl --install -d Ubuntu-22.04 --location D:\WSL\Ubuntu-22.04

1
2
3
4
5

# WSL 卸载

# 注销发行版

# 注销 Ubuntu-24.04（删除该发行版及其数据）
wsl --unregister Ubuntu-24.04

1
2

注意

此操作会删除该发行版中的所有数据，包括安装的软件和配置文件，不可恢复！

# 查看已安装的发行版

# 列出已安装的发行版
wsl --list --verbose

# 输出示例
NAME            STATE           VERSION
Ubuntu-24.04    Running         2
Ubuntu-22.04    Stopped         2

1
2
3
4
5
6
7

# 用户配置

# 设置默认登录用户

# 设置 Ubuntu-24.04 的默认用户为 ubuntu
wsl -d Ubuntu-24.04 config --default-user ubuntu

1
2

# 进入指定发行版

# 进入 Ubuntu-24.04
wsl -d Ubuntu-24.04

# 或使用完整路径
wsl.exe -d Ubuntu-24.04

1
2
3
4
5

# 设置默认发行版

# 设置 Ubuntu-24.04 为默认发行版
wsl --set-default Ubuntu-24.04

# 之后直接 wsl 即可进入
wsl

1
2
3
4
5

# 目录与路径配置

# 设置默认启动目录

进入 WSL 后，默认目录可能是 Windows 路径。可以设置为 Linux 主目录：

# 在 WSL 内执行
echo "cd ~" >> ~/.bashrc

# 或指定其他目录
echo "cd /home/ubuntu/projects" >> ~/.bashrc

1
2
3
4
5

# 重新加载配置

source ~/.bashrc

# Windows 与 WSL 路径互访

# 在 WSL 中访问 Windows 文件
cd /mnt/c/Users/YourName/
ls /mnt/d/Projects/

# 在 Windows 中访问 WSL 文件
# PowerShell
cd \\wsl$\Ubuntu-24.04\home\ubuntu\

1
2
3
4
5
6
7

# WSL 管理

# 关闭 WSL

# 关闭所有 WSL 发行版
wsl --shutdown

# 关闭指定发行版
wsl --terminate Ubuntu-24.04

1
2
3
4
5

# 导出与导入

# 导出 Ubuntu-24.04 为 tar 文件（备份）
wsl --export Ubuntu-24.04 D:\WSL\backup\ubuntu-24.04.tar

# 从 tar 文件导入（恢复或迁移）
wsl --import Ubuntu-24.04 D:\WSL\Ubuntu-24.04 D:\WSL\backup\ubuntu-24.04.tar

1
2
3
4
5

# 更新 WSL

# 更新 WSL 内核
wsl --update

# 查看版本
wsl --version

1
2
3
4
5

# IP 地址查看

# 查看 WSL IP

# 在 WSL 内查看 IP
ip addr show eth0

# 或使用 hostname
hostname -I

# 只显示 IP
ip -4 addr show eth0 | grep -oP '(?<=inet\s)\d+(\.\d+){3}'

1
2
3
4
5
6
7
8

# 查看 Windows 主机 IP（从 WSL）

WSL2 通过 NAT 网络连接 Windows，可以通过以下方式获取宿主机 IP：

# 方法一：读取 resolv.conf
cat /etc/resolv.conf | grep nameserver | awk '{print $2}'

# 方法二：使用 ip 命令
ip route | grep default | awk '{print $3}'

# 方法三：快捷别名（添加到 ~/.bashrc）
alias winip='cat /etc/resolv.conf | grep nameserver | awk "{print \$2}"'

1
2
3
4
5
6
7
8

# Windows 查看 WSL IP

# 在 PowerShell 中查看 WSL 的 IP
wsl -d Ubuntu-24.04 hostname -I

1
2

# 网络端口转发

WSL2 的端口默认会自动转发到 Windows，可以直接访问：

# 在 WSL 启动服务（如 Hermes Gateway）
hermes gateway

# Windows 可通过 localhost:端口访问
# 例如 Gateway 默认端口

1
2
3
4
5

如果需要手动转发：

# Windows 端口转发到 WSL
netsh interface portproxy add v4tov4 listenport=8000 listenaddress=0.0.0.0 connectport=8000 connectaddress=<WSL_IP>

# 查看转发规则
netsh interface portproxy show all

# 删除转发规则
netsh interface portproxy delete v4tov4 listenport=8000 listenaddress=0.0.0.0

1
2
3
4
5
6
7
8

# 常用命令速查

# PowerShell 命令（Windows）

命令	说明
`wsl --install`	一键安装 WSL + Ubuntu
`wsl --install -d <发行版>`	安装指定发行版
`wsl --install -d <发行版> --location <路径>`	安装到指定位置
`wsl --list --online`	查看可用发行版
`wsl --list --verbose`	查看已安装发行版（含状态）
`wsl -d <发行版>`	进入指定发行版
`wsl --set-default <发行版>`	设置默认发行版
`wsl --shutdown`	关闭所有 WSL
`wsl --terminate <发行版>`	关闭指定发行版
`wsl --unregister <发行版>`	注销发行版（删除数据）
`wsl --export <发行版> <文件>`	导出为 tar
`wsl --import <发行版> <位置> <文件>`	从 tar 导入
`wsl --update`	更新 WSL 内核
`wsl --version`	查看版本
`wsl --status`	查看状态
`wsl -d <发行版> config --default-user <用户>`	设置默认用户

# Bash 命令（WSL 内）

命令	说明
`hostname -I`	查看 IP
`ip addr show eth0`	查看网卡信息
`cat /etc/resolv.conf`	查看 DNS（含 Windows IP）
`ip route`	查看路由表
`echo "cd ~" >> ~/.bashrc`	设置默认目录
`source ~/.bashrc`	重载配置

# 性能优化

# 将 WSL2 安装到 SSD

WSL2 使用虚拟磁盘（VHDX），安装在 SSD 上性能更好：

# 安装到 SSD 路径
wsl --install -d Ubuntu-24.04 --location D:\WSL\Ubuntu-24.04

1
2

# 调整内存限制

创建 .wslconfig 文件限制 WSL 内存使用：

# 在 C:\Users\<用户名>\.wslconfig
[wsl2]
memory=4GB
processors=2
swap=2GB
localhostForwarding=true

1
2
3
4
5
6

# 禁用自动启动

# 设置 WSL 不自动启动
wsl --set-default-version 2

1
2

# 常见问题

# WSL 启动慢

# 关闭后重启
wsl --shutdown
wsl -d Ubuntu-24.04

1
2
3

# 网络不通

# 重启网络服务
sudo systemctl restart network

# 或手动配置 DNS
echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf

1
2
3
4
5

# 空间不足

# 导出 -> 注销 -> 导入（压缩）
wsl --export Ubuntu-24.04 D:\backup.tar
wsl --unregister Ubuntu-24.04
wsl --import Ubuntu-24.04 D:\WSL\Ubuntu-24.04 D:\backup.tar --version 2

1
2
3
4

# 权限问题

# WSL 内修复权限
sudo chown -R ubuntu:ubuntu ~/

1
2

# 与 Hermes 结合

WSL2 是 Hermes Agent 在 Windows 上的推荐运行环境：

# 进入 WSL
wsl -d Ubuntu-24.04

# 安装 Hermes
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

# 配置并启动
hermes setup --portal
hermes

1
2
3
4
5
6
7
8
9

Gateway 端口会自动转发到 Windows，可以从 Windows 的 Telegram/Discord 等客户端访问。

# 相关链接

WSL 官方文档：https://docs.microsoft.com/en-us/windows/wsl (opens new window)
Ubuntu 24.04：https://ubuntu.com (opens new window)
Hermes Agent：https://hermes-agent.nousresearch.com (opens new window)

# 总结

WSL2 提供了接近原生 Linux 的体验，是 Windows 用户运行 Hermes Agent、OpenClaw 等 AI 工具的理想选择。通过自定义安装位置、用户配置、网络管理，可以打造高效稳定的开发环境。

#WSL #Windows #Linux

← Linux 安装 Hermes Agent Telegram 机器人创建与接入指南→