概述
运行环境(Environment)是 AI SRE Agent 实际执行动作的地方。Agent 的每一次工具调用,包括执行命令、读写文件、运行 Skill、连接 MCP 服务,都会落在一个运行环境里。 AI SRE 提供两类运行环境:云端 Sandbox
Flashduty 托管的临时容器,零安装、开箱即用。没有可用的在线自托管 Runner 时,会话使用云端 Sandbox。
自托管 Runner
部署在您自己机器上的常驻进程(BYOC,Bring Your Own Compute)。它主动连接 AI SRE,让 Agent 在您的网络边界内执行任务。
控制台里的记录称为 环境(Environment),跑在机器上的进程称为 Runner。一个自托管环境对应一个 Runner 进程;云端 Sandbox 由系统按会话管理。
云端 Sandbox
云端 Sandbox 是 Flashduty 托管的临时执行容器。它适合快速上手、演示,以及不需要访问您内网的排查。您不需要安装任何进程,也不需要维护机器。 适合使用云端 Sandbox 的场景:- 还没有部署 Runner,想先体验 AI SRE;
- 排查只需要访问 Flashduty 数据、公网服务或公开文档;
- 一次性、轻量任务,不值得准备常驻机器;
- 希望强制隔离在托管环境中执行,而不是使用账户下已有 Runner。
云端环境模板
云端环境模板是为 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 凭据,以及是否加载本页的权限配置收敛命令范围。
创建并连接
进入 AI SRE → 自定义 → 环境 → 自托管,创建一个自托管环境。创建时需要填写:
创建成功后会弹出接入指引,包含这个环境的 Token、安装命令、升级命令和卸载命令。列表行里的钥匙按钮或 pending 状态的“查看接入指引”也会打开同一个弹窗。
安装方式
接入指引里的命令会自动填入真实TOKEN 与 URL。以下示例只展示占位符,请以控制台生成的命令为准。
- Linux (systemd)
- Docker
- 手动 / macOS
在目标机器上以 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、且端点位于可信私有网络内时,才关闭校验。- Linux (systemd)
- Docker
- 手动 / macOS
编辑 重启 Runner,让新的环境变量生效:
/etc/flashduty-runner/env,写入私有化端点和 TLS 配置: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 服务以该用户运行,也会相应放宽该用户主目录的保护策略。
Token、升级和卸载
Token 是 Runner 连接 AI SRE 的唯一凭据。它会写入安装命令或环境变量中,请只在安装、升级或排查连接时查看,不要发给无关人员。若怀疑泄露,请删除对应环境后重新创建。 Runner 启动后会持续发送心跳。列表状态含义如下:性能下降 会自动出现和消失,无需手动清除。Runner 的任务积压或任务连续超时时出现,积压消除、任务恢复正常后回到 在线。
发现新版本时,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 模型、信任模型的判断是同一套信任模型:--permission-config 参数或 FLASHDUTY_RUNNER_PERMISSION_CONFIG 环境变量指定它。权限配置是 Runner 本机文件,不在控制台表单里编辑。
Linux (systemd) 安装后,推荐在 /etc/flashduty-runner/env 中加入:
permission,值是 glob 模式 → allow/deny 的映射:
- 不设置
--permission-config/FLASHDUTY_RUNNER_PERMISSION_CONFIG是默认行为,等价于允许所有命令; - 规则会应用到命令的每一处出现——管道(
cmd1 | cmd2)、$(...)/反引号命令替换、进程替换、算术展开,以及写入重定向目标(例如echo x > /etc/passwd会像执行命令一样被拦截;读重定向本身不会额外拦截); - 命令按规范化后的 shell 片段匹配,空格差异不会影响匹配;
- 最具体的规则优先:第一个
*之前字面前缀最长的模式最先被尝试匹配,兜底规则"*"始终最后尝试,第一个匹配的规则生效; - 该文件仅在 Runner 启动时加载一次——修改规则后需要重启 Runner,新规则才会生效,不支持热重载;
- 若指定了该 flag/环境变量,但文件缺失、格式错误,或未在
permission键下定义任何规则,Runner 会拒绝启动(fail closed),而不是静默放行所有命令:显式配置权限即代表明确希望限制执行范围,配置写错时应当报错而非留下安全隐患。
严格模式(推荐用于共享环境)
严格模式(推荐用于共享环境)
默认拒绝所有命令,仅显式放行需要的命令:
信任模式(用于专属/隔离环境)
信任模式(用于专属/隔离环境)
等价于完全不设置 适用于 Runner 运行在隔离 VM/容器、影响范围有限,或更看重响应速度而非限制权限的场景。
--permission-config,但允许显式声明例外:只读模式(仅用于监控)
只读模式(仅用于监控)
只放行只读命令,适合仅用于观测、不希望 Runner 修改任何状态的场景:
文件访问边界
权限配置约束的是命令;Agent 的文件读写工具另有独立的路径语义,与bash 的行为保持一致:
- 相对路径:限制在 workspace 根目录内,并带符号链接逃逸保护——通过相对路径只能读写 workspace 内的文件。
- 绝对路径:按设计直接落到宿主机文件系统,与
bash一致。
在会话中选择环境
聊天输入框底部的环境选择器决定新会话在哪里执行:
打开历史会话时,选择器只读显示该会话的环境及其状态。如果绑定的 Runner 已离线或被删除,该会话不能继续发送消息;请先恢复 Runner,或新建会话。
子会话的执行环境
派发出去的子代理会带出一条自己的子会话,它的执行环境规则与根会话不同:- 默认与父会话共用环境:子会话与父会话共用同一个沙箱 / workspace,可以直接看到父会话的文件。
- 派到其他环境时使用独立环境:子任务派到另一个自托管 Runner 或云端环境(见 Agent)时,子会话有自己的沙箱或 Runner 目录,看不到父会话的文件。
- 子会话面板只读显示环境:不能在子会话中切换环境。
- A2A 子会话不显示运行环境:远端 Agent 在它自己的环境里执行,位置不由本平台决定。
作用域
自托管环境使用共享范围和团队范围两级作用域,创建时选定,之后不能修改。可见、可编辑和可创建的规则见作用域与权限。自动选择 Runner 或按 ID 固定 Runner 时,只会使用共享范围的 Runner,或当前成员所属团队下的团队级 Runner。
故障排查
排查 Runner 问题时,先看自托管环境列表的状态与最后心跳。Runner 显示离线
Runner 显示离线
离线说明 Runner 曾连接过,但 AI SRE 在约 90 秒内没有收到心跳。请检查 systemd 服务或进程是否在运行、机器是否休眠或断网、到 AI SRE 的出网是否被防火墙阻断。恢复进程和网络后,Runner 会自动重连;重连后,此前正在进行中的 A2A 委派会接着跑(Runner 保留并重放已产出的内容),不会整轮失败或重跑。
Runner 一直等待首次连接
Runner 一直等待首次连接
等待中说明这个环境从未成功连接过。请确认安装命令完整执行、Token 属于这个环境、
URL 从目标机器可达。如果使用了权限配置,也要确认配置文件存在且 YAML 可解析。会话提示连接超时或无响应
会话提示连接超时或无响应
如果会话固定到了某个离线 Runner,AI SRE 不会偷偷改派到其他环境。请先恢复该 Runner,或新建会话并选择“自动”或“云端 Sandbox”。如果 Runner 在线但任务失败,多半是 Runner 到目标资源这一段的网络或权限问题。
相关页面
Sandbox
了解云端 Sandbox 的生命周期、数据位置与出网范围。
控制台对话
在会话中查看绑定的运行环境、团队与 Agent 调用的资源。
MCP(外部工具)
MCP 连接在 Agent 运行时于所选环境内建立。
Skill
Skill 在所选运行环境中执行。