Files
deerflow-code/deploy/linux-docker-offline-deerflow-only/docs/12-直接覆盖源码并重启.md
T

2.8 KiB
Raw Blame History

直接覆盖源码并重启(最简单方式)

当前部署已经把前后台代码作为宿主机目录挂载到容器。日常修改源码时不需要重新打镜像,也不需要重新加载离线镜像。

需要替换的目录

在 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

该脚本只执行以下操作:

  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。