Hermes Agent Docker Compose 部署3 分鐘跑通容器化附 3 個(gè)避坑清單【免費(fèi)下載鏈接】hermes-agentThe agent that grows with you項(xiàng)目地址: https://gitcode.com/GitHub_Trending/he/hermes-agentHermes Agent 是一個(gè)會(huì)自我進(jìn)化的個(gè)人 AI 代理能調(diào)工具、接消息、管定時(shí)任務(wù)。這篇講怎么用 Docker Compose 把它跑進(jìn)容器、掛好數(shù)據(jù)卷避開(kāi)最常翻車的三處。讀完你能獨(dú)立啟動(dòng)并驗(yàn)證它。先跑起來(lái)3 條命令驗(yàn)證 Hermes Agent為什么要用容器跑因?yàn)檫@東西會(huì)替你執(zhí)行命令、讀寫文件關(guān)進(jìn)隔離環(huán)境里先跑心理上踏實(shí)一層。倉(cāng)庫(kù)自帶一份現(xiàn)成的 DockerfilePython 環(huán)境、瀏覽器、依賴全部烤好鏡像即成品不用你在里面再裝任何東西。先克隆并構(gòu)建git clone https://gitcode.com/GitHub_Trending/he/hermes-agent cd hermes-agent docker build -t hermes-agent .這一步在干嘛拉下源碼按 Dockerfile 構(gòu)建一個(gè)本地鏡像并打上 hermes-agent 標(biāo)簽。頭一次構(gòu)建偏慢耐心等之后重建都走緩存很快。然后是最短驗(yàn)證路徑docker run -d --name hermes -v hermes-data:/opt/data hermes-agent docker logs -f hermes這一步在干嘛起一個(gè)容器把命名卷 hermes-data 掛到 /opt/data配置和會(huì)話都落在這接著看日志?？吹絾?dòng)信息打出來(lái)就成了。鏡像內(nèi)置了 s6 進(jìn)程監(jiān)督主進(jìn)程、網(wǎng)關(guān)掉了都會(huì)自動(dòng)拉起所以掛后臺(tái)跑沒(méi)問(wèn)題。想自我體檢的話補(bǔ)一條docker exec -it hermes hermes doctor。關(guān)鍵配置改哪幾行就行跑通之后用 Docker Compose 固化下來(lái)。整個(gè)文件真正要你操心的只有這幾行services: hermes: image: hermes-agent # 上面構(gòu)建出的本地鏡像 volumes: - hermes-data:/opt/data # 配置和會(huì)話唯一必須掛的卷 environment: - HERMES_UID1000 # 你的宿主機(jī)用戶 ID防權(quán)限問(wèn)題 restart: unless-stopped volumes: hermes-data:逐行說(shuō)image 指向本地構(gòu)建的鏡像hermes-data 命名卷是 Hermes Agent 的配置、會(huì)話、技能文件的家這行別動(dòng)HERMES_UID 填id -u的輸出讓容器內(nèi)用戶和你宿主機(jī)用戶 ID 對(duì)齊文件歸屬才干凈restart 保證宕機(jī)自愈。其余字段保持默認(rèn)即可。升級(jí)也簡(jiǎn)單拉新代碼重新docker build后docker compose up -d重建容器數(shù)據(jù)卷不動(dòng)配置就還在。只用命令行就別映射端口哪天想用瀏覽器開(kāi) Web 面板再加一行ports就行。三個(gè)最常翻車的點(diǎn)?? 第一個(gè)數(shù)據(jù)丟了?，F(xiàn)象容器重建后配置和會(huì)話全沒(méi)了。根因/opt/data 沒(méi)掛載數(shù)據(jù)寫在容器層里容器一刪就沒(méi)了。一行修復(fù)volumes 里永遠(yuǎn)寫上hermes-data:/opt/data不要裸跑。第二個(gè)文件權(quán)限?，F(xiàn)象用 docker exec 寫進(jìn)去的文件服務(wù)突然讀不了。根因exec 默認(rèn)以 root 進(jìn)容器而鏡像里的服務(wù)用戶是 UID 10000root 寫的文件它沒(méi)權(quán)限。一行修復(fù)docker exec --user hermes hermes ...落盤歸屬就對(duì)了。第三個(gè)靜默?，F(xiàn)象第一次對(duì)話沒(méi)反應(yīng)也不報(bào)錯(cuò)。根因模型的 API key 還沒(méi)配。一行修復(fù)docker exec -it hermes hermes setup走一遍向?qū)О?provider 和密鑰一次設(shè)好。往深里走的入口下一步看哪想查全量環(huán)境變量從 .env.example 入手逐行帶注釋連終端后端local、docker、ssh 等和容器鏡像選擇都覆蓋到了想看代碼代理核心循環(huán)在 agent/ 目錄下容器啟動(dòng)與進(jìn)程監(jiān)督的寫法則藏在 Dockerfile 的 s6-overlay 段落里值得翻一遍?，F(xiàn)在打開(kāi)終端把上面那條docker run敲進(jìn)去親眼看著它啟動(dòng)一次比再讀三篇教程都管用。【免費(fèi)下載鏈接】hermes-agentThe agent that grows with you項(xiàng)目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考