Using MinerU in Dify reports a ConnectError #896

Closed
opened 2026-02-16 10:20:53 -05:00 by yindo · 1 comment
Owner

Originally created by @fruitage on GitHub (Dec 24, 2025).

Self Checks

  • This is only for bug report, if you would like to ask a question, please head to Discussions.
  • I have searched for existing issues Dify issues & Dify Official Plugins, including closed ones.
  • I confirm that I am using English to submit this report (我已阅读并同意 Language Policy).
  • [FOR CHINESE USERS] 请务必使用英文提交 Issue,否则会被关闭。谢谢!:)
  • Please do not modify this template :) and fill in all the required fields.

Dify version

1.11.1

Plugin version

0.5.1

Cloud or Self Hosted

Cloud, Self Hosted (Source)

Steps to reproduce

It worked fine in version 1.7.2, but after upgrading Dify to version 1.11.1, using a locally deployed mineru-api throws a ConnectError.

✔️ Error log

An error occurred in the langgenius/mineru/mineru, please contact the author of langgenius/mineru/mineru for help, error type: ConnectError, error details: [Errno -2] Name or service not known

FAIL
运行时间
1.048s
总 token 数
0 Tokens
An error occurred in the langgenius/mineru/mineru, please contact the author of langgenius/mineru/mineru for help, error type: ConnectError, error details: [Errno -2] Name or service not known
流程中有 1 个节点运行异常,请前往追踪查看日志。

Originally created by @fruitage on GitHub (Dec 24, 2025). ### Self Checks - [x] This is only for bug report, if you would like to ask a question, please head to [Discussions](https://github.com/langgenius/dify/discussions/categories/general). - [x] I have searched for existing issues [Dify issues](https://github.com/langgenius/dify/issues) & [Dify Official Plugins](https://github.com/langgenius/dify-official-plugins/issues), including closed ones. - [x] I confirm that I am using English to submit this report (我已阅读并同意 [Language Policy](https://github.com/langgenius/dify/issues/1542)). - [x] [FOR CHINESE USERS] 请务必使用英文提交 Issue,否则会被关闭。谢谢!:) - [x] Please do not modify this template :) and fill in all the required fields. ### Dify version 1.11.1 ### Plugin version 0.5.1 ### Cloud or Self Hosted Cloud, Self Hosted (Source) ### Steps to reproduce It worked fine in version 1.7.2, but after upgrading Dify to version 1.11.1, using a locally deployed mineru-api throws a ConnectError. <!-- Failed to upload "image.png" --> ### ✔️ Error log `An error occurred in the langgenius/mineru/mineru, please contact the author of langgenius/mineru/mineru for help, error type: ConnectError, error details: [Errno -2] Name or service not known` FAIL 运行时间 1.048s 总 token 数 0 Tokens An error occurred in the langgenius/mineru/mineru, please contact the author of langgenius/mineru/mineru for help, error type: ConnectError, error details: [Errno -2] Name or service not known 流程中有 1 个节点运行异常,请前往追踪查看日志。
yindo added the bug label 2026-02-16 10:20:53 -05:00
yindo closed this issue 2026-02-16 10:20:53 -05:00
Author
Owner

@dosubot[bot] commented on GitHub (Dec 24, 2025):

Hi @fruitage! I'm Dosu and I’m helping the dify-official-plugins team.

The ConnectError ([Errno -2] Name or service not known) after upgrading is caused by stricter validation in recent MinerU plugin and Dify versions: the plugin now requires the base_url for your local mineru-api to be a resolvable LAN IP address, not localhost or 127.0.0.1. Any hostname that can't be resolved from the Dify environment will trigger this error immediately.

To fix this:

  1. Find the current LAN IP of the machine running mineru-api (e.g., 192.168.x.x).
  2. Update the MinerU plugin's base_url in Dify to use this IP and the correct port (e.g., http://192.168.x.x:8888).
  3. Set server_type to local and leave the token blank.
  4. Make sure mineru-api is running and accessible from the Dify environment (test with curl or browser from the Dify container/host).
  5. If your local IP changed (for example, after switching networks), update both the plugin's base_url and, if needed, the FILES_URL in Dify's .env file, then restart Dify for changes to take effect.

If you still see the error after these steps, check for network or firewall issues between Dify and mineru-api, and try running network diagnostics from within the Dify environment to confirm connectivity.

References:

To reply, just mention @dosu.


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

Open in Cursor Join Discord Share on X

