跳转到主要内容

概述

运行环境(Environment)是 AI SRE Agent 实际执行动作的地方。Agent 的每一次工具调用,包括执行命令、读写文件、运行 Skill、连接 MCP 服务,都会落在一个运行环境里。 AI SRE 提供两类运行环境:

云端 Sandbox

Flashduty 托管的临时容器,零安装、开箱即用。没有可用的在线自托管 Runner 时,会话使用云端 Sandbox。

自托管 Runner

部署在您自己机器上的常驻进程(BYOC,Bring Your Own Compute)。它主动连接 AI SRE,让 Agent 在您的网络边界内执行任务。
不手动指定时,系统按以下优先级为新会话挑选运行环境:首先使用会话绑定团队名下在线的自托管 Runner;团队下没有时,改用共享范围(即账户级)内在线的 Runner;两者都没有时,使用云端 Sandbox。选择在会话第一条消息发送时确定,之后不会改变,详见在会话中选择环境。 您也可以在会话输入框的环境选择器中手动固定:强制使用云端 Sandbox,或固定使用某个具体 Runner。
控制台里的记录称为 环境(Environment),跑在机器上的进程称为 Runner。一个自托管环境对应一个 Runner 进程;云端 Sandbox 由系统按会话管理。

云端 Sandbox

云端 Sandbox 是 Flashduty 托管的临时执行容器。它适合快速上手、演示,以及不需要访问您内网的排查。您不需要安装任何进程,也不需要维护机器。 适合使用云端 Sandbox 的场景:
  • 还没有部署 Runner,想先体验 AI SRE;
  • 排查只需要访问 Flashduty 数据、公网服务或公开文档;
  • 一次性、轻量任务,不值得准备常驻机器;
  • 希望强制隔离在托管环境中执行,而不是使用账户下已有 Runner。
云端 Sandbox 不能访问您的 VPC、专线、内网数据库、内网 API 或跳板机。需要直连这些资源时,请使用自托管 Runner,把执行位置放到能访问目标资源的机器上。
生命周期、数据位置与出网范围见 Sandbox。

云端环境模板

云端环境模板是为 Flashduty 托管的云端 Sandbox 预定义的可复用配置:网络访问、环境变量与启动脚本。会话使用的云端 Sandbox 如果没有绑定模板,就用系统默认配置启动;绑定了模板后,新建的 Sandbox 会按模板配置启动。 进入 AI SRE → 自定义 → 环境 → 云端,即可查看、创建、编辑或删除云端环境模板。

创建云端环境模板

环境变量以明文形式对所有使用该云端环境模板的人可见——请勿在这里填写密钥或凭据。
平台保留的环境变量名。 以下变量由平台注入,模板里设置它们会在保存时被拒绝:FLASHDUTY_APP_KEY、FLASHDUTY_BASE_URL、FLASHDUTY_DOCS_URL、FLASHDUTY_CONSOLE_URL、PATH、HOME,以及 GitHub(GH_TOKEN*、GIT_CONFIG_*)和 GitLab(GITLAB_*、GLAB_*)的认证与主机配置变量。 FLASHDUTY_CONSOLE_URL 是控制台地址,Agent 用它把结论里引用的故障、告警、协作空间、值班表等拼成可点击的链接;没有配置控制台地址时不注入,Agent 改在正文里用资源 ID 指代。它不含密钥,Agent 可以读取。 即使通过其他方式设置了同名变量,执行命令时也以平台的值为准(云端 Sandbox 与自托管 Runner 相同)。模板中的环境变量只用于非敏感的业务配置;需要密钥时,请使用 MCP 的成员授权或相应的 App 集成。 启动脚本在全新沙箱(Ubuntu 24.04,以 root 身份运行)内、Agent 启动前执行,典型用途是用 apt 安装 Agent 需要的软件包。

删除云端环境模板

删除一个云端环境模板不影响正在使用它的会话——已绑定的会话会回退为系统默认配置继续可用;后续新建的 Sandbox 会改用系统默认配置。
云端环境模板只配置云端 Sandbox。自托管 Runner 的网络访问由您自己的机器和防火墙决定,见下方自托管 Runner。

自托管 Runner

自托管 Runner 是您部署在自己机器上的 flashduty-runner 进程。它与 AI SRE 保持常驻连接,收到任务后在本机执行命令、读写文件、运行 Skill,并按需连接本机可达的 MCP 服务。 自托管 Runner 的价值来自执行位置:
Runner 跑在您的机器上,因此能访问这台机器本身可达的 VPC、内网、专线、Kubernetes 集群、云厂商 CLI、数据库或跳板机。
命令输出、日志、临时文件和工具执行结果优先留在您的网络边界内。Agent 能读取和分析这些信息,但执行面仍由您机器的系统账号、文件权限和网络策略约束。
您可以决定 Runner 运行在哪个 OS 用户下、能访问哪些目录、拥有哪些 CLI 凭据,以及是否加载本页的权限配置收敛命令范围。
自托管 Runner 的网络访问由您的机器和防火墙决定,自托管环境表单里没有网络访问配置。

