![[Question]: where config the AccessKeyId of Minio in ragflow](https://www.chat-gpts.plus/wp-content/uploads/2026/06/5938-65b1b296.jpg)
[Question]: where config the AccessKeyId of Minio in ragflow
快速结论:该问题发生于用户在 RAGFlow 中使用 MinIO 对象存储时,找不到 AccessKeyId 的配置位置,同时在文档解析过程中出现文件找不到的错误。优先排查 /ragflow/conf/service_conf.yaml 中 MinIO 配置项,并检查 MinIO 容器运行状态。
问题场景
用户在 RAGFlow 中上传 Excel 文件(test.xlsx)并进行文档解析时,系统报错文件不存在,同时用户需要知道如何配置 MinIO 的 AccessKeyId。用户通过 Docker 部署 RAGFlow,后端使用了 MinIO 作为对象存储后端。
报错原文
12:07:43 Page(1~100000001): [ERROR]Internal server error while chunking: [Errno 2] No such file or directory: test.xlsx
12:07:43 [ERROR][Exception]: [Errno 2] No such file or directory: 'test.xlsx'
原因分析
可能原因:MinIO 的 AccessKeyId 和 SecretKey 配置在 /ragflow/conf/service_conf.yaml 中,但配置值不正确或 MinIO 服务未正常运行,导致文件上传后无法被 RAGFlow 后端正确访问,解析时提示文件不存在。也可能 MinIO 容器未正确挂载存储卷或存储桶权限配置有误。
环境排查
- 确认 RAGFlow 部署方式:是否使用 Docker Compose 部署
- 确认
/ragflow/conf/service_conf.yaml中 MinIO 配置段内容 - 确认 MinIO 容器名称:默认可能为
ragflow-minio - 确认 MinIO 容器运行状态:
docker ps - 确认 MinIO 容器日志中是否有 AccessKey 错误或连接拒绝:
docker logs -f ragflow-minio
解决步骤
- 检查
/ragflow/conf/service_conf.yaml中 MinIO 配置项,确认access_key_id和access_key_secret字段已填写正确。若未设置,则根据 MinIO 启动时的默认凭据(通常是minioadmin/minioadmin)进行配置。 - 运行
docker ps确认名为ragflow-minio的容器是否在运行且状态为 Up。 - 运行
docker logs -f ragflow-minio查看 MinIO 容器日志,检查是否有认证失败、存储桶不存在或磁盘空间不足等错误。 - 如果 MinIO 容器未运行,使用
docker-compose up -d重新启动 MinIO 服务。 - 如果 AccessKeyId 或 SecretKey 有变更,修改
service_conf.yaml后需重启 RAGFlow 后端服务使配置生效。 - 如果文件报错依旧存在,检查 RAGFlow 挂载卷中文件是否实际存在于 MinIO 存储桶中,可通过 MinIO 控制台(默认端口 9001)或 mc 客户端验证。
验证方法
重新上传一个测试文件(例如 test.xlsx)并触发文档解析任务。若解析成功且不再出现 No such file or directory 报错,则说明 MinIO 配置和连接正常。同时可以通过 docker logs -f ragflow-minio 检查后续操作中是否仍有认证错误。



