安全

Hermes Agent 采用深度防御安全模型设计。本页面涵盖了所有安全边界——从命令审批到容器隔离再到消息平台上的用户授权。

概述

安全模型有七个层次：

用户授权 — 谁可以与代理对话（允许列表、DM 配对）
危险命令审批 — 破坏性操作的人工干预
容器隔离 — 使用加固设置的 Docker/Singularity/Modal 沙箱
MCP 凭证过滤 — MCP 子进程的环境变量隔离
上下文文件扫描 — 项目文件中的提示注入检测
跨会话隔离 — 会话无法访问彼此的数据或状态；定时任务存储路径针对路径遍历攻击进行了加固
输入清理 — 终端工具后端中的工作目录参数根据允许列表进行验证，以防止 shell 注入

危险命令审批

在执行任何命令之前，Hermes 会根据精心策划的危险模式列表进行检查。如果找到匹配项，用户必须明确批准。

审批模式

审批系统支持三种模式，通过 ~/.hermes/config.yaml 中的 approvals.mode 配置：

approvals:
  mode: manual    # manual | smart | off
  timeout: 60     # 等待用户响应的秒数（默认：60）

模式	行为
manual（默认）	总是在危险命令上提示用户批准
smart	使用辅助 LLM 评估风险。低风险命令（例如 `python -c "print('hello')"`）会自动批准。真正危险的命令会自动拒绝。不确定的情况会升级为手动提示。
off	禁用所有批准检查 — 相当于使用 `--yolo` 运行。所有命令无需提示即可执行。

注意

设置 approvals.mode: off 会禁用所有安全提示。仅在受信任的环境（CI/CD、容器等）中使用。

YOLO 模式

YOLO 模式为当前会话绕过所有危险命令批准提示。可以通过三种方式激活：

CLI 标志：使用 hermes --yolo 或 hermes chat --yolo 启动会话
斜杠命令：在会话期间输入 /yolo 来开启/关闭
环境变量：设置 HERMES_YOLO_MODE=1

/yolo 命令是一个切换开关 — 每次使用都会开启或关闭模式：

> /yolo
  ⚡ YOLO 模式开启 — 所有命令自动批准。请谨慎使用。

> /yolo
  ⚠ YOLO 模式关闭 — 危险命令将需要批准。

YOLO 模式在 CLI 和网关会话中都可用。在内部，它设置 HERMES_YOLO_MODE 环境变量，在每次命令执行前都会检查。

危险

YOLO 模式禁用会话的所有危险命令安全检查。仅在完全信任生成的命令时使用（例如，在一次性环境中经过充分测试的自动化脚本）。

审批超时

当出现危险命令提示时，用户有可配置的时间来响应。如果在超时时间内没有响应，命令默认被拒绝（故障关闭）。

在 ~/.hermes/config.yaml 中配置超时：

approvals:
  timeout: 60  # 秒（默认：60）

什么会触发审批

以下模式会触发批准提示（在 tools/approval.py 中定义）：

模式	描述
`rm -r` / `rm --recursive`	递归删除
`rm ... /`	在根路径中删除
`chmod 777/666` / `o+w` / `a+w`	世界/其他可写权限
`chmod --recursive` 带有不安全权限	递归世界/其他可写（长标志）
`chown -R root` / `chown --recursive root`	递归 chown 到 root
`mkfs`	格式化文件系统
`dd if=`	磁盘复制
`> /dev/sd`	写入块设备
`DROP TABLE/DATABASE`	SQL DROP
`DELETE FROM`（不带 WHERE）	不带 WHERE 的 SQL DELETE
`TRUNCATE TABLE`	SQL TRUNCATE
`> /etc/`	覆盖系统配置
`systemctl stop/disable/mask`	停止/禁用系统服务
`kill -9 -1`	杀死所有进程
`pkill -9`	强制杀死进程
Fork 炸弹模式	Fork 炸弹
`bash -c` / `sh -c` / `zsh -c` / `ksh -c`	通过 `-c` 标志执行 shell 命令（包括组合标志如 `-lc`）
`python -e` / `perl -e` / `ruby -e` / `node -c`	通过 `-e`/`-c` 标志执行脚本
`curl ... \| sh` / `wget ... \| sh`	将远程内容管道到 shell
`bash <(curl ...)` / `sh <(wget ...)`	通过进程替换执行远程脚本
`tee` 到 `/etc/`、`~/.ssh/`、`~/.hermes/.env`	通过 tee 覆盖敏感文件
`>` / `>>` 到 `/etc/`、`~/.ssh/`、`~/.hermes/.env`	通过重定向覆盖敏感文件
`xargs rm`	xargs 与 rm
`find -exec rm` / `find -delete`	查找并执行破坏性操作
`cp`/`mv`/`install` 到 `/etc/`	复制/移动文件到系统配置
`sed -i` / `sed --in-place` 在 `/etc/` 上	原地编辑系统配置
`pkill`/`killall` hermes/gateway	防止自我终止
`gateway run` 带 `&`/`disown`/`nohup`/`setsid`	防止在服务管理器外启动网关

