deerflow-code/deploy/linux-docker-offline-deerflow-only/README_OFFLINE.md

DeerFlow 纯项目完全离线一键部署包

本包面向 Linux x86_64/amd64，只包含构建时工作区中的 DeerFlow 前端、后端镜像、命名智能体、技能和一键部署文件。版本来源、镜像标签和构建时间见 VERSION.json。

明确不包含：WeKnora UI/App、ParadeDB、Redis、DocReader、独立远程 Sandbox 镜像及 WeKnora 预置 Skills。DeerFlow 默认使用后端容器内的本地沙箱；该沙箱已经内置 Word、Excel、PowerPoint、OpenDocument 和 PDF 处理依赖。DeerFlow 中依赖 WeKnora 的 LLMWiki 连接和本地 Wiki 同步会被运行配置强制关闭。

“完全离线”是指解压、Docker 镜像加载和应用启动不访问镜像仓库、npm、pip 或 Git。实际问答仍需服务器能访问你在 config/deploy.env 中填写的外部 MySQL 和模型服务；模型权重不在本包内。

最短部署流程

sha256sum -c deerflow-linux-amd64-offline-*.tar.gz.sha256
tar -xzf deerflow-linux-amd64-offline-*.tar.gz
cd deerflow-linux-amd64-offline-*
vi config/deploy.env
sudo ./OFFLINE_INSTALL.sh --start

唯一需要人工修改的运行配置文件是 config/deploy.env。必须填写访问地址、外部 MySQL 和至少一个 DeerFlow 模型服务；支持用连续编号配置 1～20 个模型。新增离线 Python 依赖时只需向 source/wheelhouse 放入 wheel，并在该目录的 requirements.txt 增加一行。

sudo ./OFFLINE_INSTALL.sh --start
sudo ./OFFLINE_INSTALL.sh --stop
sudo ./OFFLINE_INSTALL.sh --restart
sudo ./OFFLINE_INSTALL.sh --status
sudo ./OFFLINE_INSTALL.sh --logs
sudo ./OFFLINE_INSTALL.sh --logs deerflow-backend
sudo ./OFFLINE_INSTALL.sh --office-check

--stop 只停止容器，不删除镜像、容器、网络或数据卷。再次启动会检查两个镜像，已存在时跳过 docker load。

MySQL ORM 固定使用 aiomysql 兼容组。--start 与 --restart 都只从包内 wheelhouse 安装依赖，不访问 pip 仓库；依赖安装在持久卷中，容器重建后仍保留。

详细文档按顺序阅读：

1. docs/01-部署前准备.md
2. docs/02-deploy.env配置说明.md
3. docs/03-一键部署与启停.md
4. docs/04-技能与智能体位置.md
5. docs/05-数据备份与恢复.md
6. docs/06-故障排查与校验.md
7. docs/07-升级与版本回退.md
8. docs/08-离线验收清单.md
9. docs/09-后续增量更新发版手册.md
10. docs/10-Office文档处理与自检.md
11. docs/11-只替换前后端源码.md
12. docs/12-直接覆盖源码并重启.md
13. docs/13-wheelhouse离线新增依赖与多模型.md