创建并连接

进入 AI SRE → 自定义 → 环境 → 自托管,创建一个自托管环境。创建时需要填写: 创建成功后会弹出接入指引,包含这个环境的 Token、安装命令、升级命令和卸载命令。列表行里的钥匙按钮或 pending 状态的“查看接入指引”也会打开同一个弹窗。

安装方式

接入指引里的命令会自动填入真实 TOKEN 与 URL。以下示例只展示占位符,请以控制台生成的命令为准。
在目标机器上以 root / sudo 执行:
脚本会安装二进制、创建 systemd 服务,并写入 /etc/flashduty-runner/env。同一条命令可用于首次安装和升级;如果已是最新版本,会自动跳过。
connect-url 与 install_script_url 都由平台动态下发,不是固定地址。私有化或离线部署可以把安装脚本分发源替换为内部镜像,但镜像需要同时提供 install.sh、releases/latest 与 releases/download/<version>/... release assets。

连接使用自签证书的私有化端点

Runner 默认会校验控制 WebSocket 的证书链和主机名。私有化端点使用自签证书时,优先把对应 CA 加入 Runner 所在系统或容器的信任库;只有无法安装 CA、且端点位于可信私有网络内时,才关闭校验。
编辑 /etc/flashduty-runner/env,写入私有化端点和 TLS 配置:
重启 Runner,让新的环境变量生效:
开启后,Runner 不再校验控制 WebSocket 的证书链和主机名,攻击者可能冒充控制端。该开关只影响 Runner 到 AI SRE 的控制 WebSocket,不会改变任务执行期间 MCP、A2A 或其他 HTTPS 请求的 TLS 配置。Runner 启动时会在日志中明确提示校验已关闭。

Linux 服务用户

Linux (systemd) 安装默认使用安装脚本自动创建的 flashduty 用户。该用户没有 sudo 权限,systemd unit 会启用 NoNewPrivileges=true、ProtectSystem=strict、PrivateTmp=true 等限制,并只把 Runner 的状态目录设为可写。 如果 Runner 需要读取某个已有用户的 kubeconfig、云厂商 CLI 凭据或 Docker 权限组,可以在接入指引里填写“Linux 服务用户”,或手动在命令中增加 RUN_AS:
RUN_AS 等价于安装脚本的 --run-as <user> 参数,要求该系统用户已经存在。这样做会让 systemd 服务以该用户运行,也会相应放宽该用户主目录的保护策略。
只有在 Runner 确实需要读取该用户的本地凭据或加入该用户所在权限组时,才指定 RUN_AS。否则优先使用默认 flashduty 用户。

Token、升级和卸载

Token 是 Runner 连接 AI SRE 的唯一凭据。它会写入安装命令或环境变量中,请只在安装、升级或排查连接时查看,不要发给无关人员。若怀疑泄露,请删除对应环境后重新创建。 Runner 启动后会持续发送心跳。列表状态含义如下: 性能下降 会自动出现和消失,无需手动清除。Runner 的任务积压或任务连续超时时出现,积压消除、任务恢复正常后回到 在线。
看到 性能下降 时,先检查 Runner 所在主机的 CPU、内存与磁盘负载,以及是否有长时间占用执行器的任务。它不阻断会话,但持续处于该状态说明这台主机已经吃不消当前的任务量。
发现新版本时,Runner 会自行下载、校验并替换。手动重跑安装命令也可升级。 卸载命令也在接入指引里,按安装方式不同:
  • Linux (systemd) / 手动安装:安装脚本的 --uninstall(保留配置卸载)与 --purge(清除配置与数据)。
  • Docker 安装:卸载是容器命令,与安装脚本的参数无关——docker rm -f flashduty-runner(卸载,保留 /var/flashduty/workspace 数据)与 docker rm -f flashduty-runner && rm -rf /var/flashduty/workspace(彻底卸载,同时清除 workspace 数据)。

权限配置

Runner 默认使用允许全部命令的规则,这与直接在自己的 shell 里运行 AI 模型、信任模型的判断是同一套信任模型:
当您希望把 Runner 的命令执行范围收敛到允许列表或拒绝列表时,可以在 Runner 所在机器上创建一个 YAML 文件,并通过 --permission-config 参数或 FLASHDUTY_RUNNER_PERMISSION_CONFIG 环境变量指定它。权限配置是 Runner 本机文件,不在控制台表单里编辑。 Linux (systemd) 安装后,推荐在 /etc/flashduty-runner/env 中加入:
然后重启服务:
手动启动时也可以直接传参数:
权限配置会在 Runner 启动时加载。修改 YAML 后需要重启 Runner,新的规则才会生效。
规则文件顶层键是 permission,值是 glob 模式 → allow/deny 的映射:
规则语义:
  • 不设置 --permission-config / FLASHDUTY_RUNNER_PERMISSION_CONFIG 是默认行为,等价于允许所有命令;
  • 规则会应用到命令的每一处出现——管道(cmd1 | cmd2)、$(...)/反引号命令替换、进程替换、算术展开,以及写入重定向目标(例如 echo x > /etc/passwd 会像执行命令一样被拦截;读重定向本身不会额外拦截);
  • 命令按规范化后的 shell 片段匹配,空格差异不会影响匹配;
  • 最具体的规则优先:第一个 * 之前字面前缀最长的模式最先被尝试匹配,兜底规则 "*" 始终最后尝试,第一个匹配的规则生效;
  • 该文件仅在 Runner 启动时加载一次——修改规则后需要重启 Runner,新规则才会生效,不支持热重载;
  • 若指定了该 flag/环境变量,但文件缺失、格式错误,或未在 permission 键下定义任何规则,Runner 会拒绝启动(fail closed),而不是静默放行所有命令:显式配置权限即代表明确希望限制执行范围,配置写错时应当报错而非留下安全隐患。
