前言
Dify 最新稳定版本 v1.16.1 已经正式推送，本次版本定位为Bug修复+安全增强版本，同时配套上线多项实用新功能、性能优化，重点强化Agent沙箱安全边界、内部服务通信安全，修复大量工作流协同、RAG知识库、Agent应用、前端UI、后端API存在的问题。 本次更新包含新增功能、全域Bug修复、多项关键性安全加固、接口性能优化、环境变量调整、数据库迁移脚本、Docker Compose配置变更。对于私有化部署、企业生产环境的实例，强烈建议规划升级，尤其是安全相关修复涉及代码执行沙箱、模板注入、服务内部认证等高危场景。
本文完整梳理Dify 1.16.1全部变更内容，覆盖新增功能、Bug修复清单、安全增强、性能优化、环境变量变动、数据库迁移方案、详细升级步骤，所有内容均来自官方更新日志，方便运维、开发人员快速评估升级收益与风险。
一、新增功能 New Features
1. 工具多选输入（Tool Multi-Select Input）
工作流工具节点现在支持下拉多选输入能力。用户在配置工具参数时，可以从预定义列表中选择多个值。该能力丰富了工作流工具参数传递场景，不再局限单一参数选择，拓展工具节点的数据交互能力。
2. 工作流节点定位器（Workflow Node Locator）
新增工作流节点快速定位功能。用户可以直接点击工作流运行日志、报错信息中的节点ID，编辑器画布会自动定位并高亮对应的节点。当工作流链路复杂、节点数量庞大时，可以极大降低排查报错的成本，快速找到异常节点。
3. 工作流组件选择器优化（Workflow Block Selector Improvements）
工作流添加节点时使用的组件选择面板迎来全面优化：完善键盘导航操作、增加分类预览视图，同时优化搜索交互逻辑，整体使用体验更加直观。对于高频搭建复杂工作流的用户，能够有效提升编排效率。
4. 侧边栏导出Agent DSL配置
Agent应用支持直接在应用侧边菜单导出DSL YAML文件。方便开发者对Agent配置进行本地备份、代码仓库版本管理，支持跨环境导入迁移Agent应用配置，实现配置IaC管理。
5. 知识库追踪（Knowledge Tracing）
为知识库/RAG文档处理链路新增更多可观测追踪信息，提升索引流水线运行状态的可见度。运维人员可以更清晰观测文档加载、文本分割、向量化入库全流程，便于定位知识库处理阶段各类异常。
二、Bug修复汇总
按照模块划分，本次修复覆盖工作流&协同、RAG知识库、Agent应用、Web前端UI、API后端五大模块数十项问题。
2.1 工作流 & 多人协同模块
修复标签处于非激活状态时，协同会话负责人保存过期草稿的问题；
修复协同连接始终失败时，未保存的编辑内容直接丢失的问题；
网络重连后，系统保留最新的协同会话，避免会话信息丢失；
修复严格模式初始化阶段产生虚假草稿保存错误提示；
工作流草稿保存失败时，展示常驻错误通知，不再无提示静默失败；
Celery任务完成前，等待工作流工作线程正常退出，杜绝孤立执行任务；
延迟加载Loro协同运行时，减小前端初始资源包体积，优化页面加载速度；
注释模式下点击节点，不会自动打开节点配置面板，避免干扰注释操作；
解决解析其他注释时，当前激活的注释面板被意外关闭的问题。
2.2 RAG & 知识库模块
文档清洗器错误剔除合法字符问题修复，不再删除 ï、¿、¾ 这类特殊字符；
递归文本分割逻辑优化，保留原始文本中的空格，防止文本分片后格式错乱；
数据集服务调整，使用flush()替代commit()，保留调用方事务边界，避免事务提前提交引发的数据一致性问题；
外部知识库连通性探测请求携带合法请求体，解决外部知识库校验失败问题。
2.3 Agent应用模块
Agent预览会话隔离：新建预览对话不会复用旧会话ID，避免会话状态互相干扰；
修复对话历史更新时，Agent聊天输入框内容被意外覆盖的问题；
Agent运行日志完整保留模型用量计费相关数据；
Agent执行日志展示内部工作流节点运行记录；
Agent监控统计数据纳入工作流运行信息；
禁止未发布的Agent在工作流中被调用；
修复Agent预览操作界面内容被截断的界面问题；
构建重置操作不会清空预览对话历史；
修复Agent构建草稿应用配置时界面闪烁问题。
2.4 Web应用 & 前端UI
修复Web应用JWT过期时间配置错误问题；
解决Safari、Firefox浏览器下TTS语音播放失效问题；
嵌入模式应用中剪贴板写入功能异常修复；
文本生成Web应用超时后无限加载状态问题修复；
模型不支持视觉能力时，聊天对话不会错误传递文档图片数据；
窄容器场景下，分片长度、重叠度输入框宽度异常收缩无法使用的问题修复；
修复搜索快捷键前端注水状态不匹配引发功能异常；
DSL导入导出弹窗交互状态优化；
登录刷新跳转时basePath路径重复拼接问题修复；
已禁用Web应用展示不可用状态提示；
权限选择器语义逻辑修正；
定制页面横向溢出布局问题修复。
2.5 API & 后端服务
MCP工具output_schema参数逻辑修复：该参数为可选参数，修复后端强制判定必填的问题；
变量截断器针对文件数组类型，正确遵守数组元素上限与字节预算限制；
解决身份日志记录死锁问题；
插件远程安装端口配置校验，拦截host:port格式非法值，并给出清晰提示；
分页结果集处理优化：空数据集pages返回值修正为0，原先错误返回1；
草稿变量文件使用资源租户信息；
人工介入快照消息查询做范围限定，充分利用数据库索引提升查询性能；
语音转文字接口缺少文件字段时返回400错误，不再返回500服务异常；
工具执行过程中tool_meta缺失工具提供者类型问题修复；
企业版内部API请求会应用系统配置的超时参数；
自动升级策略缺失时，正常返回禁用状态的自动升级配置；
强制校验工具提供者类型契约；
WaterCrawl网站爬虫处理非JSON格式错误响应；
租户默认模型存在Schema错误时，无法创建聊天应用问题修复。
三、安全增强 Security Enhancements（生产环境重点关注）
本版本是安全重点更新版本，多项修复针对潜在攻击面，私有化部署务必升级。
Agent本地沙箱新增独立Squid正向代理，并配置严格ACL访问控制策略。沙箱无法直连内部服务，仅允许访问API /files/ 接口与agent_backend /agent-stub/ 接口，两个接口均依靠短期有效令牌保护。极大缩小Agent沙箱内任意代码执行带来的攻击影响范围。
Dify API与Agent后端之间通信启用令牌鉴权，依靠环境变量DIFY_AGENT_API_TOKEN、AGENT_BACKEND_API_TOKEN实现内部服务边界加固，杜绝裸通信风险。
Jinja2模板渲染切换为SandboxedEnvironment沙箱环境，防护工作流代码节点中存在的模板注入攻击风险。
修复React Server Components存在的DoS拒绝服务漏洞。
邮箱验证器使用完整正则匹配，拒绝尾部换行符，规避校验逻辑绕过攻击。
接收工作空间邀请前，先校验账户状态，拦截异常账户邀请流程。
四、性能优化 Performance
轻量化最近应用接口：新增接口 GET /console/api/apps/recent，优化首页「继续工作」板块加载性能。延迟降低约69%，速度提升3.2倍；SQL查询从19条以上精简为单条投影查询；接口响应体积缩减约50%。
首页创建弹窗延迟加载：创建弹窗代码在用户交互之后才加载，减少页面初始化JavaScript资源体积，提升首屏加载速度。
五、体验优化 Improvements
Agent编辑器保存与发布状态逻辑统一，状态展示更加清晰；
Dify Logo主题配置逻辑简化；
工作流组件选择器UI界面优化；
网页无障碍访问语义优化；
工作流预览模式下，节点禁止拖拽，防止预览时误编辑；
集成工具详情面板展示非LLM相关配置项；
六、环境变量变更 Environment Variable Changes
新增环境变量
变量名称默认值说明
| DIFY_AGENT_API_TOKEN |
dify-agent-run-token-for-dev-only |
API访问agent_backend的共享Bearer令牌。生产环境必须修改默认值。 |
| AGENT_BACKEND_API_TOKEN |
dify-agent-run-token-for-dev-only |
Agent后端侧鉴权令牌，必须和DIFY_AGENT_API_TOKEN保持一致。 |
| PLUGIN_MODEL_PROVIDERS_CACHE_ENABLED |
true |
若插件采用外部安装方式，缓存无法主动失效，可设置为false关闭缓存。 |
重要注意事项
DIFY_AGENT_API_TOKEN为本次版本新增必需环境变量，用于Dify API与Agent后端安全通信。默认值仅用于开发环境，存在安全风险，所有生产实例必须重新生成密钥。 生成密钥命令：
python –c 'import secrets; print(secrets.token_urlsafe(32))'
生成后，将相同字符串同时配置到DIFY_AGENT_API_TOKEN、AGENT_BACKEND_API_TOKEN两个环境变量。
七、Docker Compose 配置变更
Agent沙箱网络隔离调整：local_sandbox从默认网络迁移至独立网络agent_sandbox_network、local_sandbox_proxy_network；新增agent_ssrf_proxy代理服务（Squid）；
Bearer鉴权令牌环境变量同步注入api、worker、agent_backend服务；
所有镜像标签更新为1.16.1。
八、数据库迁移说明
本次版本包含4条新增迁移脚本，全部为增量变更（新增数据表、字段、索引），支持不停机执行迁移，升级启动时自动执行。
为workflow_run_archive_bundles表增加索引，PostgreSQL环境支持并发创建索引；
创建account_step_by_step_tour_states数据表；
agent_debug_conversations表新增draft_type字段，并更新唯一约束；
dify_setups数据表新增遥测相关字段：instance_id、install_reported_at、last_heartbeat_at。
九、完整升级指南
方式一：Docker Compose部署（官方推荐）
cd docker
docker compose down
git pull origin main
docker compose pull
docker compose up -d
数据库迁移会在服务启动过程自动执行。 升级前置操作：务必修改.env文件内新增的两个鉴权Token，替换默认不安全密钥。
方式二：源代码部署
git pull origin main
cd api
flask db upgrade
启动前配置好新增环境变量。
十、升级风险与适配建议
安全优先级最高：私有化部署、对外开放访问、启用Agent代码沙箱、工作流代码节点的实例优先升级；模板注入、沙箱SSRF防护都在本次版本落地；
环境变量必须处理：忘记配置DIFY_AGENT_API_TOKEN会导致API与Agent后端通信失败，Agent相关功能无法正常运行；
Docker用户需要重启拉取最新镜像，并且compose配置文件同步更新，新增代理服务与网络配置；
数据库迁移为增量操作，无需担心数据丢失，建议升级前常规备份数据库；
若外部托管插件，需要评估是否需要配置PLUGIN_MODEL_PROVIDERS_CACHE_ENABLED=false关闭插件模型提供商缓存；
结语
代码地址：github.com/langgenius/dify
Dify v1.16.1 并不是单纯的小版本修复，大量底层安全机制重构值得重视。Agent沙箱网络隔离、内部服务Token认证、Jinja沙箱模板防护，全方位加固LLM应用平台的安全边界。同时工作流编排、RAG知识库、Agent开发体验持续优化，多项前端性能优化降低大实例部署的资源压力。 对于企业私有化部署场景，建议完成环境变量密钥更换、数据库备份后择期升级；社区开发者可以提前测试新版本，验证现有工作流、Agent应用、知识库流程兼容性。后续版本会持续围绕安全、可观测性、工作流能力迭代。
网硕互联帮助中心
评论前必须登录！
注册