AI Skill 大全

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 测试套件的测试开发

使用步骤

  1. 先确认现象:容器里 PID 1 是不是 s6-svscan,具体哪个服务没起来。
  2. 用 s6-svstat 看待排查服务的状态字符串,判断是崩溃循环还是被主动停止,并 tail container-boot.log 看协调结果。
  3. 把问题定位到启动脚本、静态服务定义或运行时注册的 profile 网关这三层中的哪一层。
  4. 按层修改:启动脚本在 cont-init.d,静态服务在 s6-rc.d 下补 type 与 run 与 bundle 条目,网关命令改渲染脚本并同步测试。
  5. 重建镜像后用 docker 测试套件跑 tests/docker/ 验证,确认没有回归。

开始使用

将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。

查看 MCP 接入说明

技术信息

分类
编程
适用工具
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
  • 读取用户主动提供的内容

同类 Skill