手把手教你在本地部署MinerU 1.3.10 API并接入Dify插件

最近一个多月，MinerU接连发布了多个版本，现在已经更新到1.3.10了。新版本最大的亮点之一，就是Web API接口终于支持了Docx、Png等多种格式的文件。不仅如此，官方上周还专门出了一份教程，教大家如何在Dify里使用MinerU的插件。这篇文章就来一步步拆解：怎么在本地部署1.3.10版官方API，再把它接到Dify插件里。

部署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服务器的地址和开放的端口。

常见问题

配置完以后，在工作流里试用时可能会遇到下面这个错误。别急，官方已经给出了解决方案：

1. 找到 Dify 部署目录，打开 .env 文件，修改 FILES_URL 配置项，依据你的部署方式填写：

- Docker Compose 部署：FILES_URL 设置为 http://api:5001

- 其他部署方式：FILES_URL 设置为 http://Dify宿主机IP:5001

2. 确认 Dify API 服务的 5001 端口已对外暴露（可检查 docker-compose.yaml 文件的端口映射）。

3. 保存 .env 文件。

4. 重启 Dify 服务以使配置生效。

按照官方指引修改 Dify 的 .env 文件，然后重启服务即可。

工作流测试

搭一个简单的 Dify 工作流，测一下 MinerU 插件的效果。拿官方发布的那篇文章来实验（链接见原文），打印成PDF，一共22页。上传到工作流测试，结果如下：

成功实现了图片型PDF的识别！新版本MinerU优化之后，不仅显存占用下降了，速度也很快。22页的图片PDF，整个工作流只用了20秒就解析完了。