lixiyu/mineru

MinerU

https://github.com/opendatalab/MinerU 是一个开源文档解析工具，支持PDF/Office/网页等格式转换为Markdown/JSON，内置布局分析、OCR、公式识别能力。

可用标签

基础镜像：vllm/vllm-openai:v0.21.0，CUDA 13.0，需要NVIDIA GPU（计算能力≥7.0），内置中文字体。

3.3.1 兼容性说明

mineru[core]==3.3.1 要求 pdftext<0.7，无法升级到0.7.x版本。而pdftext==0.6.3本身存在稳定性问题。这是一个两难选择——锁定在0.6.x版本是为了确保可运行，但该版本稳定性不足。

bash
# 3.3.1 的依赖约束（镜像已按此构建）
pip install 'mineru[core]==3.3.1' 'pdftext<0.7'

推荐使用3.4.4版本，不受此问题影响。

快速启动

bash
docker run --gpus '"device=0"' \
  --shm-size docker.xuanyuan.run/32g \
  --ipc=host \
  -p 8000:8000 \
  -e MINERU_MODEL_SOURCE=local \
  lixiyu/mineru:3.4.4

服务启动后访问 http://localhost:8000/docs 查看API文档。

Docker Compose

yaml
services:
  mineru-api:
    image: docker.xuanyuan.run/lixiyu/mineru:3.4.4-gpu
    container_name: mineru-api
    restart: unless-stopped
    ports:
      - "8000:8000"
    environment:
      MINERU_MODEL_SOURCE: local
    shm_size: 32gb
    ipc: host
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              device_ids: ["0"]
              capabilities: [gpu]

关键配置

• --shm-size 32g：共享内存必须足够大，否则大文件解析会出现内存不足（OOM）问题
• --ipc=host：使用宿主机IPC命名空间，PyTorch DataLoader多进程通信依赖此配置
• MINERU_MODEL_SOURCE=local：镜像内置模型文件（通过modelscope下载），无需额外挂载

NPU版启动命令

shell
docker run -d \
  --name mineru-npu \
  --restart unless-stopped \
  --privileged \
  --shm-size 32g \
  --ipc host \
  -p 6003:8000 \
  -e MINERU_MODEL_SOURCE=local \
  -e ASCEND_VISIBLE_DEVICES=0 \
  -e VLLM_WORKER_MULTIPROC_METHOD=spawn \
  -e HF_HUB_OFFLINE=1 \
  -e TRANSFORMERS_OFFLINE=1 \
  -e HF_DATASETS_OFFLINE=1 \
  -v /usr/local/Ascend/driver:/usr/local/Ascend/driver \
  -v /usr/local/bin/npu-smi:/usr/local/bin/npu-smi \
  -v /usr/local/dcmi:/usr/local/dcmi \
  mineru:3.4.4-npu \
  mineru-api --host 0.0.0.0 --port 8000