§02 五分钟跑通

DeerFlow 给了 make 一条龙脚本。照做，五分钟能看到界面。

第一步：克隆与初始化

git clone https://github.com/bytedance/deer-flow.git
cd deer-flow
make setup        # 交互向导，生成 config.yaml 和 .env（约 2 分钟）

make setup 是个交互式向导。它会问你 API Key、搜索源、沙箱偏好，最后吐出两份配置：

• config.yaml —— 模型、数据库、沙箱、调度等核心配置
• .env —— 密钥类环境变量

跑完用两个命令自检：

make doctor            # 验证依赖和配置是否就绪
make support-bundle    # 排障时生成隐私安全的打包信息

第二步：用 Docker 跑（推荐）

make docker-init    # 拉取沙箱镜像
make docker-start   # 启动开发用服务栈

开发栈起来后，访问 http://localhost:2026 就能用 Web UI 了。

第三步：生产栈（可选）

make up     # 构建并启动生产服务
make down   # 停止

本地开发模式

不想碰 Docker，也可以纯本地跑：

make dev

它对机器有要求，下面这张表照着配：

标叔的结论：第一次玩，直接 make setup + make docker-init + make docker-start，别在资源配置上省。沙箱镜像不拉，后面代码执行会报错。

下一章，我们钻进「你在界面里发一句话」之后，系统内部到底走了什么路。