# Portainer Stack Hermes

> 仓库地址：https://github.com/ellickjohnson/portainer-stack-hermes
> 作者/组织：ellickjohnson
> 成熟度：experimental
> 分析日期：2026-04-15

## 一句话总结
一个将 Hermes Agent 与 ttyd web terminal 打包为 Portainer Git Repository stack 的容器化部署方案，通过浏览器访问 agent terminal。

## 项目定位与架构
portainer-stack-hermes 面向使用 Portainer 管理 Docker 容器的运维人员，提供了一键部署 Hermes Agent 的方式。核心思路是将 Hermes Agent + ttyd（web terminal）打包为 Docker 镜像，通过 Portainer 的 Git Repository stack 功能实现声明式部署。

架构组件：Multi-stage Dockerfile → GHCR 预构建镜像 → Portainer stack 部署 → ttyd web terminal（端口 7681）。GitHub Actions 自动构建和推送镜像到 GHCR。

100% Dockerfile 构成，无额外应用代码——纯基础设施方案。

## 关键技术特性
- **Web terminal 访问**：通过 ttyd 提供浏览器端 terminal，端口 7681
- **GHCR 预构建镜像**：无需本地 build，直接 pull 使用
- **Portainer 原生集成**：作为 Git Repository stack 添加，与 Portainer 工作流无缝衔接
- **GitHub Actions CI/CD**：自动化镜像构建和推送
- **Multi-stage Dockerfile**：优化镜像大小

## 设计亮点与创新
针对 Portainer 用户群体的精准定位——已经在用 Portainer 管理容器的团队可以零学习成本添加 Hermes Agent。ttyd 集成避免了 SSH 配置的复杂性，通过浏览器直接操作 agent。

## 局限性与风险
仅 2 stars / 6 commits，项目极其早期。未提及认证/安全机制——ttyd 暴露的 terminal 是否有访问控制不明确。功能非常基础，仅提供容器化 + web terminal，无配置管理、监控或持久化方案。更新流程需要手动触发 GitHub Action → pull 新镜像 → 重部署。

## 与生态系统的关联
是部署工具链中最轻量的方案之一。与 hermes-agent-docker（纯 Docker）、evey-setup（全栈 Docker Compose）、nix-hermes-agent（NixOS）形成不同部署哲学的对比。适合已有 Portainer 基础设施的小团队快速试用 Hermes Agent。