v4.14.5
labring/FastGPTv4.14.5Jan 9, 2026by c121914yu
AI Summary
Introduces multi-cloud storage support (MinIO, OSS, COS), workflow UI improvements, and MongoDB upgrade.
Key Highlights
- Support for MinIO, OSS, and COS storage backends
- Workflow canvas presentation mode and style optimizations
- Upgrade MongoDB to 5.0.32 to resolve CVE-2025-14847
Breaking Changes
- Storage environment variable migration (S3_* to STORAGE_*)
- Field renames: showNodeStatus -> showRunningStatus, responseDetail -> showCite
New Features
- Multi-cloud storage support
- Workflow presentation mode
- Chat log soft delete
- Email configuration with security mode and port support
Full Release Notes
## 更新指南
### 1. 修改存储桶环境变量
该版本除了支持 minio 以外,还增加支持了原生 OSS 和 COS, 所以需要修改相关环境变量修改成新的命名。
**新增变量**
```
STORAGE_VENDOR=minio
STORAGE_REGION=us-east-1
STORAGE_ACCESS_KEY_ID=minioadmin
STORAGE_SECRET_ACCESS_KEY=minioadmin
STORAGE_PUBLIC_BUCKET=fastgpt-public
STORAGE_PRIVATE_BUCKET=fastgpt-private
STORAGE_EXTERNAL_ENDPOINT=http://192.168.0.2:9000 # 一个服务器和客户端均可访问到存储桶的地址,可以是固定的宿主机 IP 或者域名,注意不要填写成 127.0.0.1 或者 localhost 等本地回环地址(因为容器里无法使用)
STORAGE_S3_ENDPOINT=http://fastgpt-minio:9000 # 协议://域名(IP):端口
```
**移除旧的变量**
* S3_EXTERNAL_BASE_URL
* S3_ENDPOINT
* S3_PORT
* S3_USE_SSL
* S3_ACCESS_KEY
* S3_SECRET_KEY
* S3_PUBLIC_BUCKET
* S3_PRIVATE_BUCKET
### 2. 更新镜像:
- 更新 FastGPT 镜像tag: v4.14.5
- 更新 FastGPT 商业版镜像tag: v4.14.5
- 更新 fastgpt-plugin 镜像 tag: v0.4.0
- mcp_server 无需更新
- Sandbox 无需更新
- AIProxy 无需更新
### 3. 执行升级脚本
从任意终端,发起 1 个 HTTP 请求。其中 `{{rootkey}}` 替换成环境变量里的 `rootkey`;`{{host}}` 替换成**FastGPT 域名**。
```bash
curl --location --request POST 'https://{{host}}/api/admin/initv4145' \
--header 'rootkey: {{rootkey}}' \
--header 'Content-Type: application/json'
```
1. 重试所有失败的 S3 删除任务
2. 为所有 share 类型的 OutLink 记录添加 showFullText 字段
3. 重命名字段:
- showNodeStatus -> showRunningStatus
- responseDetail -> showCite
- showRawSource -> canDownloadSource
## 🚀 新增内容
1. 工作流画布增加演示模式,同时优化折叠模式样式,优化工作流线重叠问题。 @newfish-cmyk
2. 工作流增加嵌套应用快速跳转按钮。 @c121914yu
3. 工作流导出支持选择过滤/不过滤敏感信息。 @xqvvu
4. 对话记录使用侧改成软删除,增加从日志管理里删除对话记录。 @newfish-cmyk
5. 更新Agent/工具时,会更新其上层所有目录的更新时间,以便其会排在列表前面。 @newfish-cmyk
6. 门户页支持配置单个应用运行可见度。 @newfish-cmyk
7. 导出单个知识库集合分块接口。 @xqvvu
8. 升级 Mongo5.x 至 5.0.32 解决CVE-2025-14847。 @c121914yu
9. 邮箱配置,支持配置安全模式以及端口号。 @FinleyGe
## ⚙️ 优化
1. 优化获取 redis 所有 key 的逻辑,避免大量获取时导致阻塞。 @c121914yu
2. MongoDB, Redis 和 MQ 的重连逻辑优化。 @c121914yu
3. 变量输入框禁用状态可复制。 @c121914yu
4. LLM 请求空响应判断,排除敏感过滤错误被误认为无响应。 @c121914yu
5. 完善 AI 对话和工具调用的错误提示,提供更多原始数据。 @c121914yu
6. 增大文件解析接口的请求大小限制为 10MB。 @c121914yu
7. 对话回复下方的引用列表,仅显示 AI 实际引用的知识库内容。 @newfish-cmyk
8. 更新 MCP SDK 版本。 @c121914yu
9. Chats 表索引,减少冗余,增加条件索引。 @c121914yu
## 🐛 修复
1. 重要 - 工作流并行合并后,可能导致重复运行问题。 @c121914yu
2. MCP 工具创建时,使用自定义鉴权头会报错。 @newfish-cmyk
3. 获取对话日志列表时,如果用户头像为空,会抛错。 @c121914yu
4. chatAgent 未开启问题优化时,前端 UI 显示开启。 @c121914yu
5. 加载默认模型时,maxTokens 字段未赋值,导致模型最大响应值配置为空。 @c121914yu
6. S3 文件清理队列因网络稳定问题出现阻塞,导致删除任务不再执行。 @c121914yu
7. 对话日志接口适配 mongo4.x 语法。 @c121914yu
8. 变量更新节点将文件 URL 字符串数组错误转换为对象数组。 @newfish-cmyk
9. 多个表单输入节点共享 sessionStorage 导致默认值不显示。@newfish-cmyk
10. 代码运行节点切换语言后,AI 仍使用旧语言生成代码。@newfish-cmyk
11. 多个自定义反馈节点并发写入触发数据库写入冲突。@newfish-cmyk
12. 交互节点后续的自定义反馈节点写入失败。@newfish-cmyk
## What's Changed
* deploy doc by @c121914yu in https://github.com/labring/FastGPT/pull/6100
* fix mcp header by @newfish-cmyk in https://github.com/labring/FastGPT/pull/6105
* support add pay form url env by @newfish-cmyk in https://github.com/labring/FastGPT/pull/6086
* perf log by @c121914yu in https://github.com/labring/FastGPT/pull/6107
* chat log soft delete by @newfish-cmyk in https://github.com/labring/FastGPT/pull/6110
* perf: Get redis kes function by @c121914yu in https://github.com/labring/FastGPT/pull/6112
* add mineru_saas_api for fastgpt by @fangqiluxatu in https://github.com/labring/FastGPT/pull/5923
* perf: redis del;perf: cron app run by @c121914yu in https://github.com/labring/FastGPT/pull/6113
* limit custom param description width in http tools by @newfish-cmyk in https://github.com/labring/FastGPT/pull/6116
* perf: redis del by @c121914yu in https://github.com/labring/FastGPT/pull/6115
* fix: create time by @c121914yu in https://github.com/labring/FastGPT/pull/6117
* add savechat test by @c121914yu in https://github.com/labring/FastGPT/pull/6118
* image compatibility for various content-types by @newfish-cmyk in https://github.com/labring/FastGPT/pull/6119
* fix: openapi by @c121914yu in https://github.com/labring/FastGPT/pull/6121
* rename log by @c121914yu in https://github.com/labring/FastGPT/pull/6124
* limit custom param name width in http tools by @newfish-cmyk in https://github.com/labring/FastGPT/pull/6125
* app delete queue by @newfish-cmyk in https://github.com/labring/FastGPT/pull/6122
* perf: index by @c121914yu in https://github.com/labring/FastGPT/pull/6131
* perf: remove dataset code by @c121914yu in https://github.com/labring/FastGPT/pull/6132
* fix: s3 del worker while by @c121914yu in https://github.com/labring/FastGPT/pull/6133
* fix: ticktime by @c121914yu in https://github.com/labring/FastGPT/pull/6134
* optimize app update time by @newfish-cmyk in https://github.com/labring/FastGPT/pull/6127
* Fix: action by @c121914yu in https://github.com/labring/FastGPT/pull/6146
* add plan activity config by @newfish-cmyk in https://github.com/labring/FastGPT/pull/6139
* fix cite visibility by @newfish-cmyk in https://github.com/labring/FastGPT/pull/6153
* feat: hehe pdf api by @YYH211 in https://github.com/labring/FastGPT/pull/6149
* Visibillty playground by @c121914yu in https://github.com/labring/FastGPT/pull/6152
* fix: filename with whitespace will cause regex unmatched by @xqvvu in https://github.com/labring/FastGPT/pull/6154
* fix: santinize the upload filename by @xqvvu in https://github.com/labring/FastGPT/pull/6159
* feat: add user ip filter for chat log table by @xqvvu in https://github.com/labring/FastGPT/pull/6162
* feat: export all chunks in collection by @xqvvu in https://github.com/labring/FastGPT/pull/6163
* fix:agent eval and doc file by @YYH211 in https://github.com/labring/FastGPT/pull/6158
* upgrade: MongoDB 5.0.18 to 5.0.32 by @FinleyGe in https://github.com/labring/FastGPT/pull/6148
* perf: vector db log;perf: s3 mock by @c121914yu in https://github.com/labring/FastGPT/pull/6165
* feat: workflow presentation ui by @newfish-cmyk in https://github.com/labring/FastGPT/pull/6156
* fix: workflow fixview padding & context menu position by @newfish-cmyk in https://github.com/labring/FastGPT/pull/6169
* fix: vector ts by @c121914yu in https://github.com/labring/FastGPT/pull/6166
* Update 4141.mdx by @c121914yu in https://github.com/labring/FastGPT/pull/6175
* fix app detail bg by @newfish-cmyk in https://github.com/labring/FastGPT/pull/6172
* fix fold node connection handle by @newfish-cmyk in https://github.com/labring/FastGPT/pull/6178
* fix: workflow batch repeat run by @c121914yu in https://github.com/labring/FastGPT/pull/6186
* fix: surrender;perf: llm response by @c121914yu in https://github.com/labring/FastGPT/pull/6190
* Clarify image version consistency in SSO guide by @Deepturn in https://github.com/labring/FastGPT/pull/6189
* perf: request llm by @c121914yu in https://github.com/labring/FastGPT/pull/6191
* feat:add openapi download link in document by @whxxxxxxxxxx in https://github.com/labring/FastGPT/pull/6192
* feat: pg half vector by @c121914yu in https://github.com/labring/FastGPT/pull/6201
* chore(deps): bump @modelcontextprotocol/sdk from 1.24.0 to 1.25.2 by @dependabot[bot] in https://github.com/labring/FastGPT/pull/6212
* chore(deps): bump next from 14.2.33 to 14.2.35 by @dependabot[bot] in https://github.com/labring/FastGPT/pull/6214
* chat item soft delete by @newfish-cmyk in https://github.com/labring/FastGPT/pull/6216
* feat: select wheather filter sensitive info when export apps by @xqvvu in https://github.com/labring/FastGPT/pull/6222
* fix some bugs by @newfish-cmyk in https://github.com/labring/FastGPT/pull/6210
* fix file default local upload by @newfish-cmyk in https://github.com/labring/FastGPT/pull/6223
* docs: improve object storage introduction by @xqvvu in https://github.com/labring/FastGPT/pull/6224
## New Contributors
* @whxxxxxxxxxx made their first contribution in https://github.com/labring/FastGPT/pull/6192
**Full Changelog**: https://github.com/labring/FastGPT/compare/v4.14.4...v4.14.5