Hermes Windows 客户端安装详解：一键脚本与手动配置指南

最近看到不少朋友在问，Hermes 这款工具在 Windows 下到底能不能像 Linux 那样搞个“一键安装”脚本？毕竟对于不想折腾环境的小伙伴来说，越简单越好。

虽然官方目前似乎并没有直接为 Windows 推出原生的“安装包”或者标准的一键脚本，但咱们完全可以利用现有的工具，通过 WSL（Windows Subsystem for Linux）或者 Git 环境，模拟出一个类似“一键安装”的体验。

今天就把我实测的几种方案分享出来，无论是追求极致速度，还是需要深度定制，都能找到适合你的路子。

方案一：利用 WSL 运行类 Shell 脚本（推荐新手）

这个方法最接近大家心目中的“一键安装”。既然 Hermes 大多数开源脚本都是基于 Linux 环境编写的，那我们在 Windows 上造一个 Linux 环境不就行了？

1. 准备工作

首先，确保你的 Windows 版本支持 WSL。Win10 更新版或者 Win11 基本都没问题。

2. 安装 WSL 和 Ubuntu

以管理员身份打开 PowerShell，输入以下命令安装 WSL 和 Ubuntu （默认版本）：

wsl --install

重启电脑后，系统会自动引导你完成 Ubuntu 的初始化设置（设置用户名和密码）。

3. 在 WSL 中执行安装

进入 Ubuntu 终端后，你就可以像在普通 Linux 服务器上一样，粘贴 Hermes 社区里大佬提供的安装脚本了。通常的流程是：

curl -fsSL https://your-hermes-script-url | bash

或者

wget -qO- https://your-hermes-script-url | bash

脚本会自动处理依赖下载、Docker 安装和容器启动。虽然中间多开了一个 WSL 窗口，但这在 Windows 上已经是最省心的“全自动”方案了。

方案二：使用 Git Bash / Cygwin 模拟环境

如果你不想开启 WSL 虚拟机，觉得占用资源大，那可以试试 Git Bash。

1. 安装 Git Bash

去官网下载安装 Git for Windows，安装完后自带 Git Bash 终端。

2. 修改脚本适配

注意： 很多一键脚本里包含 systemctl 命令（用来管理服务），这在 Git Bash 的模拟环境里是不工作的。

你需要手动下载 Hermes 的二进制文件或者 Docker 镜像，然后手动启动。比如如果你使用 Docker Desktop（需提前安装好），启动命令大概是：

docker run -d --name hermes-client -p 你的端口:映射端口 hermes-image:latest

这个方案稍微灵活一点，但需要你对 Docker 命令有基本的了解。

方案三：原生 Windows 二进制文件的部署

其实，Hermes 本身如果是 Go 或者 Rust 编写的，通常会有编译好的 Windows 版二进制文件（.exe）。这种方法最纯粹，性能损耗最小。

1. 前去 GitHub Release 页面，下载对应架构（通常是 amd64）的 Windows 压缩包。
2. 解压到一个文件夹，比如 D:\Tools\Hermes。
3. 配置写法： 在同级目录下新建一个 config.yaml 或者 .env 文件（具体看项目文档），把你在 Linux 上配置好的参数粘贴进去。
4. 运行： 在这个文件夹里打开 CMD 或 PowerShell，输入：

   .\hermes.exe -c config.yaml
   

如何后台运行（守护进程）

Windows 下直接运行 exe，关掉窗口程序就停了。想让它像服务一样跑在后台，可以用两个小工具：

• NSSM (Non-Sucking Service Manager)： 图形化工具，能把 exe 包装成 Windows 系统服务，开机自启，崩溃重启。
• WinSW： 配合 XML 配置文件使用，也是为了将 exe 注册为服务。

遇到常见问题怎么破？

1. 端口被占用

现象： 提示 Address already in use。 解决： 在 PowerShell 用 netstat -ano | findstr 端口号 找到占用进程的 PID，然后 taskkill /PID xxx /F 结束它。记得在 config 里换个端口避开冲突。

2. 防火墙拦截

现象： 本地能跑，外网访问不通。 解决： Windows Defender 防火墙默认会拦截陌生入站连接。去“控制面板” -> “系统和安全” -> “Windows Defender 防火墙” -> “允许应用通过防火墙”，把你的 Hermes.exe 或者终端程序勾选上（特别是专用网络和公用网络都要勾）。

3. 依赖缺失（针对方案二）

现象： 提示缺少某个 .dll。 解决： 这种情况一般出现在直接运行未编译完善的 exe 时。建议优先使用 Docker 或 WSL 方案，环境隔离更干净。

总结

目前 Hermes 严格意义上的“Windows 原生一键安装包”可能还没有，但通过 WSL 套娃脚本 或者 Docker Desktop，完全可以达到“复制粘贴即可用”的效果。如果你是硬核玩家，直接拿 exe 配合 NSSM 做成服务才是长久之计。

希望这篇指南能帮你省去翻遍文档的烦恼，趁着还没跑路，赶紧搭起来薅羊毛吧！