1. 环境准备:为什么离线部署是刚需?
很多朋友第一次接触 RAGFlow 这类 AI 应用,可能都是在有网的开发环境里,一条 docker-compose up -d 命令就搞定了。但真实的生产或内网环境,比如一些对数据安全要求极高的金融、科研单位,或者干脆就是网络条件受限的现场服务器,情况就完全不同了。在这些地方,你没法直接从 Docker Hub 拉取镜像,一个看似简单的部署任务,瞬间就变成了需要精密策划的“离线作战”。
我自己就遇到过好几次,带着 U 盘跑到客户机房,结果因为镜像依赖、内存配置这些细节没处理好,折腾一整天都没把服务跑起来。所以,今天这篇指南,就是把我踩过的坑、总结出来的最佳实践,掰开揉碎了分享给你。我们的目标很明确:在完全没有外网的环境下,用 WSL2 和 Docker,一次性、稳定地把 RAGFlow 部署成功。
首先,你得有两台机器。一台是源机器,它有网络,能正常访问 Docker Hub,并且已经成功运行了 RAGFlow。它的任务就是“打包”,把所有需要的东西准备好。另一台是目标机器,也就是我们最终要部署的内网或无网服务器。它的任务就是“解包并运行”。
在源机器上,你需要确保:
- Docker Desktop 和 WSL2 已经安装好。我个人强烈推荐使用 Ubuntu 作为 WSL2 的发行版,兼容性和社区支持都更好。
- RAGFlow 及其所有依赖服务(MySQL、Elasticsearch、MinIO、Valkey)都已经通过
docker-compose up -d成功启动,并且能通过浏览器正常访问http://localhost:9380。这一步是基础,确保你打包的东西是“活”的。
在目标机器上,准备工作更关键,因为它没有“后悔药”可吃:
- 同样安装好 Docker Desktop 和 WSL2。这里有个大坑:务必确保源机器和目标机器的 CPU 架构一致,比如都是 x86_64。如果你在苹果 M 系列芯片的 Mac 上打包了 ARM 架构的镜像,拿到 x86 的服务器上是跑不起来的。
- 提前关闭防火墙,或者至少放行 Docker 和 RAGFlow 需要用到的端口(比如 9380)。离线环境排查网络问题非常麻烦,不如一开始就扫清障碍。
2. 源机器操作:如何安全地“打包”整个 RAGFlow?
好了,源机器上的 RAGFlow 跑得欢快,现在我们要把它“冷冻”起来,搬到目标机器上去。核心就是两样东西:Docker 镜像和配置文件。镜像就是一个个集装箱,里面装好了运行程序;配置文件就是装箱单和组装说明书。
2.1 分批次导出镜像:避开内存崩溃的深坑
直接使用 docker save 命令导出所有镜像行不行?理论上行,但实操中,尤其是 RAGFlow 的主镜像(infiniflow/ragflow)体积可能超过 10GB,一次性导出极有可能把系统内存吃满,导致 WSL2 崩溃,导出进程中断,前功尽弃。我吃过这个亏,所以必须分批次、先小后大地导出。
这里我准备了一个 PowerShell 脚本,你直接复制使用就行。切记,很多 Docker 操作需要在 RAGFlow 项目的 docker 目录下进行,因为那里有 docker-compose.yml 文件,环境变量都配置好了。
首先,打开 PowerShell,切换到你的 RAGFlow 项目下的 docker 目录:
cd "你的路径\ragflow-main\docker"
然后,创建一个名为 export-ragflow.ps1 的文件,把下面的脚本内容粘贴进去保存。
# export-ragflow.ps1
# 分批次定义镜像(小镜像优先,减少单次内存压力)
$smallImages = @(
"valkey/valkey:8", # 约112MB,替代Redis的轻量缓存
"mysql:8.0.39", # 约572MB,数据库
"quay.io/minio/minio:RELEASE.2023-12-20T01-
264



被折叠的 条评论
为什么被折叠?



