2.8 KiB
2.8 KiB
直接覆盖源码并重启(最简单方式)
当前部署已经把前后台代码作为宿主机目录挂载到容器。日常修改源码时不需要重新打镜像,也不需要重新加载离线镜像。
需要替换的目录
在 DeerFlow 部署目录中只替换以下内容:
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
在开发或构建机器执行:
cd frontend-web
pnpm install
pnpm build
只把生成的 frontend-web/dist/ 内容上传到部署目录的 source/frontend/dist/。服务器不需要 Node.js,也不会在启动时安装 npm 依赖。
替换完成后重启
进入服务器当前 DeerFlow 部署目录:
sudo ./OFFLINE_INSTALL.sh --restart
该脚本只执行以下操作:
- 检查四个代码目录和前端
index.html; - 从
deploy.env重新生成数据库、模型和前端运行配置; - 检查
source/wheelhouse,仅在内容变化时离线安装依赖; - 使用一次性容器检查后端 Python 导入;
- 依次重建并重启后端、前端容器;
- 等待两个服务健康。
它不会执行数据库预检,不会 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。