DockRoot 使用手册

一、DockRoot 简介

DockRoot 是一个轻量版 Docker。

特点：

  • 用法与 Docker 类似
  • 不需要 Docker Daemon
  • 不依赖 OverlayFS
  • 不依赖 Cgroup
  • 不需要 systemd
  • 基于 ruri 实现
  • 支持更多 Linux 环境
  • 内存占用极低

缺点：

  • 必须使用 Root 权限运行
  • 无网络隔离（相当于 Docker Host 模式）
  • 不支持 Docker Compose
  • 不支持 Docker Network
  • 不支持 Docker Exec
  • 不支持 Docker Inspect

二、目录结构

假设：

1
2
3
4
/opt/minipanel/
├── DockRoot
├── ruri
└── DockRootData/

容器数据目录：

1
/opt/minipanel/DockRootData/

例如：

1
/opt/minipanel/DockRootData/hermes/

包含：

1
2
3
rootfs/      # 容器文件系统
ruri.conf    # 容器配置
ruri.log     # 容器日志

三、常用命令

查看帮助

1
./DockRoot --help

查看 run 参数：

1
./DockRoot run --help

查看 pull 参数：

1
./DockRoot pull --help

拉取镜像

语法：

1
./DockRoot pull 镜像地址 容器名称

示例：

1
2
./DockRoot pull library/alpine:latest alpine
./DockRoot pull docker.xuanyuan.run/nousresearch/hermes-agent:latest hermes

查看容器状态

1
./DockRoot ps 容器名称

示例：

1
./DockRoot ps hermes

前台启动容器

1
./DockRoot run 容器名称

示例：

1
./DockRoot run hermes

后台启动容器

1
./DockRoot run -d 容器名称

示例：

1
./DockRoot run -d hermes

停止容器

1
./DockRoot stop 容器名称

示例：

1
./DockRoot stop hermes

删除容器

1
./DockRoot rm 容器名称

示例：

1
./DockRoot rm hermes

四、进入容器

进入 Shell：

1
./DockRoot run hermes sh

或者：

1
./DockRoot run hermes bash

如果不存在 bash：

1
./DockRoot run hermes /bin/sh

五、执行命令

语法：

1
./DockRoot run 容器名 命令

示例：

1
2
3
./DockRoot run hermes pwd
./DockRoot run hermes ls
./DockRoot run hermes env

六、目录挂载

类似 Docker 的：

1
-v 宿主机目录:容器目录

语法：

1
2
3
4
./DockRoot run \
-v 宿主机目录:容器目录 \
--renew \
容器名称

示例：

1
2
3
4
5
6
mkdir -p /root/.hermes

./DockRoot run \
-v /root/.hermes:/opt/data \
--renew \
hermes

说明：

1
2
宿主机目录：/root/.hermes
容器目录：/opt/data

七、查看日志

查看日志：

1
cat DockRootData/hermes/ruri.log

实时查看：

1
tail -f DockRootData/hermes/ruri.log

八、Hermes Agent 安装

拉取镜像：

1
./DockRoot pull docker.xuanyuan.run/nousresearch/hermes-agent:latest hermes

进入容器

1
./DockRoot run hermes sh

进入后：

1
cd /opt/hermes

初始化 Hermes

Docker 官方命令：

1
docker run image setup

在 DockRoot 中应执行：

1
./hermes setup

不要执行：

1
setup

否则会出现：

1
2
Failed to execute setup
No such file or directory

Quick Setup

推荐选择：

1
Quick Setup (Nous Portal)

优点：

  • 无需 OpenAI API Key
  • 无需 Claude API Key
  • 无需 Gemini API Key
  • 自动配置模型
  • 自动配置工具

Full Setup

适用于：

  • OpenAI
  • Anthropic
  • Gemini
  • DeepSeek
  • OpenRouter
  • Ollama

用户自备 API Key。

九、Hermes 常用命令

进入容器：

1
./DockRoot run hermes sh

进入程序目录：

1
cd /opt/hermes

初始化：

1
./hermes setup

查看帮助：

1
./hermes --help

启动：

1
./hermes

十、故障排查

setup 找不到

错误：

1
2
Failed to execute setup
No such file or directory

原因：

1
2
setup 不是独立可执行文件
而是 Hermes CLI 的参数

正确方式：

1
./hermes setup

查看 Hermes 目录

1
ls -lah /opt/hermes

查看 Python 环境

1
python --version

查看环境变量

1
env

查看容器日志

1
tail -f /opt/minipanel/DockRootData/hermes/ruri.log

十一、常用命令速查表

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
# 拉取镜像
./DockRoot pull 镜像 容器名

# 启动容器
./DockRoot run 容器名

# 后台启动
./DockRoot run -d 容器名

# 进入容器
./DockRoot run 容器名 sh

# 查看状态
./DockRoot ps 容器名

# 停止容器
./DockRoot stop 容器名

# 删除容器
./DockRoot rm 容器名

# 查看日志
tail -f DockRootData/容器名/ruri.log

# Hermes 初始化
./hermes setup

# Hermes 帮助
./hermes --help