保姆级教程：零基础部署DeerFlow，让AI帮你自动搜索、分析、写报告
保姆级教程：零基础部署DeerFlow，让AI帮你自动搜索、分析、写报告
1. 认识DeerFlow：你的智能研究助手
DeerFlow是一款基于LangStack技术框架开发的深度研究工具，它能帮你自动完成网络搜索、数据分析、报告撰写等一系列研究工作。想象一下，你只需要提出一个问题，它就能自动搜索相关资料、分析数据、整理成结构化的报告，甚至还能生成播客内容。
这个工具特别适合以下场景：
- 需要快速了解某个新领域的研究人员
- 需要定期撰写行业分析报告的市场人员
- 需要收集大量资料的学生和学者
- 需要制作专业内容的自媒体创作者
2. 部署前的准备工作
2.1 系统要求检查
在开始部署前，请确保你的系统满足以下基本要求：
- 操作系统：Linux（推荐Ubuntu 20.04+）
- Python版本：3.12+
- Node.js版本：22+（如果需要使用Web界面）
- 内存：至少16GB（运行大模型需要较多内存）
- 存储空间：至少50GB可用空间
2.2 获取必要的API密钥
DeerFlow需要以下API密钥才能正常工作：
搜索引擎API（任选其一）：
- Tavily（推荐，每月有1000次免费额度）
- Brave Search
- DuckDuckGo
大模型API（可选）：
- 可以使用内置的Qwen3-4B-Instruct模型
- 也可以配置其他商业API（如OpenAI、阿里云等）
文本转语音API（可选）：
- 火山引擎TTS服务（用于生成播客内容）
3. 快速部署DeerFlow
3.1 检查基础服务状态
部署完成后，首先需要确认两个核心服务是否正常运行：
- 检查vllm服务状态：
cat /root/workspace/llm.log如果看到类似下图的输出，表示服务已正常启动：
- 检查DeerFlow服务状态：
cat /root/workspace/bootstrap.log正常启动的输出示例如下：
3.2 访问Web界面
DeerFlow提供了直观的Web界面，操作步骤如下：
打开Web界面： 点击WebUI按钮，系统会自动打开浏览器访问界面
开始提问： 点击界面上的提问按钮，输入你的研究问题
查看结果： 系统会自动搜索、分析并生成报告
4. 使用DeerFlow进行深度研究
4.1 基本研究流程
DeerFlow的研究工作流程分为以下几个步骤：
- 提出问题：在Web界面输入你的研究问题
- 自动规划：系统会生成一个研究计划
- 执行研究：自动进行网络搜索、数据收集和分析
- 生成报告：整理研究成果并输出结构化报告
4.2 高级功能使用
研究模式选择：
- 调查模式(Investigation Mode)：会先快速搜索网络获取背景信息
- 学术模式(Academic)：采用更严谨的学术写作风格
人工干预点： 在研究计划阶段，你可以修改系统自动生成的计划，实现"人在环路"(human-in-loop)的研究流程。
多格式输出： DeerFlow支持生成多种格式的输出：
- Markdown格式的研究报告
- PowerPoint演示文稿
- 播客音频内容（需配置TTS服务）
5. 常见问题解决
5.1 服务启动失败
如果服务没有正常启动，可以尝试以下步骤：
- 检查日志文件中的错误信息
- 确保端口没有被占用（默认使用8000和3000端口）
- 检查API密钥是否配置正确
5.2 Web界面加载问题
如果Web界面加载异常，可能是以下原因：
字体加载失败： 解决方法：下载Geist字体并放置到指定目录
mkdir -p web/public/fonts/geist cp /path/to/geist-font/*.woff2 web/public/fonts/geist/API连接问题： 检查后端服务是否正常运行，可以通过以下命令测试：
curl http://localhost:8000/health
5.3 模型API错误
如果使用内置模型时出现API错误，可能是以下原因：
- 模型服务没有正常启动
- 内存不足导致模型加载失败
- 端口冲突导致服务无法启动
解决方法：
- 检查
llm.log日志文件 - 确保系统有足够的内存资源
- 尝试重启服务
6. 总结与进阶建议
通过本教程，你已经成功部署了DeerFlow并学会了基本使用方法。这个工具可以极大提升你的研究效率，特别是在需要快速了解新领域或定期生成专业报告的场合。
进阶使用建议：
- 定制研究流程：通过修改配置文件，可以调整研究的工作流程
- 集成更多数据源：除了默认的搜索引擎，还可以添加专业数据库接入
- 优化报告模板：自定义报告的输出格式和内容结构
- 结合本地知识库：将DeerFlow与你已有的资料库结合，提升研究质量
记住，DeerFlow是一个强大的辅助工具，但它不能完全替代人类的判断和思考。最好的使用方式是把它作为你的智能助手，帮助你完成繁琐的资料收集和初步分析工作，而由你来把控研究方向和质量。
获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。