feat: standardize DeerFlow offline deployment

This commit is contained in:
吉鑫升 committed 2026-08-27 22:06:43 +08:00
1 parent 1764d0d5f2
commit d9a94245fc
37 files changed
+3761 -2

No files matched your search

@@ -0,0 +1,66 @@
# 直接覆盖源码并重启(最简单方式)
当前部署已经把前后台代码作为宿主机目录挂载到容器。日常修改源码时不需要重新打镜像,也不需要重新加载离线镜像。
## 需要替换的目录
在 DeerFlow 部署目录中只替换以下内容:
```text
source/
├── backend/
│ ├── app/ # 替换为 offline-backend-20260512/backend/app
│ ├── packages/ # 替换为 offline-backend-20260512/backend/packages
│ └── tests/ # 替换为 offline-backend-20260512/backend/tests
├── frontend/
│ └── dist/ # 替换为 frontend-web 执行 pnpm build 后的 dist
└── wheelhouse/ # 离线 Python wheel 与 requirements.txt;日常源码替换不要删除
```
注意:后端目录名是 `tests`,不是 `test`。
## 前端怎么生成 dist
在开发或构建机器执行:
```bash
cd frontend-web
pnpm install
pnpm build
```
只把生成的 `frontend-web/dist/` 内容上传到部署目录的 `source/frontend/dist/`。服务器不需要 Node.js,也不会在启动时安装 npm 依赖。
## 替换完成后重启
进入服务器当前 DeerFlow 部署目录:
```bash
sudo ./OFFLINE_INSTALL.sh --restart
```
该脚本只执行以下操作:
1. 检查四个代码目录和前端 `index.html`;
2. 从 `deploy.env` 重新生成数据库、模型和前端运行配置;
3. 检查 `source/wheelhouse`,仅在内容变化时离线安装依赖;
4. 使用一次性容器检查后端 Python 导入;
5. 依次重建并重启后端、前端容器;
6. 等待两个服务健康。
它不会执行数据库预检,不会 `docker load`,不会构建、拉取或删除镜像,也不会修改 `config/deploy.env`、数据库业务数据、技能、智能体或知识文件。容器会重建以应用新增的挂载和环境变量,但数据库卷、用户数据卷、浏览器上下文卷和 Python 依赖卷均保留。
## 哪些修改不能这样更新
如果修改了以下内容,不能只覆盖源码:
- 后端 `pyproject.toml`、`uv.lock`、`requirements-offline.txt` 中涉及无法通过纯 Python wheel 提供的依赖;
- 系统软件、Python/Office/浏览器依赖;
- Nginx 镜像运行环境;
- Dockerfile 或容器启动命令。
这些修改涉及系统运行环境,需要重新制作基础镜像包。新增普通纯 Python/C-extension wheel 时,可按 `docs/13-wheelhouse离线新增依赖与多模型.md` 操作,无需重做镜像;单纯修改后端 `app/packages/tests` 和前端页面代码可以直接覆盖。
## 建议的安全替换方式
上传时先放到临时目录,确认完整后再改名覆盖,避免服务运行期间读到上传一半的文件。替换之前可复制一份旧目录作为备份;若新代码有问题,恢复旧目录后再次运行 `OFFLINE_INSTALL.sh --restart`。