chroot容器模块安装配置hermes完整教程

本文将详细讲解 chroot 容器环境 下 Hermes 服务的安装、面板部署、容器运维及后台配置全流程,全程基于轻量 chroot 容器面板实现可视化管理,操作简单、适配性强。

一、前置准备:安装 chroot 容器 Ubuntu 面具模块

首先部署 chroot 容器基础环境,安装 Ubuntu 面具模块,完成后通过 SSH 连接服务器进行后续所有操作,为后续容器面板、Hermes 服务部署提供基础运行环境。

二、部署轻量 chroot 容器管理面板(mini-panel)

2.1 项目介绍

mini-panel 是基于 1Panel 管理面板 + DockRoot 开发的轻量级 chroot 容器面板管理服务,支持一键部署容器环境、可视化管理容器启停,内置类 Docker 容器工具 DockRoot,完美适配 chroot 容器场景。

项目开源地址:YevolcXhb/mini-panel

2.2 一键部署命令

SSH 连接服务器后,执行以下命令完成面板全自动部署:

1
curl -fsSL https://raw.githubusercontent.com/YevolcXhb/mini-panel/main/install.sh | bash

2.3 环境说明

部署完成后,环境自动集成 DockRoot 工具(替代 Docker 的 chroot 容器工具),可直接用于容器镜像拉取、启动、停止、进入终端等全流程操作。后续所有容器操作均可在该面板对应的项目目录中执行。

三、安装部署 Hermes Web UI 服务

3.1 项目介绍

Hermes Web UI 是配套 Hermes 服务的可视化前端界面,依托 DockRoot 容器运行,可实现模型配置、网关服务、消息通知等功能的可视化管理。

项目开源地址:EKKOLearnAI/hermes-web-ui

3.2 拉取 Hermes 容器镜像

进入 mini-panel 项目根目录,执行以下 DockRoot 命令拉取最新 Hermes Web UI 镜像,并命名为 hermes

1
./DockRoot pull gh-proxy.org/docker/ekkoye8888/hermes-web-ui:latest hermes

3.3 Hermes 容器常用运维命令

所有命令均在 mini-panel 项目目录下执行,日常容器管理可直接使用以下指令,也可通过 1Panel 可视化面板 快速启停容器,操作更便捷:

1
2
3
4
5
6
7
8
# 启动 hermes 容器
./DockRoot run hermes

# 进入 hermes 容器终端
./DockRoot run hermes sh

# 停止 hermes 容器
./DockRoot stop hermes

四、容器内 Hermes 服务初始化配置

进入 Hermes 容器终端后,依次执行以下配置命令,完成模型、通知网关、后台常驻运行配置。

4.1 模型配置向导

启动交互式模型配置面板,可自主选择模型提供商、填写 API Key、绑定对应AI模型:

1
hermes model

4.2 配置通知服务网关

初始化 Hermes 消息通知、转发网关服务,配置消息推送、接口转发规则:

1
hermes gateway setup

4.3 网关常驻后台运行(防掉线)

开启 Root 权限允许规则,通过 nohup 守护进程常驻运行网关,避免终端关闭后服务掉线,日志自动输出至指定目录:

1
HERMES_ALLOW_ROOT_GATEWAY=1 nohup hermes gateway run > /opt/hermes/gateway.log 2>&1 

五、运维优化建议

  • 容器启停、状态监控、日志查看优先使用1Panel 管理面板,可视化操作更高效,无需反复执行命令;

  • 网关日志统一存储在 /opt/hermes/gateway.log,故障排查可直接查看日志文件;

  • 服务器重启后,可通过 1Panel 一键重启 hermes 容器及网关服务,无需重新配置。