MinerU教程第一弹丨Dify插件超详细配置攻略和工作流搭建案例，不允许还有人不会-CSDN博客

本文链接：https://blog.csdn.net/OpenDataLab/article/details/147902519

近期，MinerU 与 Dify 联合研发的 MinerU 插件在 Dify 市场上架了！大量社区的小伙伴们在社群里询问，应该如何使用 Dify 中 MinerU 插件来搭建工作流。今天，使用教程，它来啦！

MinerU Dify 插件主页：https://marketplace.dify.ai/plugins/langgenius/mineru

我们先来看一下大家使用 Dify 和 MinerU 插件的场景，大致可分为如下环境：

针对不同的使用场景，一些配置会有些许不同，一定要注意我们的提示哦（都是社区小伙伴们部署时的血泪教训），接下来就跟着小编一步步地操作，就能在 Dify 中愉快地使用 MinerU 了。

01 场景一：在 Dify MinerU 插件中配置 MinerU 官方在线 API 服务

1. 登录你的 Dify 平台；

2. 进入【工具】 -> 【插件市场】，搜索 MinerU 插件并添加。

传送门：https://marketplace.dify.ai/plugins/langgenius/mineru

3. 配置 MinerU 插件参数：

● 先访问 MinerU 官网申请在线 API，审批通过后方可使用：https://mineru.net/apiManage

（* 注意关闭代理，否则页面无法访问）

● 在 Dify 平台逐项填写授权字段：

# MinerU服务的Base URLhttps://mineru.net#令牌（MinerU 官网申请后自己创建的 API token）#服务类型MinerU官方API

4. 保存配置，就可以在 Dify 应用中成功使用 MinerU 工具来处理 PDF等文件啦！

填写示意：

02 场景二：在 Dify MinerU 插件中配置 MinerU 本地服务

💡提示：此场景前提是您已在本地部署了 MinerU，并参照 MinerU GitHub Repo 中 projects 文件夹中的 web_api 项目，构建部署了 MinerU 本地 API 服务，然后在 Dify 中进行授权配置。

MinerU web_api 传送门：https://github.com/opendatalab/MinerU/tree/master/projects/web_api

1. 登录你的 Dify 平台

2. 进入【工具】 -> 【插件市场】，搜索 MinerU 插件并添加

3. 获取本机 IP 地址

为了让 Dify 正确访问 MinerU API，需要使用局域网 IP 地址（不能使用 127.0.0.1 或 localhost）。请根据你的系统获取本机 IP：

● Windows：打开命令提示符 cmd，输入下方命令，查找 "IPv4 地址":

ipconfig

● macOS：打开终端（Terminal），输入下方命令，查找 IP

#无线网络：ipconfig getifaddr en0#有线网络：ipconfig getifaddr en1

● Linux：打开终端，执行：

ip hostname -I或ip addr

记录下你的 IP 地址，例如：192.168.1.100。

4. 配置 MinerU 插件参数：

# MinerU服务的Base URLhttp://192.168.1.100:8888（填入'http://你的本机IP地址:8888', 注意不是https哦）#令牌（留空，本地不需要Token）#服务类型本地部署

5. 保存配置，就可以在 Dify 应用中成功使用 MinerU 工具来处理 PDF等文件啦！

填写示意：

03 使用 Dify 中 MinerU 插件的常见问题

本地部署的 Dify，在执行过程中遇到如下错误怎么办

1Run failed: Failed to transform tool message: PluginInvokeError: {"args":{},"error_type":"Exception","message":"Error extracting page from PDF: Request URL is missing an 'http://' or 'https://' protocol."}（报错示意）

为了解决上述问题，接下来你需要设置 Dify 的配置文件：

1. 找到 Dify 部署目录，打开 .env 文件，修改 FILES_URL 配置项，依据你的部署方式填写：

● Docker Compose 部署：FILES_URL 设置为 ‘http://api:5001'

● 其他部署方式：FILES_URL 设置为 'http://Dify宿主机IP:5001'

（如 http://192.168.1.100:5001，这里的 IP 通常是运行 Dify 的机器的 IP，即前文提到的“本地IP”端口。5001 是 Dify API 服务的默认端口）。

2. 确认 Dify API 服务的 5001 端口已对外暴露（可检查 docker-compose.yaml 文件的端口映射）。

3. 保存 .env 文件。

4. 重启 Dify 服务以使配置生效。

💡 提示:

1. 如果你使用本机 IP 设置 FILES_URL ，那么当你的网络环境发生变化 (例如连接了不同的 WiFi)，你的本机 IP 地址可能会改变。届时需要：

● 重新获取本机 IP 地址；

● 更新 Dify 中 MinerU 插件的 Base URL 配置；

● 如有必要 (如果 Dify 的 FILES_URL 配置的是 IP 地址而不是 api)，更新 Dify 的 .env 文件并重启 Dify 服务。

2. 在使用 Dify 的 MinerU 插件时，尤其是在处理文件上传时，如果不配置此步骤，可能会遇到类似 ‘Request URL is missing an 'http://' or 'https://' protocol’的错误。这是常是因为 Dify 的 API 服务无法正确访问其自身的文件服务。