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

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

针对不同的使用场景，一些配置会有些许不同，一定要注意我们的提示哦（都是社区小伙伴们部署时的血泪教训 MinerU教程第一弹丨Dify插件超详细配置攻略和工作流搭建案例，不允许还有人不会），接下来就跟着小编一步步地操作，就能在 Dify 中愉快地使用 MinerU 了。

场景一：在 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等文件啦！

填写示意：

场景二：在 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等文件啦！

填写示意：

使用 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 服务无法正确访问其自身的文件服务。