An error occurred in the langgenius/mineru/mineru, please contact the author of langgenius/mineru/mineru for help, error type: Exception, error details: Failed to download zip file: The handshake operation timed out

[1623575960]

[dosubot[bot]]

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

The "handshake operation timed out" error when downloading a zip file in MinerU is almost always caused by network issues—like slow or blocked internet, firewall/proxy restrictions, or the remote server being unresponsive. MinerU doesn't set custom timeouts or retries for downloads, so if the connection is unstable, you'll see this error. This is common when using HuggingFace as the model source, especially from regions with restricted access.

Here’s how you can work around or fix it:

1. Switch model source: If you’re in China or have trouble with HuggingFace, set the model source to ModelScope, which is more reliable in some regions. You can do this by setting the environment variable:

   export MINERU_MODEL_SOURCE=modelscope

   Or, if you’re using the CLI:

   mineru -p <input_path> -o <output_path> --source modelscope

   Details

2. Use local models to bypass downloads:

   • Download the required models in advance using:

     mineru-models-download

     This will save the models locally and update your mineru.json config.
   • To force MinerU to use local models and never attempt a remote download, set:

     export MINERU_MODEL_SOURCE=local

     Or use the CLI flag:

     mineru -p <input_path> -o <output_path> --source local

   • If you move the model folder, update the path in your mineru.json (in your home directory) under the models-dir key.
     How local config works

3. Check your network: Make sure your server can reach the model source (try downloading the zip manually with wget or curl). If you’re behind a proxy or firewall, you may need to adjust your network settings.

4. Update everything: Make sure you’re using the latest version of MinerU and its plugins, and that your plugin and backend API versions are compatible.

5. If you’re using Docker or a reverse proxy: Make sure nothing is interfering with large file downloads or altering response headers.

If you still see handshake or timeout errors after switching to ModelScope or local models, enable debug logging and check the logs for more details on where the failure occurs.

Let me know if you need the exact steps for your deployment method or help with the config file!

To reply, just mention @dosu.

---

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

   

[1623575960]

@dosu 我使用dify官方插件调用的官方的API

[dosubot[bot]]

你用 Dify 官方插件调用 MinerU 官方 API 时遇到的 handshake/timeout（握手超时/下载超时）问题，常见原因和排查建议如下：

1. 网络问题：MinerU 下载模型（如 zip 文件）时，默认用 HuggingFace 作为源，国内网络经常超时。推荐让 MinerU 后端设置 MINERU_MODEL_SOURCE=modelscope，这样会走 ModelScope 源，国内更稳定。如果还是不行，可以提前用 mineru-models-download 命令下载模型，配置 MINERU_MODEL_SOURCE=local 让 MinerU 只用本地模型，不再联网下载（这些都需要在 MinerU 后端服务器设置，Dify 插件本身无法通过 API 参数切换模型源）参考。

2. 环境变量和配置：Dify 的 .env 文件里 BASE_URL 和 FILES_URL 必须精确指向 MinerU API 根地址（如 http://your-mineru-ip:8000，不要带 /docs 等路径），改完后必须 docker compose down && docker compose up -d 完全重启 Dify 服务，否则配置不会生效参考。

3. 版本兼容：Dify 插件和 MinerU 后端 API 版本要匹配，比如 Dify 插件 0.4.2 需要 MinerU 2.1.1+，接口参数名也要一致（/pdf_parse 用 pdf_file，/file_parse 用 file），否则会超时、404 或报 “File is required”参考。

4. 文件上传方式：MinerU 只支持 PDF 和图片，且必须用 multipart/form-data 上传本地文件，不能只传 URL 或文件名参考。

5. 容器网络：如果用 Docker Compose，Dify 容器和 MinerU 容器要能互通。建议进 Dify 容器里 curl 一下 MinerU API 地址，确认网络没问题。

6. 日志排查：设置 MINERU_LOG_LEVEL=DEBUG，看 MinerU 和 Dify 的日志，确认请求是否到达、参数是否匹配，能帮助定位问题。

7. 后端模型选择：Dify 插件目前不支持通过 API 参数切换模型源或后端（如 VLM），只能在 MinerU 后端用环境变量配置。如果需要 VLM 高精度模型，建议直接用 MinerU 官网或本地 CLI/Gradio 部署。

如以上都确认无误但依然 handshake/timeout，可以贴下你的 .env 配置、Dify/MinerU 版本、相关日志片段，我帮你进一步定位。

To reply, just mention @dosu.

---

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

   

[wangjiawen2013]

@dosu
是下载一次就可以了 ，还是每次运行都会重新下载？