3.0版本的mineru-router咋用呢 求助

[finch-xu]

mineru-router 这个新功能在api接口里也没找到，deepwiki也没更新搜不到，这是咋用的呢，是接口还是独立的服务呢？有没有它的文档地址。

[dosubot[bot]]

mineru-router 是 MinerU 3.0（2026-03-28 发布）新增的一个独立 HTTP 服务，用于在多个 mineru-api 工作进程之间做负载均衡和编排，实现一键多 GPU 部署 [1]。它不是单独的 pip 包，而是 pip install mineru 后自动注册的 CLI 命令，入口在 mineru/cli/router.py [2]。

快速使用：

# 自动检测所有 GPU，一键启动
mineru-router --host 0.0.0.0 --port 8002 --local-gpus auto

# 也可以聚合已有的远程 mineru-api 服务
mineru-router --host 0.0.0.0 --port 8002 \
  --upstream-url http://server-a:8000 \
  --upstream-url http://server-b:8001 \
  --local-gpus none

[3] [4]

启动后，它暴露的 API 接口和 mineru-api 完全一致（/tasks、/file_parse、/health 等），可以直接作为 mineru-api 的替代使用 [5]。访问 http://<host>:<port>/docs 即可查看 Swagger 文档。

工作原理： 默认 --local-gpus auto 模式下，router 会自动检测可用 CUDA 设备，每个 GPU 启动一个 mineru-api 子进程，自动做健康检查和故障重启，并按负载分数进行任务路由 [6]。

文档位置：

• CLI 工具文档（含完整参数和环境变量）
• 快速使用指南
• 高级 CLI 参数（多 GPU 示例）

To reply, just mention @dosu.

---

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

   

[finch-xu]

谢谢机器人老哥