alexsuntop/mineru-sglang
alexsuntop
请使用alexsuntop/mineru，因为MinerU已切换至vLLM框架，以实现更高效的模型推理、更快的响应速度及更高的吞吐量，为用户提供更优质的使用体验，确保在处理各类任务时能够保持稳定性能与卓越效率，满足不同场景下的应用需求。
2 次收藏下载次数: 0状态：社区镜像维护者：alexsuntop仓库类型：镜像最近更新：9 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
MinerU SGLang 后端部署指南
一、概述
MinerU 是一款文档解析工具，其 SGLang 后端支持通过 Docker 快速部署。本文基于官方 Dockerfile 及 Docker Compose 配置，提供 SGLang 后端服务（含服务器、API、WebUI）的部署与使用说明。
注意：MinerU 2.5+ 版本已切换为 vLLM 后端，相关镜像可参考 [alexsuntop/mineru] 。本文内容适用于基于 SGLang 后端的旧版本（如 2.2.2）。
二、环境准备
- 依赖工具：Docker、Docker Compose（需支持 Compose V2）。
- 硬件要求：NVIDIA GPU（需配置 NVIDIA Container Toolkit，确保容器可调用 GPU）。
三、配置说明
以下是核心配置文件 docker-compose.yaml 的关键说明（完整配置见 [源码仓库] ）：
3.1 默认配置（x-default）
定义所有服务的通用基础配置：
- 重启策略：
unless-stopped（异常退出后自动重启）。 - 数据卷：挂载本地时区文件（
/etc/localtime、/etc/timezone），确保容器内时间同步。 - 日志限制：单日志文件最大 100MB（避免磁盘占用过大）。
3.2 通用服务配置（x***u-sglang）
所有 MinerU 服务的共享配置：
- 镜像：默认使用
alexsuntop/mineru-sglang:2.2.2，可通过环境变量MINERU_DOCKER_IMAGE自定义。 - 环境变量：
MINERU_MODEL_SOURCE: local（使用本地模型）。 - 资源限制：默认限制 8 CPU 核心、4G 内存，保留 1 CPU 核心、2G 内存；GPU 仅使用第 0 号设备（可通过
device_ids调整）。 - 性能优化：解除内存锁定限制（
memlock: -1），提升 GPU 通信效率（ipc: host）。
3.3 服务详情
（1）SGLang 后端服务器（sglang-server）
- 功能：提供模型推理服务，端口 30000（可通过
MINERU_PORT_OVERRIDE_SGLANG自定义）。 - 启动命令：
mineru-sglang-server --host 0.0.0.0 --port 30000。 - 可选参数：
- 多 GPU 并行：
--data-parallel-size 2（需调整device_ids包含多个 GPU）。 - 显存优化：
--gpu-memory-utilization 0.5（单 GPU 显存不足时降低，如 0.4）。
- 多 GPU 并行：
- 健康检查：通过 `curl [] 验证服务状态。
（2）文档解析 API（api）
- 功能：提供文档解析接口，端口 8000（可通过
MINERU_PORT_OVERRIDE_API自定义）。 - 启动命令：
mineru-api --host 0.0.0.0 --port 8000，支持与 sglang-server 相同的 GPU 配置参数。
（3）Gradio WebUI（gradio）
- 功能：可视化 Web 界面，端口 7860（可通过
MINERU_PORT_OVERRIDE_GRADIO自定义）。 - 核心参数：
--enable-vllm-engine true：启用 vllm 引擎加速推理。--enable-api false：可选，禁用 API 接口。--max-convert-pages 20：可选，限制文档转换页数。
四、启动服务
通过 Docker Compose 的 --profile 指定服务类型，后台启动：
CODE_TOKEN_0
五、测试 SGLang 后端
安装 MinerU 客户端并测试文档解析：
-
安装客户端：
CODE_TOKEN_1 -
执行测试（需替换
demo.pdf为实际文件路径）：
CODE_TOKEN_2-p：输入文档路径-o：输出目录-b：后端类型（vlm-sglang-client）-u：sglang-server 地址（默认 `[]
六、注意事项
- GPU 资源调整：根据实际硬件配置修改
device_ids（GPU 设备）、data-parallel-size（多卡并行）及gpu-memory-utilization（显存占用）。 - 端口冲突：通过环境变量（如
MINERU_PORT_OVERRIDE_SGLANG=30001）修改默认端口。 - 功能限制：Gradio 界面可通过
--max-convert-pages限制文档转换页数，避免资源过载。
源码参考：[compose-anything]
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 mineru-sglang 镜像标签
docker pull docker.xuanyuan.run/alexsuntop/mineru-sglang:<标签>
DockerHub 原生拉取命令
docker pull alexsuntop/mineru-sglang:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"