Hermes Agent 安装指南
目录
1. 前置准备
2. 在 1Panel 创建 Docker 环境
3. Docker 版一键脚本
4. 常用命令 & 调试技巧
5. 文章发布建议（API 示例，仅供参考）
---
1️⃣ 前置准备
| 项目 | 推荐版本 | 检查方式 |
|------|----------|----------|
| 操作系统 | Ubuntu 22.04 LTS（或兼容的 Debian 系列） | lsb_release -a |
| Docker | Docker 23.x（已在 1Panel 中安装） | docker version |
| Docker‑Compose | 2.x（1Panel 自带） | docker compose version |
| Git | 2.40+ | git --version |
| 网络 | 能访问 GitHub、Docker Hub、以及 https://www.xiaozhuo.eu.org（Halo） | curl -I https://github.com |
Tip：如果 1Panel 已经启用了 “Docker 容器管理”，可以直接跳到第 2 步。
---
2️⃣ 在 1Panel 创建 Docker 环境
1. 登录 1Panel → 容器 → 创建容器。
2. 填写基本信息：
| 字段 | 示例值 |
|------|--------|
| 容器名称 | hermes-agent |
| 镜像名称 | ghcr.io/hermes-ai/hermes-agent:latest |
| 端口映射 | 8080:8080（如需自定义端口请自行修改） |
| 环境变量（可选） | HERMES_API_KEY=YOUR_API_KEY |
| 挂载卷 | /root/.hermes:/root/.hermes（持久化配置） |
| 启动命令 | hermes --gateway http://0.0.0.0:8080 |
3. 点击 创建 → 启动。页面会显示容器日志，确认出现 ✅ Hermes Agent is ready 即代表启动成功。
---
3️⃣ Docker 版一键脚本（无需 1Panel UI）
如果您更喜欢直接在终端操作（不走 1Panel UI），执行下面的脚本即可完成全部部署。
#!/usr/bin/env bash
# 1️⃣ 拉取最新镜像
docker pull ghcr.io/hermes-ai/hermes-agent:latest
# 2️⃣ 创建持久化目录（宿主机）
mkdir -p $HOME/.hermes
# 3️⃣ 启动容器（后台运行）
docker run -d \
--name hermes-agent \
-p 8080:8080 \
-v $HOME/.hermes:/root/.hermes \
-e HERMES_API_KEY=YOUR_API_KEY \ # 如已有 API Key，可在此注入
ghcr.io/hermes-ai/hermes-agent:latest \
hermes --gateway http://0.0.0.0:8080
验证：
> curl -s http://127.0.0.1:8080/status | jq .
>
若返回 { "status":"running" }，说明服务已就绪。
---
4️⃣ 常用命令 & 调试技巧
| 场景 | 命令 |
|------|------|
| 查看运行状态 | curl -s http://127.0.0.1:8080/status \| jq . |
| 获取帮助文档 | docker exec -it hermes-agent hermes --help |
| 列出已安装的 Skill | docker exec -it hermes-agent hermes skills list |
| 查看容器日志 | docker logs -f hermes-agent |
| 重启容器 | docker restart hermes-agent |
| 修改配置（模型切换等） | 编辑 $HOME/.hermes/config.yaml → docker restart hermes-agent |
Tip：所有 hermes 子命令都可以通过 docker exec -it hermes-agent hermes <subcommand> 直接执行，便于调试。
---
5️⃣ 文章发布建议（API 示例，仅供参考）
如果您打算使用 程序化方式（curl /脚本）把本文发布到 Halo，下面是一段示例代码。请先在 Halo 后台 → Swagger UI（/swagger-ui.html）确认实际的 POST 路径（如 /api/content/articles），并使用您在后台生成的 PAT（Personal Access Token）替换示例中的占位符。
#!/usr/bin/env bash
# ----- ① 准备 Markdown 内容（保持原格式） -----
MARKDOWN=$(cat <<'ENDMD'
# Hermes Agent 安装指南
> 适用于在本机 1Panel 环境下通过 Halo 博客平台发布此文档。下面的内容涵盖所有前置准备、Docker 部署、常用调试命令以及完整的 Markdown 示例，您只需复制全文粘贴到 Halo 编辑器即可。
## 目录
1. 前置准备
2. 在 1Panel 创建 Docker 环境
3. Docker 版一键脚本
4. 常用命令 & 调试技巧
5. 文章发布建议（API 示例，仅供参考）
## 1️⃣ 前置准备
| 项目 | 推荐版本 | 检查方式 |
|------|----------|----------|
| 操作系统 | Ubuntu 22.04 LTS（或兼容的 Debian 系列） | lsb_release -a |
| Docker | Docker 23.x（已在 1Panel 中安装） | docker version |
| Docker‑Compose | 2.x（1Panel 自带） | docker compose version |
| Git | 2.40+ | git --version |
| 网络 | 能访问 GitHub、Docker Hub、以及 https://www.xiaozhuo.eu.org（Halo） | curl -I https://github.com |
> Tip：如果 1Panel 已经启用了 “Docker 容器管理”，可以直接跳到第 2 步。
## 2️⃣ 在 1Panel 创建 Docker 环境
1. 登录 1Panel → 容器 → 创建容器。
2. 填写基本信息：
| 字段 | 示例值 |
|------|--------|
| 容器名称 | hermes-agent |
| 镜像名称 | ghcr.io/hermes-ai/hermes-agent:latest |
| 端口映射 | 8080:8080（如需自定义端口请自行修改） |
| 环境变量（可选） | HERMES_API_KEY=YOUR_API_KEY |
| 挂载卷 | /root/.hermes:/root/.hermes（持久化配置） |
| 启动命令 | hermes --gateway http://0.0.0.0:8080 |
3. 点击 创建 → 启动。页面会显示容器日志，确认出现 ✅ Hermes Agent is ready 即代表启动成功。
## 3️⃣ Docker 版一键脚本（无需 1Panel UI）
bash
#!/usr/bin/env bash
1️⃣ 拉取最新镜像
docker pull ghcr.io/hermes-ai/hermes-agent:latest
2️⃣ 创建持久化目录（宿主机）
mkdir -p $HOME/.hermes
3️⃣ 启动容器（后台运行）
docker run -d \ (1/2)
[2026/4/18 22:56] 小强1号: --name hermes-agent \
-p 8080:8080 \
-v $HOME/.hermes:/root/.hermes \
-e HERMES_API_KEY=YOUR_API_KEY \ # 如已有 API Key，可在此注入
ghcr.io/hermes-ai/hermes-agent:latest \
hermes --gateway http://0.0.0.0:8080
> 验证：
> bash
curl -s http://127.0.0.1:8080/status | jq .
> 若返回 { "status":"running" }，说明服务已就绪。
## 4️⃣ 常用命令 & 调试技巧
| 场景 | 命令 |
|------|------|
| 查看运行状态 | curl -s http://127.0.0.1:8080/status \| jq . |
| 获取帮助文档 | docker exec -it hermes-agent hermes --help |
| 列出已安装的 Skill | docker exec -it hermes-agent hermes skills list |
| 查看容器日志 | docker logs -f hermes-agent |
| 重启容器 | docker restart hermes-agent |
| 修改配置（模型切换等） | 编辑 $HOME/.hermes/config.yaml → docker restart hermes-agent |
> Tip：所有 hermes 子命令都可以通过 docker exec -it hermes-agent hermes <subcommand> 直接执行，便于调试。
## 5️⃣ 文章发布建议（API 示例，仅供参考）
> 若您希望使用脚本而不是手动粘贴，请先在 Halo 后台 → Swagger UI 中确认实际的发布路径（如 /api/content/articles），并使用在后台生成的 PAT（Personal Access Token）。
bash
#!/usr/bin/env bash
① 替换为实际的 API 路径（Swagger 中看到的完整路径）
API_URL="https://www.xiaozhuo.eu.org/api/content/articles"
② 替换为您自己的 PAT
TOKEN="pat_eyJraWQiOiJ...（完整的 token）"
③ 发起 POST 请求
curl -X POST "$API_URL" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"title": "Hermes Agent 安装指南",
"content": "'"$(printf '%s' "$MARKDOWN" | sed 's/"/\\"/g')"'" ,
"status": "publish",
"allowComment": true,
"allowPing": true,
"allowFeed": true,
"tags": ["Hermes","Agent","Docker","1Panel"],
"categories": ["运维","开源工具"]
}'
如果返回类似：
json
{
"id": 123,
"title": "Hermes Agent 安装指南",
"url": "https://www.xiaozhuo.eu.org/posts/123",
"status": "publish"
}
``
则文章已经成功发布。
---
### 🎉 完成