Files
deerflow-code/deploy/linux-docker-offline-deerflow-only/docs/01-部署前准备.md
T

1.9 KiB

01 部署前准备

服务器要求

  • Linux x86_64/amd64。
  • Docker Engine 和独立命令 docker-compose 已安装且运行正常;脚本优先使用它,并兼容 Compose v2 插件作为回退。
  • 建议至少 8 核 CPU、16 GiB 内存、20 GiB 可用磁盘;镜像加载期间需要同时容纳压缩包、解压目录和 Docker 镜像层。
  • 可访问外部 MySQL 8.x;部署账号需要连接、建库和建表权限。
  • 可从 Docker 容器访问 OpenAI 兼容的 DeerFlow 对话模型接口。

目标机部署过程不需要访问互联网、镜像仓库、npm 或 pip。PUBLIC_HOST 对应的前端和后端端口需要在防火墙放行。

本包不包含 WeKnora 以及其 PostgreSQL、Redis、DocReader、独立远程 Sandbox 镜像,也不包含模型权重。默认本地沙箱位于 DeerFlow 后端容器内,Office/PDF 依赖已经随该镜像离线交付。

部署前检查

uname -m                         # 应为 x86_64
docker version
docker-compose version           # 目标服务器使用此命令
docker info
df -h

还需要系统命令:bash、tar、gzip、sha256sum、curl。部署用户可以直接使用 Docker;否则命令前加 sudo。

准备并确认以下网络方向:

  • 浏览器 → FRONTEND_PORT。
  • 浏览器 → BACKEND_PORT(前端运行时会直连 Gateway)。
  • DeerFlow 后端容器 → 外部 MySQL。
  • DeerFlow 后端容器 → OpenAI 兼容模型接口。
  • 如果启用 Tavily、Serper 或业务接口,还需按实际调用方向访问相应地址。

同一服务器上的服务不能从容器里使用 127.0.0.1 访问宿主机。应使用宿主机内网 IP;Docker 支持 host-gateway 时也可使用 host.docker.internal。

文件校验

把压缩包和同名 .sha256 放在同一目录:

sha256sum -c deerflow-linux-amd64-offline-*.tar.gz.sha256

显示 OK 后再解压。校验失败不要继续部署,应重新传输文件。