求助：拉Mineru源码后打包成docker镜像，部署到linux服务器上的OCR效果比在windows系统上直接运行Mineru源码要差

[Wxx1250227780]

1. linux服务器和windows系统的GPU分别是：NVIDIA GeForce RTX 3090和NVIDIA GeForce RTX 3060
2. Dockerfile的内容是：
   dockerfile.txt
3. docker-entrypoint.sh的内容是：
   docker-entrypoint.sh
4. docker镜像的启动命令是：
   docker run -d --gpus all --name mineru-api -p 8002:8002 -v /home/drdp/mineru-models/pipeline/PDF-Extract-Kit-1:/models/pipeline -v /home/drdp/mineru-models/vlm/MinerU25-Pro:/models/vlm mineru:3.1.0
5. 调用ocr服务通过命令行执行：
   mineru -p C:\Users\wxx\Desktop\黄銅及び黄銅材の製造方法、製造設備.pdf -o C:\Users\wxx\Desktop\mineru-ocr -b hybrid-auto-engine -l japan --api-url [linux服务器IP|本地IP]
   6.windows系统运行结果

linux服务器运行结果

[dosubot[bot]]

@Wxx1250227780 你好！Docker 部署 MinerU OCR 效果比 Windows 原生差是一个已经有不少用户反馈过的问题，可能的原因有几个方面：

1. 日语处理在 3.x 版本的退化
MinerU 3.10 更换了 VLM 模型，导致日语等小语种的 OCR 效果变差 [1]。维护者建议：对于日语 PDF，使用 pipeline 后端代替 hybrid-auto-engine，即将 -b hybrid-auto-engine 改为 -b pipeline [1] [2]。这可能是你看到效果差异的主要原因之一。

2. VLLM_USE_V1 环境变量未配置
使用 hybrid-auto-engine 时需要根据 GPU 算力设置该变量 [3]：

• RTX 3090 算力 8.6 → 设置 VLLM_USE_V1=1
• 如未正确设置，可能导致引擎初始化异常

3. 模型缓存目录未挂载
建议显式挂载 .cache 目录，否则模型可能加载不完整 [4]：

docker run ... -v /home/drdp/.cache:/root/.cache ...

4. GPU 内存利用率和并发配置
Docker 环境中建议添加以下环境变量 [5] [6]：

-e MINERU_API_MAX_CONCURRENT_REQUESTS=1
-e VLLM_USE_V1=1

5. PDF 渲染 DPI
Docker 默认 DPI 可能较低（200），可以尝试提高到 300 或 400 来改善中间图像质量 [7]。

建议的排查步骤：

1. 首先尝试将后端从 hybrid-auto-engine 切换为 pipeline，看日语 OCR 效果是否改善
2. 如果仍需使用 hybrid-auto-engine，确保在 Dockerfile 或启动命令中设置 VLLM_USE_V1=1
3. 挂载 .cache 目录并确认容器内模型路径正确
4. 开启 debug 日志排查是否有模型加载失败的情况

RTX 3090 和 RTX 3060 的硬件差异本身不太会导致 OCR 质量不同，问题更可能出在 Docker 环境配置和后端选择上 [8]。

To reply, just mention @dosu.

---

Share context across your team and agents. Try Dosu.