[Feature Request]: The absence of sandbox configuration and image in helm prevents the execution of code and adminServer, whereas they exist

问题场景

用户使用 Helm 部署 RAGFlow 后，尝试执行代码（code 执行）或访问 adminServer 时功能不可用；使用 Docker 环境时无此问题。

报错原文

[Feature Request]: The absence of sandbox configuration and image in helm prevents the execution of code and adminServer, whereas they exist

原因分析

可能原因：Helm Chart 的 values.yaml 和 templates/env.yaml 中缺少 sandbox 相关的环境变量（如 SANDBOX_HOST、SANDBOX_EXECUTOR_MANAGER_IMAGE、SANDBOX_BASE_PYTHON_IMAGE、SANDBOX_BASE_NODEJS_IMAGE 等），也缺少 sandbox-executor-manager 及基础镜像的部署配置。Docker Compose 中这些配置是存在的，但 Helm 版本尚未同步。

环境排查

• 确认部署方式：是使用 Helm Chart 还是 Docker Compose？
• 检查 Helm 的 values.yaml 中是否存在 sandbox 相关配置块（通常以 # Sandbox settings 注释开头）。
• 检查 templates/env.yaml 中是否注入了以上环境变量。
• 确认集群中是否有 sandbox-executor-manager 的 Pod 运行。

解决步骤

1. 若只期望快速使用沙箱功能，推荐切换至 Docker Compose 部署：参照官方文档配置 docker-compose.yml 中的 sandbox 部分，并确保已拉取 infiniflow/sandbox-executor-manager、infiniflow/sandbox-base-python、infiniflow/sandbox-base-nodejs 镜像。
2. 若必须在 Helm 中启用 sandbox，可优先尝试手动修改 Helm Chart：
   ① 在 values.yaml 中添加 sandbox 配置段，参考 Docker Compose 中的环境变量（如 SANDBOX_HOST=sandbox-executor-manager、SANDBOX_EXECUTOR_MANAGER_IMAGE=infiniflow/sandbox-executor-manager:latest 等）。
   ② 在 templates/env.yaml 中增加对应环境变量渲染逻辑。
   ③ 创建新的 Deployment 和 Service 用于 sandbox-executor-manager，挂载必要的配置（如 seccomp 策略、资源限制）。
   ④ 重新部署 Helm Release 并验证。
3. 官方尚未提供现成的 sandbox Helm Chart 补丁，在社区中出现相关 PR 前该功能属于已知限制。

验证方法

在 RAGFlow 界面中尝试执行一段代码（如 Python 脚本）并观察是否成功运行；或访问 adminServer 相关的接口是否可正常响应。同时检查 sandbox-executor-manager 容器日志确认无配置缺失错误。

参考来源

infiniflow/ragflow #12042

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。