信息

容器绕过：在 docker、singularity、modal 或 daytona 后端中运行时，危险命令检查被跳过，因为容器本身就是安全边界。容器内的破坏性命令无法损害主机。

审批流程（CLI）

在交互式 CLI 中，危险命令显示内联批准提示：

  ⚠️  危险命令：递归删除
      rm -rf /tmp/old-project

      [o]nce  |  [s]ession  |  [a]lways  |  [d]eny

      选择 [o/s/a/D]：

四个选项：

once — 允许这次单次执行
session — 在本次会话剩余时间允许此模式
always — 添加到永久允许列表（保存到 config.yaml）
deny（默认）— 阻止命令

审批流程（网关/消息）

在消息平台上，代理将危险命令详情发送到聊天中并等待用户回复：

回复 yes、y、approve、ok 或 go 来批准
回复 no、n、deny 或 cancel 来拒绝

运行网关时会自动设置 HERMES_EXEC_ASK=1 环境变量。

永久允许列表

使用"always"批准的命令会保存到 ~/.hermes/config.yaml：

# 永久允许的危险命令模式
command_allowlist:
  - rm
  - systemctl

这些模式在启动时加载，并在所有未来的会话中静默批准。

提示

使用 hermes config edit 来审查或从永久允许列表中删除模式。

用户授权（网关）

运行消息网关时，Hermes 通过分层授权系统控制谁可以与机器人交互。

授权检查顺序

_is_user_authorized() 方法按以下顺序检查：

按平台允许所有标志（例如 DISCORD_ALLOW_ALL_USERS=true）
DM 配对批准列表（通过配对代码批准的用户）
平台特定允许列表（例如 TELEGRAM_ALLOWED_USERS=12345,67890）
全局允许列表（GATEWAY_ALLOWED_USERS=12345,67890）
全局允许所有（GATEWAY_ALLOW_ALL_USERS=true）
默认：拒绝

平台允许列表

在 ~/.hermes/.env 中将允许的用户 ID 设置为逗号分隔的值：

# 平台特定允许列表
TELEGRAM_ALLOWED_USERS=123456789,987654321
DISCORD_ALLOWED_USERS=111222333444555666
WHATSAPP_ALLOWED_USERS=15551234567
SLACK_ALLOWED_USERS=U01ABC123

# 跨平台允许列表（所有平台都检查）
GATEWAY_ALLOWED_USERS=123456789

# 按平台允许所有（谨慎使用）
DISCORD_ALLOW_ALL_USERS=true

# 全局允许所有（极其谨慎使用）
GATEWAY_ALLOW_ALL_USERS=true

注意

如果没有配置允许列表且未设置 GATEWAY_ALLOW_ALL_USERS，所有用户都被拒绝。网关在启动时记录警告：

未配置用户允许列表。所有未授权用户将被拒绝。
在 ~/.hermes/.env 中设置 GATEWAY_ALLOW_ALL_USERS=true 以允许开放访问，
或配置平台允许列表（例如 TELEGRAM_ALLOWED_USERS=your_id）。

DM 配对系统

为了更灵活的授权，Hermes 包含基于代码的配对系统。不需要预先提供用户 ID，未知用户会收到一次性配对代码，机器人所有者通过 CLI 批准。

工作原理：

未知用户向机器人发送 DM
机器人回复一个 8 字符的配对代码
机器所有者在 CLI 上运行 hermes pairing approve <platform> <code>
用户被永久批准该平台

在 ~/.hermes/config.yaml 中控制如何处理未经授权的直接消息：

unauthorized_dm_behavior: pair

whatsapp:
  unauthorized_dm_behavior: ignore

pair 是默认设置。未经授权的 DM 会收到配对代码回复。
ignore 静默丢弃未经授权的 DM。
平台部分覆盖全局默认值，因此您可以在 Telegram 上保持配对，同时让 WhatsApp 保持静默。

安全功能（基于 OWASP + NIST SP 800-63-4 指南）：

