Hermes容器服务调试
排查和修改 Hermes Docker 镜像里的 s6 服务与启动流程:网关起不来、重启不恢复、要新增静态服务都走这套做法。
功能与用途
Hermes 的 Docker 镜像用 s6-overlay 管启动:进程 1 是 /init,开机脚本负责重映射用户、种子配置文件和把持久卷里的 profile 网关槽位重建出来,每个 profile 的网关注册在 /run/service 下被单独监管。出问题时的现象往往很反直觉,比如容器一直以退出码 143 结束、docker exec 里提示命令找不到、或者某个网关被反复拉起又崩。这个能力帮你按架构定位到具体是哪一环,给出要改的文件、要跑的 s6 状态查询命令和验证方式。
适用场景
- 某个 profile 的网关在 docker restart:某个 profile 的网关在 docker restart 之后没有自己起来,需要判断是崩溃循环还是被标记为不自动启动
- 要在镜像里新加一个每次容器启动都要被监管的服务(例如仪表盘):要在镜像里新加一个每次容器启动都要被监管的服务(例如仪表盘),不确定该建哪些 s6 目录文件
- 想改每 profile 网关的启动命令,需要找到那处单一事实:想改每 profile 网关的启动命令,需要找到那处单一事实来源并同步对应的测试断言
适用人群
- 维护 Hermes Docker 镜像构建与启动脚本的开发工程师
- 在自托管环境里跑 Hermes 多 profile 网关的运维工程师
- 给 Hermes 容器写集成测试、需要跑 docker 测试套件的测试开发
使用步骤
- 先确认现象:容器里 PID 1 是不是 s6-svscan,具体哪个服务没起来。
- 用 s6-svstat 看待排查服务的状态字符串,判断是崩溃循环还是被主动停止,并 tail container-boot.log 看协调结果。
- 把问题定位到启动脚本、静态服务定义或运行时注册的 profile 网关这三层中的哪一层。
- 按层修改:启动脚本在 cont-init.d,静态服务在 s6-rc.d 下补 type 与 run 与 bundle 条目,网关命令改渲染脚本并同步测试。
- 重建镜像后用 docker 测试套件跑 tests/docker/ 验证,确认没有回归。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 专业
- 版本
- main
- 最近更新
- 2026-09-10
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Modify or debug s6 services in the Hermes Docker image.
使用前准备
- 需要 Docker 环境、可构建的 Hermes 镜像,以及 s6-overlay 与容器进程监管的基础知识。
依赖与权限
- PATH
- 读取用户主动提供的内容