OpenSource-Hub
P

papra

4.4k stars·文件管理·已提供 SHA-256 校验码,下载后可自行核对文件完整性

Papra 是一个极简的文档管理平台,支持上传、搜索和归档,适合个人或小团队使用。

智能下载

前往项目主页

该项目暂未提供安装包,请直接访问源代码仓库

轻量极简的文档管理工具,自托管,支持 OCR 和全文搜索。

核心功能

  • 文档上传、存储、管理,支持标签分类
  • 全文搜索和高级筛选,快速找到文件
  • 自动提取图片和扫描件中的文字(OCR)
  • 邮件导入:转发邮件即可自动归档文档
  • 文件夹监控:自动导入指定目录的文件

避坑指南

  • 目前处于活跃开发中,部分高级功能(如文档分享、移动端)尚未完成,默认仅支持 SQLite 数据库,生产环境建议使用 Turso 等远程数据库,OCR 功能依赖 Tesseract,中文识别效果可能不如专用 OCR 服务

适用场景

  • 个人文档归档(合同、发票、保修卡等)
  • 小团队共享文档(通过组织功能)
  • 家庭档案管理(照片、扫描件、信件)
  • 自动从邮件或文件夹导入票据

详细介绍

Papra 是一款轻量级、开源的文档管理平台,专注于长期存储和便捷检索。核心功能包括:文档上传、标签分类、全文搜索、图片/扫描件的文字自动提取(OCR)、邮件导入、文件夹自动导入、CLI 和 REST API。Docker 镜像小于 200MB,支持 x86、ARM64 等架构。目前缺少文档分享和移动端(规划中)。相比 Paperless-ngx,Papra 更简单易上手,界面更清爽,占用资源更少,适合个人或小团队无需复杂配置直接使用。

常见问题与排障 (2)

故障排除
为什么在我自托管的Papra实例上注册用户时会收到'Invalid Origin'错误?

当前端 URL 与配置的 CLIENT_BASE_URL 不匹配时会发生此情况。解决方法:1) 在环境中设置正确的 CLIENT_BASE_URL。2) 如果您使用 v0.2.1 及以上版本,请将您的前端来源添加到 TRUSTED_ORIGINS 以允许多个 URL。对于 Docker 部署,请确保在 docker-compose.yml 中的服务下添加 env_file: - .env 以加载您的 .env 文件。参见文档:https://docs.papra.app/self-hosting/configuration/

来源 Issue #194
故障排除
如何修复在将扫描的PDF导入Papra时出现的文本提取失败(ELIFECYCLE/ENOENT)问题?

当 Papra 尝试处理不完整的文件或通过符号链接访问的文件时,提取会失败。为避免这种情况,请勿通过 FTP 或符号链接将扫描文档直接上传到输入文件夹。相反,应上传到临时目录,并使用看门狗脚本(例如,使用 inotify-tools)将完整写入的文件移动到输入文件夹。示例:使用 inotifywait -m /upload_tmp -e close_write,并通过 mv 将文件移动到 Papra 的输入目录。

来源 Issue #1073

标签

document-managementopen-sourceself-hosteddockerocrfull-text-searchcli

快速上手

1

下载安装包

点击上方按钮下载对应系统的安装包

2

安装软件

双击下载的安装程序,按提示完成安装

3

使用 Docker 运行:docker run -d --name papra -p 1221:1221 -e AUTH_SECRET=你的密钥 ghcr.io/papra-hq/papra:latest

4

生成安全密钥:openssl rand -hex 48

5

打开浏览器访问 http://localhost:1221 创建账户即可开始使用

安装指引
  1. 使用 Docker 运行:docker run -d --name papra -p 1221:1221 -e AUTH_SECRET=你的密钥 ghcr.io/papra-hq/papra:latest
  2. 生成安全密钥:openssl rand -hex 48
  3. 打开浏览器访问 http://localhost:1221 创建账户即可开始使用
文件完整性

暂未获取到校验码

该项目暂未在 GitHub Release 页面提供 SHA-256 校验码

SHA256 校验码

暂无校验码

建议从 GitHub Releases 页面直接下载,并自行核对文件完整性

本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件,未做任何修改。你可以通过 GitHub Releases 页面自行验证。

运维指引

卸载说明

停止并删除容器:docker stop papra && docker rm papra,同时删除持久化数据目录(如有映射卷)。

无额外依赖

下载后即可直接使用,无需安装其他运行环境

项目信息
开源协议AGPL-3.0
最后更新2026-06-26 01:50:24
GitHub 仓库官方网站

遇到问题?查看下方 FAQ

2 FAQs

相似推荐