默认拒绝所有命令,仅显式放行需要的命令:
等价于完全不设置 --permission-config,但允许显式声明例外:
适用于 Runner 运行在隔离 VM/容器、影响范围有限,或更看重响应速度而非限制权限的场景。
只放行只读命令,适合仅用于观测、不希望 Runner 修改任何状态的场景:

文件访问边界

权限配置约束的是命令;Agent 的文件读写工具另有独立的路径语义,与 bash 的行为保持一致:
  • 相对路径:限制在 workspace 根目录内,并带符号链接逃逸保护——通过相对路径只能读写 workspace 内的文件。
  • 绝对路径:按设计直接落到宿主机文件系统,与 bash 一致。
因此真正划定文件访问边界的,是 Runner 运行的 OS 用户 与部署隔离(systemd 的用户与目录保护、Docker 的挂载与容器边界),而不是权限配置文件。

在会话中选择环境

聊天输入框底部的环境选择器决定新会话在哪里执行:
会话的运行环境在首次发送消息时确定,之后不会因为切换选择器而改变。要换环境,请新建会话。
打开历史会话时,选择器只读显示该会话的环境及其状态。如果绑定的 Runner 已离线或被删除,该会话不能继续发送消息;请先恢复 Runner,或新建会话。

子会话的执行环境

派发出去的子代理会带出一条自己的子会话,它的执行环境规则与根会话不同:
  • 默认与父会话共用环境:子会话与父会话共用同一个沙箱 / workspace,可以直接看到父会话的文件。
  • 派到其他环境时使用独立环境:子任务派到另一个自托管 Runner 或云端环境(见 Agent)时,子会话有自己的沙箱或 Runner 目录,看不到父会话的文件。
  • 子会话面板只读显示环境:不能在子会话中切换环境。
  • A2A 子会话不显示运行环境:远端 Agent 在它自己的环境里执行,位置不由本平台决定。

作用域

自托管环境使用共享范围和团队范围两级作用域,创建时选定,之后不能修改。可见、可编辑和可创建的规则见作用域与权限。
自动选择 Runner 或按 ID 固定 Runner 时,只会使用共享范围的 Runner,或当前成员所属团队下的团队级 Runner。

故障排查

排查 Runner 问题时,先看自托管环境列表的状态与最后心跳。
离线说明 Runner 曾连接过,但 AI SRE 在约 90 秒内没有收到心跳。请检查 systemd 服务或进程是否在运行、机器是否休眠或断网、到 AI SRE 的出网是否被防火墙阻断。恢复进程和网络后,Runner 会自动重连;重连后,此前正在进行中的 A2A 委派会接着跑(Runner 保留并重放已产出的内容),不会整轮失败或重跑。
等待中说明这个环境从未成功连接过。请确认安装命令完整执行、Token 属于这个环境、URL 从目标机器可达。如果使用了权限配置,也要确认配置文件存在且 YAML 可解析。
私有化端点的证书未被 Runner 信任。优先把签发该证书的 CA 加入 Runner 所在系统或容器的信任库;如果端点使用自签证书且位于可信私有网络内,也可以按上文说明显式开启 FLASHDUTY_RUNNER_INSECURE_SKIP_TLS_VERIFY。systemd 部署需要重启服务,Docker 部署需要用新的环境变量重新创建容器,手动运行的进程需要重新启动。
如果会话固定到了某个离线 Runner,AI SRE 不会偷偷改派到其他环境。请先恢复该 Runner,或新建会话并选择“自动”或“云端 Sandbox”。如果 Runner 在线但任务失败,多半是 Runner 到目标资源这一段的网络或权限问题。
最快的定位方法:离线 / 等待中看 Runner 到 AI SRE 的连接;在线但执行失败看 Runner 到目标资源的网络、凭据和权限。

相关页面

Sandbox

了解云端 Sandbox 的生命周期、数据位置与出网范围。

控制台对话

在会话中查看绑定的运行环境、团队与 Agent 调用的资源。

MCP(外部工具)

MCP 连接在 Agent 运行时于所选环境内建立。

Skill

Skill 在所选运行环境中执行。