如何在Docker中部署Hermes Agent
如果這是你第一次運(yùn)行 Hermes Agent,請(qǐng)?jiān)谥鳈C(jī)上創(chuàng)建一個(gè)數(shù)據(jù)目錄,并以交互方式啟動(dòng)容器以運(yùn)行設(shè)置向?qū)В?/p>
mkdir -p ~/.hermes docker run -it --rm \ -v ~/.hermes:/opt/data \ nousresearch/hermes-agent setup
/opt/data 卷是 Hermes 所有狀態(tài)的唯一數(shù)據(jù)源。它映射到主機(jī)上的 ~/.hermes/ 目錄,并包含:
| Path | 內(nèi)容 |
|---|---|
| .env | API 密鑰和密鑰 |
| config.yaml | 所有Hermes的配置 |
| SOUL.md | Agent個(gè)性/身份 |
| sessions/ | 對(duì)話歷史 |
| memories/ | 持久內(nèi)存存儲(chǔ) |
| skills/ | 已安裝技能 |
| cron/ | 計(jì)劃作業(yè)定義 |
| hooks/ | 事件鉤子 |
| logs/ | 運(yùn)行時(shí)日志 |
| skins/ | 自定義 CLI skins |
切勿同時(shí)對(duì)同一數(shù)據(jù)目錄運(yùn)行兩個(gè) Hermes 網(wǎng)關(guān)容器——會(huì)話文件和內(nèi)存存儲(chǔ)并非設(shè)計(jì)用于并發(fā)寫入訪問。與網(wǎng)關(guān)并行運(yùn)行儀表盤容器是安全的,因?yàn)閮x表盤僅讀取數(shù)據(jù)。
這將引導(dǎo)你進(jìn)入設(shè)置向?qū)?,該向?qū)?huì)提示你輸入 API 密鑰并將其寫入 ~/.hermes/.env 文件。你只需執(zhí)行此操作一次。強(qiáng)烈建議你此時(shí)為網(wǎng)關(guān)設(shè)置一個(gè)聊天系統(tǒng)。







配置完成后,將容器作為持久網(wǎng)關(guān)在后臺(tái)運(yùn)行。
創(chuàng)建 hermes目錄,并在里面創(chuàng)建 docker-compose.yaml:
mkdir -p ~/hermes cd ~/hermes vim docker-compose.yaml
寫入以下內(nèi)容:
services:
hermes:
image: nousresearch/hermes-agent:latest
container_name: hermes
restart: unless-stopped
command: gateway run
ports:
- "8642:8642"
volumes:
- ~/.hermes:/opt/data
networks:
- hermes-net
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
ports:
- "9119:9119"
volumes:
- ~/.hermes:/opt/data
environment:
- GATEWAY_HEALTH_URL=http://hermes:8642
networks:
- hermes-net
depends_on:
- hermes
deploy:
resources:
limits:
memory: 512M
cpus: "0.5"
networks:
hermes-net:
driver: bridge- 如果不需要dashboard (比如只是Channel訪問),可以把上面dashboard那部分給刪了。
- 端口 8642 暴露了網(wǎng)關(guān)的OpenAI 兼容 API 服務(wù)器和健康檢查端點(diǎn)。如果你僅使用聊天平臺(tái)(例如 Telegram、Discord 等),則此端口為可選;但如果你希望儀表盤或外部工具能夠訪問網(wǎng)關(guān),則此端口為必需。在面向互聯(lián)網(wǎng)的計(jì)算機(jī)上打開任何端口都存在安全風(fēng)險(xiǎn)。除非你了解這些風(fēng)險(xiǎn),否則不應(yīng)這樣做。
| Environment variable | Description | Default |
|---|---|---|
GATEWAY_HEALTH_URL | 網(wǎng)關(guān) API 服務(wù)器的基本 URL,例如 http://gateway:8642 | (未設(shè)置 — 僅進(jìn)行本地 PID 檢查) |
GATEWAY_HEALTH_TIMEOUT | 健康探測超時(shí)時(shí)間(秒) | 3 |
- 如果沒有
GATEWAY_HEALTH_URL,儀表板將回退到本地進(jìn)程檢測——這僅在網(wǎng)關(guān)在同一容器或同一主機(jī)上運(yùn)行時(shí)才有效
然后構(gòu)建鏡像:
docker compose down docker compose up -d
可以監(jiān)控啟動(dòng)日志:
docker compose logs -f


要針對(duì)正在運(yùn)行的數(shù)據(jù)目錄打開交互式聊天會(huì)話:
docker run -it --rm \ -v ~/.hermes:/opt/data \ nousresearch/hermes-agent
到此這篇關(guān)于在Docker中部署Hermes Agent的文章就介紹到這了,更多相關(guān)Docker部署Hermes Agent內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持腳本之家!
相關(guān)文章

Hermes Agent Windows Docker 部署完全指南如何從零開始搭建你的自我進(jìn)化AI 智能體
HermesAgent是NousResearch開發(fā)的開源自我進(jìn)化型AI智能體,支持多模型、多平臺(tái)網(wǎng)關(guān)和持久化記憶,文章詳細(xì)介紹了環(huán)境準(zhǔn)備、Docker鏡像拉取、初始化配置、接入LLM模型、啟動(dòng)運(yùn)2026-05-13
Docker 部署 Hermes Agent 完整實(shí)戰(zhàn)指南(Windows / Linux 通用)
本文將詳細(xì)介紹如何通過 Docker 快速部署 Hermes Agent,部署前先為大家提供 Docker 一鍵安裝與鏡像加速方案,適配絕大多數(shù)場景,新手也能輕松上手,感興趣的朋友跟隨小編一2026-04-24
基于Docker部署Hermes Agent并接入飛書機(jī)器人的完整指南
本文將圍繞開源項(xiàng)目 Hermes Agent,手把手帶你完成從部署到接入飛書機(jī)器人的完整流程,相比零散教程,本文不僅提供詳細(xì)步驟,還會(huì)補(bǔ)充關(guān)鍵原理說明與實(shí)踐建議,幫助你真正掌2026-04-17




