RAGFlow + Ollama 本地部署完整指南（适配 Mac M 系列 / 新手友好版）

type

status

date

slug

summary

category

icon

password

URL

Text

😀

本篇适合小白用户使用 RAGFlow + Ollama 本地部署完整指南（适配 Mac M 系列 / 新手友好版）

📍 系统环境：macOS（Apple 芯片，如 M1/M2/M4） 📍 项目目录：~/Downloads/ragflow-main

一、前期准备

✅ 所需工具安装

打开“终端”（Terminal）

方法一：按下快捷键 Command + 空格，输入 "终端" 或 "Terminal"，回车

方法二：从“应用程序 > 实用工具 > 终端”中打开

安装 Homebrew（如未安装）

在终端输入以下命令，按回车： /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装 Docker Desktop for Mac

下载地址：https://www.docker.com/products/docker-desktop

下载后双击安装，安装后打开 Docker Desktop

顶部状态栏看到 🐳 图标，说明 Docker 已在运行

验证命令：在终端输入：docker info

安装 Ollama（本地大模型引擎）

官网：https://ollama.com

下载 Mac 版本并安装

安装后，在终端输入：ollama --version 验证成功

下载 DeepSeek 模型（示例使用 deepseek-r1:14b）

打开终端输入： ollama pull deepseek-r1:14b

下载 RAGFlow 项目源码（任选一种方式）

方法一（推荐）：在终端执行： git clone https://github.com/infiniflow/ragflow.git

方法二：浏览 https://github.com/infiniflow/ragflow，点击“Code” → “Download ZIP”

二、进入项目目录

假设你将项目下载到“下载”文件夹中，请执行：

cd ~/Downloads/ragflow-main

三、配置 .env 文件

下载官方 .env 文件

curl -L -o ~/Downloads/ragflow-main/docker/.env https://raw.githubusercontent.com/infiniflow/ragflow/main/docker/.env

编辑 .env 文件

终端中输入以下命令：

nano ~/Downloads/ragflow-main/docker/.env

如何编辑（Nano 编辑器指令说明）：

使用 ↑ ↓ ← → 移动光标

在文件最底部粘贴以下内容：

LLM_PROVIDER=ollama OLLAMA_BASE_URL=http://host.docker.internal:11434 OLLAMA_MODEL=deepseek-r1:14b EMBEDDING_MODEL=BAAI/bge-base-en-v1.5 EMBEDDING_PROVIDER=local

📌 中文推荐 EMBEDDING_MODEL=BAAI/bge-large-zh-v1.5

保存并退出编辑器：

按下：Ctrl + O（字母 O 不是数字 0） → 回车（保存）

然后按下：Ctrl + X（退出）

四、启动 RAGFlow 服务

cd ~/Downloads/ragflow-main docker compose -f docker/docker-compose.yml up -d

等待容器启动（首次运行可能需要几分钟）

五、访问 RAGFlow 网页界面

打开浏览器输入地址：

http://localhost

首次进入需要注册账户，然后可上传文档并使用“助理”进行问答。

六、验证 Ollama 模型是否可访问

终端中输入：

curl http://localhost:11434/api/tags

应返回包含 deepseek-r1:14b 的模型信息

七、常见问题与解决

❌ localhost:3000 打不开：使用 http://localhost（RAGFlow 默认监听 80 端口）

❌ Connection refused：请使用 http://host.docker.internal:11434 而不是局域网 IP

❌ 'NoneType' 错误：.env 文件中未配置 embedding 模型

❌ .env 文件空白：确保使用 raw.githubusercontent.com 链接下载

⚠️ ARM 芯片平台不匹配：提示可忽略，Docker 已自动处理

八、Docker 命令速查

启动服务：docker compose -f docker/docker-compose.yml up -d

查看服务状态：docker ps

停止服务：docker compose down

查看日志：docker compose logs -f

九、附加说明（进阶）

如需使用 VS Code 打开项目目录，可输入：

code ~/Downloads/ragflow-main

如要使用 vim 编辑器：

vim ~/Downloads/ragflow-main/docker/.env

按 i 进入编辑模式

编辑完成后按 Esc

输入 :wq 保存并退出

📌 所有操作尽量在项目根目录（ragflow-main）下进行，以确保路径一致

十、电脑重启后如何再次启动 RAGFlow

每次电脑关机或重启后，Docker 中的容器会停止运行，但不会被删除。你只需执行以下步骤即可重新启动项目。

✅ 第 1 步：启动 Docker Desktop

打开 Launchpad 或 Spotlight（按 Command + 空格），输入 Docker，回车启动

看到右上角 🐳 图标变为 “Docker is running” 即表示后台服务已准备好

✅ 第 2 步：打开终端 Terminal

按 Command + 空格，输入 Terminal，回车打开终端

✅ 第 3 步：进入项目目录并重启服务 cd ~/Downloads/ragflow-main docker compose -f docker/docker-compose.yml up -d

⏱️ 等待几秒钟后，即可在浏览器访问：http://localhost

✅ 可选：查看容器运行状态 docker ps

如果输出中显示 ragflow、mysql、redis 等容器，说明服务已恢复运行 ✅

📌 所有之前的模型、文档和配置都会被保留，无需重复部署。

💡

推荐使用至少24g内存的MAC MINI 或者更高的版本。