企业官网建设流程全解析

1. 为什么选择WSL2安装Hermes Agent

在Windows系统上运行Hermes Agent有两种主要方式：原生Windows安装和WSL2安装。WSL2（Windows Subsystem for Linux 2）是微软提供的完整Linux内核兼容层，相比原生Windows安装有以下优势：

• 终端兼容性：WSL2提供完整的POSIX兼容终端环境，支持内嵌终端面板和PTY（伪终端）功能
• 开发一致性：与Linux开发工具链无缝集成，避免Windows与Linux的文件系统、路径处理差异
• 性能优势：在Linux文件系统上执行Git操作、文件搜索等任务比通过/mnt/c访问Windows文件快10-100倍

提示：如果你主要使用交互式聊天、网关功能且不涉及复杂Linux工具链，原生Windows安装可能更简单

2. WSL2环境准备

2.1 基础安装步骤

1. 以管理员身份打开PowerShell，执行安装命令：

wsl --install

这个命令会自动完成以下操作：

• 启用WSL2功能组件
• 安装虚拟机平台
• 下载默认的Ubuntu发行版

2. 重启计算机后，首次打开Ubuntu会提示创建Linux用户名和密码（与Windows账户独立）

3. 验证WSL版本：

wsl --list --verbose

确保显示VERSION 2，如果显示1则需要转换：

wsl --set-version Ubuntu 2 wsl --set-default-version 2

2.2 推荐配置优化

在WSL内执行以下命令启用systemd支持：

sudo tee /etc/wsl.conf >/dev/null <<'EOF' [boot] systemd=true [interop] enabled=true appendWindowsPath=true [automount] options = "metadata,umask=22,fmask=11" EOF

然后关闭并重启WSL：

wsl --shutdown

重新打开终端后验证：

ps -p 1 -o comm=

应输出systemd

3. Hermes Agent安装流程

3.1 一键安装脚本

在WSL终端中执行：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash source ~/.bashrc hermes

安装过程会自动：

1. 下载最新版Hermes Agent
2. 设置环境变量
3. 创建~/.hermes配置目录

3.2 文件系统最佳实践

WSL2与Windows存在两套独立的文件系统：

强烈建议：

• 将Hermes相关文件全部放在WSL文件系统内（如~/code）
• 避免在/mnt/c下进行开发操作（性能差、权限问题）

4. 网络配置要点

4.1 本地服务互通

场景1：WSL中的Hermes访问Windows本地服务（如Ollama）

Windows 11 22H2+用户：

1. 创建或编辑%USERPROFILE%\.wslconfig：

[network] networkingMode=mirrored

2. 重启WSL：wsl --shutdown

旧版Windows需要：

1. 确保服务绑定到0.0.0.0而不仅是127.0.0.1
2. 添加Windows防火墙规则

4.2 外部访问WSL服务

场景2：从Windows访问WSL中的Hermes服务

镜像模式下自动可用。传统NAT模式需要：

1. 在WSL中绑定到0.0.0.0
2. 获取WSL IP：ip -4 addr show eth0 | grep inet
3. 从Windows直接访问该IP

5. 长期运行方案

5.1 使用systemd管理

如果已启用systemd，可以设置开机自启：

hermes gateway setup

按提示选择安装systemd用户单元

5.2 Windows自动启动

创建计划任务：

1. 触发器：用户登录时
2. 操作：启动程序C:\Windows\System32\wsl.exe
3. 参数：-d Ubuntu --exec /bin/sh -c "sleep infinity"

6. 常见问题解决

问题1：git status极慢

• 原因：在/mnt/c下操作
• 解决：将仓库移到WSL文件系统（如~/code）

问题2：脚本报错bad interpreter: /bin/bash^M

• 原因：Windows行尾符
• 解决：

sudo apt install dos2unix dos2unix script.sh git config --global core.autocrlf input

问题3：休眠后时间不同步

• 解决：

sudo hwclock -s

7. GPU加速配置

对于NVIDIA显卡：

1. 确保Windows已安装最新驱动
2. WSL内执行nvidia-smi验证识别
3. CUDA工具链会自动使用GPU

注意：AMD和Intel显卡在WSL中的支持有限，建议使用原生Windows版模型服务器并通过网络访问