Octop v1.0.0如何配置Shell命令护栏-人工智能-PHP中文网

octop v1.0.0 的 shell 命令护栏是内建于 agent 引擎和 connector 网关的行为约束机制，通过 connector.yaml 白名单、arg_pattern 正则校验、docker 上下文隔离实现安全控制，需显式配置且依赖 rbac 权限与 loop-enabled 模式。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

octop v1.0.0如何配置shell命令护栏

Octop v1.0.0 的 Shell 命令护栏（Shell Command Guard）不是默认开启的独立开关，而是一套内建在 Agent 执行引擎 和 Connector 安全网关 中的行为约束机制。它的作用是防止 AI 误执行高危命令（如 rm -rf /、shutdown、chmod 777 等），同时允许受信命令在可控范围内运行——关键在于“配置信任边界”，而非简单开/关。

Shell 命令护栏的核心配置方式

通过 connector.yaml 限制可执行命令白名单
在 Octop 部署目录的 config/connectors/ 下编辑对应 Shell Connector 的配置文件（如 shell-local.yaml），添加或修改 allowed_commands 字段：
```
allowed_commands:
  - "ls"
  - "cat"
  - "grep"
  - "ps aux | grep"
  - "systemctl status"
```
不在列表中的命令会被直接拦截，并返回提示：“该命令未被授权执行”。

SuperCLUE
SuperCLUE是一款AI模型评测工具，中文通用大模型综合性测评基准。

下载
启用命令参数校验规则（正则过滤）
可为每个白名单命令附加 arg_pattern，例如禁止 rm 删除根目录或隐藏文件：
```
- name: "rm"
  arg_pattern: "^-f?\s+[^/].*$"  # 只允许删除非绝对路径下的文件
```
设置执行上下文隔离（推荐搭配 Docker 后端）
若你使用 docker 作为可插拔后端（见 backend.yaml），Shell 命令实际运行在轻量容器中，天然具备文件系统与进程空间隔离。此时即使命令未被白名单覆盖，也无法影响宿主机。
关闭护栏需显式声明（不建议）
若确需临时放开（如调试场景），可在对应 Connector 配置中设：
```
security:
  disable_command_guard: true
```
但该字段必须由管理员手动写入，且启动时会输出 WARN 日志提醒。