Paperless-ngx
一个开源文档管理系统，将纸质文件转为可搜索的数字档案。支持自托管、OCR 识别、智能分类，帮你彻底告别纸张。
스마트 다운로드
프로젝트 홈페이지 방문
아직 설치 프로그램이 없습니다 — 소스 저장소로 이동하세요
自建文档库，扫描即搜索，告别纸质文件。
주요 기능
- 自动 OCR 文字识别，支持 100+ 语言
- 机器学习自动分类文档、提取标签和对应关系
- 强大全文搜索，可按日期、类型、标签等过滤
- 支持从邮件、摄像头、扫描仪自动导入
- 响应式 Web 界面，手机电脑都能用
할 수 없는 것
- •不要在公网上直接暴露，因为文档存储为明文未加密。建议仅在内网或通过 VPN 访问,OCR 对中文支持不错但手写体识别精度一般，扫描时尽量保证清晰
사용 사례
- 家庭：扫描整理发票、合同、病历、保修单，随时查找
- 自由职业/小团队：管理收据、合同、客户文件，多人协作
- 归档癖：把所有纸质书、笔记、剪报数字化，变成个人知识库
상세 설명
Paperless-ngx 是一个开源文档管理系统，能把纸质文件变成可搜索、可管理的在线档案。它自动对扫描件进行 OCR 文字识别、用机器学习分类文档，再通过一个清爽的网页界面让你随时搜索、打标签、调取任何文件。和网盘不同，它是自托管方案——所有数据存你自己服务器上，隐私安全。项目由社区驱动，是 Paperless 和 Paperless-ng 的官方继承版，团队活跃、更新频繁。支持多用户、多语言、邮件自动导入，还能和 Nextcloud、Home Assistant 等工具联动。官方提供在线 demo 可以试用。
문제 해결 & FAQ (2)
문제 해결Paperless-ngx가 llama.cpp를 임베딩에 사용할 때 '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에서 일괄 편집 시 태그가 저장되지 않나요?
Paperless-ngx를 ASGI(예: Granian) 환경에서 PostgreSQL 및 psycopg3와 함께 실행할 때 알려진 문제입니다. bulk modify_tags 작업이 M2M 쓰기가 절대 커밋되지 않는 다른 데이터베이스 트랜잭션에서 발생하기 때문에 조용히 실패합니다. 해결 방법: 태그는 문서 상세 보기(PATCH /api/documents/{id}/)에서 편집하면 작업이 성공합니다. 또는 가능하다면 WSGI 서버(예: Gunicorn)로 전환하여 비동기/동기 경계 문제를 회피하세요. 영구적인 수정을 위해 GitHub 이슈 #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