智能体通过Web App方式运行，输出结果里看不到文件下载的输出内容。

问题场景

用户在 Dify 1.13.0（Self Hosted，Docker 部署）中打造了工作流智能体，在“输出”节点定义了文本及三个文件下载。在设计界面的测试环境运行时，输出结果可以正常下载文件；但改用 “Web App” 方式运行后，输出结果里看不到文件下载的输出内容。

报错原文

智能体通过Web App方式运行，输出结果里看不到文件下载的输出内容。

原因分析

Issue 讨论中把原因归为两个可能方向：

• 环境变量配置问题（最常见）：Docker 部署时，INTERNAL_FILES_URL 环境变量优先于 FILES_URL。如果 INTERNAL_FILES_URL 被设置为内部 Docker 地址（例如 http://api:5001），浏览器将无法访问这些 URL，于是 Web App 中就无法展示下载内容。
• Agent 节点序列化问题：如果使用 Agent 节点调用工具生成文件，文件可能无法正确传递到输出。该问题在 Issue #32812 的评论中被提及，并正在 #32665 中跟踪修复。

讨论中还解释了为什么“设计模式可以而 Web App 不行”：设计模式的测试环境可以直接访问内部服务，而 Web App 模式需要浏览器能够访问外部可用的 URL。因此内部地址在浏览器侧不可达时，文件下载就不会显示。

环境排查

• 确认 Dify 版本为 1.13.0。
• 确认部署方式为 Self Hosted（Docker）。
• 检查 .env 中 INTERNAL_FILES_URL 是否被设置为内部 Docker 地址（如 http://api:5001）。
• 检查 .env 中 FILES_URL 是否设置为主机可被浏览器访问的局域网 IP（不是 localhost）。
• 检查 docker-compose.yml 是否包含端口映射 ports: - "5001:5001"。
• 如果文件由 Agent 节点调用工具生成，确认 langgenius/agent 插件是否为较新版本。

解决步骤

1. 编辑 .env 文件，取消或留空 INTERNAL_FILES_URL。
2. 将 FILES_URL 设置为主机的局域网 IP（不是 localhost），例如 FILES_URL=http://192.168.x.x:5001。请替换为实际部署机器的 IP。
3. 在 docker-compose.yml 中为对应服务添加端口映射 ports: - "5001:5001"。
4. 重启服务：docker-compose down && docker-compose up -d。
5. 如果使用的是 Agent 节点调用工具生成文件，可优先尝试升级到最新的 langgenius/agent 插件，作为临时解决方法。

验证方法

修改配置并重启后，通过 Web App 方式重新运行该工作流智能体，确认输出结果中能够显示并下载这些文件。如果仍然看不到，请转向排查 Agent 节点文件传递相关问题（对应 Issue #32665）。

参考来源

langgenius/dify #32986

相关链接：Why can’t files be downloaded after the update?、dify #32812 评论、dify #32665。

AI 工具推荐

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

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

了解 GamsGo AI

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