Paperless-ngx
一个开源文档管理系统,将纸质文件转为可搜索的数字档案。支持自托管、OCR 识别、智能分类,帮你彻底告别纸张。
スマートダウンロード
プロジェクトのホームページへ
インストーラはまだありません — ソースリポジトリをご覧ください
自建文档库,扫描即搜索,告别纸质文件。
主な機能
- 自动 OCR 文字识别,支持 100+ 语言
- 机器学习自动分类文档、提取标签和对应关系
- 强大全文搜索,可按日期、类型、标签等过滤
- 支持从邮件、摄像头、扫描仪自动导入
- 响应式 Web 界面,手机电脑都能用
できないこと
- •不要在公网上直接暴露,因为文档存储为明文未加密。建议仅在内网或通过 VPN 访问,OCR 对中文支持不错但手写体识别精度一般,扫描时尽量保证清晰
使用例
- 家庭:扫描整理发票、合同、病历、保修单,随时查找
- 自由职业/小团队:管理收据、合同、客户文件,多人协作
- 归档癖:把所有纸质书、笔记、剪报数字化,变成个人知识库
詳細説明
Paperless-ngx 是一个开源文档管理系统,能把纸质文件变成可搜索、可管理的在线档案。它自动对扫描件进行 OCR 文字识别、用机器学习分类文档,再通过一个清爽的网页界面让你随时搜索、打标签、调取任何文件。和网盘不同,它是自托管方案——所有数据存你自己服务器上,隐私安全。项目由社区驱动,是 Paperless 和 Paperless-ng 的官方继承版,团队活跃、更新频繁。支持多用户、多语言、邮件自动导入,还能和 Nextcloud、Home Assistant 等工具联动。官方提供在线 demo 可以试用。
トラブルシューティング & FAQ (2)
トラブル対応Paperless-ngxがllama.cppをembeddingsに使用する際に、'input (681 tokens) is too large to process. increase the physical batch size'というエラーで失敗するのはなぜですか?
このエラーは、埋め込みバックエンド(llama.cpp)が、設定された物理バッチサイズ(-b 512)よりも大きな入力を受け取ったために発生します。修正するには、llama.cppコマンドのバッチサイズを少なくとも1024に増やしてください(例:-b 1024)。または、より大きな入力サイズをサポートする埋め込みモデルを使用してください。Paperless-ngxは現在、RAG_CHUNK_SIZEを1024にハードコードしており、コンテキストウィンドウが小さいモデルではこの問題が発生する可能性があります。将来のアップデートでこの値を調整できるようになるかもしれません。
トラブル対応なぜPaperless-ngxでbulk editを使用するときにタグが保存されないのですか?
Paperless-ngx を ASGI(例:Granian)で、PostgreSQL と psycopg3 を使用して実行する場合の既知の問題。バルクの modify_tags 操作が静かに失敗します。これは、M2M 書き込みがコミットされない別のデータベーストランザクションで発生するためです。回避策:ドキュメント詳細ビュー(PATCH /api/documents/{id}/)からタグを編集すると、操作は成功します。あるいは、可能であれば WSGI サーバー(例:Gunicorn)に切り替えて、非同期/同期の境界問題を回避してください。恒久的な修正については、GitHub の issue #12699 を追跡してください。
タグ
はじめ方
ソフトウェアをインストール
ダウンロードしたインストーラをダブルクリックし、指示に従ってください
步骤1:确保已安装 Docker 和 Docker Compose
步骤2:运行一键安装命令:bash -c "$(curl -L https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/install-paperless-ngx.sh)"
步骤3:按提示配置端口、存储路径,启动后访问 http://localhost:8000 设置管理员账号
- 步骤1:确保已安装 Docker 和 Docker Compose
- 步骤2:运行一键安装命令:bash -c "$(curl -L https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/install-paperless-ngx.sh)"
- 步骤3:按提示配置端口、存储路径,启动后访问 http://localhost:8000 设置管理员账号
チェックサムがありません
このプロジェクトは GitHub Release ページに SHA-256 チェックサムを公開していません
SHA256 チェックサム
チェックサムなし
GitHub Releases から直接ダウンロードし、ファイルの整合性をご自身で確認してください
本プラットフォーム上のすべての SHA-256 チェックサムは、プロジェクトの公式 GitHub Release ページから抽出されたもので、一切の改変はありません。GitHub Releases ページで独自に検証できます。
オープンソースの透明性
GitHub ソースを見るアンインストール情報
停止容器并删除相关数据:docker compose down -v。如需清理持久化数据(如 /mnt/paperless 下的文件夹),手动删除对应目录即可。建议备份文档后再操作。
追加の依存関係なし
ダウンロード後すぐに使用可能。追加のランタイムは不要です。
問題が発生?以下のFAQを確認
2 FAQs