도구별 실전 가이드 · 공식 정보 확인 2026-08-20
paperless-ngx GPL-3.0 오픈소스 조건과 시작 절차
작성: gentive · 편집·검수 책임: 신유빈 · 지원 환경: Web, Self-hosted · 페이지 갱신: · 운영·편집 기준
종이 문서를 OCR로 검색 가능하게 만들고 대응자·유형·태그로 장기 보관하는 스캔·색인·보관을 통합한 자가 호스팅 문서 관리 시스템입니다.
종이 문서를 OCR로 검색 가능하게 만들고 대응자·유형·태그로 장기 보관하는 스캔·색인·보관을 통합한 자가 호스팅 문서 관리 시스템입니다. paperless-ngx의 첫 실전 과제는 “가정 문서 열 장을 스캔해 업체와 연도별로 자동 분류하기”이며, 이 흐름을 직접 통제할 사람에게 맞습니다.
이럴 때 맞습니다
- “보험·공과금·영수증이 섞인 비식별 스캔 PDF 열 장” 같은 입력으로 paperless-ngx의 핵심 기능을 시험하려는 사람
- 각 파일의 날짜·대응자·문서 유형이 맞고 원본과 OCR 사본을 모두 열 수 있는지 기준으로 paperless-ngx 결과를 직접 검수할 수 있는 경우
- Web·Self-hosted 환경에서 GPL-3.0 코드를 직접 설치·관리하려는 작업
이럴 때는 멈추세요
- 스캔·색인·보관을 통합한 자가 호스팅 문서 관리 시스템 설치·모델 준비·업데이트를 관리하지 않고 즉시 완성된 서비스를 원하는 경우
- 다음 위험을 사람이 확인할 수 없는 작업: 관리 화면이나 소비 폴더 노출로 신분·금융 문서 전체가 유출되고 OCR 자동 규칙이 파일을 잘못 분류하는 위험.
참고 시작점
팩트시트 · 작업 근거 확인 필요: 아래 문구는 공식 제품 사실을 정리한 참고 시작점이며, 성공 결과를 보장하는 검증 절차가 아닙니다.
소비 폴더와 원본 보관 경계를 만든다
보험·공과금·영수증 열 장을 안전하게 수신하는 문서함이 생긴다.
참고 시작점: 비식별 PDF 열 장만 consume folder에서 받아 원본을 보존해 줘.
- paperless-ngx self-hosted instance의 consume folder를 비공개 volume에 둔다.
- Web management access를 localhost 또는 인증 VPN으로 제한한다.
- 열 PDF 원본의 hash와 유형 예상값을 import 전 기록한다.
OCR하고 대응자·유형·연도를 분류한다
검색 가능한 사본과 metadata 후보가 생성된다.
참고 시작점: 각 문서를 OCR하고 업체 대응자, 문서 유형, 연도를 제안해 줘.
- paperless-ngx OCR로 스캔 PDF를 searchable document로 만든다.
- correspondent·document type·date를 원문 첫 페이지와 대조한다.
- machine learning rule은 첫 열 장에서 자동 확정하지 않고 suggestion으로 둔다.
원본·OCR·자동 규칙을 함께 검수한다
잘못 분류된 파일 없이 검색 가능한 가정 문서함이 남는다.
참고 시작점: 열 문서의 날짜·대응자·유형을 원본과 비교하고 원본·OCR 사본을 모두 열어 줘.
- 각 record에서 original file과 archive PDF가 모두 열리는지 확인한다.
- 보험·공과금·영수증별 date·correspondent·type을 표로 검수한다.
- 오분류 rule을 삭제하고 관리 화면·consume volume의 외부 노출을 다시 점검한다.
무료 조건과 주의점
GPL-3.0 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도
GPL-3.0 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도
GPL-3.0 라이선스의 고지·소스 공개·동일 라이선스 등 조건을 확인해야 합니다.
관리 화면이나 소비 폴더 노출로 신분·금융 문서 전체가 유출되고 OCR 자동 규칙이 파일을 잘못 분류하는 위험.
공식 근거와 확인일
| 확인 항목 | 확인한 내용 | 공식 출처·확인일 |
|---|---|---|
| 제품 정보 | 종이 문서를 OCR로 검색 가능하게 만들고 대응자·유형·태그로 장기 보관하는 스캔·색인·보관을 통합한 자가 호스팅 문서 관리 시스템입니다. | paperless-ngx 공식 사이트 |
| 무료 조건 | GPL-3.0 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도 | 공식 무료 정책·요금 안내 |
| 공식 코드 라이선스 | 오픈소스 코드의 사용·수정·재배포 조건 | 공식 코드 라이선스 |
| 공식 제품 페이지 | 종이 문서를 OCR로 검색 가능하게 만들고 대응자·유형·태그로 장기 보관하는 스캔·색인·보관을 통합한 자가 호스팅 문서 관리 시스템입니다. | 공식 제품 페이지 |