零基础10分钟部署MinerU：Docker Compose一键搭建指南

MinerU 是一款高效的数据处理工具，基于 Docker Compose 部署可以极大简化环境配置流程，无需复杂的依赖安装即可快速启动服务。本文将详细讲解通过 Docker Compose 分步部署 MinerU 的完整流程，适配国内网络环境，新手也能轻松上手。

一、部署前准备

1. 环境要求

已安装 Docker 和 Docker Compose（建议 Docker 版本 ≥ 20.10，Compose 版本 ≥ 2.0）
服务器/本地机器具备外网访问能力（用于下载镜像和配置文件）
至少 2GB 可用内存，确保容器正常运行

2. 环境检查

执行以下命令验证 Docker 和 Compose 是否安装成功：

Bash 复制代码

# 检查 Docker 版本
docker --version
# 检查 Docker Compose 版本
docker compose version

若未安装，可参考 Docker 官方文档完成安装（国内用户建议使用阿里云镜像加速）。

二、分步部署 MinerU

步骤1：构建 MinerU 镜像（适配国内环境）

首先下载适配国内网络的 Dockerfile，并构建本地镜像：

Bash 复制代码

# 下载国内版 Dockerfile
wget https://gcore.jsdelivr.net/gh/opendatalab/MinerU@master/docker/china/Dockerfile

# 构建 MinerU 镜像（标签为 latest）
docker build -t mineru:latest -f Dockerfile .

执行过程中会自动下载基础镜像和依赖，国内网络可能需要几分钟，耐心等待即可；
若出现下载超时，可配置 Docker 镜像加速（如阿里云、网易云镜像源）。

步骤2：下载 Compose 配置文件

Compose 配置文件定义了 MinerU 各服务的运行规则，执行以下命令下载：

Bash 复制代码

wget https://gcore.jsdelivr.net/gh/opendatalab/MinerU@master/docker/compose.yaml

下载完成后，可通过 cat compose.yaml 查看文件内容，确认配置无异常。

步骤3：启动 OpenAI 服务（可选）

若需使用 OpenAI 相关功能，启动对应 profile：

Bash 复制代码

docker compose -f compose.yaml --profile openai-server up -d

--profile 指定启动的服务组，openai-server 对应 OpenAI 相关服务；
-d 表示后台运行，不占用当前终端。

步骤4：启动 API 服务

API 服务是 MinerU 的核心接口层，执行以下命令启动：

Bash 复制代码

docker compose -f compose.yaml --profile api up -d

启动后可通过 docker compose ps 查看服务状态，若状态为 Up 则表示启动成功。

步骤5：启动 Gradio 可视化界面

Gradio 提供了可视化操作界面，方便非命令行用户使用：

Bash 复制代码

docker compose -f compose.yaml --profile gradio up -d

启动完成后，访问服务器 IP + 对应端口（默认 7860）即可打开 Gradio 界面。

三、常用运维命令

1. 查看服务状态

Bash 复制代码

docker compose -f compose.yaml ps

2. 查看服务日志

Bash 复制代码

# 查看 API 服务日志
docker compose -f compose.yaml logs mineru-api
# 实时查看日志
docker compose -f compose.yaml logs -f mineru-gradio

3. 停止服务

Bash 复制代码

# 停止单个服务
docker compose -f compose.yaml stop mineru-gradio
# 停止所有服务
docker compose -f compose.yaml down

4. 重启服务

Bash 复制代码

docker compose -f compose.yaml restart mineru-api

四、常见问题解决

镜像构建失败：检查网络是否正常，或手动替换 Dockerfile 中的源为国内镜像（如清华源、阿里云源）；
服务启动后无法访问：检查服务器防火墙/安全组是否开放对应端口（30000、7860、8000 等）；
Compose 命令报错 ：确认 Docker Compose 版本为 v2，若为 v1 需替换为 docker-compose（带短横线）。

总结

MinerU Docker Compose 部署核心分为三步：构建国内适配镜像、下载配置文件、按 profile 启动对应服务；
不同 profile 对应不同功能模块，可根据需求选择性启动（如仅用可视化界面可只启动 gradio，需 API 调用则启动 api）；
部署后可通过 docker compose 系列命令完成服务的启停、日志查看等运维操作，便于问题排查。

通过以上步骤，你可以快速完成 MinerU 的 Docker Compose 部署，无需关注复杂的环境依赖，直接开箱即用。根据实际需求选择启动的服务模块，既能节省资源，又能满足不同的使用场景。