功能	详情
代码格式	32 字符无歧义字母表中的 8 字符（无 0/O/1/I）
随机性	加密（`secrets.choice()`）
代码 TTL	1 小时过期
速率限制	每用户每 10 分钟 1 个请求
待处理限制	每个平台最多 3 个待处理代码
锁定	5 次批准失败 → 1 小时锁定
文件安全	所有配对数据文件设置 `chmod 0600`
日志记录	代码从不记录到 stdout

配对 CLI 命令：

# 列出待处理和已批准的用户
hermes pairing list

# 批准配对代码
hermes pairing approve telegram ABC12DEF

# 撤销用户访问权限
hermes pairing revoke telegram 123456789

# 清除所有待处理代码
hermes pairing clear-pending

**存储：**配对数据存储在 ~/.hermes/pairing/ 中，每个平台有 JSON 文件：

{platform}-pending.json — 待处理的配对请求
{platform}-approved.json — 已批准的用户
_rate_limits.json — 速率限制和锁定跟踪

容器隔离

使用 docker 终端后端时，Hermes 对每个容器应用严格的安全加固。

Docker 安全标志

每个容器都使用这些标志运行（在 tools/environments/docker.py 中定义）：

_SECURITY_ARGS = [
    "--cap-drop", "ALL",                          # 放弃所有 Linux 能力
    "--cap-add", "DAC_OVERRIDE",                  # root 可以写入绑定挂载的目录
    "--cap-add", "CHOWN",                         # 包管理器需要文件所有权
    "--cap-add", "FOWNER",                        # 包管理器需要文件所有权
    "--security-opt", "no-new-privileges",         # 阻止权限提升
    "--pids-limit", "256",                         # 限制进程数量
    "--tmpfs", "/tmp:rw,nosuid,size=512m",         # 大小限制的 /tmp
    "--tmpfs", "/var/tmp:rw,noexec,nosuid,size=256m",  # 无执行 /var/tmp
    "--tmpfs", "/run:rw,noexec,nosuid,size=64m",   # 无执行 /run
]

资源限制

容器资源可在 ~/.hermes/config.yaml 中配置：

terminal:
  backend: docker
  docker_image: "nikolaik/python-nodejs:python3.11-nodejs20"
  docker_forward_env: []  # 仅显式允许列表；空值将机密保留在容器外
  container_cpu: 1        # CPU 核心数
  container_memory: 5120  # MB（默认 5GB）
  container_disk: 51200   # MB（默认 50GB，需要在 XFS 上使用 overlay2）
  container_persistent: true  # 在会话间持久化文件系统

文件系统持久性

持久模式（container_persistent: true）：从 ~/.hermes/sandboxes/docker/<task_id>/ 绑定挂载 /workspace 和 /root
临时模式（container_persistent: false）：工作空间使用 tmpfs — 清理时所有内容都会丢失

提示

对于生产网关部署，使用 docker、modal 或 daytona 后端将代理命令与主机系统隔离。这完全消除了对危险命令批准的需求。

注意

如果您向 terminal.docker_forward_env 添加名称，这些变量会被有意注入到容器中供终端命令使用。这对于任务特定的凭证（如 GITHUB_TOKEN）很有用，但也意味着容器中运行的代码可以读取并泄露它们。

终端后端安全比较

后端	隔离	危险命令检查	最适用于
local	无 — 在主机上运行	✅ 是	开发、受信任用户
ssh	远程机器	✅ 是	在单独服务器上运行
docker	容器	❌ 跳过（容器是边界）	生产网关
singularity	容器	❌ 跳过	HPC 环境
modal	云沙箱	❌ 跳过	可扩展云隔离
daytona	云沙箱	❌ 跳过	持久云工作空间

环境变量传递

execute_code 和 terminal 都会从子进程中剥离敏感环境变量，以防止 LLM 生成的代码泄露凭证。但是，声明了 required_environment_variables 的技能确实需要访问这些变量。

工作原理

两种机制允许特定变量通过沙箱过滤器：

1. 技能范围传递（自动）

当加载技能（通过 skill_view 或 /skill 命令）并声明 required_environment_variables 时，任何在环境中实际设置的这些变量都会自动注册为传递。缺失的变量（仍处于需要设置状态）不会被注册。

# 在技能的 SKILL.md 前言中
required_environment_variables:
  - name: TENOR_API_KEY
    prompt: Tenor API 密钥
    help: 从 https://developers.google.com/tenor 获取密钥

加载此技能后，TENOR_API_KEY 会传递到 execute_code、terminal（本地）和远程后端（Docker、Modal） — 无需手动配置。

Docker & Modal

