先了解：MinerU 移动端到底怎么“安装”

MinerU 是一款专注于文档解析、版面识别、OCR 处理以及内容结构化的 AI 工具，常用于将 PDF、扫描件、论文、报告、说明书等资料转换为可编辑、可检索的文本或 Markdown 结构。其核心计算通常依赖于服务端环境，包括模型文件、运行框架、显存或高性能 CPU，因此严格来说，手机并非最适合本地运行 MinerU 的设备。

移动端安装的推荐思路并非将完整模型塞入手机，而是先在电脑、工作站或云主机上完成 MinerU 服务部署，再用手机浏览器访问 Web 页面，必要时添加到手机桌面，从而获得类似 App 的使用体验。这样既能保留移动端随时上传、查看、下载结果的便捷性，又能避免手机性能不足、模型依赖复杂、存储空间紧张等问题。

适用场景与准备条件

移动端使用 MinerU 适合三类场景：一是外出时临时处理文档，例如拍摄纸质资料后快速识别；二是团队已有统一部署，希望成员用手机提交解析任务；三是内容编辑、研究人员需要随时查看解析结果并复制文本。若需批量处理上百个大文件，仍建议在电脑端操作。

开始前需要准备四项内容：第一，已经可用的 MinerU Web 服务地址，例如由管理员提供的访问链接；第二，手机浏览器，Android 可使用系统自带浏览器或 Chrome，iPhone 建议使用 Safari；第三，登录账号或访问令牌，具体取决于部署方式；第四，稳定网络环境，尤其是上传大 PDF 时，建议保持屏幕常亮并避免切换应用导致上传中断。

服务端部署确认：移动端能访问才是关键

如果你是普通使用者，只需向部署人员确认“访问地址、账号、上传大小限制、结果保存时间”四项信息即可。如果你负责部署，则要先确认 MinerU 的 WebUI 或接口服务已正常启动，并且手机与服务端处于可访问的网络范围内。常见方式包括公司内网访问、同一局域网访问，或通过安全网关开放给指定成员使用。

部署完成后，先在电脑浏览器打开服务地址，确认可以上传测试文件并获得解析结果；再用手机访问同一地址。如果电脑能打开而手机打不开，通常不是 MinerU 本身的问题，而是服务监听地址、防火墙策略、端口映射、域名解析或访问权限没有配置好。建议优先检查服务是否绑定在 0.0.0.0，而不是仅绑定 127.0.0.1；同时确认端口未被拦截。

Android 端安装与使用步骤

第一步，在手机浏览器输入 MinerU 服务地址。若页面提示证书异常，不要急于继续访问，应先确认地址是否由团队提供、证书是否正确配置。内部测试环境可以临时使用 IP 加端口访问，正式使用建议配置 HTTPS 域名。

第二步，登录账号。首次登录后建议不要在公共设备上保存密码。若系统支持多角色权限，普通成员只保留上传、查看本人任务、下载结果等权限即可，不建议授予配置模型、删除全站任务、修改用户等高权限。

第三步，添加到桌面。Android 浏览器通常可在菜单中找到“添加到主屏幕”或“安装应用”选项。添加后，桌面会出现 MinerU 快捷入口，下次点击即可像打开 App 一样进入服务。需要注意，这不是独立原生应用，而是 Web 快捷方式，因此服务端关闭或网络不可达时仍无法使用。

第四步，上传文档并选择解析模式。移动端上传文件时，可从文件管理器、相册或最近文件中选择。扫描件建议先裁切清晰，避免大面积阴影、歪斜和反光。若页面提供 OCR、版面分析、公式识别、表格识别等选项，可按需求开启；文件较大时不要一次勾选过多高耗时能力，以免等待时间过长。

iPhone 端安装与使用步骤

iPhone 端推荐使用 Safari 打开 MinerU 服务地址。登录成功后，点击分享按钮，选择“添加到主屏幕”，填写名称后保存。之后桌面会生成一个入口，适合经常处理文档的用户使用。

