粤ICP备17114055号
微信扫码
添加专属顾问
支持私有云部署
我要投稿
MacOS 安装 RagFlow 的详细踩坑指南，苹果用户不容错过！ 核心内容： 1. 环境配置文件修改要点，优化RAGFLOW镜像 2. Docker Compose在MacOS环境下的特殊配置 3. 网络连接问题的解决策略及国内镜像源的使用
“满满 3 天的全踩坑指南，苹果电脑用户适用。”
对，我用了 3 天时间，才搞定 MacOS 安装 RagFlow。太不容易了，逐一记录里面的要点：
如果需要下载 embedding 模型，则需要在.env 环境搜索 RAGFLOW_IMAG ，然后注释掉这段代码
#RAGFLOW_IMAGE=infiniflow/ragflow:v0.17.0-slim
RagFlow 的安装使用 Docker 完成，对应的目录文件下，有不同版本的.yml配置文件。
MacOS 要选择docker-compose-macos.yml来启动服务，这个配置文件已经针对MacOS环境做了特殊优化。
又一大坑。构建 RAGFlow 时遇到了网络连接问题，无法从 Docker Hub 下载基础镜像。这是因为连接到 Docker Hub 的请求超时了。
报错信息：
> [ragflow internal] load metadata for docker.io/infiniflow/ragflow_deps:latest:
------
------
> [ragflow internal] load metadata for docker.io/library/ubuntu:22.04:
------
failed to solve: ubuntu:22.04: failed to resolve source metadata for docker.io/library/ubuntu:22.04: failed to authorize: failed to fetch anonymous token: Get "https://auth.docker.io/token?scope=repository%3Alibrary%2Fubuntu%3Apull&service=registry.docker.io": dial tcp [2a03:2880:f12c:183:face:b00c:0:25de]:443: i/o timeout对应的解决思路如下：
首先，继续修改 .env 文件，使用国内镜像源而不是尝试构建：
# 修改这部分，使用预构建的镜像而不是尝试构建
# RAGFLOW_IMAGE=infiniflow/ragflow:v0.17.0
# 使用国内镜像源
RAGFLOW_IMAGE=registry.cn-hangzhou.aliyuncs.com/infiniflow/ragflow:v0.17.0
# 确保已启用MacOS优化
MACOS=1
# 添加HuggingFace镜像
HF_ENDPOINT=https://hf-mirror.com使用 docker-compose-macos.yml 文件，但需要先修改它以使用预构建镜像而不是构建：
然后，再继续使用docker-compose-macos.yml文件启动。
docker-compose -f docker-compose-macos.yml up -d
拉镜像的时间非常非常长，整个文件大小 50G。所以，这一步可以去做其他事情，慢慢等。
使用如下指令查看 docker 的状态。如果都正常，那就差不多了。
docker ps
接下来，去打开本地页面应用。第一次使用需要注册。
网页地址：http://localhost/login
如果你的电脑同时也安装了 Dify，大概率会端口冲突。
如何修改 ragflow 的端口映射：编辑docker-compose-macos.yml文件，更改端口映射。
完成端口更改后，请使用以下命令重新启动RagFlow：
docker-compose -f docker-compose-macos.yml down #关闭
docker-compose -f docker-compose-macos.yml up -d #启动服务
使用浏览器访问：
http://localhost:8080
奋战 3 天的成果，太不容易了！
53AI，企业落地大模型首选服务商
产品：场景落地咨询+大模型应用平台+行业解决方案
承诺：免费场景POC验证，效果验证后签署服务协议。零风险落地应用大模型，已交付160+中大型企业
回到顶部