在 v0.5.1 之前，Docker 的 forward_env 是与技能传递分离的系统。现在它们已合并 — 技能声明的环境变量会自动转发到 Docker 容器和 Modal 沙箱，无需手动添加到 docker_forward_env。

2. 基于配置的传递（手动）

对于任何技能都未声明的环境变量，将它们添加到 config.yaml 中的 terminal.env_passthrough：

terminal:
  env_passthrough:
    - MY_CUSTOM_KEY
    - ANOTHER_TOKEN

凭证文件传递（OAuth 令牌等）

某些技能需要沙箱中的文件（不仅仅是环境变量）— 例如，Google Workspace 将 OAuth 令牌存储为活动配置文件 HERMES_HOME 下的 google_token.json。技能在前言中声明这些：

required_credential_files:
  - path: google_token.json
    description: Google OAuth2 令牌（由设置脚本创建）
  - path: google_client_secret.json
    description: Google OAuth2 客户端凭证

加载时，Hermes 检查这些文件是否存在于活动配置文件的 HERMES_HOME 中并注册它们以进行挂载：

Docker：只读绑定挂载（-v host:container:ro）
Modal：在沙箱创建时挂载 + 每次命令前同步（处理会话中的 OAuth 设置）
本地：无需操作（文件已可访问）

您也可以在 config.yaml 中手动列出凭证文件：

terminal:
  credential_files:
    - google_token.json
    - my_custom_oauth_token.json

路径相对于 ~/.hermes/。文件挂载到容器内的 /root/.hermes/。

每个沙箱过滤的内容

沙箱	默认过滤器	传递覆盖
execute_code	阻止名称中包含 `KEY`、`TOKEN`、`SECRET`、`PASSWORD`、`CREDENTIAL`、`PASSWD`、`AUTH` 的变量；只允许安全前缀变量通过	✅ 传递变量绕过两个检查
terminal（本地）	阻止显式的 Hermes 基础设施变量（提供者密钥、网关令牌、工具 API 密钥）	✅ 传递变量绕过阻止列表
terminal（Docker）	默认无主机环境变量	✅ 传递变量 + `docker_forward_env` 通过 `-e` 转发
terminal（Modal）	默认无主机环境/文件	✅ 凭证文件挂载；环境传递通过同步
MCP	阻止除安全系统变量 + 显式配置的 `env` 外的所有内容	❌ 不受传递影响（改用 MCP `env` 配置）

安全考虑

传递只影响您或您的技能显式声明的变量 — 对于任意 LLM 生成的代码，默认安全姿态不变
凭证文件以只读方式挂载到 Docker 容器中
Skills Guard 在安装前扫描技能内容以查找可疑的环境访问模式
缺失/未设置的变量永远不会被注册（您无法泄露不存在的东西）
Hermes 基础设施机密（提供者 API 密钥、网关令牌）绝不应添加到 env_passthrough — 它们有专用机制

MCP 凭证处理

MCP（模型上下文协议）服务器子进程接收过滤的环境以防止意外凭证泄露。

安全环境变量

只有这些变量从主机传递到 MCP stdio 子进程：

PATH, HOME, USER, LANG, LC_ALL, TERM, SHELL, TMPDIR

加上任何 XDG_* 变量。所有其他环境变量（API 密钥、令牌、机密）都被剥离。

在 MCP 服务器的 env 配置中显式定义的变量会被传递：

mcp_servers:
  github:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_..."  # 只有这个会被传递

凭证编辑

来自 MCP 工具的错误消息在返回给 LLM 之前会被清理。以下模式会被替换为 [REDACTED]：

GitHub PAT（ghp_...）
OpenAI 风格密钥（sk-...）
Bearer 令牌
token=、key=、API_KEY=、password=、secret= 参数

网站访问策略

您可以限制代理可以通过其 Web 和浏览器工具访问的网站。这对于防止代理访问内部服务、管理面板或其他敏感 URL 很有用。

# 在 ~/.hermes/config.yaml 中
security:
  website_blocklist:
    enabled: true
    domains:
      - "*.internal.company.com"
      - "admin.example.com"
    shared_files:
      - "/etc/hermes/blocked-sites.txt"

当请求被阻止的 URL 时，工具返回错误，说明域名被策略阻止。阻止列表在 web_search、web_extract、browser_navigate 和所有支持 URL 的工具中强制执行。

有关完整详情，请参阅配置指南中的网站阻止列表。

SSRF 保护

所有支持 URL 的工具（web 搜索、web 提取、vision、browser）在获取之前验证 URL 以防止服务器端请求伪造（SSRF）攻击。被阻止的地址包括：

