当前位置：

社区首页

文化娱乐

在线教育

软件技能

文章详情

Windows电脑部署Hermes全教程：WSL2+Docker+Portainer一条龙

我一直用 NAS 上跑的 Hermes 做日常 AI 助手，轻量任务完全够用。

但碰到写代码、需要 GPU 渲染的重活，NAS 的性能就不够看了。于是在性能更强大的 PC 端，安装一个 AI 助手迫在眉睫。

Windows电脑部署Hermes全教程：WSL2+Docker+Portainer一条龙

说干就干，既然我对 Hermes 熟悉，那就先从 Hermes 开始。

虽然 Hermes 已经有 Windows 版的桌面端了，但还是有这样那样的问题。所以我们这次还是走最成熟的那条路：

WSL2 里跑 Linux 内核系统 Ubuntu，再把 Hermes 装在 Docker 里。

这篇文章把从 WSL2 到 Hermes 跑起来的每一步都走一遍，为的就是方便大家照抄。

第一步：启用 WSL2 + 安装 Ubuntu 第二步：安装 Docker Desktop 第三步：用 Docker Desktop 部署 Portainer 第四步：为 Portainer 配置本地 Docker 环境第五步：用 Portainer 部署 Hermes 第六步：进入 Hermes 容器终端进行初始配置第七步：Hermes Dashboard 第八步：在 Windows 访问 Hermes 目录

第一步：启用 WSL2 + 安装 Ubuntu

大家知道，Hermes、OpenClaw、Codex 这类 AI 助手在 Mac、Linux 系统中如鱼得水，但是对 Windows 的支持并不好。

这就是为什么我们要用 WSL 2+Ubuntu 的组合。

WSL2 是 Windows 的子系统功能，Windows 10/11 都支持，我们可以把它看做一台性能非常好的虚拟机。

我们把 Ubuntu 安装到 WSL2 ，就能在日常用 Windows 系统不变的前提下，额外获得一个完整的 Linux 环境。

现在我们正式开始。

以管理员身份打开 PowerShell，按顺序执行：

开启 WSL功能：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

开启虚拟机功能：

m.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

执行后需要重启电脑。

重启后查询 WSL 中可用的 Ubuntu 镜像名称。

wsl --list --online

我这里显示 Ubuntu，所以等会儿我们安装 Ubuntu 的命令要注意与这个名称一致。

输入命令，安装 Ubuntu：

wsl --install -d Ubuntu

安装后，Ubuntu 会自动弹出，提示创建 Linux 用户名和密码。

这是 Ubuntu 系统的账号，设置密码时不会显示字符，输入完直接回车就行。需要输入两次。

设置用户名密码后，Ubuntu 配置就完成了。

第二步：安装 Docker Desktop

出于方便和安全考虑，我还是建议通过 Docker 部署 Hermes。

我们去 Docker 官网下载 Docker Desktop 安装。

安装完成后，需要注销 Windows 账户再重新登入，以完成剩余设置。

注销重新登录后，启动 Docker Desktop，进入 Settings → Resources → WSL Integration。

确认 Enable integration with my default WSL distro 和 Ubuntu 这两项已经勾选。

这两个选项的作用是让 Docker Desktop 与 WSL2 Ubuntu 集成。

应用后，在 Ubuntu 终端里验证：

docker --version

看到 Docker 的版本信息就说明 Docker 没问题了。

第三步，用 Docker Desktop 部署 Portainer（选装）

Portainer 是一个开源 Docker 图形化管理工具。支持 Compose 项目。

因为我们后续可能要安装很多 Docker 应用，为了方便，建议先部署 Portainer。

Docker 镜像的拉取，如果速度慢，需要自己解决网络问题，这里不便多说。

在 docker desktop 搜索框输入 portainer，选择 ce 版本，点击 pull，拉取完成后，点击 run。

Container name 填 portainer，端口 8000 用于边缘代理（可选）、9443 用于 Web UI（必填）、9000 用于旧版端口（可选）。

Volumes 是持久化数据卷，参照下图填写就行。

Volumes 的第二行 /var/run/docker.sock 是为了 Portainer 与 Docker Desktop 的绑定。

配置完成后，点击 Run。

启动后，在浏览器地址栏输入 https://本地 IP:9443 就可以进入管理界面了。

第一次进入需要创建用户，按要求设置 12 位以上的密码，并从 Portainer 的日志中找到 Setup token，粘贴进来。点击 Create user。

日志中 Setup token 的位置：

第四步：为Portainer配置本地Docker环境

通过左侧菜单栏进入环境管理，点击 Add Environments。

选择 Docker Standalone，点击 Start Wizard 开始配置向导。

连接方式选择 Socket，命名随便填，比如 local，然后点击 Connect。

连接成功后，点击鲸鱼标志，就可以看到左侧菜单栏有 Docker 的选项了。

第五步：用 Portainer 部署 Hermes

现在通过 Portainer 部署 Hermes。

在左边栏点击 Stacks，右上角点击 Add stack。

填写容器名称，比如 hermes，构建方式选择 Web editor，然后粘贴 Docker Compose 内容。

Docker-Compose 可以参照这个填写，这个里面同时部署了 Hermes 和官方的网页管理端 Dashboard：

version: '3.8' services: hermes: image: nousresearch/hermes-agent:latest container_name: hermes restart: unless-stopped command: gateway run ports: - "8642:8642" # API 服务端口 volumes: - /home/用户名/docker/hermes:/opt/data environment: - TZ=Asia/Shanghai - API_SERVER_ENABLED=true - API_SERVER_HOST=0.0.0.0 - API_SERVER_KEY=密码 deploy: resources: limits: memory: 4G cpus: "2.0"

dashboard: image: nousresearch/hermes-agent:latest container_name: hermes-dashboard restart: unless-stopped command: dashboard --host 0.0.0.0 --port 8643 --no-open ports: - "8643:8643" # Web 仪表盘端口 volumes: - /home/用户名/docker/hermes:/opt/data environment: - GATEWAY_HEALTH_URL=http://hermes:8642 - HERMES_DASHBOARD_BASIC_AUTH_USERNAME=** - HERMES_DASHBOARD_BASIC_AUTH_PASSWORD=** depends_on: - hermes deploy: resources: limits: memory: 512M cpus: "0.5"

注意修改里面的用户名、密码。

然后拉到最后，点击 Deploy the stack。

下载镜像需要一段时间，不要离开页面。可以去 Docker Desktop 里的 Portainer 日志看跑马灯。