MinerU 本地部署完整指南：从零构建你的私有文档智能处理系统

引言：为什么选择 MinerU？

在当今人工智能与大模型技术飞速发展的时代，如何高效、安全地处理企业或个人的敏感文档数据成为一项关键挑战。MinerU 正是在这一背景下应运而生的开源工具——它是一个专注于将 PDF、Word、PPT 等复杂格式文档智能解析为结构化 Markdown 的本地化解决方案。MinerU 不仅支持高精度的版面识别（Layout Analysis）、表格重建、公式还原，还能保留原始文档中的层级结构、图片位置与语义顺序，极大地方便了后续的向量化、知识库构建或 RAG（Retrieval-Augmented Generation）应用。

更重要的是，MinerU 完全支持本地部署，这意味着你的文档数据无需上传至任何云端服务器，所有处理过程均在你自己的机器上完成，从根本上保障了数据隐私与合规性。对于金融、法律、医疗、科研等对数据安全要求极高的行业而言，MinerU 提供了一条兼顾效率与安全的可行路径。

本文将为你提供一份详尽、可操作、覆盖 Windows 与 Linux 系统的 MinerU 本地部署指南。无论你是开发者、AI 工程师，还是希望搭建私有知识管理系统的普通用户，只要具备基础的命令行操作能力，都能按照本教程成功部署并运行 MinerU。全文超过 5000 字，涵盖环境准备、依赖安装、模型下载、服务启动、API 调用、性能优化及常见问题排查等核心环节，并附有实战示例与最佳实践建议。

---

第一章：MinerU 简介与核心功能

1.1 什么是 MinerU？