手把手教你在本地部署MinerU 1.3.10 API并接入Dify插件 - 53AI-AI知识库大模型知识库大模型训练智能体开发

Zine⁶2025/7/21大约 8 分钟

手把手教你在本地部署MinerU 1.3.10 API并接入Dify插件 - 53AI-AI知识库大模型知识库大模型训练智能体开发

发布日期：2025-06-04 06:21:20 浏览次数： 3396

最近一个多月 MinerU 连续发布版本，已经更新到 1.3.10 了。新版本的 MinerU 提供的 Web API 接口也支持 Docx、Png 等多种格式的文件了。上周官方也推出了教程，在 dify 中使用 MinerU 的插件。本篇文章将实现通过本地部署 1.3.10 版官方 API，并接入 Dify 插件。

MinerU 1.3.0~1.3.10 更新日志

部署 MinerU WEB API

Docker 镜像构建

git 拉取最新的 MinerU 源码，进入到 projects/web_api 目录执行 docker 构建命令。

## 拉取最新源码
cd MinerU/
git pull
git checkout tags/magic_pdf-1.3.10-released

## 制作docker镜像
cd projects/web_api
docker build -t mineru-api:offical-1.3.10 .

国内环境配置

如果你的网络环境相当好，上述的 docker 镜像很快就完成了。当然，大部分情况下速度没那么快，而且可能还会网络中断。

替换 download_models.py 文件，原本的模型是通过 HuggingFace 下载，大概率是网络受限的，替换官方使用 ModelScope 下载的方式

wget https://gcore.jsdelivr.net/gh/opendatalab/MinerU@master/scripts/download_models.py -O download_models.py

在 Dockerfile 中添加一些镜像站，如下

## 【添加】
RUN sed -i 's@deb.debian.org@mirrors.aliyun.com@g' /etc/apt/sources.list.d/debian.sources

# Update the package list and install necessary packages
RUN apt-get update && \
    apt-get install -y --no-install-recommends \
        build-essential && \
    apt-get clean && \
    rm -rf /var/lib/apt/lists/*

# Build Python dependencies  【添加 -i https://mirrors.aliyun.com/pypi/simple/】
COPY requirements.txt .
RUN python -m venv /app/venv && \
    . /app/venv/bin/activate && \
    pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/

另外，我们更换了 download_models.py 文件，模型下载地址发生了变更，因此下面两行也需要修改

# Copy Python dependencies and models from the build stage
COPY --from=build /root/.cache/modelscope/hub/models/opendatalab/PDF-Extract-Kit-1___0/models  /opt/models
COPY --from=build /root/.cache/modelscope/hub/models/ppaanngggg/layoutreader  /opt/layoutreader

根据上述修改，基本上能快速构建镜像了。

Docker 启动服务

为了能在 Dify 插件里使用本地部署的 MinerU 服务，因此我们直接接入到 Dify 的内部网络中，不对外暴露端口了。

docker run -d --gpus all --network docker_ssrf_proxy_network --name mineru-api mineru-api:offical-1.3.10

Dify 插件 MinerU

插件安装及授权

在 Dify 的插件市场，找到 MinerU 产检，点击安装。

等待安装完成后，点击授权，在授权页面填写以下信息。由于我们 Dify 和 MinerU 在一台服务器上。如果部署在不同的机器上，请填写 MinerU 服务器的地址及开放的端口。

授权 MinerU 插件

常见问题

配置完以后在工作流中试用会提示以下错误

MinerU 插件常见错误

对此我们可以参考 MinerU 官方给出的解决方案：

找到 Dify 部署目录，打开. Env 文件，修改 FILES_URL 配置项，依据你的部署方式填写：
-Docker Compose 部署：FILES_URL 设置为http://api:5001
-其他部署方式：FILES_URL 设置为 http://Dify宿主机IP:5001
确认 Dify API 服务的 5001 端口已对外暴露（可检查 docker-compose. Yaml 文件的端口映射）。
保存. Env 文件。
重启 Dify 服务以使配置生效。

我们根据官方提示，修改 Dify 的配置文件 .env ，然后重启 Dify。