上传文件时，iPhone 可从“文件”应用、相册、聊天软件保存的文档目录中选择。若资料来自拍照，建议先使用系统扫描文稿功能生成清晰 PDF，再上传到 MinerU。直接上传照片也可以，但页面识别质量受拍摄角度、光线、文字密度影响较大。对于页数较多的资料，建议拆分成较小文件分批处理，减少移动端上传失败的概率。

进阶配置：让移动端体验更稳定

如果 MinerU 供多人使用，建议配置任务队列和结果缓存。移动端用户经常在碎片时间提交任务，若没有队列控制，多人同时上传大文件可能导致服务卡顿。可以设置单文件大小上限、单用户并发任务数、解析结果保留天数，并在页面上给出明确提示。

同时建议启用 HTTPS、登录验证和访问日志。HTTPS 可以降低传输过程中的泄露风险，登录验证用于区分不同成员的任务，访问日志方便排查异常请求和失败原因。若部署在公网环境，不建议直接暴露原始端口，应放在统一入口后面，并限制可访问人群。

移动端页面还可以做一些轻量优化，例如开启响应式布局、压缩预览图、延迟加载历史任务、把下载按钮放在明显位置。很多失败体验并不来自模型能力，而是手机屏幕小、网络波动、文件选择路径复杂导致的交互问题。

后台管理入口说明

MinerU 的后台管理入口并没有一个放之四海皆准的固定地址，取决于你使用的是官方示例界面、第三方封装面板，还是团队自行开发的管理系统。常见做法是把管理页配置在 /admin、/dashboard、/console 等路径下，也可能通过独立子域名访问。是否存在后台、入口是什么，应以部署配置文件和管理员说明为准。

如果你是管理员，可以在部署文档、环境变量或反向入口配置中查找后台路由；如果你是普通用户，不建议自行猜测后台路径。后台一般用于管理用户、查看任务、调整解析参数、清理历史文件、配置模型路径和查看运行状态，权限较高。错误操作可能导致任务丢失、服务不可用或配置混乱。

后台首次启用后应立即完成三件事：修改默认账号密码，关闭不需要的开放注册，按角色分配权限。上传解析类工具通常会接触大量文档，管理入口一旦弱口令或无鉴权，风险会明显增加。对于离职成员、临时测试账号和过期项目账号，也要及时停用。

常见问题与排查方法

问题一：手机打开页面空白。先尝试刷新页面、清理浏览器缓存，再确认服务端是否正常运行。若电脑可访问而手机不可访问，重点检查网络范围、端口放行和访问地址是否写成了本机地址。

问题二：上传到一半失败。通常与文件过大、网络切换、浏览器后台限制有关。可以压缩或拆分 PDF，保持页面前台运行，避免锁屏。管理员可适当提高上传超时时间，但不建议无限放开大小限制。

问题三：识别结果乱码或结构错乱。可能是源文件质量差、扫描分辨率低、文字倾斜严重，或文档中包含复杂公式、跨页表格。可先用更清晰的源文件重试，必要时分章节解析，并人工复核关键内容。

问题四：后台入口无法登录。先确认你是否具备管理权限，再检查账号状态、密码是否更新、管理路由是否被改名。若多次失败，不要反复尝试，应联系部署人员查看日志，避免触发安全策略。

安全边界与实用建议

使用 MinerU 处理文档时，应遵循最小化原则：只上传完成任务所需的文件，不上传无关附件；解析完成后及时下载并清理；团队共享环境中，不要把个人任务设置为公开可见。涉及合同、证件、研发资料、客户资料等内容时，应先确认组织内部的数据处理规范。

不要把 MinerU 当作完全自动化的最终审稿工具。OCR 和版面分析再成熟，也可能在数字、公式、表格、脚注、页眉页脚处出现误差。重要材料应进行人工复核，尤其是金额、日期、姓名、编号、专业术语等字段。

移动端最推荐的使用方式是“轻提交、轻查看、重处理交给服务端”。也就是说，手机负责上传、预览和下载，模型计算、任务排队、文件存储由服务端承担。只要入口配置清楚、权限划分合理、后台管理规范，MinerU 在移动端就能成为高效的随身文档解析工具。