什么值得买App下载 App ›
连续签到专享现金活动

2026 最新 Windows 离线安装 WSL + Hermes 教程(无网络报错版)

针对此前镜像方案与 Git 克隆常因网络问题失败的情况,采用最稳定的离线下载手动安装方案。通过直接下载 GitHub 压缩包,彻底避开网络卡顿、中断及超时问题,确保 Windows 环境下 WSL 与 Hermes 的顺利部署。
01前置准备:环境检查与功能开启
  1. 检查系统版本
    按 Win + R 输入 winver,确认系统为 Windows 10 2004(内部版本 19041+)及以上,或 Windows 11 任意版本。
  2. 开启系统底层功能
    以管理员身份打开 PowerShell 或终端,依次执行以下命令开启适用于 Linux 的 Windows 子系统和虚拟机平台:
    dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
    dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
    执行完毕后必须重启电脑使设置生效。
  3. 安装 WSL2 内核更新包
    根据电脑架构下载对应的 msi 包(x64 或 ARM64)并双击安装。
02WSL 离线部署:Ubuntu 手动导入
  1. 下载与解压安装包
    推荐下载 Ubuntu 22.04 LTS 或 24.04 LTS 的 .appx 安装包。若下载后自动变为 .zip,需手动改回后缀。将文件放入非系统盘目录(如 D:\WSL-Ubuntu),解压至找到 install.tar.gz 文件。
  2. 执行导入命令
    在 PowerShell 中执行以下命令导入发行版:
    cd D:\WSL-Ubuntu
    wsl --import Ubuntu-22.04 D:\WSL-Ubuntu\ install.tar.gz --version 2
  3. 创建普通用户
    启动 Ubuntu (wsl -d Ubuntu-22.04),执行 adduser 添加用户并设置密码,通过 usermod -aG sudo 赋予管理员权限。最后编辑 /etc/wsl.conf 文件设置 default 用户,执行 wsl --shutdown 重启生效。
03Hermes 离线部署:源码手动安装
  1. 准备目录与源码
    在 WSL 终端创建目录 mkdir -p ~/.hermes。从 GitHub 下载 Hermes 源码 ZIP 包,通过 Windows 资源管理器访问 ~/.hermes 目录或使用 mv 命令将文件传入 WSL 环境。
  2. 解压与环境配置
    解压源码包并重命名移动到标准路径:
    unzip hermes-agent-main.zip
    mv hermes-agent-main ~/.hermes/hermes-agent
    进入目录后创建虚拟环境并激活:
    cd ~/.hermes/hermes-agent
    python3 -m venv venv
    source venv/bin/activate
  3. 安装依赖与验证
    执行 pip install -r requirements.txt 安装依赖,最后输入 hermes --version 验证,显示版本号即安装成功。
04WebUI 配置与离线优势
安装 Hermes-WebUI 需下载并解压 WebUI 源码,进入目录执行 ./start.sh 即可启动网页界面。采用离线安装方案主要具备以下优势:绕过 Git 协议限制,仅使用 HTTP/HTTPS,避免公司或校园网拦截;利用一次性下载和断点续传机制,避免长连接中断,使安装成功率接近 100%。

评论

评论区空态插画

当前文章无评论,是时候发表评论了