@dosubot[bot] commented on GitHub (Dec 24, 2025): <!-- Greeting --> Hi @fruitage! I'm [Dosu](https://go.dosu.dev/dosubot) and I’m helping the dify-official-plugins team. <!-- Answer --> The ConnectError ([Errno -2] Name or service not known) after upgrading is caused by stricter validation in recent MinerU plugin and Dify versions: the plugin now requires the base_url for your local mineru-api to be a resolvable LAN IP address, not localhost or 127.0.0.1. Any hostname that can't be resolved from the Dify environment will trigger this error immediately. To fix this: 1. Find the current LAN IP of the machine running mineru-api (e.g., 192.168.x.x). 2. Update the MinerU plugin's base_url in Dify to use this IP and the correct port (e.g., http://192.168.x.x:8888). 3. Set server_type to local and leave the token blank. 4. Make sure mineru-api is running and accessible from the Dify environment (test with curl or browser from the Dify container/host). 5. If your local IP changed (for example, after switching networks), update both the plugin's base_url and, if needed, the FILES_URL in Dify's .env file, then restart Dify for changes to take effect. If you still see the error after these steps, check for network or firewall issues between Dify and mineru-api, and try running network diagnostics from within the Dify environment to confirm connectivity. References: - [MinerU plugin README: LAN IP requirement and troubleshooting](https://github.com/langgenius/dify-official-plugins/blob/f7e9b3d0a3c0f89c5e140487ed1bfede86e6f4db/tools/mineru/README.md#L95-L161) - [MinerU plugin code: stricter base_url validation and error handling](https://github.com/langgenius/dify-official-plugins/blob/f7e9b3d0a3c0f89c5e140487ed1bfede86e6f4db/tools/mineru/tools/parse.py#L12-L178) <!-- Dosu Comment Footer --> *To reply, just mention [@dosu](https://go.dosu.dev/dosubot).* --- <sup>How did I do? [Good](https://app.dosu.dev/response-feedback/118f5008-efa4-4968-a567-d9e4779b3fc4?feedback_type=great_response) | [Irrelevant](https://app.dosu.dev/response-feedback/118f5008-efa4-4968-a567-d9e4779b3fc4?feedback_type=irrelevant_answer) | [Incorrect](https://app.dosu.dev/response-feedback/118f5008-efa4-4968-a567-d9e4779b3fc4?feedback_type=incorrect_sources) | [Verbose](https://app.dosu.dev/response-feedback/118f5008-efa4-4968-a567-d9e4779b3fc4?feedback_type=too_verbose) | [Hallucination](https://app.dosu.dev/response-feedback/118f5008-efa4-4968-a567-d9e4779b3fc4?feedback_type=hallucination) | [Report 🐛](https://app.dosu.dev/response-feedback/118f5008-efa4-4968-a567-d9e4779b3fc4?feedback_type=bug_report) | [Other](https://app.dosu.dev/response-feedback/118f5008-efa4-4968-a567-d9e4779b3fc4?feedback_type=other)</sup> [![Open in Cursor](https://dosu.dev/dosu-in-cursor.svg)](https://cursor.com/link/prompt?text=The%20ConnectError%20%28%5BErrno%20-2%5D%20Name%20or%20service%20not%20known%29%20after%20upgrading%20is%20caused%20by%20stricter%20validation%20in%20recent%20MinerU%20plugin%20and%20Dify%20versions%3A%20the%20plugin%20now%20requires%20the%20base_url%20for%20your%20local%20mineru-api%20to%20be%20a%20resolvable%20LAN%20IP%20address%2C%20not%20localhost%20or%20127.0.0.1.%20Any%20hostname%20that%20can%27t%20be%20resolved%20from%20the%20Dify%20environment%20will%20trigger%20this%20error%20immediately.%20%0A%0ATo%20fix%20this%3A%0A1.%20Find%20the%20current%20LAN%20IP%20of%20the%20machine%20running%20mineru-api%20%28e.g.%2C%20192.168.x.x%29.%0A2.%20Update%20the%20MinerU%20plugin%27s%20base_url%20in%20Dify%20to%20use%20this%20IP%20and%20the%20correct%20port%20%28e.g.%2C%20http%3A//192.168.x.x%3A8888%29.%0A3.%20Set%20server_type%20to%20local%20and%20leave%20the%20token%20blank.%0A4.%20Make%20sure%20mineru-api%20is%20running%20and%20accessible%20from%20the%20Dify%20environment%20%28test%20with%20curl%20or%20browser%20from%20the%20Dify%20container/host%29.%0A5.%20If%20your%20local%20IP%20changed%20%28for%20example%2C%20after%20switching%20networks%29%2C%20update%20both%20the%20plugin%27s%20base_url%20and%2C%20if%20needed%2C%20the%20FILES_URL%20in%20Dify%27s%20.env%20file%2C%20then%20restart%20Dify%20for%20changes%20to%20take%20effect.%0A%0AIf%20you%20still%20see%20the%20error%20after%20these%20steps%2C%20check%20for%20network%20or%20firewall%20issues%20between%20Dify%20and%20mineru-api%2C%20and%20try%20running%20network%20diagnostics%20from%20within%20the%20Dify%20environment%20to%20confirm%20connectivity.%0A%0AReferences%3A%20%20%0A-%20%5BMinerU%20plugin%20README%3A%20LAN%20IP%20requirement%20and%20troubleshooting%5D%28https%3A//github.com/langgenius/dify-official-plugins/blob/f7e9b3d0a3c0f89c5e140487ed1bfede86e6f4db/tools/mineru/README.md%23L95-L161%29%20%20%0A-%20%5BMinerU%20plugin%20code%3A%20stricter%20base_url%20validation%20and%20error%20handling%5D%28https%3A//github.com/langgenius/dify-official-plugins/blob/f7e9b3d0a3c0f89c5e140487ed1bfede86e6f4db/tools/mineru/tools/parse.py%23L12-L178%29)&nbsp;[![Join Discord](https://img.shields.io/badge/join-5865F2?logo=discord&logoColor=white&label=)](https://go.dosu.dev/discord-bot)&nbsp;[![Share on X](https://img.shields.io/badge/X-share-black)](https://twitter.com/intent/tweet?text=%40dosu_ai%20helped%20me%20solve%20this%20issue!&url=https%3A//github.com/langgenius/dify-official-plugins/issues/2318)
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langgenius/dify-official-plugins#896