私有化dify中使用插件报错

[CatsMyLove]

🔎 Search before asking | 提交之前请先搜索

• I have searched the MinerU Readme and found no similar bug report.
• I have searched the MinerU Issues and found no similar bug report.
• I have searched the MinerU Discussions and found no similar bug report.

🤖 Consult the online AI assistant for assistance | 在线 AI 助手咨询

• I have consulted the online AI assistant but was unable to obtain a solution to the issue.

Description of the bug | 错误描述

你好，我在私有化的dify中用这个插件报下面的错误，配置的是公共API地址和token，不是私有化部署的mineru
An error occurred in the plugin, please contact the author of langgenius/mineru/mineru for help, error type: Exception, error details: Failed to download zip file: [Errno 101] Network is unreachable
，不知道是访问哪个网络不通，baseurl和阿里云oss网络都已开通，都是通的。我搜了下类似问题说是切换镜像源但是我是调用远程的没有本地部署

How to reproduce the bug | 如何复现

dify中使用远程api

Operating System Mode | 操作系统类型

Linux

Operating System Version| 操作系统版本

麒麟10

Python version | Python 版本

3.13

Software version | 软件版本 (mineru --version)

No response

Backend name | 解析后端

No response

Device mode | 设备模式

No response

[dosubot]

Hi @CatsMyLove! I'm Dosu and I’m helping the MinerU team.

你遇到的 [Errno 101] Network is unreachable 报错，虽然 MinerU 插件配置的是公网 API 和 token，但实际上插件在解析文件时，后台会尝试从 HuggingFace 或 ModelScope 等外部源下载模型或资源（如 zip 文件），而不是只访问你配置的 base_url 或 OSS。这些外部源在部分网络环境（如公司内网、云服务器、国内部分地区）经常被防火墙、代理或 DNS 限制，导致无法连接，从而报出该错误相关讨论。

建议排查和解决步骤如下：

1. 确认插件配置：确保 base_url、token、服务类型等完全符合 MinerU 官方 API 要求，base_url 不要带 /docs 或其他路径，只填根地址（如 https://mineru.net）配置说明。
2. 容器内网络测试：进入 Dify 容器内部，使用 curl 或 wget 测试能否访问 https://huggingface.co、https://modelscope.cn 等外部模型源。如果访问失败，说明网络被限制网络排查。
3. 检查防火墙/代理/DNS：确认服务器或容器的防火墙、代理、DNS 没有屏蔽上述外部域名。
4. 切换模型源：如果 HuggingFace 访问不通，可以在 MinerU 后台（不是 Dify 插件 UI）设置环境变量 MINERU_MODEL_SOURCE=modelscope，让 MinerU 优先用 ModelScope 下载模型，部分地区更稳定切换方法。
5. 本地预下载模型：如果网络始终受限，可用 mineru-models-download 命令提前下载好模型，并设置 MINERU_MODEL_SOURCE=local，让 MinerU 只用本地模型，避免运行时联网下载本地模式说明。
6. 日志排查：设置 MINERU_LOG_LEVEL=DEBUG，重启 Dify 和 MinerU，查看日志能否定位具体失败的 URL 或网络请求，进一步定位问题日志建议。

注意：Dify 插件 UI 里填写的 token 不会自动加到请求头，MinerU 后台需通过环境变量 MINERU_API_KEY 配置 token，否则会导致 401 报错token 说明。

如果还有问题，建议贴出 MinerU 和 Dify 的详细 debug 日志（注意脱敏），这样可以更快定位是哪一步的网络请求失败。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}