专用网络（RFC 1918）：10.0.0.0/8、172.16.0.0/12、192.168.0.0/16
环回：127.0.0.0/8、::1
链路本地：169.254.0.0/16（包括 169.254.169.254 的云元数据）
CGNAT / 共享地址空间（RFC 6598）：100.64.0.0/10（Tailscale、WireGuard VPN）
云元数据主机名：metadata.google.internal、metadata.goog
保留、多播和未指定地址

SSRF 保护始终激活且无法禁用。DNS 故障被视为被阻止（故障关闭）。重定向链在每个跳点重新验证以防止基于重定向的绕过。

Tirith 执行前安全扫描

Hermes 集成 tirith 用于执行前的内容级命令扫描。Tirith 检测仅模式匹配遗漏的威胁：

同形异义词 URL 欺骗（国际化域名攻击）
管道到解释器模式（curl | bash、wget | sh）
终端注入攻击

Tirith 在首次使用时从 GitHub 发布版自动安装，具有 SHA-256 校验和验证（如果 cosign 可用，还包括 cosign 来源验证）。

# 在 ~/.hermes/config.yaml 中
security:
  tirith_enabled: true       # 启用/禁用 tirith 扫描（默认：true）
  tirith_path: "tirith"      # tirith 二进制文件路径（默认：PATH 查找）
  tirith_timeout: 5          # 子进程超时秒数
  tirith_fail_open: true     # 当 tirith 不可用时允许执行（默认：true）

当 tirith_fail_open 为 true（默认）时，如果 tirith 未安装或超时，命令会继续执行。在高安全环境中设置为 false，在 tirith 不可用时阻止命令。

Tirith 的裁决与审批流程集成：安全命令通过，而可疑和被阻止的命令都会触发用户批准，并提供完整的 tirith 发现（严重性、标题、描述、更安全的替代方案）。用户可以批准或拒绝 — 默认选择是拒绝，以保持无人值守场景的安全。

上下文文件注入保护

上下文文件（AGENTS.md、.cursorrules、SOUL.md）在包含在系统提示中之前会扫描提示注入。扫描器检查：

忽略/无视先前指令的指令
带有可疑关键词的隐藏 HTML 注释
尝试读取机密（.env、credentials、.netrc）
通过 curl 的凭证泄露
不可见的 Unicode 字符（零宽度空格、双向覆盖）

被阻止的文件显示警告：

[已阻止：AGENTS.md 包含潜在提示注入（prompt_injection）。内容未加载。]

生产部署最佳实践

网关部署检查清单

设置显式允许列表 — 生产中绝不使用 GATEWAY_ALLOW_ALL_USERS=true
使用容器后端 — 在 config.yaml 中设置 terminal.backend: docker
限制资源限制 — 设置适当的 CPU、内存和磁盘限制
安全存储机密 — 将 API 密钥保存在 ~/.hermes/.env 中并设置适当的文件权限
启用 DM 配对 — 尽可能使用配对代码而不是硬编码用户 ID
审查命令允许列表 — 定期审计 config.yaml 中的 command_allowlist
设置 MESSAGING_CWD — 不要让代理从敏感目录操作
以非 root 身份运行 — 绝不以 root 身份运行网关
监控日志 — 检查 ~/.hermes/logs/ 中的未经授权访问尝试
保持更新 — 定期运行 hermes update 以获取安全补丁

保护 API 密钥

# 在 .env 文件上设置适当的权限
chmod 600 ~/.hermes/.env

# 为不同服务保留单独的密钥
# 绝不将 .env 文件提交到版本控制

网络隔离

为了最大安全性，在单独的机器或 VM 上运行网关：

terminal:
  backend: ssh
  ssh_host: "agent-worker.local"
  ssh_user: "hermes"
  ssh_key: "~/.ssh/hermes_agent_key"

这将网关的消息连接与代理的命令执行分开。

概述​

危险命令审批​

审批模式​

YOLO 模式​

审批超时​

什么会触发审批​

审批流程（CLI）​

审批流程（网关/消息）​

永久允许列表​

用户授权（网关）​

授权检查顺序​

平台允许列表​

DM 配对系统​

容器隔离​

Docker 安全标志​

资源限制​

文件系统持久性​

终端后端安全比较​

环境变量传递​

工作原理​

凭证文件传递（OAuth 令牌等）​

每个沙箱过滤的内容​

安全考虑​

MCP 凭证处理​

安全环境变量​

凭证编辑​

网站访问策略​

SSRF 保护​

Tirith 执行前安全扫描​

上下文文件注入保护​

生产部署最佳实践​

网关部署检查清单​

保护 API 密钥​

网络隔离​

概述