1.9 KiB
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 后再解压。校验失败不要继续部署,应重新传输文件。