⚕ Hermes Agent 完整部署经验文档

从零到全栈 AI Agent 系统 · 2026年5月26日 · 约8小时完成

📋 最终成果

🐳

Docker 容器

💬

消息平台

🌐

在线域名

🛠

工具服务

🎯 核心经验

1. Docker 网络问题

国内访问 Docker Hub 极不稳定，必须使用镜像加速：

docker pull docker.m.daocloud.io/xxx/yyy

所有镜像前面加 docker.m.daocloud.io/ 前缀

2. QQ邮箱端口被屏蔽

SMTP (465/587) 和 IMAP (993) 全部超时。最终移除了 Email 功能，改用微信/企业微信通知。

3. DeepSeek API 路径陷阱

Base URL 必须完整写 https://api.deepseek.com/v1，不能漏掉 /v1。模型名用 deepseek-chat，不是 deepseek-v4-flash。

4. 双实例架构

Docker 版处理消息平台（微信/QQ/企微），本地版处理开发任务。通过分离配置目录 ~/.hermes 和 ~/.hermes-local 实现完全独立。

5. Cloudflare Tunnel 持久化

Windows 后台进程容易挂，必须用 docker run --restart unless-stopped 部署 tunnel。配置文件注意路径统一用正斜杠。

6. WSL 内存限制

Docker Desktop 的 WSL 默认占用大量内存。创建 %USERPROFILE%\.wslconfig 限制：

[wsl2]
memory=4GB
swap=4GB

7. Portal 三件套最佳组合

Portainer (Docker管理) + Uptime Kuma (监控) + Gitea (Git仓库) 是最实用的 Docker 工具栈，一次性部署终身受益。

8. Cloudflare Pages 部署

wrangler login 后用 wrangler pages deploy 一键部署静态站。自定义域名在 Pages Dashboard 直接添加，Cloudflare 自动创建 CNAME。

⚡ 常用命令速查

docker compose up -d
启动所有服务 (C:\AI-Workspace\docker-stack)

docker compose restart
重启所有服务

docker compose logs -f hermes-agent
查看 Agent 实时日志

hermes pairing approve weixin CODE
批准微信新用户

hermes gateway status
查看网关状态

hermes dashboard --port 9120
启动本地 Dashboard

wrangler pages deploy .
部署到 Cloudflare Pages

cloudflared tunnel run hermes-tunnel
启动外网隧道

📅 完整部署时间线

13:38 创建 AI-Workspace，系统环境确认：Win11 Pro · 20GB RAM · Python 3.12 · Node 24 · Docker 29.4 · WSL

17:00 pip install hermes-agent v0.13 → 升级 v0.14，setup wizard 配置 DeepSeek + Edge TTS + Docker终端

17:30 Dashboard 前端构建（npm build），firecrawl 双Key 搜索配置，API Server 启用

18:00 微信扫码 + 企业微信扫码 + QQ Bot 配置，Email IMAP (端口屏蔽)

18:30 Cursor 连接 Hermes API，SOUL.md 人格文件，OpenRouter 后备模型

19:00 多 Agent 团队 (CEO/Coder/Designer/Researcher/Writer)，优化参数 (max_turns=150, compression=0.7)

19:30 Docker 容器化 Hermes，双实例架构，wrangler 登录

20:00 Portainer + Uptime Kuma + Gitea + Nginx + PostgreSQL + MinIO 全部部署

20:30 系统优化：WSL 4GB限制，虚拟内存 8-16GB，Edge 标签休眠，TERMINAL_ENV=local

21:00 Cloudflare Pages 部署文档，命名 Tunnel 创建，8 个 DNS 记录，全站上线

23:00 经验文档总结，最终发布

🌐 在线服务入口

doc.bearqh.fun	部署经验文档
hermes.bearqh.fun	Hermes Agent Dashboard
portainer.bearqh.fun	Docker 可视化管理
gitea.bearqh.fun	自建 Git 仓库
status.bearqh.fun	Uptime Kuma 服务监控
minio.bearqh.fun	MinIO S3 云存储
home.bearqh.fun	Nginx 首页

Hermes Agent v0.14.0 · Nous Research · Windows 11 Pro · Docker 29.4.3 · Cloudflare Tunnel

Generated 2026-05-26 · Deployed on Cloudflare Pages