v4.14.10
labring/FastGPTv4.14.10Mar 31, 2026by c121914yu
AI Summary
A major update introducing OpenSandbox Docker deployment support with volume persistence, new WeChat personal channel, and Feishu streaming output. Includes significant workflow performance optimizations and security fixes.
Key Highlights
- Add OpenSandbox docker deployment with volume persistence support
- Add WeChat personal channel publishing
- Add Feishu streaming output support
- Optimize workflow runtime performance
Breaking Changes
- Rename sandbox service image from 'fastgpt-sandbox' to 'fastgpt-code-sandbox'
- Update FastGPT image tags to v4.14.10
- Update code-sandbox image tag to v4.14.10
- Required configuration changes for docker-compose (adding opensandbox services, updating environment variables)
New Features
- Add sandbox readfile tool
- Add directory max limit configuration via env variable
- Add LLM gradient metering billing mode
- Add SSRF defense for HTTP tools
- Optimize workflow runtime complexity
Full Release Notes
## 升级指南 ### 1. 增加 agent-sandbox 相关配置 以下针对的是 `docker compose` 部署方案的配置调整,使用`sealos`的商业版用户,可私信支持人员,提供在线的沙盒服务方案。 打开[最新 yml 部署文件](https://github.com/labring/FastGPT/blob/main/deploy/docker/cn/docker-compose.pg.yml),调整以下内容: 1. 在文件顶部增加 `x-volume-manager-auth-token: &x-volume-manager-auth-token 'vmtoken'` 变量配置。 2. 增加 3 组 services: `opensandbox-server`,`volume-manager`,`agent-sandbox-image` 3. 增加 `configs`, 文件底部可找到该内容,直接复制添加。 4. 修改 `fastgpt` 环境变量, 增加以下变量: ```bash # ==================== Agent sandbox 配置 ==================== AGENT_SANDBOX_PROVIDER: opensandbox # OpenSandbox 配置(PROVIDER: opensandbox 时生效) AGENT_SANDBOX_OPENSANDBOX_BASEURL: http://opensandbox-server:8090 AGENT_SANDBOX_OPENSANDBOX_API_KEY: AGENT_SANDBOX_OPENSANDBOX_RUNTIME: docker AGENT_SANDBOX_OPENSANDBOX_IMAGE_REPO: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-agent-sandbox AGENT_SANDBOX_OPENSANDBOX_IMAGE_TAG: v0.0.2 # Volume 持久化配置(opensandbox provider 下可选) AGENT_SANDBOX_ENABLE_VOLUME: true AGENT_SANDBOX_VOLUME_MANAGER_URL: http://volume-manager:3000 AGENT_SANDBOX_VOLUME_MANAGER_TOKEN: *x-volume-manager-auth-token ``` ### 2. 修改 sandbox 镜像名 原先的 `sandbox` 服务的镜像名,需要从`fastgpt-sandbox`改成`fastgpt-code-sandbox`。 目的是为了区分 agent-sandbox 和 code-sandbox。 ### 3. 更新镜像 tag - 更新 FastGPT 镜像 tag: v4.14.10 - 更新 FastGPT 商业版镜像 tag: v4.14.10 - 更新 code-sandbox 镜像 tag: v4.14.10 - 更新 fastgpt-plugin 镜像 tag: v0.5.6 更新完后即可重启服务。 ### 4. 更新系统工具,刷新头像 系统工具部分头像,移除了 icon,都转用图片链接,所以会丢失一部分工具的头像。可以重新更新一次系统工具(卸载再安装,或者直接导入 pkg 覆盖)。 ## 🚀 新增内容 1. 增加 OpenSandbox docker 部署方案及适配,并支持通过挂载 volume 进行数据持久化。 @ctlaltlaltc @chanzhi82020 @c121914yu 2. 新增沙盒读取文件链接工具,可以直接让 AI 返回文件的访问链接。 @c121914yu 3. 新增微信个人号发布渠道 @c121914yu 4. 飞书发布渠道,支持流输出。 @c121914yu 5. 目录最大上限,可通过环境变量配置。 @gaga0714 6. rerank 模型上限配置,避免超出单条 document 上限导致 rerank 失败。 @YYH211 7. 增加 LLM 梯度计量计费模式,同时统一计费推送方式。 @xqvvu ## ⚙️ 优化 1. 工作流 runtime,减少计算复杂。 @c121914yu 2. 增加一些对于大变量的计算限制,避免计算复杂度过高导致线程阻塞。 @c121914yu 3. 移除模型配置里“用于知识库文件处理”、“用于问题分类”等配置,统一增加“测试模型“标志。测试模型会有特殊标识,并且仅可在 ai chat 中使用,其余场景将会过滤。 @xqvvu ## 🐛 修复 1. 子工作流的全局变量默认值未生效。 2. agent 模式下已配的 rerank 模型不显示。 3. bge-m3 embedding 向量模型输出都为 0 的问题。 4. MCP 并发调用时,连接异常导致调用失败。 5. 修复登录接口安全问题 6. 修复 MCP SSRF 安全问题 7. 修复工作流工具错误未成功捕获问题 8. 修复子工作流全局变量默认值未生效 ## What's Changed * Opensandbox by @c121914yu in https://github.com/labring/FastGPT/pull/6657 * fix: action by @c121914yu in https://github.com/labring/FastGPT/pull/6659 * fix: auth code secret by @c121914yu in https://github.com/labring/FastGPT/pull/6662 * perf: add process memory metrics by @xqvvu in https://github.com/labring/FastGPT/pull/6656 * perf: runtime performance by @c121914yu in https://github.com/labring/FastGPT/pull/6665 * V4.14.10 dev by @c121914yu in https://github.com/labring/FastGPT/pull/6674 * feat: sandbox readfile tool by @c121914yu in https://github.com/labring/FastGPT/pull/6679 * fix: deal with undefined valueType by @gaga0714 in https://github.com/labring/FastGPT/pull/6684 * fix: fix left-aligned list marker styling in chat welcome guide by @TheOne-Xin in https://github.com/labring/FastGPT/pull/6681 * fix: mcp toolcall by @c121914yu in https://github.com/labring/FastGPT/pull/6683 * version by @c121914yu in https://github.com/labring/FastGPT/pull/6685 ## New Contributors * @TheOne-Xin made their first contribution in https://github.com/labring/FastGPT/pull/6681 **Full Changelog**: https://github.com/labring/FastGPT/compare/v4.14.9.5...v4.14.10